第六期：emWin5.20汉字显示方法二（将字库放到外部Flash，SD卡等）

eric2013

特别说明：pdf版60期emWin教程已经发布：
                  http://www.armbbs.cn/forum.php?mod=viewthread&tid=2932
                  armfly-x2,x3,v2,v3,v5开发板裸机和带系统的emWin工程已经全部建立，链接如下：
                  http://www.armbbs.cn/forum.php?mod=viewthread&tid=1830
       本期主要讲如何将字库放置到外部存储器的方法，这里以放到SD卡为例，放到其他存储器是一样的。
其实用官方提供的XBF方式，将字库放到外部字库是最合适的，而且能够使用抗锯齿，暂时还没有调试出
来，后面有机会了再做尝试，这里用的外置字库的方法还是UCGUI时代遗留下来的。现在贴个图让大家看
一下实际的显示效果，有一点在这里必须的说明一下，外置字库到SD卡显示大字体的时候会非常的卡。


本期分为三个小节：
6. 1  移植方法
6. 2  点阵字体的说明
6. 3  将生成的字体移植到armfly - v5开发板上面
6. 4  实验总结



6. 1  移植方法
   6.1.1  要添加两个文件，一个是 GUI_UC_EncodeNone.c 用于解码非unicode编码的字符，程序如下

1. #include "GUI_Private.h"
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. }
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. }
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. }
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. }
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. };
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. };

复制代码

    6.1.2  另一个要添加的文件主要是用于从外部存储器读取字体点阵数据，并提供为emWin提供相应的接口函数

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

复制代码

   6.1.3  比如这里要显示12*12的点阵数据需要提供一个如下内容的文件

1. #include "GUI.h"
3. extern void GUIPROP_X_DispChar(U16P c);
4. extern int GUIPROP_X_GetCharDistX(U16P c);
6. GUI_CONST_STORAGE GUI_CHARINFO GUI_FontHZ12_CharInfo[2] =  
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. };
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. };

复制代码

    6.1.4  还有一个重要的问题就是需要在GUI_Typ.h文件里面添加如下的声明

#define GUI_FONTTYPE_PROP_USER   \
            GUIPROP_X_DispChar,            \
            GUIPROP_X_GetCharDistX,        \
            GUIMONO_GetFontInfo,           \
            GUIMONO_IsInFont,              \
           (GUI_GETCHARINFO *)0,          \
           (tGUI_ENC_APIList*)0            

6. 2  点阵字体的说明      
关于点阵字体，这里有一点需要特别的说明：
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; 注意和前两个的不同
                                      主要是因为这个里面只有汉字。最重要的是这个字体居然显示的时候是躺在的，而且上下镜像。
                                      所以24*24的点阵是用软件《字模3》生成的。

48*48点阵汉字和字符  使用的是UCDOS里面的，半角显示正常，字库里面全角字符，需要单独添加。
                                      偏移地址计算：oft = ((((c >> 8)-0xA1)) + ((c & 0xFF)-0xB0) * 94)* BytesPerFont; 注意和前两个的不同
                                      主要是因为这个里面只有汉字。
提供一下我从网上下载的UCDOS字体
ABC            英文字库文件
ASC12         ASCII字库文件12X6
ASC16         ASCII字库文件16X8
ASC48         ASCII字库文件48X24
Hzk12          汉字库宋体12X12
Hzk16          汉字库宋体16X16
hzk16F         汉字库仿宋16X16
HZK24F        汉字库仿宋24X24
HZK24H        汉字库黑体24X24
HZK24K        汉字库楷体24X24
HZK24S        汉字库宋体24X24
HZK24T        全角字符库24X24
HZK24Z        汉字库篆体24X24
HZK40S        汉字库宋体40X40
HZK40T        全角字符库40X40
HZK48S        汉字库宋体48X48
HZK48S        全角字符库48X48
字库UCDOS.zip (3.26 MB, 下载次数: 2162)

2013-9-16 21:23 上传

点击文件名下载附件

6. 3  将生成的字体移植到armfly - v5开发板上面
    根据上面的说明将其添加到工程中即可，通过截图，实际显示效果如下：




6. 4  实验总结
        实际使用中，从SD卡读取大点阵的数据并显示，显示速度比较的慢，不能满足实际的应用，所以建议大字体存储到内部flash（当然是只生产部分字体）。
还有一个比较郁闷的地方是，以前我用字模提取软件《字模3》非常的好用，字体能够在UCGUI上面正常的显示，现在用emWin，32*32以上的点阵就是无法显示，
下面这个图就是以前用UCGUI时的显示效果，软件《字模3》生成的汉字前面没有全角字符，这点一定要注意，也就是说里面只有汉字。



SD卡根目录要放的文件
system.zip (1.29 MB, 下载次数: 2530)

2013-9-16 21:34 上传

点击文件名下载附件

程序下载
STemWin5.20+uCOS-III+FatFS.zip (15.97 MB, 下载次数: 9415)

2013-9-16 21:37 上传

点击文件名下载附件

stm32f4

顶起，学习下

byccc

顶起，学习下

用户不存在

本部分内容设定了隐藏，需要回复后才能看到

gzsam

顶起................................

lucky_jeck

学习学习。
不错，赞一个。

xidaole

对于国人来说，出汉字，是很实用的技术活。。。支持！

chenlijian80

先留个脚印，希望斑竹能把这资料整理出来，做成PDF档就好了。

tigerdill

谢谢，学习了

lianfutiana

haohao ,学习先

otw123

学习一下

ztzjl2010

顶一个    有用

hqgboy

好消息。多谢。。。。。

ghostxdy

这是一个我很相实现的东西！力顶！

zhgwork

zhgwork

forevertoo

[s:151]

nel2010

太好了！

drjloveyou

[s:148] 学习

hqgboy

版主，看图片，好像控件上也可以放汉字了？
是不是啊？

eric2013

hqgboy:版主，看图片，好像控件上也可以放汉字了？
是不是啊？
 (2013-09-17 12:02) 

是的，控件上面使用是没有问题的。

eric2013

chenlijian80:先留个脚印，希望斑竹能把这资料整理出来，做成PDF档就好了。 (2013-09-17 08:24) 

会的，现在先做10期，后面会逐渐的都整理成pdf。

hqgboy

eric2013:是的，控件上面使用是没有问题的。 (2013-09-17 12:03) 

谢谢版主。

hqgboy

eric2013:会的，现在先做10期，后面会逐渐的都整理成pdf。 (2013-09-17 12:04) 

好事情。。。。
以前因为不支持中文，没法用。
现在打算用到LPC1788上。刷屏那个爽。

wujialing300

学学，最近也在学这个。

feiante

学习学习。。。。。
还有就是第三期在哪呢

jcx0324

[s:152]  [s:152]  [s:152]  [s:152]  [s:151]  [s:151]

eric2013

feiante:
学习学习。。。。。
还有就是第三期在哪呢

应该找到第三期了吧，以后可以直接的点击这里就可以的

hqgboy

[s:141]

zhouxiong

找了好久，终于找到了

forevertoo

楼主，昨天在LPC1788上移植了，我用的是LPC1788的emwin库（5.20），在测试汉字显示的时候，用GUI_DisplayString等函数可以实现汉字显示，但是把控件上用汉字就显示出不对劲。例如在标题框上显示“系统设置”，结果人家显示出来“绯荤璁距疆”这些玩意。我在另一块板子上用字库芯片GL2312却能够正常显示。求楼主正解啊！

eric2013

forevertoo:
楼主，昨天在LPC1788上移植了，我用的是LPC1788的emwin库（5.20），在测试汉字显示的时候，用GUI_DisplayString等函数可以实现汉字显示，但是把控件上用汉字就显示出不对劲。例如在标题框上显示“系统设置”，结果人家显示出来“绯荤璁距疆”这些玩意。我在另一块板子上用字库芯片GL2312却能够正常显示。求楼主正解啊！

用的是我提供的的字体库么，出现汉字了说明读取是正确的，显示的不是你想要的，估计问题是出在不能正确的解析文字的位置。

hqgboy

楼主，没有32*32的汉字？

eric2013

hqgboy:楼主，没有32*32的汉字？ (2013-09-18 13:35) 

需要自己制作。UCDOS里没有找到，只在网上找到了那么几种

123456kkk

[s:151]

zhl_tc

正在研究emwin的汉字显示，感觉用EncodeUTF8很麻烦，向楼主学习

eric2013

zhl_tc:正在研究emwin的汉字显示，感觉用EncodeUTF8很麻烦，向楼主学习
 (2013-09-18 16:42) 

不麻烦，我觉得还是很不错的。

zhou_1989

[s:151] [s:151]

wfmartin28

[s:140]

hqgboy

[s:151] [s:151] [s:151]

hubbybob

[s:151]  [s:150]  [s:149]  [s:141]