|
浅析μC/GUI-v3.90a之WM_ITERATE_START剪切域计算宏
文章来源:http://gliethttp.cublog.cn
接续《浅析μC/GUI-v3.90a之GUI_DispString函数》讨论WM_ITERATE_START剪切域计算宏
//剪切域宗旨:本hWin内部被控件占用的部分不用绘制;窗体Z序中比本hWin窗体高的窗体遮盖住本hWin的部分不用绘制;
//本hWin超出parent窗体边界的部分不用绘制;窗体的窗体Z序比本hWin的parent窗体高的窗体遮盖住本hWin需要绘制的部分不需要绘制;
//这就是剪切域绘制的宗旨,让绘制部分最小,通过复杂的cpu计算,避免窗体互相遮盖部分的重复绘制,提高显式速度,增加lcd使用寿命.[gliethttp]
//计算完剪切域之后,通过WM__ActivateClipRect()将会使_ClipContext.CurRect传递给GUI_Context.ClipRect,最终影响绘图的有效空间
//拿对当前hWin进行GUI_Clear()来说,剪切域的绘制顺序是上到下窄条依次绘制,在上到下的过程中又会由左到右依次计算绘制
-------------------------------------------------------------------------------------
1.
...
{
r = *pr;
#if GUI_WINSUPPORT
WM_ADDORG(r.x0, r.y0);
WM_ADDORG(r.x1, r.y1); //平移矩形r
WM_ITERATE_START(&r) { //计算r矩形区域内的剪切域
#endif
GUI_Context.DispPosX = r.x0;
GUI_Context.DispPosY = r.y0;
_DispLine(s, MaxNumChars, &r);
#if GUI_WINSUPPORT
} WM_ITERATE_END();
#endif
}
...
-------------------------------------------------------------------------------------
2.WM_ITERATE_START宏
gui/wm/WM_GUI.h
#define WM_ITERATE_START(pRect) \
{ \
if (WM__InitIVRSearch(pRect)) \ //构造循环体
do {
-------------------------------------------------------------------------------------
3.WM__InitIVRSearch()函数
gui/wm/WM.c
int WM__InitIVRSearch(const GUI_RECT* pMaxRect) {
GUI_RECT r;
WM_Obj* pAWin;
GUI_ASSERT_LOCK();
if (WM_IsActive==0) {
WM__ActivateClipRect();
return 1;
}
if (++_ClipContext.EntranceCnt > 1) //如果重入,返回,保持计算操作的唯一性
return 1;
pAWin = WM_H2P(GUI_Context.hAWin); //当前句柄,详情请参考《浅析μC/GUI-v3.98之WM_H2P()句柄hWin转内存函数》
_ClipContext.Cnt = -1;
if (WM__PaintCallbackCnt) { //从回调函数进入的剪切计算
WM__GetInvalidRectAbs(pAWin, &r); //r=pWin->InvalidRect;r存放pWin失效矩形区
} else {
if (pAWin->Status & WM_SF_ISVIS) {
r = pAWin->Rect; //不是回调函数引起的剪切计算,那么整个pWin窗体作为失效区域
} else {
--_ClipContext.EntranceCnt; //窗体属性为不可见
return 0;
}
}
if (pMaxRect) {
GUI__IntersectRect(&r, pMaxRect); //r依据pMaxRect,缩小自己的矩形区域
}
/* If user has reduced the cliprect size, reduce the rectangle */
if (GUI_Context.WM__pUserClipRect) {
WM_Obj* pWin = pAWin; //用户指定了失效重绘区域,那么继续缩小r的矩形区域
GUI_RECT rUser = *(GUI_Context.WM__pUserClipRect);
#if WM_SUPPORT_TRANSPARENCY
if (WM__hATransWindow) { //具有半透明属性
pWin = WM_H2P(WM__hATransWindow);
}
#endif
WM__Client2Screen(pWin, &rUser); //以pWin(x0,y0)位坐标原点,平移rUser矩形
GUI__IntersectRect(&r, &rUser); //继续缩小r矩形区
}
#if WM_SUPPORT_TRANSPARENCY
if (WM__hATransWindow) { //如果有半透明窗体,那么需要继续缩小剪切域r
if (WM__ClipAtParentBorders(&r, WM__hATransWindow) == 0) {
--_ClipContext.EntranceCnt;
return 0;
}
}
#endif
//主要进行如下五步操作:
//一.以上所有工作主要是是计算当前激活窗体hWin自身与pMaxRect的平面剪切区域r,
//二.接下来WM__ClipAtParentBorders()函数完成和hWin所有父窗体边框剪切,如果有一个父窗体属性为不可见,直接0退出
if (WM__ClipAtParentBorders(&r, GUI_Context.hAWin) == 0) {
--_ClipContext.EntranceCnt;
return 0;
}
_ClipContext.ClientRect = r; //保存r重绘区域到IVR专用单元_ClipContext.ClientRect
return WM__GetNextIVR(); //hWin自己的、所有父窗体的同级兄弟窗体与该r进行平面、三维立体z序混合剪切
} //pWin->hNext其实从窗口Z序来讲,是在pWin上面的控件,而不把pWin->hNext叫作hWin的兄弟
//pWin->hNext以及hNext->hNext都有权力覆盖hWin窗体,因为他们在窗口Z序的比hWin更靠近顶层处
-------------------------------------------------------------------------------------
4.WM__GetInvalidRectAbs()函数
gui/wm/WM.c
static void WM__GetInvalidRectAbs(WM_Obj* pWin, GUI_RECT* pRect) {
*pRect = pWin->InvalidRect;
}
-------------------------------------------------------------------------------------
5.WM__GetNextIVR()函数
gui/wm/WM.c
int WM__GetNextIVR(void) {
#if GUI_SUPPORT_CURSOR
static char _CursorHidden;
#endif
if (WM_IsActive==0) {
return 0;
}
if (_ClipContext.EntranceCnt > 1) {
_ClipContext.EntranceCnt--;
return 0;
} //非法性检查
#if GUI_SUPPORT_CURSOR
if (_CursorHidden) {
_CursorHidden = 0;
(*GUI_CURSOR_pfTempUnhide) (); //如果当前鼠标,即上一次进入时鼠标不可见,那么显示鼠标
}
#endif
++_ClipContext.Cnt;
/* Find next rectangle and use it as ClipRect */
//三.与窗口Z序比hWin->parent大的窗体进行剪切计算,缩小本次hWin绘制的区域
//四.与窗口Z序比hWin大的窗体进行剪切计算,继续缩小本次hWin绘制的区域
//五.与hWin窗体内部所有Child控件进行剪切计算,继继续缩小本次hWin绘制的区域
if (!_FindNext_IVR()) { //见函数6的注解
_ClipContext.EntranceCnt--;
return 0;
}
WM__ActivateClipRect();
/* Hide cursor if necessary */
#if GUI_SUPPORT_CURSOR
if (GUI_CURSOR_pfTempHide) {
_CursorHidden = (*GUI_CURSOR_pfTempHide) ( &_ClipContext.CurRect);
}
#endif
return 1;
}
-------------------------------------------------------------------------------------
6._FindNext_IVR()函数
//2007-07-11 gliethttp宗旨就是:本hWin内部被控件占用的部分不用绘制,窗体Z序中比本hWin窗体高的窗体遮盖住本hWin的部分不用绘制
//本hWin超出parent窗体边界的部分不用绘制,窗体的窗体Z序比本hWin的parent窗体高的窗体遮盖住本hWin需要绘制的部分不需要绘制
//这样就是剪切域绘制的宗旨了,让绘制部分最小,通过复杂的cpu计算,避免窗体遮盖部分的重复绘制,提高显式速度,增加lcd使用寿命.
gui/wm/WM.c
static int _FindNext_IVR(void) {
WM_HMEM hParent;
GUI_RECT r;
WM_Obj* pAWin;
WM_Obj* pParent;
r = _ClipContext.CurRect;
//1.设置r的初始化值
if (_ClipContext.Cnt == 0) { //如果从WM__InitIVRSearch()->WM__GetNextIVR()->_FindNext_IVR()进入
r.x0 = _ClipContext.ClientRect.x0; //那么_ClipContext.Cnt==0成立,将WM__InitIVRSearch()计算的存储到_ClipContext.ClientRect的剪切域
r.y0 = _ClipContext.ClientRect.y0; //读取到r中
} else {
r.x0 = _ClipContext.CurRect.x1+1; //接续上一已经绘制的窄条剪切域,继续进行其它窄条剪切域的计算
r.y0 = _ClipContext.CurRect.y0; //绘制顺序是上到下窄条依次绘制,在上到下的过程中又会由左到右依次计算绘制
if (r.x0 > _ClipContext.ClientRect.x1) {
NextStripe: /* go down to next stripe */
r.x0 = _ClipContext.ClientRect.x0;
r.y0 = _ClipContext.CurRect.y1+1;
}
}
//2.检测剪切计算完成否
if (r.y0 >_ClipContext.ClientRect.y1) {
return 0;
}
//3.寻找pRect->y1这个下边沿在所有和pRect存在剪切关系控件窗体中的最小位置,即:"r.y1靠上计算"
pAWin = WM_H2P(GUI_Context.hAWin);
if (r.x0 == _ClipContext.ClientRect.x0) {
r.y1 = _ClipContext.ClientRect.y1;
r.x1 = _ClipContext.ClientRect.x1;
/* Iterate over all windows which are above */
/* Check all siblings above (Iterate over Parents and top siblings (hNext) */
for (hParent = GUI_Context.hAWin; hParent; hParent = pParent->hParent) {
//_Findy1就是寻找pRect->y1这个下边沿的最小位置
pParent = WM_H2P(hParent); //计算GUI_Context.hAWin自己的哥们窗体[Z序比hWin高的窗口],
_Findy1(pParent->hNext, &r, NULL); //和父窗体的哥们窗体分别和r剪切域[Z序比老爹高的窗口]
//2007-07-11 gliethttp _Findy1()计算pParent->hNext和hNext->hNext等窗口Z序比pParent窗口Z序大的r剪切域
//举例:如A,B两个窗口,A窗口Z序比B窗口Z序大,那么A就在B的上面,A可以覆盖B,但B不能覆盖A,因为A窗口Z序比B窗口Z序大
}
/* Check all children */
_Findy1(pAWin->hFirstChild, &r, NULL); //对pWin窗体内部的所有孩子控件进行同样的r剪切计算
}
//4.调整pRect->x0到所有存在剪切关系的控件窗口的最右边rWinClipped.x1+1处,即:"r.x0靠右计算"
Find_x0:
r.x1 = r.x0;
{
hParent = GUI_Context.hAWin;
}
for (; hParent; hParent = pParent->hParent) {
pParent = WM_H2P(hParent);
if (_Findx0(pParent->hNext, &r, NULL)) {
goto Find_x0; //如果pParent的窗口Z序上层中存在和该r剪切区域,调整r.x0到
} //相应窗口Z序对应窗口的x1+1处,goto Find_x0继续计算接下来的pParent
} //就这样一直将r.x0调整到所有与r存在剪切关系的窗口Z序上层窗体的右边x1+1处
/* Check all children */
if (_Findx0(pAWin->hFirstChild, &r, NULL)) { //在自己hWin窗体内的所有孩子控件进行r.x0靠右计算
goto Find_x0;
}
//5.如果r.x0 > r.x1即,r的右边框,那么该窄条剪切域完毕.goto NextStripe去找下一个窄条剪切域
r.x1 = _ClipContext.ClientRect.x1; //恢复"r.x0靠右计算"中破坏了的r.x1
if (r.x1 < r.x0) {
_ClipContext.CurRect = r;
goto NextStripe; //x0过界,计算下一个需要重绘窄条剪切域
}
//6.调整pRect->x1到所有存在剪切关系的控件窗口的最左边rWinClipped.x0-1处,即:"r.x1靠左计算"
{
hParent = GUI_Context.hAWin;
}
for (; hParent; hParent = pParent->hParent) {
pParent = WM_H2P(hParent);
_Findx1(pParent->hNext, &r, NULL);
}
/* Check all children */
_Findx1(pAWin->hFirstChild, &r, NULL); //在自己hWin窗体内的所有孩子控件进行r.x1靠左计算
if (_ClipContext.Cnt >200) {
return 0; //最大嵌套数目
}
_ClipContext.CurRect = r;
return 1; //2007-07-11 gliethttp计算完毕;通过WM__ActivateClipRect()将会使
} //_ClipContext.CurRect传递给GUI_Context.ClipRect,来影响绘图的有效空间
-------------------------------------------------------------------------------------
6._Findy1()函数
gui/wm/WM.c
static void _Findy1(WM_HWIN iWin, GUI_RECT* pRect, GUI_RECT* pParentRect) {
WM_Obj* pWin; //_Findy1就是寻找pRect->y1这个下边沿的最小位置
for (; iWin; iWin = pWin->hNext) { //窗体z序比hWin高的所有窗体中,剪切遮盖住本pRect的部分[gliethttp]:找y1.
int Status = (pWin = WM_H2P(iWin))->Status;
if (Status & WM_SF_ISVIS) {
GUI_RECT rWinClipped;
if (pParentRect) { //指定了剪切参考
GUI__IntersectRects(&rWinClipped, &pWin->Rect, pParentRect);
} else {
rWinClipped = pWin->Rect; //pWin->Rect作为剪切参考
}
if (GUI_RectsIntersect(pRect, &rWinClipped)) {
if ((Status & WM_SF_HASTRANS) == 0) {
if (pWin->Rect.y0 > pRect->y0) {
ASSIGN_IF_LESS(pRect->y1, rWinClipped.y0 - 1); //将pRect->y1和rWinClipped矩形的上边延y0对齐
} else {
ASSIGN_IF_LESS(pRect->y1, rWinClipped.y1); //将pRect->y1和rWinClipped矩形的下边延y1对齐
}
} else {
/* Check all children*/
WM_HWIN hChild;
WM_Obj* pChild;
for (hChild = pWin->hFirstChild; hChild; hChild = pChild->hNext) {
pChild = WM_H2P(hChild);
_Findy1(hChild, pRect, &rWinClipped);
}
}
}
}
}
}
-------------------------------------------------------------------------------------
6._Findx0()函数
gui/wm/WM.c
static int _Findx0(WM_HWIN hWin, GUI_RECT* pRect, GUI_RECT* pParentRect) {
WM_Obj* pWin;
int r = 0;
for (; hWin; hWin = pWin->hNext) { //窗体z序比hWin高的所有窗体中,剪切遮盖住本pRect的部分[gliethttp]:找x0.
int Status = (pWin = WM_H2P(hWin))->Status;
if (Status & WM_SF_ISVIS) {
GUI_RECT rWinClipped;
if (pParentRect) {
GUI__IntersectRects(&rWinClipped, &pWin->Rect, pParentRect);
} else {
rWinClipped = pWin->Rect;
}
if (GUI_RectsIntersect(pRect, &rWinClipped)) {
if ((Status & WM_SF_HASTRANS) == 0) {
pRect->x0 = rWinClipped.x1+1; //调整pRect->x0到所有存在剪切关系的控件窗口的右边rWinClipped.x1+1处
r = 1;
} else {
/* Check all children */ //半透明处理
WM_HWIN hChild;
WM_Obj* pChild;
for (hChild = pWin->hFirstChild; hChild; hChild = pChild->hNext) {
pChild = WM_H2P(hChild);
if (_Findx0(hChild, pRect, &rWinClipped)) {
r = 1;
}
}
}
}
}
}
return r;
}
-------------------------------------------------------------------------------------
6._Findx1()函数
static void _Findx1(WM_HWIN hWin, GUI_RECT* pRect, GUI_RECT* pParentRect) {
WM_Obj* pWin;
for (; hWin; hWin = pWin->hNext) { //窗体z序比hWin高的所有窗体中,剪切遮盖住本pRect的部分[gliethttp]:找x1.
int Status = (pWin = WM_H2P(hWin))->Status;
if (Status & WM_SF_ISVIS) {
GUI_RECT rWinClipped;
if (pParentRect) {
GUI__IntersectRects(&rWinClipped, &pWin->Rect, pParentRect);
} else {
rWinClipped = pWin->Rect;
}
if (GUI_RectsIntersect(pRect, &rWinClipped)) {
if ((Status & WM_SF_HASTRANS) == 0) {
pRect->x1 = rWinClipped.x0-1; //调整pRect->x1到所有存在剪切关系的控件窗口的左边rWinClipped.x0-1处
} else {
/* Check all children */ //半透明处理
WM_HWIN hChild;
WM_Obj* pChild;
for (hChild = pWin->hFirstChild; hChild; hChild = pChild->hNext) {
pChild = WM_H2P(hChild);
_Findx1(hChild, pRect, &rWinClipped);
}
}
}
}
}
}
|
