第19章 汉字显示方式二（放到外部存储器）

第19章 汉字显示方式二（放到外部存储器）

    本期教程主要讲如何将字库放置到外部存储器的方法，这里以放到SD卡为例，放到其他存储器是一样的。本章教程提供的方法是以前UCGUI时代遗留下来的，这种方法相对于后面要讲到的XBF方式还是有差距的（官方推荐方式）。不过为了照顾以前从UCGUI转战过来的，写了这么一期教程。

    19. 1  移植方法

    19. 2 总结

    在工程的emWin文件夹中新建一个HanZi文件夹，主要有以下几个文件：

19.1.3 第三步：GUI_UC_EncodeNone.c文件内容

1. #include "GUI_Private.h"
   
2. 
   
3. /*********************************************************************
   
4. *
   
5. *       Static code
   
6. *
   
7. **********************************************************************
   
8. */
   
9. /*********************************************************************
   
10. *
    
11. *       _GetCharCode
    
12. *
    
13. * Purpose:
    
14. *   Return the UNICODE character code of the current character.
    
15. */
    
16. static U16 _GetCharCode(const char GUI_UNI_PTR * s) {
    
17.   if((*s) > 0xA0)
    
18.   {
    
19.     return *(const U16 GUI_UNI_PTR *)s;
    
20.   }
    
21.   return *(const U8 GUI_UNI_PTR *)s;
    
22. }
    
23. 
    
24. /*********************************************************************
    
25. *
    
26. *       _GetCharSize
    
27. *
    
28. * Purpose:
    
29. *   Return the number of bytes of the current character.
    
30. */
    
31. static int _GetCharSize(const char GUI_UNI_PTR * s) {
    
32.   GUI_USE_PARA(s);
    
33.   if((*s) > 0xA0)
    
34.   {
    
35.     return 2;
    
36.   }
    
37.   return 1;
    
38. }
    
39. 
    
40. /*********************************************************************
    
41. *
    
42. *       _CalcSizeOfChar
    
43. *
    
44. * Purpose:
    
45. *   Return the number of bytes needed for the given character.
    
46. */
    
47. static int _CalcSizeOfChar(U16 Char) {
    
48.   GUI_USE_PARA(Char);
    
49.   if(Char > 0xA0A0)
    
50.   {
    
51.     return 2;
    
52.   }
    
53.   return 1;
    
54. }
    
55. 
    
56. /*********************************************************************
    
57. *
    
58. *       _Encode
    
59. *
    
60. * Purpose:
    
61. *   Encode character into 1/2/3 bytes.
    
62. */
    
63. static int _Encode(char *s, U16 Char) {
    
64.   if(Char > 0xA0A0)
    
65.   {
    
66.     *((U16 *)s) = (U16)(Char);
    
67.     return 2;
    
68.   }
    
69.   *s = (U8)(Char);
    
70.   return 1;
    
71. }
    
72. 
    
73. /*********************************************************************
    
74. *
    
75. *       Static data
    
76. *
    
77. **********************************************************************
    
78. */
    
79. /*********************************************************************
    
80. *
    
81. *       _API_Table
    
82. */
    
83. const GUI_UC_ENC_APILIST GUI__API_TableNone = {
    
84.   _GetCharCode,     /*  return character code as U16 */
    
85.   _GetCharSize,     /*  return size of character: 1 */
    
86.   _CalcSizeOfChar,  /*  return size of character: 1 */
    
87.   _Encode           /*  Encode character */
    
88. };
    
89. 
    
90. const GUI_UC_ENC_APILIST GUI_UC_None = {
    
91.   _GetCharCode,     /*  return character code as U16 */
    
92.   _GetCharSize,     /*  return size of character: 1 */
    
93.   _CalcSizeOfChar,  /*  return size of character: 1 */
    
94.   _Encode           /*  Encode character */
    
95. };
    
96. 
    
97. /*********************************************************************
    
98. *
    
99. *       Exported code
    
100. *
     
101. **********************************************************************
     
102. */
     
103. /*********************************************************************
     
104. *
     
105. *       GUI_UC_SetEncodeNone
     
106. */
     
107. //void GUI_UC_SetEncodeNone(void) {
     
108. //  GUI_LOCK();
     
109. //  GUI_pContext->pUC_API = &GUI__API_TableNone;
     
110. //  GUI_UNLOCK();
     
111. //}

19.1.4  第四步：GUICharPEx.c文件内容

1. #include <stddef.h>           /* needed for definition of NULL */
   
2. #include "GUI_Private.h"
   
3. #include "ff.h"
   
4. #include "bsp.h"
   
5. #include "MainTask.h"
   
6. #include "string.h"
   
7. 
   
8. 
   
9. /* 字模数据的暂存数组,以单个字模的最大字节数为设定值 */
   
10. #define BYTES_PER_FONT      1024
    
11. static U8 GUI_FontDataBuf[BYTES_PER_FONT];
    
12. 
    
13. /*
    
14.    用于12*12和16*16电子汉字的路径部分，要和其它汉字路径作区分
    
15.    使用sizeof的时候，得指定数组的大小。
    
16. */
    
17. const char FontEx_HZ[22] = {"0:/system/gui_font/HZ1"};
    
18. 
    
19. FIL fsrc;        // 定义文件操作类  
    
20. FRESULT res;     // 定义操作结果变量  
    
21. UINT bw1;         // 定义读写数量变量
    
22. /*---------------------------------------------------------------------------*/
    
23. /*字库外部函数部分-----------------------------------------------------------*/
    
24. void GUI_X_GetFontData(char* font, U32 oft, U8 *ptr, U16 bytes)
    
25. {
    
26.     res = f_open(&fsrc, font, FA_OPEN_EXISTING | FA_READ);   //打开字库文件   
    
27.     if(res ！= FR_OK)   
    
28.     {   
    
29. 
    
30.     }   
    
31.     res = f_lseek(&fsrc,oft); //找到首地址  
    
32.     res = f_read(&fsrc, ptr, bytes, &bw1); //读取32个字库点阵数据
    
33. res = f_close(&fsrc); //关闭字体  
    
34. 
    
35. }
    
36. 
    
37. static void GUI_GetDataFromMemory(const GUI_FONT_PROP GUI_UNI_PTR *pProp, U16P c)
    
38. {
    
39.     U16 BytesPerFont;
    
40.     U32 oft;
    
41. char *font = (char *)pProp->paCharInfo->pData;
    
42. 
    
43. /* 每个字模的数据字节数 */
    
44.     BytesPerFont = GUI_pContext->pAFont->YSize * pProp->paCharInfo->BytesPerLine;
    
45.     if (BytesPerFont > BYTES_PER_FONT)
    
46. {
    
47. BytesPerFont = BYTES_PER_FONT;
    
48. }
    
49. /* 英文字符地址偏移算法 */
    
50.     if (c < 0x80)                                                               
    
51.     {
    
52. oft = (c-0x20) * BytesPerFont;
    
53.     }
    
54.     else                                                                           
    
55.     {
    
56. 
    
57. if(strncmp(FontEx_HZ, font, sizeof(FontEx_HZ)) == 0) （1）
    
58. {
    
59. /* 中文字符地址偏移算法包括符号 */
    
60. oft = ((((c >> 8)-0xA1)) + ((c & 0xFF)-0xA1) * 94)* BytesPerFont;
    
61. }
    
62. else
    
63. {
    
64. /* 中文字符地址偏移算法包括符号 */
    
65. oft = ((((c >> 8)-0xA1)) + ((c & 0xFF)-0xB0) * 94)* BytesPerFont;
    
66. }
    
67. 
    
68.     }
    
69. 
    
70. 
    
71. GUI_X_GetFontData(font, oft, GUI_FontDataBuf, BytesPerFont);
    
72. 
    
73. }
    
74. 
    
75. void GUIPROP_X_DispChar(U16P c)  
    
76. {
    
77.     int BytesPerLine;
    
78.     GUI_DRAWMODE DrawMode = GUI_pContext->TextMode;
    
79.     const GUI_FONT_PROP GUI_UNI_PTR *pProp = GUI_pContext->pAFont->p.pProp;
    
80.     //搜索定位字库数据信息  
    
81.     for (; pProp; pProp = pProp->pNext)                                          
    
82.     {
    
83.         if ((c >= pProp->First) && (c <= pProp->Last))break;
    
84.     }
    
85.     if (pProp)
    
86.     {
    
87.         GUI_DRAWMODE OldDrawMode;
    
88.         const GUI_CHARINFO GUI_UNI_PTR * pCharInfo = pProp->paCharInfo;
    
89.         GUI_GetDataFromMemory(pProp, c);//取出字模数据
    
90.         BytesPerLine = pCharInfo->BytesPerLine;               
    
91.         OldDrawMode  = LCD_SetDrawMode(DrawMode);
    
92.         LCD_DrawBitmap(GUI_pContext->DispPosX, GUI_pContext->DispPosY,
    
93.                        pCharInfo->XSize, GUI_pContext->pAFont->YSize,
    
94.                        GUI_pContext->pAFont->XMag, GUI_pContext->pAFont->YMag,
    
95.                        1,     /* Bits per Pixel */
    
96.                        BytesPerLine,
    
97. &GUI_FontDataBuf[0],
    
98. &LCD_BKCOLORINDEX
    
99.                        );
    
100.         /* Fill empty pixel lines */
     
101.         if (GUI_pContext->pAFont->YDist > GUI_pContext->pAFont->YSize)
     
102.         {
     
103.             int YMag = GUI_pContext->pAFont->YMag;
     
104.             int YDist = GUI_pContext->pAFont->YDist * YMag;
     
105.             int YSize = GUI_pContext->pAFont->YSize * YMag;
     
106.             if (DrawMode ！= LCD_DRAWMODE_TRANS)
     
107.             {
     
108.                 LCD_COLOR OldColor = GUI_GetColor();
     
109.                 GUI_SetColor(GUI_GetBkColor());
     
110.                 LCD_FillRect(GUI_pContext->DispPosX, GUI_pContext->DispPosY + YSize,
     
111.                              GUI_pContext->DispPosX + pCharInfo->XSize,
     
112.                              GUI_pContext->DispPosY + YDist);
     
113.                 GUI_SetColor(OldColor);
     
114.             }
     
115.         }
     
116.         LCD_SetDrawMode(OldDrawMode); /* Restore draw mode */
     
117. //      if (！GUI_MoveRTL)
     
118.         GUI_pContext->DispPosX += pCharInfo->XDist * GUI_pContext->pAFont->XMag;
     
119.     }
     
120. }
     
121. 
     
122. /*********************************************************************
     
123. *
     
124. *       GUIPROP_GetCharDistX
     
125. */
     
126. int GUIPROP_X_GetCharDistX(U16P c)
     
127. {
     
128.     const GUI_FONT_PROP GUI_UNI_PTR * pProp = GUI_pContext->pAFont->p.pProp;  
     
129.     for (; pProp; pProp = pProp->pNext)                                         
     
130.     {
     
131.         if ((c >= pProp->First) && (c <= pProp->Last))break;
     
132.     }
     
133.     return (pProp) ? (pProp->paCharInfo)->XSize * GUI_pContext->pAFont->XMag : 0;
     
134. }

1. 这个地方非常重要，讲之前先介绍下外置到SD卡中的字体。

    12*12点阵汉字和字符  使用的是UCDOS里面的，半角和全角字符显示都正常，汉字也正常

        偏移地址计算：oft = ((((c >> 8)-0xA1)) + ((c & 0xFF)-0xA1) * 94)* BytesPerFont;

    16*16点阵汉字和字符  使用的是UCDOS里面的，半角和全角字符显示都正常，汉字也正常

        偏移地址计算：oft = ((((c >> 8)-0xA1)) + ((c & 0xFF)-0xA1) * 94)* BytesPerFont;

    24*24点阵汉字和字符  使用的是UCDOS里面的，半角显示正常，字库里面全角字符需要单独添加。偏移地址计算：oft = ((((c >> 8)-0xA1)) + ((c & 0xFF)-0xB0) * 94)* BytesPerFont; 注意和前两个的不同。主要是因为这个里面只有汉字。最重要的是这个字体居然显示的时候是躺在的，而且上下镜像。

    48*48点阵汉字和字符  使用的是UCDOS里面的，半角显示正常，字库里面全角字符，需要单独添加。 偏移地址计算：oft = ((((c >> 8)-0xA1)) + ((c & 0xFF)-0xB0) * 94)* BytesPerFont; 注意和前两个的不同。主要是因为这个里面只有汉字。

    SD卡中存放的字库如下（路径0:/system/gui_font）：

    特别注意24*24和48*48汉字点阵库中没有加全角字符，而12*12和16*16中添加了，所以就出现了上面程序中的区别对待。用路径的前22个字符0:/system/gui_font/HZ1就可以区分开。

19.1.5  第五步：字库文件

下面的是GUI_Font12.c中的内容，其它类似：

1. #include "GUI.h"
   
2. 
   
3. extern void GUIPROP_X_DispChar(U16P c);
   
4. extern int GUIPROP_X_GetCharDistX(U16P c);
   
5. 
   
6. GUI_CONST_STORAGE GUI_CHARINFO GUI_FontHZ12_CharInfo[2] =    （1）
   
7. {     
   
8.     {  6,    6,  1, (void *)"0:/system/gui_font/ASC6x12.bin"},      
   
9.     {  12,  12,  2, (void *)"0:/system/gui_font/HZ12x12.bin"},         
   
10. };
    
11. GUI_CONST_STORAGE GUI_FONT_PROP GUI_FontHZ12_PropHZ= {
    
12.       0xA1A1,  
    
13.       0xFEFE,  
    
14. &GUI_FontHZ12_CharInfo[1],
    
15.       (void *)0,  
    
16. };
    
17. GUI_CONST_STORAGE  GUI_FONT_PROP GUI_FontHZ12_PropASC= {
    
18.       0x0000,  
    
19.       0x007F,  
    
20. &GUI_FontHZ12_CharInfo[0],
    
21.       (void GUI_CONST_STORAGE *)&GUI_FontHZ12_PropHZ,  
    
22. };
    
23. GUI_CONST_STORAGE  GUI_FONT GUI_FontHZ12 =  
    
24. {
    
25.   GUI_FONTTYPE_PROP_USER,
    
26.       12,  
    
27.       12,  
    
28.       1,   
    
29.       1,   
    
30.       (void GUI_CONST_STORAGE *)&GUI_FontHZ12_PropASC
    
31. };
    
32. 
    
33. GUI_CONST_STORAGE  GUI_FONT GUI_FontHZ12x2 =  
    
34. {
    
35. GUI_FONTTYPE_PROP_USER,
    
36.       12,  
    
37.       12,  
    
38.       2,   
    
39.       2,   
    
40.       (void GUI_CONST_STORAGE *)&GUI_FontHZ12_PropASC
    
41. };

1. 要修改文件存放的路径，需要修改这里和GUICharPEx文件中的：

       const char FontEx_HZ[22] = {"0:/system/gui_font/HZ1"};

1. #define GUI_FONTTYPE_PROP_USER        \
   
2.             GUIPROP_X_DispChar,       \
   
3.             (GUI_GETCHARDISTX *) GUIPROP_X_GetCharDistX,   \
   
4.             GUIMONO_GetFontInfo,      \
   
5.             GUIMONO_IsInFont,         \
   
6.            (GUI_GETCHARINFO *)0,      \
   
7.            (tGUI_ENC_APIList*)0

19.1.7 第七步：添加主函数

1. #include "includes.h"
   
2. #include "MainTask.h"
   
3. 
   
4. 
   
5. extern GUI_CONST_STORAGE  GUI_FONT GUI_FontHZ48;
   
6. 
   
7. /*
   
8. *********************************************************************************************************
   
9. *        对话框信息
   
10. *********************************************************************************************************
    
11. */
    
12. static const GUI_WIDGET_CREATE_INFO _aDialogCreate[] = {
    
13.     { FRAMEWIN_CreateIndirect,  "armfly",              0,          0,  0,  800,480,FRAMEWIN_CF_MOVEABLE,0},
    
14.     { BUTTON_CreateIndirect,    "安富莱电子armfly",               GUI_ID_BUTTON0,          40,320,700,100,0,0},
    
15. { BUTTON_CreateIndirect,    "世界人民欢迎你Eric2013",        GUI_ID_BUTTON1,          40,200,700,100,0,0},
    
16.     { TEXT_CreateIndirect,      "ａｒｍｆｌｙ安富莱电子armfly",   GUI_ID_TEXT0,            5, 10, 200, 33, 0,0},
    
17.     { TEXT_CreateIndirect,      "ａｒｍｆｌｙ安富莱电子armfly",   GUI_ID_TEXT1,            5, 40,200, 33, 0,0},
    
18.     { TEXT_CreateIndirect,      "安富莱电子armfly",               GUI_ID_TEXT2,            5, 80,360, 72, 0,0},
    
19. };
    
20. 
    
21. /*
    
22. *********************************************************************************************************
    
23. *        函 数 名: PaintDialog
    
24. *        功能说明: 重绘
    
25. *        形    参：pMsg  消息指针
    
26. *        返 回 值: 无
    
27. *********************************************************************************************************
    
28. */
    
29. void PaintDialog(WM_MESSAGE * pMsg)
    
30. {
    
31.     WM_HWIN hWin = pMsg->hWin;
    
32. }
    
33. 
    
34. /*
    
35. *********************************************************************************************************
    
36. *        函 数 名: InitDialog
    
37. *        功能说明: 对话框初始化
    
38. *        形    参：pMsg  消息指针
    
39. *        返 回 值: 无
    
40. *********************************************************************************************************
    
41. */
    
42. void InitDialog(WM_MESSAGE * pMsg)
    
43. {
    
44.     WM_HWIN hWin = pMsg->hWin;
    
45.     //
    
46.     //FRAMEWIN
    
47.     //
    
48.     FRAMEWIN_SetFont(hWin,&GUI_Font32B_ASCII);
    
49.     FRAMEWIN_SetTextAlign(hWin,GUI_TA_VCENTER|GUI_TA_CENTER);
    
50.     FRAMEWIN_AddCloseButton(hWin, FRAMEWIN_BUTTON_RIGHT, 0);
    
51.     FRAMEWIN_AddMaxButton(hWin, FRAMEWIN_BUTTON_RIGHT, 1);
    
52.     FRAMEWIN_AddMinButton(hWin, FRAMEWIN_BUTTON_RIGHT, 2);
    
53.     FRAMEWIN_SetTitleHeight(hWin,35);
    
54.     //
    
55.     //GUI_ID_BUTTON0
    
56.     //
    
57.     BUTTON_SetFont(WM_GetDialogItem(hWin,GUI_ID_BUTTON0),&GUI_FontHZ48);
    
58. BUTTON_SetFont(WM_GetDialogItem(hWin,GUI_ID_BUTTON1),&GUI_FontHZ48);
    
59.     //
    
60.     //GUI_ID_TEXT0
    
61.     //
    
62. TEXT_SetTextColor(WM_GetDialogItem(hWin,GUI_ID_TEXT0), GUI_RED);
    
63. TEXT_SetFont(WM_GetDialogItem(hWin,GUI_ID_TEXT0),&GUI_FontHZ12);
    
64. TEXT_SetTextColor(WM_GetDialogItem(hWin,GUI_ID_TEXT1), GUI_GREEN);
    
65. TEXT_SetFont(WM_GetDialogItem(hWin,GUI_ID_TEXT1),&GUI_FontHZ16);
    
66. TEXT_SetTextColor(WM_GetDialogItem(hWin,GUI_ID_TEXT2), GUI_BLUE);
    
67. TEXT_SetFont(WM_GetDialogItem(hWin,GUI_ID_TEXT2),&GUI_FontHZ24);
    
68. }
    
69. 
    
70. /*
    
71. *********************************************************************************************************
    
72. *        函 数 名: _cbCallback
    
73. *        功能说明: 对话框回调函数
    
74. *        形    参：pMsg  消息指针
    
75. *        返 回 值: 无
    
76. *********************************************************************************************************
    
77. */
    
78. static void _cbCallback(WM_MESSAGE * pMsg)
    
79. {
    
80.     int NCode, Id;
    
81.     WM_HWIN hWin = pMsg->hWin;
    
82.     switch (pMsg->MsgId)
    
83.     {
    
84.         case WM_PAINT:
    
85.             PaintDialog(pMsg);
    
86.             break;
    
87.         case WM_INIT_DIALOG:
    
88.             InitDialog(pMsg);
    
89.             break;
    
90.         case WM_KEY:
    
91.             switch (((WM_KEY_INFO*)(pMsg->Data.p))->Key)
    
92.             {
    
93.                 case GUI_KEY_ESCAPE:
    
94.                     GUI_EndDialog(hWin, 1);
    
95.                     break;
    
96.                 case GUI_KEY_ENTER:
    
97.                     GUI_EndDialog(hWin, 0);
    
98.                     break;
    
99.             }
    
100.             break;
     
101.         case WM_NOTIFY_PARENT:
     
102.             Id = WM_GetId(pMsg->hWinSrc);
     
103.             NCode = pMsg->Data.v;        
     
104.             switch (Id)
     
105.             {
     
106.                 case GUI_ID_OK:
     
107.                     if(NCode==WM_NOTIFICATION_RELEASED)
     
108.                         GUI_EndDialog(hWin, 0);
     
109.                     break;
     
110.                 case GUI_ID_CANCEL:
     
111.                     if(NCode==WM_NOTIFICATION_RELEASED)
     
112.                         GUI_EndDialog(hWin, 0);
     
113.                     break;
     
114. 
     
115.             }
     
116.             break;
     
117.         default:
     
118.             WM_DefaultProc(pMsg);
     
119.     }
     
120. }
     
121. 
     
122. 
     
123. /*
     
124. *********************************************************************************************************
     
125. *        函 数 名: MainTask
     
126. *        功能说明: GUI主函数
     
127. *        形    参：无
     
128. *        返 回 值: 无
     
129. *********************************************************************************************************
     
130. */
     
131. void MainTask(void)
     
132. {
     
133.     GUI_Init();
     
134.     WM_SetDesktopColor(GUI_WHITE);       /* Automacally update desktop window */
     
135.     WM_SetCreateFlags(WM_CF_MEMDEV);     /* Use memory devices on all windows to avoid flicker */
     
136. PROGBAR_SetDefaultSkin(PROGBAR_SKIN_FLEX);
     
137. FRAMEWIN_SetDefaultSkin(FRAMEWIN_SKIN_FLEX);
     
138. PROGBAR_SetDefaultSkin(PROGBAR_SKIN_FLEX);
     
139. BUTTON_SetDefaultSkin(BUTTON_SKIN_FLEX);
     
140. CHECKBOX_SetDefaultSkin(CHECKBOX_SKIN_FLEX);
     
141. DROPDOWN_SetDefaultSkin(DROPDOWN_SKIN_FLEX);
     
142. SCROLLBAR_SetDefaultSkin(SCROLLBAR_SKIN_FLEX);
     
143. SLIDER_SetDefaultSkin(SLIDER_SKIN_FLEX);
     
144. HEADER_SetDefaultSkin(HEADER_SKIN_FLEX);
     
145. RADIO_SetDefaultSkin(RADIO_SKIN_FLEX);
     
146.     GUI_CreateDialogBox(_aDialogCreate, GUI_COUNTOF(_aDialogCreate), &_cbCallback, 0, 0, 0);
     
147. while(1)
     
148. {
     
149. GUI_Delay(10);
     
150. }
     
151. }

实际显示效果如下：

    特别注意，如果使用的是800*480分辨率的屏可以完全显示出来，如果是小于这个分辨率的屏只能显示出一部分，大家可以按照上面的设计方法做一个适合自己屏大小的显示或者直接拖动这个对话框即可。

19.2 总结

    本期教程就为大家讲这么多，这种方法大家有个了解即可，由于考虑到还有很多从UCGUI转战过来的，而且很多项目都是用的这种方式，所以特此做了本期教程。如果对这个方法没有了解的，可以放弃这种显示方法了，因为有更好的XBF方式。

19.2总结
本期教程就为大家讲这么多，这种方法大家有个了解即可，由于考虑到还有很多从UCGUI转战过来的，而且很多项目都是用的这种方式，所以特此做了本期教程。如果对这个方法没有了解的，可以放弃这种显示方法了，因为有更好的XBF方式。