浅析μC/GUI-v3.90a之GUI_DispString函数

1.GUI_DispString()函数
gui/core/GUI_DispString.c

void GUI_DispString(const char GUI_UNI_PTR *s) {  int xAdjust, yAdjust, xOrg;  int FontSizeY;  if (!s)    return;  GUI_LOCK();  FontSizeY = GUI_GetFontDistY();                          //Font的y大小,默认8  xOrg = GUI_Context.DispPosX; /* Adjust vertical position */  yAdjust = GUI_GetYAdjust();                              //垂直对齐方式  GUI_Context.DispPosY -= yAdjust;  for (; *s; s++) {    GUI_RECT r;    int LineNumChars = GUI__GetLineNumChars(s, 0x7fff);    //获取一行\0或\n 8bits字节数[该版本只能显示英文]    int xLineSize = GUI__GetLineDistX(s, LineNumChars);    //这些数据所占用x轴上横向点阵数  /* Check if x-position needs to be changed due to h-alignment */    switch (GUI_Context.TextAlign & GUI_TA_HORIZONTAL) {   //水平对齐方式      case GUI_TA_CENTER: xAdjust = xLineSize / 2; break;      case GUI_TA_RIGHT: xAdjust = xLineSize; break;      default: xAdjust = 0;    }    r.x0 = GUI_Context.DispPosX -= xAdjust;    r.x1 = r.x0 + xLineSize - 1;     r.y0 = GUI_Context.DispPosY;    r.y1 = r.y0 + FontSizeY - 1;                           //该行字体显示矩形区域r    GUI__DispLine(s, LineNumChars, &r);                    //显示该行数据    GUI_Context.DispPosY = r.y0;    s += GUI_UC__NumChars2NumBytes(s, LineNumChars);       //s指向下一行待显示的数据区    if ((*s == '\n') || (*s == '\r')) {      switch (GUI_Context.TextAlign & GUI_TA_HORIZONTAL) {       case GUI_TA_CENTER:      case GUI_TA_RIGHT:        GUI_Context.DispPosX = xOrg;                       //居中和右对齐,传递函数原始位置xOrg        break;      default:        GUI_Context.DispPosX = GUI_Context.LBorder;        break;      }      if (*s == '\n')        GUI_Context.DispPosY += FontSizeY;                 //回车,转入下一行    } else {      GUI_Context.DispPosX = r.x0 + xLineSize;             //接着上一行的结束位置,继续显示    }    if (*s == 0)                                           //待显示数据已经显示完毕      break;  }  GUI_Context.DispPosY += yAdjust;                         //将垂直对齐方式还原成未调用GUI_DispString之前值  GUI_Context.TextAlign &= ~GUI_TA_HORIZONTAL;             //清除文本水平对齐方式  GUI_UNLOCK();}-------------------------------------------------------------------------------------2.GUI__DispLine()函数 2007-07-11 gliethttpgui/core/GUICharLine.cvoid GUI__DispLine(const char GUI_UNI_PTR *s, int MaxNumChars, const GUI_RECT* pr) {  GUI_RECT r;  {    r = *pr;    #if GUI_WINSUPPORT    WM_ADDORG(r.x0, r.y0);    WM_ADDORG(r.x1, r.y1);                                 //将矩形(r.x0,r.y0)平移到(GUI_Context.xOff,GUI_Context.yOff)坐标处    WM_ITERATE_START(&r) {                                 //计算剪切域,另用《浅析μC/GUI-v3.90a之WM_ITERATE_START剪切域计算宏》专门讨论    #endif      GUI_Context.DispPosX = r.x0;      GUI_Context.DispPosY = r.y0;      /* Do the actual drawing via routine call. */      _DispLine(s, MaxNumChars, &r);    #if GUI_WINSUPPORT    } WM_ITERATE_END();    WM_SUBORG(GUI_Context.DispPosX, GUI_Context.DispPosY);    #endif  }}