[应用相关] uCGUI字符串显示过程分析和uCGUI字库的组建

void GUI_DispString(const char GUI_UNI_PTR *s) {

  int xAdjust, yAdjust, xOrg;

  int FontSizeY;

  if (!s)

    return;

  GUI_LOCK();

  FontSizeY = GUI_GetFontDistY();         //获取字体的高度

  xOrg = GUI_Context.DispPosX;            //获取当前显示的x坐标

 /* Adjust vertical position */

  yAdjust = GUI_GetYAdjust();                    

  GUI_Context.DispPosY -= yAdjust;        //根据Y方向上的对齐方式对y进行调整

  for (; *s; s++) {

    GUI_RECT r;

    int LineNumChars = GUI__GetLineNumChars(s, 0x7fff);           //当前一行要显示几个字符

    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;          //根据水平方向的对齐方式对x坐标进行调整

    r.x1 = r.x0 + xLineSize - 1;    

    r.y0 = GUI_Context.DispPosY;

    r.y1 = r.y0 + FontSizeY - 1;

        

    GUI__DispLine(s, LineNumChars, &r);              //以计算好的矩形区域显示当前行字符

    GUI_Context.DispPosY = r.y0;

    s += GUI_UC__NumChars2NumBytes(s, LineNumChars); //从第一个字符开始，地址加1，可以遍历整行字符串

    if ((*s == '\n') || (*s == '\r')) {

      switch (GUI_Context.TextAlign & GUI_TA_HORIZONTAL) { 

      case GUI_TA_CENTER:

      case GUI_TA_RIGHT:

        GUI_Context.DispPosX = 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)    /* end of string (last line) reached ? */

      break;

  }

  GUI_Context.DispPosY += yAdjust;                //

  GUI_Context.TextAlign &= ~GUI_TA_HORIZONTAL;    //

  GUI_UNLOCK();

}

struct GUI_CONTEXT {

/* Variables in LCD module */

  LCD_COLORINDEX_UNION LCD;

  LCD_RECT       ClipRect;

  U8             DrawMode;

  U8             SelLayer;

  U8             TextStyle;

/* Variables in GL module */

  GUI_RECT* pClipRect_HL;                /* High level clip rectangle ... Speed optimization so drawing routines can optimize */

  U8        PenSize;

  U8        PenShape;

  U8        LineStyle;

  U8        FillStyle;

/* Variables in GUICHAR module */

  const GUI_FONT           GUI_UNI_PTR * pAFont;  //指向当前选择的字体

  #if GUI_SUPPORT_UNICODE

    const GUI_UC_ENC_APILIST * pUC_API;    /* Unicode encoding API */

  #endif

  I16P LBorder;

  I16P DispPosX, DispPosY;

  I16P DrawPosX, DrawPosY;

  I16P TextMode, TextAlign;                       //对齐方式

  GUI_COLOR Color, BkColor;           /* Required only when changing devices and for speed opt (caching) */

/* Variables in WM module */

  #if GUI_WINSUPPORT

    const GUI_RECT* WM__pUserClipRect;

    GUI_HWIN hAWin;　                                  //当前激活的窗口　

    int xOff, yOff;

  #endif

/* Variables in MEMDEV module (with memory devices only) */

  #if GUI_SUPPORT_DEVICES

    const tLCDDEV_APIList* pDeviceAPI;  /* function pointers only */

    GUI_HMEM    hDevData;

    GUI_RECT    ClipRectPrev;

  #endif

/* Variables in Anitaliasing module */

  #if GUI_SUPPORT_AA

    const tLCD_HL_APIList* pLCD_HL;     /* Required to reroute drawing (HLine & Pixel) to the AA module */

    U8 AA_Factor;

    U8 AA_HiResEnable;

  #endif

};

struct GUI_FONT {

  GUI_DISPCHAR*     pfDispChar;             //显示一个属于当前字库字符的函数

  GUI_GETCHARDISTX* pfGetCharDistX;         //获取字库中某字符的宽度

  GUI_GETFONTINFO*  pfGetFontInfo;          //获取字库信息

  GUI_ISINFONT*     pfIsInFont;             //查询字库中是否存在此字符

  const tGUI_ENC_APIList* pafEncode;        //

  U8 YSize;                        //高度

  U8 YDist;                        //对应的像素点

  U8 XMag;                         //X方向上的放大系数

  U8 YMag;                         //Y方向上的放大系数

  union {                          //此共用体主要是提供字库数据的访问地址，

                                   //对于不同的字库，其从字库中查找字模的方法，是不一样的

                                   //这里主要分成三种情况，对应三种类型的指针        

    const void          GUI_UNI_PTR * pFontData;

    const GUI_FONT_MONO GUI_UNI_PTR * pMono;

    const GUI_FONT_PROP GUI_UNI_PTR * pProp;

  } p;

  U8 Baseline;                                //

  U8 LHeight;     /* height of a small lower case character (a,x) */    //小写高度

  U8 CHeight;     /* height of a small upper case character (A,X) */    //大写高度

};

/* MONO字库代表的是单一分区 */

typedef struct {

  const unsigned char GUI_UNI_PTR * pData;        //字库的起始地址

  const U8 GUI_UNI_PTR * pTransData;              //

  const GUI_FONT_TRANSINFO GUI_UNI_PTR * pTrans;  //

  U16P FirstChar;                                 //第一个字符的索引

  U16P LastChar;                                  //最后一个字符的索引

  U8 XSize;                                       //宽度

  U8 XDist;                                       //宽度对应的像素点

  U8 BytesPerLine;                                //每行需要几个字节

} GUI_FONT_MONO;

typedef struct GUI_FONT_PROP {

  U16P First;                                /* first character               */

  U16P Last;                                 /* last character                */

  const GUI_CHARINFO GUI_UNI_PTR * paCharInfo;           /* address of first character    */

  const struct GUI_FONT_PROP GUI_UNI_PTR * pNext;        /* pointer to next */

} GUI_FONT_PROP;

typedef struct {

  U8 XSize;                                  //字符的宽度

  U8 XDist;                                  //显示所对应的像素点

  U8 BytesPerLine;                           //每行占据的字节数

  const unsigned char GUI_UNI_PTR * pData;   //指向字模的数据区

} GUI_CHARINFO;

/*******************************************************************************

* Function Name  : GetGBKCode_from_sd

* Description    : 从SD卡字库中读取自摸数据到指定的缓冲区 

* Input          : pBuffer---数据保存地址  

*                                       c--汉字字符低字节码 

* Output         : None

* Return         : 0(success)  -1(fail)

* Attention              : None

*******************************************************************************/ 

int GetGBKCode_from_sd(unsigned char* pBuffer,const unsigned char * c)

{ 

    unsigned char High8bit,Low8bit;

    unsigned int pos;

    High8bit=*c;     /* 取高8位数据 */

    Low8bit=*(c+1);  /* 取低8位数据 */

    

    pos = ((High8bit-0xa0-16)*94+Low8bit-0xa0-1)*2*16;

    

    f_mount(0, &myfs[0]);

    myres = f_open(&myfsrc , "0:/HZLIB.bin", FA_OPEN_EXISTING | FA_READ);

    

    if ( myres == FR_OK ) 

    {

        f_lseek (&myfsrc, pos);        　　　　                   //指针偏移

        myres = f_read( &myfsrc, pBuffer, 32, &mybr );         //16*16大小的汉字 其字模 占用16*2个字节

        f_close(&myfsrc);

        

        return 0;  

    }    

    else

        return -1;    

}

struct GUI_FONT {

  GUI_DISPCHAR*     pfDispChar;             //显示一个属于当前字库字符的函数

  GUI_GETCHARDISTX* pfGetCharDistX;         //获取字库中某字符的宽度

  GUI_GETFONTINFO*  pfGetFontInfo;          //获取字库信息

  GUI_ISINFONT*     pfIsInFont;             //查询字库中是否存在此字符

......

};

#define GUI_FONTTYPE_PROP_SJIS  \

  GUIPROP_DispChar,             \

    GUIPROP_GetCharDistX,         \

    GUIPROP_GetFontInfo,          \

    GUIPROP_IsInFont,             \

  &GUI_ENC_APIList_SJIS