【emWin实战教程V2.0】第25章 全字库在STemWin上的实现（GB2312编码）

席萌0209

完整65章+12章附件教程下载地址：
http://www.armbbs.cn/forum.php?mod=viewthread&tid=19834

第25章      全字库在STemWin上的实现（GB2312编码）

    本章节为大家讲解GB2312编码全字库的实现，对于习惯了GB2312编码的用户来说，使用本章节的方法非常合适。emWin本身是不支持GB2312编码字符显示的，本章节是新创建一种字体类型来实现GB2312编码字符的显示，所采用的方式是早期UCGUI3.98时期遗留下来，但对那种方法进行了修改，以适合高版本emWin5.xx的使用。
    25.1  初学者重要提示
    25.2 GB2312编码全字库说明
    25.3 GB2312全字库的移植方法
    25.4 移植文件简易说明
    25.5 GB2312字库使用方法
    25.6 实验例程说明（RTOS）
    25.7 实验例程说明（裸机）
    25.8 总结



25.1  初学者重要提示

1、对于不习惯前面章节讲解的XBF格式和SIF格式的Unicode编码全字库的用户来说，使用GB2312编码是很好的选择，很适合初学者，汉字操作方式与大家使用裸机代码（没有使用GUI）时是一样的。

2、GB2312编码的全字库文件可以存到任何外部存储介质中。本章节配套例子是将其存储到SPI Flash里面了。

3、使用GB2312编码也是有缺点的，相比前面章节使用FontCvt生成的XBF格式和SIF格式全字库，GB2312编码全字库不支持抗锯齿效果，且仅支持等宽字体（仅支持等宽是因为当前新字体的创建方法不支持非等宽字体）。

席萌0209

25.2 GB2312编码全字库说明


    本章节配套例子使用的字库是从字库芯片提取出来的，下面是点阵字库相关信息，仅列出了要用到的点阵字符：

了解了点阵字体的相关信息后，剩下就是寻址算法了。

    汉字点阵在汉字库中的地址计算：
    汉字库种类繁多，但都是按照区位的顺序排列的。前一个字节为该汉字的区号，后一个字节为该字的位号，位号是该字在该区中的位置。GB2312编码区范围是A1A1到F7FE，一共F7-A1+1 = 87个区，每区有FE-A1+1=94个字符，因此GB2312可以表示87*94=8178个字符。
    计算公式为：（94 *(区号 - 1) + 位号 - 1） * 一个汉字字模占用字节数
    我们在计算机中常用的汉字编码为汉字内码，不是区位码，需要进行转换。因此最终的计算公式为：
    ADDRESS = [(内码1 - 0xa1)* 94 + (内码2 - 0xa1)] *一个汉字字模占用字节数
    （内码1对应区号，内码2对应位号）
     ASCII区，GB2312编码的全角字符区和汉字区的所有字符可以看下这个帖子：http://www.armbbs.cn/forum.php?mod=viewthread&tid=201 ，初学者务必看下，非常有必要。

下面对这8种点阵依次做下说明：
汉字点阵GB2312编码字库地址计算
    GBCode表示汉字内码。
    MSB 表示汉字内码GBCode的高8bits，
    LSB 表示汉字内码GBCode的低8bits。
    Address 表示汉字或ASCII字符点阵在芯片中的字节地址。
    BaseAdd：说明点阵数据在字库中的起始地址。
11*12点阵计算方法：
    BaseAdd=0x0;  
    if(MSB >=0xA1 && MSB <= 0Xa9 &&LSB >=0xA1)
             Address =((MSB – 0xA1) * 94 + (LSB – 0xA1))*24+BaseAdd;
    else if(MSB >=0xB0 && MSB <= 0xF7&& LSB >=0xA1)
             Address =((MSB – 0xB0) * 94 + (LSB – 0xA1)+ 846)*24+BaseAdd;
15*16点阵计算方法：
    BaseAdd=0x2C9D0;
    if(MSB >=0xA1 && MSB <= 0Xa9 &&LSB >=0xA1)
        Address =( (MSB - 0xA1) * 94 + (LSB - 0xA1))*32+BaseAdd;
    else if(MSB >=0xB0 && MSB <= 0xF7&& LSB >=0xA1)
       Address = ((MSB - 0xB0) * 94 + (LSB - 0xA1)+ 846)*32+BaseAdd;
24*24点阵计算方法：
    BaseAdd=0x68190;
    if(MSB >=0xA1 && MSB <= 0Xa9 && LSB >=0xA1)
        Address =( (MSB - 0xA1) * 94 + (LSB - 0xA1))*72+BaseAdd;
    else if(MSB >=0xB0 && MSB <= 0xF7 && LSB >=0xA1)
        Address = ((MSB - 0xB0) * 94 + (LSB - 0xA1)+ 846)*72+BaseAdd;
32*32点阵计算方法：
    BaseAdd=0XEDF00;
    if(MSB >=0xA1 && MSB <= 0Xa9 && LSB >=0xA1)
        Address =( (MSB - 0xA1) * 94 + (LSB - 0xA1))*128+BaseAdd;
    else if(MSB >=0xB0 && MSB <= 0xF7 && LSB >=0xA1)
        Address = ((MSB - 0xB0) * 94 + (LSB - 0xA1)+ 846)*128+BaseAdd;
    这四种点阵字体除了每个点阵字符的字节数和起始地址不一样，其余都是一样的。其中第一个if条件语句是判断区号在0xA1到0xA8里面的全角字符区，共846个字符。第二个else if条件语句是判断区号在0xB0到0xF7里面的汉字区，共6763个汉字。
ASCII字符地址计算
     ASCIICode：表示ASCII 码（ 8bits）
    BaseAdd：说明该套字库在芯片中的起始地址。
    Address： ASCII字符点阵在芯片中的字节地址。
6x12点阵ASCII计算方法：
    BaseAdd=0x1DBE00
    if (ASCIICode >= 0x20) and (ASCIICode <= 0x7E)
       Address = (ASCIICode –0x20 ) * 12+BaseAdd
8x16点阵ASCII计算方法：
    BaseAdd=0x1DD780
    if (ASCIICode >= 0x20) and (ASCIICode <= 0x7E)
         Address = (ASCIICode –0x20 ) * 16+BaseAdd
12x24点阵ASCII计算方法：
    BaseAdd=0x1DFF00
    if (ASCIICode >= 0x20) and (ASCIICode <= 0x7E)
        Address = (ASCIICode –0x20 ) * 48+BaseAdd
16x32点阵ASCII计算方法：
    BaseAdd=0x1E5A50
    if (ASCIICode >= 0x20) and (ASCIICode <= 0x7E)
      Address = (ASCIICode –0x20 ) * 64+BaseAdd
    这四种点阵字体除了每个点阵字符的字节数和起始地址不一样，其余都是一样的。每个点阵都是只用到了0x20到0x7E，共96个字符。
    ---------------------------------------------------------------
    讲解完编码地址的计算后，再说一个比较重要的知识点，初学者容易在这个问题上面犯迷糊。汉字内码在文件里面存储的时候就是按照高低字节依次存储的，比如汉字“我”的GB2312编码是0xced2，汉字“们”的编码是0xc3c7，现在我们在电脑端新建一个记事本文件，然后将“我们”这两个字写到电脑端的记事本里面，然后保存，文本编码类型选择ANSI即可。

此时将这个文本文件用winhex打开，可以看到，编码数值如下：

跟汉字的编码值对比后发现汉字的编码值存储就是高低字节依次存储的。那么问题来了，一般情况下，使用MCU微控制器的时候都是用的小端模式，即低地址存储低位数据，高地址存储高位数据。现在我们采用如下的程序做简单的测试：

1. char *ptr = {"我们"};
2. U16 c1, c2;
3.    
4. c1 = *(U16 *)ptr;
5. c2 = *(U16 *)(ptr + 2);
6. printf("c1 = %x, c2 = %x\\r\\n", c1, c2);

复制代码

串口打印的输出结果就是 c1 = 0xd2ce ， c2 = 0xc7c3。正好与汉字内码的高低字节反过来了，初学者在学习的时候务必要注意这个问题。

席萌0209

25.3   GB2312全字库的移植方法

    这里用到的几个移植文件是早期UCGUI3.XX版本时代遗留下来的，但都进行了修改，更加适合STemWin5.xx版本使用（由于早期UCGUI3.XX版本是有源码的，这种方式是在源码的基础上新创建的一种字体方式，适合国内用的GB编码）。

图25-1

    GUI_Font12.c，GUI_Font16.c，GUI_Font24.c和GUI_Font32.c都是相同的代码结构，仅仅是定义的点阵大小不同，用户要实现其它点阵大小的字体，只需根据这几个文件照葫芦画瓢即可。剩下的两个文件GUI_UC_EncondeNone.c和GUICharPEx.c是必须要包含的，用户需要根据字库的起始位置做修改（如何修改，看本章节的25.4小节，本章节配套的例子不用改，因为已经根据25.2小节的起始地址设置好了）。
    接下来要做的移植工作比较简单，仅需两步即可完成：
第1步：将图25-1中的6个文件全部添加到工程中，IAR和MDK是一样的，下面以MDK为例进行说明。

    上面的截图就是添加到MDK工程的效果。如果用户要移植这几个文件到自己的工程项目，直接从本章节配套例子的emWin文件夹下打开文件HanZi就看到这几个文件了，所以用户只需复制粘贴HanZi到自己的工程项目即可。
第2步：在GUI_Type.h文件添加一种新的字体类型定义
    新添加的字体类型如下：
        DECLARE_FONT(USER);
        #define GUI_FONTTYPE_USER       \\
                GUIUSER_DispChar,         \\
                GUIUSER_GetCharDistX,    \\
                GUIMONO_GetFontInfo,    \\
                GUIMONO_IsInFont,        \\
                (GUI_GETCHARINFO *)0,    \\
                (tGUI_ENC_APIList*)0
    此定义放在等宽字体定义的前面即可：

    通过这两步就完成移植了，剩下就是如何使用了。不过第2步里面新添加的函数有必要简单的解释一下。
首先是函数DECLARE_FONT(USER)，这个函数的原始定义如下：

1. #define DECLARE_FONT(Type)                                     \\
2. void GUI##Type##_DispChar    (U16P c);                         \\
3. int  GUI##Type##_GetCharDistX(U16P c, int * pSizeX);                       \\
4. void GUI##Type##_GetFontInfo (const GUI_FONT * pFont, GUI_FONTINFO * pfi); \\
5. char GUI##Type##_IsInFont    (const GUI_FONT * pFont, U16 c); \\
6. int  GUI##Type##_GetCharInfo (U16P c, GUI_CHARINFO_EXT * pInfo)

复制代码

##是预处理运算符，这种方式有效的对宏定义进行了扩展，DECLARE_FONT里面的参数是可以任意定义的，只要满足函数命名即可，比如用户调用了DECLARE_FONT(USER)，就相当于一次声明了5个函数：

1. void GUIUSER_DispChar    (U16P c);                         \\
2. int  GUIUSER _GetCharDistX(U16P c, int * pSizeX);                       \\
3. void GUIUSER _GetFontInfo (const GUI_FONT * pFont, GUI_FONTINFO * pfi); \\
4. char GUIUSER _IsInFont    (const GUI_FONT * pFont, U16 c); \\
5. int  GUIUSER _GetCharInfo (U16P c, GUI_CHARINFO_EXT * pInfo)

复制代码

也就是将Type前后的预处理运算符##去掉，并将Type用USER代替。在GUI_Type.h文件里面还有其它几种字体类型的定义，都是这个意思。

1. DECLARE_FONT(MONO);
2. DECLARE_FONT(PROP);
3. DECLARE_FONT(PROP_EXT);
4. DECLARE_FONT(PROP_FRM);
5. DECLARE_FONT(PROPAA);
6. DECLARE_FONT(PROP_AA2);
7. DECLARE_FONT(PROP_AA2_EXT);
8. DECLARE_FONT(PROP_AA4);
9. DECLARE_FONT(PROP_AA4_EXT);
10. DECLARE_FONT(USER);

复制代码

再说下宏定义#define GUI_FONTTYPE_USER
    这种形式的宏定义也很少见，宏定义后面跟了好几个子函数。其实就是一种简单的替换，在程序代码遇到GUI_FONTTYPE_USER的地方，就用下面的代替
         GUIUSER_DispChar,         \\
         GUIUSER_GetCharDistX,    \\
         GUIMONO_GetFontInfo,    \\
         GUIMONO_IsInFont,        \\
         (GUI_GETCHARINFO *)0,    \\
         (tGUI_ENC_APIList*)0
    此宏定义是在文件GUI_Font12.c，GUI_Font16.c，GUI_Font24.c和GUI_Font32.c里面被调用。关于替代的这几个函数有必要再进一步的阐释下。
    函数GUIUSER_DispChar和GUIUSER_GetCharDistX是要用户自己实现的，已经在GUICharPEx.c里面实现了。函数GUIUSER_GetFontInfo和GUIUSER_IsInFont没有实现，而是用emWin等宽字体的GUIMONO_GetFontInfo和GUIMONO_IsInFont实现的。剩下的两个函数(GUI_GETCHARINFO *)0和(tGUI_ENC_APIList*)0未做实现，使用emWin自带的方式来实现。讲解到这里，初学者会有疑问，为什么字体类型要定义这几种函数？其实这个是由emWin的字体类型变量决定的，定义如下：

1. struct GUI_FONT {
2.   GUI_DISPCHAR     * pfDispChar;
3.   GUI_GETCHARDISTX * pfGetCharDistX;
4.   GUI_GETFONTINFO  * pfGetFontInfo;
5.   GUI_ISINFONT     * pfIsInFont;
6.   GUI_GETCHARINFO  * pfGetCharInfo;
7.   const tGUI_ENC_APIList* pafEncode;
8.   U8 YSize;
9.   U8 YDist;
10.   U8 XMag;
11.   U8 YMag;
12.   union {
13.     const void              * pFontData;
14.     const GUI_FONT_MONO     * pMono;
15.     const GUI_FONT_PROP     * pProp;
16.     const GUI_FONT_PROP_EXT * pPropExt;
17.   } p;
18.   U8 Baseline;
19.   U8 LHeight;     /* Height of a small lower case character (a,x) */
20.   U8 CHeight;     /* Height of a small upper case character (A,X) */
21. };

复制代码

    结构体GUI_FONT前六个成员就是我们这里实现的，其余的几种字体类型全是如此：

1. DECLARE_FONT(MONO);
2. DECLARE_FONT(PROP);
3. DECLARE_FONT(PROP_EXT);
4. DECLARE_FONT(PROP_FRM);
5. DECLARE_FONT(PROPAA);
6. DECLARE_FONT(PROP_AA2);
7. DECLARE_FONT(PROP_AA2_EXT);
8. DECLARE_FONT(PROP_AA4);
9. DECLARE_FONT(PROP_AA4_EXT);
11. /* MONO: Monospaced fonts */
12. #define GUI_FONTTYPE_MONO       \\
13.   GUIMONO_DispChar,             \\
14.   GUIMONO_GetCharDistX,         \\
15.   GUIMONO_GetFontInfo,          \\
16.   GUIMONO_IsInFont,             \\
17.   (GUI_GETCHARINFO *)0,         \\
18.   (tGUI_ENC_APIList*)0
20. /* PROP: Proportional fonts */
21. #define GUI_FONTTYPE_PROP       \\
22.   GUIPROP_DispChar,             \\
23.   GUIPROP_GetCharDistX,         \\
24.   GUIPROP_GetFontInfo,          \\
25.   GUIPROP_IsInFont,             \\
26.   (GUI_GETCHARINFO *)0,         \\
27.   (tGUI_ENC_APIList*)0
29. /* PROP_EXT: Extended proportional fonts */
30. #define GUI_FONTTYPE_PROP_EXT       \\
31.   GUIPROP_EXT_DispChar,             \\
32.   GUIPROP_EXT_GetCharDistX,         \\
33.   GUIPROP_EXT_GetFontInfo,          \\
34.   GUIPROP_EXT_IsInFont,             \\
35.   GUIPROP_EXT_GetCharInfo,          \\
36.   &GUI_ENC_APIList_EXT
38. /* PROP_FRM: Extended proportional fonts, framed */
39. #define GUI_FONTTYPE_PROP_FRM       \\
40.   GUIPROP_FRM_DispChar,             \\
41.   GUIPROP_FRM_GetCharDistX,         \\
42.   GUIPROP_FRM_GetFontInfo,          \\
43.   GUIPROP_FRM_IsInFont,             \\
44.   (GUI_GETCHARINFO *)0,             \\
45.   (tGUI_ENC_APIList*)0
47. /* PROP: Proportional fonts SJIS */
48. #define GUI_FONTTYPE_PROP_SJIS  \\
49.   GUIPROP_DispChar,             \\
50.   GUIPROP_GetCharDistX,         \\
51.   GUIPROP_GetFontInfo,          \\
52.   GUIPROP_IsInFont,             \\
53.   (GUI_GETCHARINFO *)0,         \\
54.   &GUI_ENC_APIList_SJIS
56. /* PROPAA: Proportional, antialiased fonts */
57. #define GUI_FONTTYPE_PROPAA       \\
58.   GUIPROPAA_DispChar,             \\
59.   GUIPROPAA_GetCharDistX,         \\
60.   GUIPROPAA_GetFontInfo,          \\
61.   GUIPROPAA_IsInFont,             \\
62.   (GUI_GETCHARINFO *)0,           \\
63.   (tGUI_ENC_APIList*)0
65. /* PROP_AA2: Proportional, antialiased fonts, 2bpp */
66. #define GUI_FONTTYPE_PROP_AA2       \\
67.   GUIPROP_AA2_DispChar,             \\
68.   GUIPROP_AA2_GetCharDistX,         \\
69.   GUIPROP_AA2_GetFontInfo,          \\
70.   GUIPROP_AA2_IsInFont,             \\
71.   (GUI_GETCHARINFO *)0,             \\
72.   (tGUI_ENC_APIList*)0
74. /* PROP_AA2_EXT: Proportional, antialiased fonts, 2bpp, extended font information */
75. #define GUI_FONTTYPE_PROP_AA2_EXT   \\
76.   GUIPROP_AA2_EXT_DispChar,         \\
77.   GUIPROP_EXT_GetCharDistX,         \\
78.   GUIPROP_EXT_GetFontInfo,          \\
79.   GUIPROP_EXT_IsInFont,             \\
80.   GUIPROP_EXT_GetCharInfo,          \\
81.   &GUI_ENC_APIList_EXT
83. /* PROP_AA2: Proportional, antialiased fonts, 2bpp, SJIS encoding */
84. #define GUI_FONTTYPE_PROP_AA2_SJIS  \\
85.   GUIPROP_AA2_DispChar,             \\
86.   GUIPROP_AA2_GetCharDistX,         \\
87.   GUIPROP_AA2_GetFontInfo,          \\
88.   GUIPROP_AA2_IsInFont,             \\
89.   (GUI_GETCHARINFO *)0,             \\
90.   &GUI_ENC_APIList_SJIS
92. /* PROP_AA4: Proportional, antialiased fonts, 4bpp */
93. #define GUI_FONTTYPE_PROP_AA4       \\
94.   GUIPROP_AA4_DispChar,             \\
95.   GUIPROP_AA4_GetCharDistX,         \\
96.   GUIPROP_AA4_GetFontInfo,          \\
97.   GUIPROP_AA4_IsInFont,             \\
98.   (GUI_GETCHARINFO *)0,             \\
99.   (tGUI_ENC_APIList*)0
101. /* PROP_AA4_EXT: Proportional, antialiased fonts, 4bpp, extended font information */
102. #define GUI_FONTTYPE_PROP_AA4_EXT   \\
103.   GUIPROP_AA4_EXT_DispChar,         \\
104.   GUIPROP_EXT_GetCharDistX,         \\
105.   GUIPROP_EXT_GetFontInfo,          \\
106.   GUIPROP_EXT_IsInFont,             \\
107.   GUIPROP_EXT_GetCharInfo,          \\
108.   &GUI_ENC_APIList_EXT
110. /* PROP_AA4: Proportional, antialiased fonts, 4bpp, SJIS encoding */
111. #define GUI_FONTTYPE_PROP_AA4_SJIS  \\
112.   GUIPROP_AA4_DispChar,             \\
113.   GUIPROP_AA4_GetCharDistX,         \\
114.   GUIPROP_AA4_GetFontInfo,          \\
115.   GUIPROP_AA4_IsInFont,             \\
116.   (GUI_GETCHARINFO *)0,             \\
117.   &GUI_ENC_APIList_SJIS

复制代码

关于移植部分就给大家讲解这么多，下面对这几个移植的文件简单的说说。

席萌0209

25.4移植文件简易说明



25.4.1   文件GUICharPEx.c

    此文件主要是实现了新定义字体里面的API函数GUIUSER_DispChar和GUIUSER_GetCharDistX，其实这两个函数是由UCGUI3.98源码里面的文件GUICharP.c修改而来。关于这两个函数暂不做讲解，用户使用的时候也不需要对这两个函数做修改，接下来重点看函数：

          static voidGUI_GetDataFromMemory(const GUI_FONT_PROP GUI_UNI_PTR *pProp, U16P c)

的实现，这个函数是需要用户去实现的，根据使用的外部存储器和汉字库地址实现点阵数据的读取。下面是根据25.2小节的说明，实现从SPI Flash里面读取点阵数据：

1. /* 点阵数据缓存, 必须大于等于单个字模需要的存储空间 */
2. #define BYTES_PER_FONT      512
3. static U8 GUI_FontDataBuf[BYTES_PER_FONT];
5. /*
6. *********************************************************************************************************
7. *    函 数 名: GUI_GetDataFromMemory
8. *    功能说明: 读取点阵数据
9. *    形    参: pProp  GUI_FONT_PROP类型结构
10. *             c      字符
11. *    返 回 值: 无
12. *********************************************************************************************************
13. */
14. static void GUI_GetDataFromMemory(const GUI_FONT_PROP GUI_UNI_PTR *pProp, U16P c)
15. {
16.     U16 BytesPerFont;
17.     U32 oft = 0, BaseAdd;
18. U8 code1,code2;
19.    
20.      char *font = (char *)pProp->paCharInfo->pData;
22.      /* 每个字模的数据字节数 */
23.     BytesPerFont = GUI_pContext->pAFont->YSize * pProp->paCharInfo->BytesPerLine;
24.     if (BytesPerFont > BYTES_PER_FONT)
25.      {
26.          BytesPerFont = BYTES_PER_FONT;
27.      }
28.    
29.      /* 英文字符地址偏移计算 */
30.     if (c < 0x80)                                                               
31.     {
32.          if(strncmp("A12", font, 3) == 0)     /* 6*12 ASCII字符 */
33.          {
34.               BaseAdd = 0x1DBE00;
35.          }
36.          else if(strncmp("A16", font, 3) == 0) /* 8*16 ASCII字符 */
37.          {
38.               BaseAdd = 0x1DD780;
39.          }
40.          else if(strncmp("A24", font, 3) == 0) /* 12*24 ASCII字符 */
41.          {
42.               BaseAdd = 0x1DFF00;
43.          }
44.          else if(strncmp("A32", font, 3) == 0) /* 24*48 ASCII字符 */
45.          {
46.               BaseAdd = 0x1E5A50;
47.          }
48.         
49.          oft = (c-0x20) * BytesPerFont + BaseAdd;
50.     }
51.      /* 汉字和全角字符的偏移地址计算 */
52.     else                                                                          
53.     {
54.          if(strncmp("H12", font, 3) == 0)      /* 12*12 字符 */
55.          {
56.               BaseAdd = 0x0;
57.          }
58.          else if(strncmp("H16", font, 3) == 0)  /* 16*16 字符 */
59.          {
60.               BaseAdd = 0x2C9D0;
61.          }
62.          else if(strncmp("H24", font, 3) == 0)  /* 24*24 字符 */
63.          {
64.               BaseAdd = 0x68190;
65.          }
66.          else if(strncmp("H32", font, 3) == 0)  /* 32*32 字符 */
67.          {
68.               BaseAdd = 0XEDF00;
69.          }
70.         
71.          /* 根据汉字内码的计算公式锁定起始地址 */
72.          code2 = c >> 8;
73.          code1 = c & 0xFF;
74.          if (code1 >=0xA1 && code1 <= 0xA9 && code2 >=0xA1)
75.          {
76.               oft = ((code1 - 0xA1) * 94 + (code2 - 0xA1)) * BytesPerFont + BaseAdd;
77.          }
78.          else if (code1 >=0xB0 && code1 <= 0xF7 && code2 >=0xA1)
79.          {
80.               oft = ((code1 - 0xB0) * 94 + (code2 - 0xA1) + 846) * BytesPerFont + BaseAdd;
81.          }
82.     }
83.    
84.      /* 读取点阵数据 */
85.      sf_ReadBuffer(GUI_FontDataBuf, oft, BytesPerFont);
86. }

复制代码

汉字和ASCII点阵数据的起始地址计算公式就是前面25.2小节讲解的内容，只是都合并成一个公式来实现了。

25.4.2   文件GUI_UC_EncodeNone.c


    这个文件就是来自UCGUI3.98源码，并对其进行了简单修改，以适合我们的GB2312编码，特别注意一点，在emWin的源码里面也是有一个此文件的，添加了这个文件，会把原有的文件覆盖掉。

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) /* ASCII字符编码是00-7F，返回一个字节数据即可，GB2312编码是A1A1到FEFE，需要返回两个字节
18. 数据，这里以第一个字节作为判断即可 */
19.   {
20.     return *(const U16 GUI_UNI_PTR *)s;
21.   }
22.   return *(const U8 GUI_UNI_PTR *)s;
23. }
25. /*********************************************************************
26. *
27. *       _GetCharSize
28. *
29. * Purpose:
30. *   Return the number of bytes of the current character.
31. */
32. static int _GetCharSize(const char GUI_UNI_PTR * s) {
33.   GUI_USE_PARA(s);
34. if((*s) > 0xA0) /* ASCII字符编码是00-7F，返回一个字节大小，GB2312编码是A1A1到FEFE，需要返回两个字节大小，
35. 这里以第一个字节作为判断即可 */
37.   {
38.     return 2;
39.   }
40.   return 1;
41. }
43. /*********************************************************************
44. *
45. *       _CalcSizeOfChar
46. *
47. * Purpose:
48. *   Return the number of bytes needed for the given character.
49. */
50. static int _CalcSizeOfChar(U16 Char) {
51.   GUI_USE_PARA(Char);
52.   if(Char > 0xA0A0) /* ASCII字符编码是00-7F，返回一个字节大小，GB2312编码是A1A1到FEFE，需要返回两个字节大
53. 小，这里以A0A0作为判断*/
54.   {
55.     return 2;
56.   }
57.   return 1;
58. }
60. /*********************************************************************
61. *
62. *       _Encode
63. *
64. * Purpose:
65. *   Encode character into 1/2/3 bytes.
66. */
67. static int _Encode(char *s, U16 Char) {
68.   if(Char > 0xA0A0) /* ASCII字符编码是00-7F，返回一个字节大小，GB2312编码是A1A1到FEFE，需要返回两个字节大
69. 小，这里以A0A0作为判断，并将编码中赋值给形参s */
70.   {
71.     *((U16 *)s) = (U16)(Char);
72.     return 2;
73.   }
74.   *s = (U8)(Char);
75.   return 1;
76. }
78. /*********************************************************************
79. *
80. *       Static data
81. *
82. **********************************************************************
83. */
84. /*********************************************************************
85. *
86. *       _API_Table
87. */
88. const GUI_UC_ENC_APILIST GUI__API_TableNone = {
89.   _GetCharCode,     /*  return character code as U16 */
90.   _GetCharSize,     /*  return size of character: 1 */
91.   _CalcSizeOfChar,  /*  return size of character: 1 */
92.   _Encode           /*  Encode character */
93. };
95. const GUI_UC_ENC_APILIST GUI_UC_None = {
96.   _GetCharCode,     /*  return character code as U16 */
97.   _GetCharSize,     /*  return size of character: 1 */
98.   _CalcSizeOfChar,  /*  return size of character: 1 */
99.   _Encode           /*  Encode character */
100. };

复制代码

25.4.3   文件GUI_Font12.c，GUI_Font16.c等


    这几个文件都是同一个架构，我们这里以GUI_Font16.c文件为例进行说明。

1. #include "GUI.h"
2. #include "GUI_Type.h"
5. GUI_CONST_STORAGE GUI_CHARINFO GUI_FontHZ16_CharInfo[2] =  // ----------（1）
6. {   
7.     {  8,    8,  1, (void *)"A16"},     
8.     {  16,  16,  2, (void *)"H16"},         
9. };
11. GUI_CONST_STORAGE GUI_FONT_PROP GUI_FontHZ16_PropHZ= {   // ----------（2）
12.       0xA1A1,
13.       0xFEFE,
14.       &GUI_FontHZ16_CharInfo[1],
15.       (void *)0,
16. };
18. GUI_CONST_STORAGE  GUI_FONT_PROP GUI_FontHZ16_PropASC= {  // ----------（3）
19.       0x0000,
20.       0x007F,
21.       &GUI_FontHZ16_CharInfo[0],
22.       (void GUI_CONST_STORAGE *)&GUI_FontHZ16_PropHZ,
23. };
25. GUI_CONST_STORAGE  GUI_FONT GUI_FontHZ16 =              // ----------（4）
26. {
27.        GUI_FONTTYPE_USER,
28.       16,
29.       16,
30.       1,  
31.       1,  
32.       (void GUI_CONST_STORAGE *)&GUI_FontHZ16_PropASC,
33. };
34. GUI_CONST_STORAGE  GUI_FONT GUI_FontHZ16x2 =            // ----------（5）
35. {
36.        GUI_FONTTYPE_USER,
37.       16,
38.       16,
39.       2,  
40.       2,  
41.       (void GUI_CONST_STORAGE *)&GUI_FontHZ16_PropASC
42. };

复制代码

第1个语句：GUI_CONST_STORAGEGUI_CHARINFO GUI_FontHZ16_CharInfo[2]
     了解这个函数得了解GUI_CHARINFO的定义，定义如下：

1. typedef struct {
2.   U8 XSize;
3.   U8 XDist;
4.   U8 BytesPerLine;
5.   const unsigned char * pData;
6. } GUI_CHARINFO;

复制代码

第1个成员U8 Xsize是点阵字符的X轴方向的长度。
第2个成员U8 XDist是实际显示时X轴方向的长度。
第3个成员U8 BytesPerLine是每行点阵数据需要的字节数。
第4个成员const unsigned char *pData用来做一些字符标记。
认识这几个变量成员后，如下两个变量成员也就不难理解了：
{  8, 8,  1, (void *)"A16"}
表示此点阵字符的X轴长度是8个像素点，实际显示也是8个像素点，显示一行需要1个字节就行，用字符A16作为识别标志，这一行的整体作用是用来识别16点阵ASCII。
{  16, 16,  2, (void *)"H16"}
表示此点阵字符的X轴长度是16个像素点，实际显示也是16个像素点，显示一行需要2个字节就行，用字符H16作为识别标志，这一行的整体作用是用来识别16点阵汉字。
第2个语句：GUI_CONST_STORAGEGUI_FONT_PROP GUI_FontHZ16_PropHZ
    了解这个函数得了解GUI_FONT_PROP的定义，定义如下：

1. typedef struct GUI_FONT_PROP {
2.   U16P First;                                  /* First character               */
3.   U16P Last;                                   /* Last character                */
4.   const GUI_CHARINFO         * paCharInfo;     /* Address of first character    */
5.   const struct GUI_FONT_PROP * pNext;          /* Pointer to next               */
6. } GUI_FONT_PROP;

复制代码

第1个成员U16P First是第一个字符的编码值。
第2个成员U16P First是最后一个字符的编码值。
第3个成员const GUI_CHARINFO  *paCharInfo记录了第一个字符的存储位置。
第4个成员const struct GUI_FONT_PROP * pNext用来指向下一个GUI_FONT_PROP定义的字符区间。
对结构体GUI_FONT_PROP的定义了解后，这里定义的如下四个参数：
0xA1A1,  
0xFEFE,  
&GUI_FontHZ16_CharInfo[1],
(void *)0,  
表示此编码区的字符是从0XA1A1开始到0XFEFE。字符的位置由GUI_FontHZ16_CharInfo[1]记录，没有指向下一个编码范围。这里的编码就是GB2312的编码范围。
第3个语句：GUI_CONST_STORAGEGUI_FONT_PROP GUI_FontHZ16_PropASC
    有了上面第二句的解释，第三句也比较好理解了。
这里表示此编码区的字符是从0x0000开始到0x007F。字符的位置由GUI_FontHZ16_CharInfo[0]记录，指向下一个编码范围就是第二句的GB2312编码区。这里的编码就是ASCII的编码范围。
第4个语句：GUI_CONST_STORAGE  GUI_FONT GUI_FontHZ16
    此句就是根据前面25.3小节末尾新创建字体类型所定义的一个16点阵字体。

1. GUI_CONST_STORAGE  GUI_FONT GUI_FontHZ16 =
2. {
3. GUI_FONTTYPE_USER,     /* 表示新定义的字体类型 */
4. 16,                    /* 字体Y轴方向的点阵高度 */
5. 16,                    /* 字体Y轴方向的实际显示点阵高度 */
6. 1,                     /* 字体X轴方向放大到1倍，就是原始大小 */
7. 1,                     /* 字体Y轴方向放大到1倍 ，就是原始大小 */
8. (void GUI_CONST_STORAGE*)&GUI_FontHZ16_PropASC,/* 此字体类型从GUI_FontHZ16_PropASC */
9. };

复制代码

第5个语句：GUI_CONST_STORAGE  GUI_FONT GUI_FontHZ16x2
    跟第4句一样，区别的地方就是将字体放大了1倍。

1. GUI_CONST_STORAGE  GUI_FONT GUI_FontHZ16 =
2. {
3. GUI_FONTTYPE_USER,     /* 表示新定义的字体类型 */
4. 16,                    /* 字体Y轴方向的点阵高度 */
5. 16,                    /* 字体Y轴方向的实际显示点阵高度 */
6. 2,                     /* 字体X轴方向放大到2倍 */
7. 2,                     /* 字体Y轴方向放大到2倍 */
8. (void GUI_CONST_STORAGE*)&GUI_FontHZ16_PropASC,/* 此字体类型从GUI_FontHZ16_PropASC */
9. };

复制代码

关于这个几个移植文件就跟大家讲解这么多。这个就是GUI_Font16.C的讲解，其它的GUI_Font12.c， GUI_Font24.c和GUI_Font32.c是一样的。

席萌0209

25.5  GB2312字库使用方法


    移植好之后，使用就比较容易了，下面分3步进行说明
第1步：声明12点阵，16点阵，24点阵和32点阵的字体，放在了MainTask.h文件里面，方便调用，程序代码中只需包含这个头文件就可以了。

1. /*
2. *********************************************************************************************************
3. *                                         字体声明
4. *********************************************************************************************************
5. */
6. extern GUI_CONST_STORAGE  GUI_FONT GUI_FontHZ32;
7. extern GUI_CONST_STORAGE  GUI_FONT GUI_FontHZ24;
8. extern GUI_CONST_STORAGE  GUI_FONT GUI_FontHZ16;
9. extern GUI_CONST_STORAGE  GUI_FONT GUI_FontHZ12;

复制代码

有几种点阵字库就通过extern声明几个，方便外部文件调用。
第2步：将字库文件font.bin存储到SPI Flash中，我们这里在电脑端将font.bin文件存储到SD卡中（字库文件font.bin已经放在本章节配例子的Doc文件夹），然后开发板上电后将其从SD卡中加载到SPI Flash里面，加载代码如下：

1. /*
2. *********************************************************************************************************
3. *    函 数 名: LoadFontLib()
4. *    功能说明: 从SD卡中加载字库文件到SPI FLASH
5. *    形    参: 无      
6. *    返 回 值: 无
7. *********************************************************************************************************
8. */
9. void LoadFontLib(void)
10. {
11.      float FinishPecent;
12.     uint32_t Count = 0;
13.      uint16_t y, i;
14.      uint8_t ucState;
15.      char cDispBuf[80];
17.    
18.      /* 清屏 */
19.      GUI_SetBkColor(GUI_BLUE);
20.      GUI_Clear();
21.    
22.      /* 设置字体 */
23.      GUI_SetFont(GUI_FONT_20_1);
25.     y = 0;
26.      /* 第1步：显示操作说明 ***************************************************************/
27.      GUI_DispStringAt("SPI Flash Chinese character Lab", 0, y);
28.      y += 20;
29.    
30.      GUI_DispStringAt("1. Please make sure the font.bin is saved in SD", 0, y);
31.      y += 20;
32.    
33.      GUI_DispStringAt("2. if the font.bin is not saved in SD, this lab will fail", 0, y);
34.      y += 20;
35.    
36.      /* 等待10s后开始进行复制，方便客户看屏幕上的显示信息 */
37.      for(i = 0; i < 11; i++)
38.      {
39.          sprintf(cDispBuf, "3. 10 seconds will start, %ds..  ", 10 - i);
40.          GUI_DispStringAt(cDispBuf, 0, y);
41.          GUI_Delay(1000);
42.      }
43.      y += 20;
44.    
45.    
46.      /* 第2步：打开文件 ***************************************************************/
47.      result = f_open(&file, "font.bin", FA_OPEN_EXISTING | FA_READ);
48.      if (result !=  FR_OK)
49.      {
50.          GUI_DispStringAt("font.bin open failed", 0, y);
51.          y += 20;
52.      }
54.      /* 第3步：复制SD卡中字库文件font.bin到SPI FLASH **********************************/
55.      for(;;)
56.      {
57.          /* 读取一个扇区的数据到buf */
58.          result = f_read(&file, &tempbuf, g_tSF.PageSize, &bw);
59.         
60.          /* 读取出错或者读取完毕，退出 */
61.          if ((result != FR_OK)||bw == 0)
62.          {
63.               break;
64.          }
65.         
66.          /* 写数据到SPI FLASH */
67.          ucState = sf_WriteBuffer(tempbuf, Count*g_tSF.PageSize, g_tSF.PageSize);
68.         
69.          /* 如果返回0，表示复制失败 */
70.          if(ucState == 0)
71.          {
72.               GUI_DispStringAt("copy failed                  ", 0, y);
73.               break;
74.          }
75.         
76.          /* 显示复制进度 */
77.          Count = Count + 1;
78.          FinishPecent = (float)(Count* g_tSF.PageSize) / file.fsize;
79.          sprintf(cDispBuf, "copying:%02d%%", (uint8_t)(FinishPecent*100));
80.          GUI_DispStringAt(cDispBuf, 0, y);
81.      }
82.    
83.      /* 等待1秒后开始进去emWin主界面 */
84.      GUI_Delay(1000);
85. }

复制代码

第3步：加载到SPI Flash后，使用就很方便了。
    比如设置按钮的字体使用16点阵，调用如下设置函数即可。
    BUTTON_SetFont(hWin, &GUI_FontHZ16);  /* hWin是按钮的句柄 */
    设置其它控件是一样的。另外注意，使用GB编码没有烦人的文件编码设置问题了，从这一点来说，比使用前面章节讲的XBF格式和SIF格式的Unicode编码方便很多了。

席萌0209

25.6   实验例程说明（RTOS）


配套例子：
    V6-532_STemWin实验_全字库实现，GB2312编码（RTOS）
实验目的：
    1.     学习emWin的GB2312编码全字库的使用方法。
    2.     emWin功能的实现在MainTask.c文件里面。
实验内容：
    1.     K1按键按下，串口打印任务执行情况（波特率115200，数据位8，奇偶校验位无，停止位1）。
    2.     K2按键按下，实现截图功能，将图片以BMP格式保存到SD卡中。
    3.     各个任务实现的功能如下：
              App Task Start   任务：实现按键和触摸扫描。
              App Task MspPro任务 ：实现截图功能，将图片以BMP格式保存到SD卡中。
              App Task UserIF  任务：按键消息处理。
              App Task COM   任务：暂未使用。
        App Task GUI    任务：GUI任务。
支持点阵：
    1.     支持12点阵，16点阵，24点阵以及32点阵汉字。
    2.     6X12点阵的ASCII，8X16点阵的ASCII，12X24点阵的ASCII，16X32点阵的ASCII
字库存储方式：
    1.     字库存储到SPI FLASH里面。
实验步骤：
    1.     将字库文件font.bin放到SD卡根目录中，系统上电后会将其加载到SPI FLASH里面。
    2.     板子上电后会有一个加载进度指示，存储到SPI FLASH成功后会显示一个对话框。
实验注意：
    1.     实验所需的字库文件font.bin已经存储到本工程的Doc文件夹下，使用此例子前，请务必将这个文件存储到SD卡根目录中，并将SD卡插到开发板上面。
μCOS-III任务调试信息（按K1按键，串口打印）：

STemWin界面显示效果：
    800*480分辨率界面效果。

STemWin动态内存配置：
    GUIConf.c文件中的配置如下：

1. #define EX_SRAM   1/*1 used extern sram, 0 used internal sram */
3. #if EX_SRAM
4. #define GUI_NUMBYTES  (1024*1024*8)
5. #else
6. #define GUI_NUMBYTES  (100*1024)
7. #endif

复制代码

    通过宏定义来配置使用内部SRAM还是外部的SDRAM做为emWin的动态内存，当配置：
#define EX_SRAM    1 表示使用外部SDRAM作为emWin动态内存，大小8MB。
#define EX_SRAM    0 表示使用内部SRAM作为emWin动态内存，大小100KB。
默认情况下，本教程配套的所有emWin例子都是用外部SDRAM作为emWin动态内存。
STemWin底层接口配置：
    LCDConf_Lin_Template.c文件中共12项emWin配置：

1. /*
2. **********************************************************************************************************
3.                                           用户可以配置的选项
4. **********************************************************************************************************
5. */
6. /* 0. 在官方代码的基础上再做优化，官方的部分函数效率低，耗内存, 0表示优化 */
7. #define emWin_Optimize   0
9. /*
10.   1. 显示屏的物理分辨率，驱动已经做了显示屏自适应，支持4.3寸，5寸和7寸屏
11.      这里填写自适应显示屏中的最大分辨率。
12. */
13. #define XSIZE_PHYS       800
14. #define YSIZE_PHYS       480
16. /* 2. 多缓冲 / 虚拟屏，多缓冲和虚拟屏不可同时使用，emWin不支持 */
17. #define NUM_BUFFERS      3 /* 定义多缓冲个数，仅可以设置1,2和3，也就是最大支持三缓冲 */
18. #define NUM_VSCREENS     1 /* 定义虚拟屏个数 */
20. /* 3. 没有图层激活时，背景色设置, 暂时未用到 */
21. #define BK_COLOR         GUI_DARKBLUE
23. /*
24.    4. 重定义图层数，对于STM32F429/439，用户可以选择一个图层或者两个图层，不支持三图层
25.       (1). 设置GUI_NUM_LAYERS = 1时，即仅使用图层1时，默认触摸值是发送给图层1的。
26.        (2). 设置GUI_NUM_LAYERS = 2时，即图层1和图层2都已经使能，此时图层2是顶层，
27.             用户需要根据自己的使用情况设置如下两个地方。
28.             a. 在bsp_touch.c文件中的函数TOUCH_InitHard里面设置参数State.Layer = 1，1就表示
29.                给图层2发送触摸值。
30.             b. 调用GUI_Init函数后，调用函数GUI_SelectLayer(1), 设置当前操作的是图层2。
31. */
32. #undef  GUI_NUM_LAYERS
33. #define GUI_NUM_LAYERS    1
35. /*
36.    5. 设置图层1和图层2对应的显存地址
37.       (1) EXT_SDRAM_ADDR 是SDRAM的首地址。
38.       (2) LCD_LAYER0_FRAME_BUFFER 是图层1的显存地址。
39.        (3) LCD_LAYER1_FRAME_BUFFER 是图层2的显存地址。
40.        (4) 每个图层的显存大小比较考究，这里进行下简单的说明。
41.            如果用户选择的颜色模式 = 32位色ARGB8888，显存的大小：
42.            XSIZE_PHYS * YSIZE_PHYS * 4 * NUM_VSCREENS * NUM_BUFFERS
43.          
44.            颜色模式 = 24位色RGB888，显存的大小：
45.            XSIZE_PHYS * YSIZE_PHYS * 3 * NUM_VSCREENS * NUM_BUFFERS
46.          
47.            颜色模式 = 16位色RGB566，ARGB1555, ARGB4444，AL88，那么显存的大小就是：
48.            XSIZE_PHYS * YSIZE_PHYS * 2 * NUM_VSCREENS * NUM_BUFFERS
50.            颜色模式 = 8位色L8，AL44，那么显存的大小就是：
51.            XSIZE_PHYS * YSIZE_PHYS * 1 * NUM_VSCREENS * NUM_BUFFERS  
52.      
53.       这里为了方便起见，将开发板配套的16MB的SDRAM前8MB分配给LCD显存使用，后8MB用于emWin动态内存。
54.        对于24位色，16位色，8位色，用户可以对其使能三缓冲，并且使能双图层。但是32位色也使能三缓冲和双
55.        图层的话会超出8MB，所以用户根据自己的情况做显存和emWin动态内存的分配调整。
56.          举一个例子，对于800*480分辨率的显示屏，使能32位色，三缓冲，那么最终一个图层需要的大小就是
57.       800 * 480 * 4 * 3  = 4.394MB的空间，如果是双图层，已经超出8MB的分配范围。
58.      
59.       (5)为了方便起见，图层2的宏定义LCD_LAYER1_FRAME_BUFFER中的参数4是按照32位色设置的，如果用户的图层1
60.          使用的是8位色，这里填数字1,如果是16位色，这里填2，如果是24位色，这里填3。
61. */
62. #define LCD_LAYER0_FRAME_BUFFER  EXT_SDRAM_ADDR
63. #define LCD_LAYER1_FRAME_BUFFER  (LCD_LAYER0_FRAME_BUFFER + XSIZE_PHYS * YSIZE_PHYS * 4 * NUM_VSCREENS *
64. NUM_BUFFERS)
66. /*
67.    6. STM32F429/439支持的颜色模式，所有模式都支持，用户可任意配置。
68.       特别注意如下两个问题：
69.        (1) 如果用户选择了ARGB8888或者RGB888模式，LCD闪烁比较厉害的话，
70.            请降低LTDC的时钟大小，在文件bsp_tft_429.c的函数LCD_ConfigLTDC里面设置。
71.            a. 一般800*480分辨率的显示屏，ARGB8888或者RGB888模式LTDC时钟选择10-20MHz即可。
72.            b. 480*272分辨率的可以高些，取20MHz左右即可。
73.        (2) 16位色或者8位色模式，LTDC的时钟频率一般可以比24位色或者32位色的高一倍。
74. */
75. #define _CM_ARGB8888      1
76. #define _CM_RGB888        2
77. #define _CM_RGB565        3
78. #define _CM_ARGB1555      4
79. #define _CM_ARGB4444      5
80. #define _CM_L8            6
81. #define _CM_AL44          7
82. #define _CM_AL88          8
84. /* 7. 配置图层1的颜色模式和分辨率大小 */
85. #define COLOR_MODE_0      _CM_RGB565
86. #define XSIZE_0           XSIZE_PHYS
87. #define YSIZE_0           YSIZE_PHYS
89. /* 8. 配置图层2的的颜色模式和分辨率大小 */
90. #define COLOR_MODE_1      _CM_RGB565
91. #define XSIZE_1           XSIZE_PHYS
92. #define YSIZE_1           YSIZE_PHYS
94. /* 9. 单图层情况下，根据用户选择的颜色模式可自动选择图层1的emWin的驱动和颜色模式 */
95. #if   (COLOR_MODE_0 == _CM_ARGB8888)
96.   #define COLOR_CONVERSION_0 GUICC_M8888I
97.   #define DISPLAY_DRIVER_0   GUIDRV_LIN_32
98. #elif (COLOR_MODE_0 == _CM_RGB888)
99.   #define COLOR_CONVERSION_0 GUICC_M888
100.   #define DISPLAY_DRIVER_0   GUIDRV_LIN_24
101. #elif (COLOR_MODE_0 == _CM_RGB565)
102.   #define COLOR_CONVERSION_0 GUICC_M565
103.   #define DISPLAY_DRIVER_0   GUIDRV_LIN_16
104. #elif (COLOR_MODE_0 == _CM_ARGB1555)
105.   #define COLOR_CONVERSION_0 GUICC_M1555I
106.   #define DISPLAY_DRIVER_0   GUIDRV_LIN_16
107. #elif (COLOR_MODE_0 == _CM_ARGB4444)
108.   #define COLOR_CONVERSION_0 GUICC_M4444I
109.   #define DISPLAY_DRIVER_0   GUIDRV_LIN_16
110. #elif (COLOR_MODE_0 == _CM_L8)
111.   #define COLOR_CONVERSION_0 GUICC_8666
112.   #define DISPLAY_DRIVER_0   GUIDRV_LIN_8
113. #elif (COLOR_MODE_0 == _CM_AL44)
114.   #define COLOR_CONVERSION_0 GUICC_1616I
115.   #define DISPLAY_DRIVER_0   GUIDRV_LIN_8
116. #elif (COLOR_MODE_0 == _CM_AL88)
117.   #define COLOR_CONVERSION_0 GUICC_88666I
118.   #define DISPLAY_DRIVER_0   GUIDRV_LIN_16
119. #else
120.   #error Illegal color mode 0!
121. #endif
123. /* 10. 双图层情况下，根据用户选择的颜色模式可自动选择图层2的emWin的驱动和颜色模式 */
124. #if (GUI_NUM_LAYERS > 1)
126. #if   (COLOR_MODE_1 == _CM_ARGB8888)
127.   #define COLOR_CONVERSION_1 GUICC_M8888I
128.   #define DISPLAY_DRIVER_1   GUIDRV_LIN_32
129. #elif (COLOR_MODE_1 == _CM_RGB888)
130.   #define COLOR_CONVERSION_1 GUICC_M888
131.   #define DISPLAY_DRIVER_1   GUIDRV_LIN_24
132. #elif (COLOR_MODE_1 == _CM_RGB565)
133.   #define COLOR_CONVERSION_1 GUICC_M565
134.   #define DISPLAY_DRIVER_1   GUIDRV_LIN_16
135. #elif (COLOR_MODE_1 == _CM_ARGB1555)
136.   #define COLOR_CONVERSION_1 GUICC_M1555I
137.   #define DISPLAY_DRIVER_1   GUIDRV_LIN_16
138. #elif (COLOR_MODE_1 == _CM_ARGB4444)
139.   #define COLOR_CONVERSION_1 GUICC_M4444I
140.   #define DISPLAY_DRIVER_1   GUIDRV_LIN_16
141. #elif (COLOR_MODE_1 == _CM_L8)
142.   #define COLOR_CONVERSION_1 GUICC_8666
143.   #define DISPLAY_DRIVER_1   GUIDRV_LIN_8
144. #elif (COLOR_MODE_1 == _CM_AL44)
145.   #define COLOR_CONVERSION_1 GUICC_1616I
146.   #define DISPLAY_DRIVER_1   GUIDRV_LIN_8
147. #elif (COLOR_MODE_1 == _CM_AL88)
148.   #define COLOR_CONVERSION_1 GUICC_88666I
149.   #define DISPLAY_DRIVER_1   GUIDRV_LIN_16
150. #else
151.   #error Illegal color mode 1!
152. #endif
154. #else
156. #undef XSIZE_0
157. #undef YSIZE_0
158. #define XSIZE_0       XSIZE_PHYS
159. #define YSIZE_0       YSIZE_PHYS
161. #endif
163. /*11. 配置选项检测，防止配置错误或者某些选项没有配置 */
164. #ifndef   XSIZE_PHYS
165.   #error Physical X size of display is not defined!
166. #endif
167. #ifndef   YSIZE_PHYS
168.   #error Physical Y size of display is not defined!
169. #endif
170. #ifndef   NUM_VSCREENS
171.   #define NUM_VSCREENS 1
172. #else
173.   #if (NUM_VSCREENS <= 0)
174.     #error At least one screeen needs to be defined!
175.   #endif
176. #endif
177. #if (NUM_VSCREENS > 1) && (NUM_BUFFERS > 1)
178.   #error Virtual screens and multiple buffers are not allowed!
179. #endif

复制代码

    对于这12个配置选项，注释说明已经比较详细。默认情况下，本教程配套的emWin例子都是用的三缓冲，RGB565格式，且仅使用单图层。
程序设计：
任务栈大小分配：
    μCOS-III任务栈大小在os_cfg.h文件中配置：
#define  APP_CFG_TASK_START_STK_SIZE                     512u
#define  APP_CFG_TASK_MsgPro_STK_SIZE                    512u
#define  APP_CFG_TASK_COM_STK_SIZE                       512u
#define  APP_CFG_TASK_USER_IF_STK_SIZE                    512u
#define  APP_CFG_TASK_GUI_STK_SIZE                        1024u
    任务栈大小的单位是4字节，那么每个任务的栈大小如下：
App Task Start   任务：2048字节。
       App Task MspPro任务 ：2048字节。
       App Task UserIF  任务：2048字节。
       App Task COM   任务：2048字节。
      App Task GUI    任务：4096字节。
系统栈大小分配：
    μCOS-III的系统栈大小在os_cfg_app.h文件中配置：
        #define  OS_CFG_ISR_STK_SIZE                      512u      
        系统栈大小的单位是4字节，那么这里就是配置系统栈大小为2KB。
μCOS-III初始化：

1. /*
2. *********************************************************************************************************
3. *    函 数 名: main
4. *    功能说明: 标准c程序入口。
5. *    形    参: 无
6. *    返 回 值: 无
7. *********************************************************************************************************
8. */
9. int main(void)
10. {
11.     OS_ERR  err;
12.    
13.      /* 初始化uC/OS-III 内核 */
14.     OSInit(&err);
16.      /* 创建一个启动任务（也就是主任务）。启动任务会创建所有的应用程序任务 */
17.      OSTaskCreate((OS_TCB       *)&AppTaskStartTCB,  /* 任务控制块地址 */           
18.                  (CPU_CHAR     *)"App Task Start",  /* 任务名 */
19.                  (OS_TASK_PTR   )AppTaskStart,      /* 启动任务函数地址 */
20.                  (void         *)0,                 /* 传递给任务的参数 */
21.                  (OS_PRIO       )APP_CFG_TASK_START_PRIO, /* 任务优先级 */
22.                  (CPU_STK      *)&AppTaskStartStk[0],     /* 堆栈基地址 */
23.                  (CPU_STK_SIZE  )APP_CFG_TASK_START_STK_SIZE / 10, /* 堆栈监测区，这里表示后10%作为监测区 */
24.                  (CPU_STK_SIZE  )APP_CFG_TASK_START_STK_SIZE,      /* 堆栈空间大小 */
25.                  (OS_MSG_QTY    )0,  /* 本任务支持接受的最大消息数 */
26.                  (OS_TICK       )0,  /* 设置时间片 */
27.                  (void         *)0,  /* 堆栈空间大小 */
28.                  (OS_OPT        )(OS_OPT_TASK_STK_CHK | OS_OPT_TASK_STK_CLR),
29.         
30.                     /*  定义如下：
31.                        OS_OPT_TASK_STK_CHK      使能检测任务栈，统计任务栈已用的和未用的
32.                        OS_OPT_TASK_STK_CLR      在创建任务时，清零任务栈
33.                        OS_OPT_TASK_SAVE_FP      如果CPU有浮点寄存器，则在任务切换时保存浮点寄存器的内容
34.                     */
35.                  (OS_ERR       *)&err);
37.      /* 启动多任务系统，控制权交给uC/OS-III */
38.     OSStart(&err);                                             
39.    
40.     (void)&err;
41.    
42.     return (0);
43. }

复制代码

硬件外设初始化
     硬件外设的初始化是在bsp.c文件实现：

1. /*
2. *********************************************************************************************************
3. *    函 数 名: bsp_Init
4. *    功能说明: 初始化所有的硬件设备。该函数配置CPU寄存器和外设的寄存器并初始化一些全局变量。只需要调用一次
5. *    形    参：无
6. *    返 回 值: 无
7. *********************************************************************************************************
8. */
9. void bsp_Init(void)
10. {
11.      /*
12.          由于ST固件库的启动文件已经执行了CPU系统时钟的初始化，所以不必再次重复配置系统时钟。
13.          启动文件配置了CPU主时钟频率、内部Flash访问速度和可选的外部SRAM FSMC初始化。
15.          系统时钟缺省配置为168MHz，如果需要更改，可以修改 system_stm32f4xx.c 文件
16.      */
17.      /* 使能CRC 因为使用STemWin前必须要使能 */
18.     RCC_AHB1PeriphClockCmd(RCC_AHB1Periph_CRC, ENABLE);
19.    
20.      /* 优先级分组设置为4，可配置0-15级抢占式优先级，0级子优先级，即不存在子优先级。*/
21.      NVIC_PriorityGroupConfig(NVIC_PriorityGroup_4);
22.    
23.      SystemCoreClockUpdate();    /* 根据PLL配置更新系统时钟频率变量 SystemCoreClock */
25.      bsp_InitUart();        /* 初始化串口 */
26.      bsp_InitKey();         /* 初始化按键变量（必须在 bsp_InitTimer() 之前调用） */
27.    
28.      bsp_InitExtIO();       /* FMC总线上扩展了32位输出IO, 操作LED等外设必须初始化 */
29.      bsp_InitLed();         /* 初始LED指示灯端口 */
30.    
31.      bsp_InitI2C();         /* 配置I2C总线 */
32.      bsp_InitSPIBus();       /* 配置SPI总线 */
33.    
34.      bsp_InitSFlash();       /* 初始化SPI Flash */
35.    
36.      bsp_InitExtSDRAM();   /* 初始化SDRAM */
37.      bsp_DetectLcdType();  /* 检测触摸板和LCD面板型号, 结果存在全局变量 g_TouchType, g_LcdType */
38.    
39.      TOUCH_InitHard();    /* 初始化配置触摸芯片 */
40.      LCD_ConfigLTDC();     /* 初始化配置LTDC */
41.    
42.      result = f_mount(&fs, "0:/", 0);     /* 挂载文件系统 */
43. }

复制代码

五个μCOS-III任务的实现：

1. /*
2. *********************************************************************************************************
3. *    函 数 名: AppTaskStart
4. *    功能说明: 这是一个启动任务，在多任务系统启动后，必须初始化滴答计数器。本任务主要实现按键和触摸检测。
5. *    形    参: p_arg 是在创建该任务时传递的形参
6. *    返 回 值: 无
7.      优 先 级: 2
8. *********************************************************************************************************
9. */
10. static  void  AppTaskStart (void *p_arg)
11. {
12.      OS_ERR      err;
13.      uint8_t  ucCount = 0;
14.      uint8_t  ucCount1 = 0;
15.    
16.     /* 仅用于避免编译器告警，编译器不会产生任何目标代码 */  
17.     (void)p_arg;
18.    
19.      /* BSP 初始化。 BSP = Board Support Package 板级支持包，可以理解为底层驱动。*/
20.      CPU_Init();  /* 此函数要优先调用，因为外设驱动中使用的us和ms延迟是基于此函数的 */
21.      bsp_Init();      
22.      BSP_Tick_Init();
23.    
24. #if OS_CFG_STAT_TASK_EN > 0u
25.      OSStatTaskCPUUsageInit(&err);  
26. #endif
28. #ifdef CPU_CFG_INT_DIS_MEAS_EN
29.     CPU_IntDisMeasMaxCurReset();
30. #endif
31.         
32.      /* 创建应用程序的任务 */
33.      AppTaskCreate();
34.    
35.      /* 创建任务通信 */
36.      AppObjCreate();
37.    
38.     while(1)
39.     {
40.          /* 1ms一次触摸扫描，电阻触摸屏 */
41.          if(g_tTP.Enable == 1)
42.          {
43.               TOUCH_Scan();
44.             
45.               /* 按键扫描 */
46.               ucCount++;
47.               if(ucCount == 10)
48.               {
49.                    ucCount = 0;
50.                    bsp_KeyScan();
51.               }
52.              OSTimeDly(1, OS_OPT_TIME_DLY, &err);         
53.          }
54.         
55.          /* 20ms一次触摸扫描，电容触摸屏GT811
56.             GT811取20ms比较稳定，取10ms偶尔会有跳动。
57.          */
58.          if(g_GT811.Enable == 1)
59.          {
60.               bsp_KeyScan();
61.               ucCount1++;
62.               if(ucCount1 == 2)
63.               {
64.                    ucCount1 = 0;
65.                    GT811_OnePiontScan();
66.               }
67.              OSTimeDly(10, OS_OPT_TIME_DLY, &err);     
68.          }
69.         
70.          /* 10ms一次触摸扫描，电容触摸屏FT5X06 */
71.          if(g_tFT5X06.Enable == 1)
72.          {
73.               bsp_KeyScan();
74.               FT5X06_OnePiontScan();
75.              OSTimeDly(10, OS_OPT_TIME_DLY, &err);
76.          }
77.     }   
78. }
80. /*
81. *********************************************************************************************************
82. *    函 数 名: AppTaskMsgPro
83. *    功能说明: 实现截图功能，将图片以BMP格式保存到SD卡中
84. *    形    参: p_arg 是在创建该任务时传递的形参
85. *    返 回 值: 无
86.      优 先 级: 3
87. *********************************************************************************************************
88. */
89. static void AppTaskMsgPro(void *p_arg)
90. {
91.      uint32_t ulStart, ulEnd;
92.      OS_ERR      err;
93.      uint8_t       Pic_Name = 0;
94.      char buf[20];
96.      (void)p_arg;
97.          
98.      while(1)
99.      {   
100.           /* 等待获取信号量同步消息，接收到后执行串口打印 */
101.          OSSemPend((OS_SEM *)&SEM_SYNCH,
102.                      (OS_TICK )0,
103.                      (OS_OPT  )OS_OPT_PEND_BLOCKING,
104.                      (CPU_TS  )0,
105.                      (OS_ERR *)&err);
106.         
107.          if(err == OS_ERR_NONE)
108.          {   
109.               sprintf(buf,"0:/PicSave/%d.bmp",Pic_Name);
110.             
111.               /* 记录截图前起始时间 */
112.               ulStart = OSTimeGet(&err);
113.             
114.               /* 开启调度锁 */
115.               OSSchedLock(&err);
116.             
117.               /* 如果SD卡中没有PicSave文件，会进行创建 */
118.               result = f_mkdir("0:/PicSave");
119.             
120.               /* 创建截图 */
121.               result = f_open(&file,buf, FA_WRITE|FA_CREATE_ALWAYS);
122.             
123.               /* 向SD卡绘制BMP图片 */
124.               GUI_BMP_Serialize(_WriteByte2File, &file);
125.             
126.               /* 创建完成后关闭file */
127.              result = f_close(&file);
128.             
129.               /* 开启调度锁 */
130.               OSSchedUnlock(&err);
131.             
132.               /* 记录截图后时间并获取截图过程耗时 */
133.               ulEnd = OSTimeGet(&err);
134.               ulEnd -= ulStart;
135.             
136.               App_Printf("截图完成，耗时 = %dms\\r\\n", ulEnd);
137.               Pic_Name++;      
138.          }                                                                                                                  
139.      }  
140. }
142. /*
143. *********************************************************************************************************
144. *    函 数 名: AppTaskUserIF
145. *    功能说明: 按键消息处理
146. *    形    参: p_arg 是在创建该任务时传递的形参
147. *    返 回 值: 无
148.      优 先 级: 4
149. *********************************************************************************************************
150. */
151. static void AppTaskUserIF(void *p_arg)
152. {
153.      OS_ERR      err;
154.      uint8_t  ucKeyCode;
155.    
156.      (void)p_arg;                /* 避免编译器报警 */
157.    
159.      while (1)
160.      {      
161.          ucKeyCode = bsp_GetKey();
162.         
163.          if (ucKeyCode != KEY_NONE)
164.          {
165.               switch (ucKeyCode)
166.               {
167.                    case KEY_DOWN_K1:             /* K1键按下 打印任务执行情况 */
168.                        DispTaskInfo();        
169.                        break;
170.                   
171.                    case KEY_DOWN_K2:             /* K2键按下 向消息队列发送数据 */
172.                        OSSemPost((OS_SEM *)&SEM_SYNCH,
173.                                   (OS_OPT  )OS_OPT_POST_1,
174.                                   (OS_ERR *)&err);
175.                        break;
176.                   
177.                    default:                     /* 其他的键值不处理 */
178.                        break;
179.               }
180.          }
181.         
182.          OSTimeDly(20, OS_OPT_TIME_DLY, &err);
183.      }
184. }
186. /*
187. *********************************************************************************************************
188. *    函 数 名: AppTaskCom
189. *    功能说明: 暂未使用
190. *    形    参: p_arg 是在创建该任务时传递的形参
191. *    返 回 值: 无
192.      优 先 级: 5
193. *********************************************************************************************************
194. */
195. static void AppTaskCOM(void *p_arg)
196. {
197.      OS_ERR  err;      
198.    
199.      (void)p_arg;
200.    
201.      while(1)
202.      {   
203.          OSTimeDly(500, OS_OPT_TIME_DLY, &err);
204.      }                                                                                                
205. }
207. /*
208. *********************************************************************************************************
209. *    函 数 名: AppTaskGUI
210. *    功能说明: GUI任务，最低优先级                        
211. *    形    参：p_arg 是在创建该任务时传递的形参
212. *    返 回 值: 无
213. *   优 先 级：OS_CFG_PRIO_MAX - 4u
214. *********************************************************************************************************
215. */
216. static void AppTaskGUI(void *p_arg)
217. {
218.     (void)p_arg;       /* 避免编译器告警 */
219.         
220.      while (1)
221.      {
222.          MainTask();
223.      }
224. }

复制代码

emWin任务的具体实现（在MainTask.c文件里面）：

1. #include "MainTask.h"
2. #include "includes.h"
5. /*
6. *********************************************************************************************************
7. *                                             变量
8. *********************************************************************************************************
9. */
10. uint8_t tempbuf[4096];  /* 从SD卡读取数据的缓冲 */
13. /*
14. *********************************************************************************************************
15. *                                               对话框信息
16. *********************************************************************************************************
17. */
18. static const GUI_WIDGET_CREATE_INFO _aDialogCreate[] = {
19.     { FRAMEWIN_CreateIndirect,  "安富莱电子",     0,          0,  0,  480, 272,FRAMEWIN_CF_MOVEABLE, 0},
20.      { BUTTON_CreateIndirect,    "安富莱电子",     GUI_ID_BUTTON0,  10, 150, 400, 50, 0, 0},
21.     { TEXT_CreateIndirect,      "安富莱电子AaＡａ-12点阵半角全角",   GUI_ID_TEXT0,   0, 10, 480, 33, 0,0},
22.     { TEXT_CreateIndirect,      "安富莱电子AaＡａ-16点阵半角全角",   GUI_ID_TEXT1,   0, 40, 480, 33, 0,0},
23.     { TEXT_CreateIndirect,      "安富莱电子AaＡａ-24点阵半角全角",   GUI_ID_TEXT2,   0, 70, 480, 72, 0,0},
24.      { TEXT_CreateIndirect,      "安富莱电子AaＡａ-32点阵半全角",     GUI_ID_TEXT3,   0, 100, 480, 72, 0,0},
25. };
27. /*
28. *********************************************************************************************************
29. *    函 数 名: PaintDialog
30. *    功能说明: 重绘
31. *    形    参：pMsg  消息指针
32. *    返 回 值: 无
33. *********************************************************************************************************
34. */
35. void PaintDialog(WM_MESSAGE * pMsg)
36. {
37. //    WM_HWIN hWin = pMsg->hWin;
38.    
39. }
41. /*
42. *********************************************************************************************************
43. *    函 数 名: InitDialog
44. *    功能说明: 对话框初始化
45. *    形    参：pMsg  消息指针
46. *    返 回 值: 无
47. *********************************************************************************************************
48. */
49. void InitDialog(WM_MESSAGE * pMsg)
50. {
51.     WM_HWIN hWin = pMsg->hWin;
52.     //
53.     //FRAMEWIN
54.     //
55.     FRAMEWIN_SetFont(hWin,&GUI_FontHZ24);
56.     FRAMEWIN_SetTextAlign(hWin,GUI_TA_VCENTER|GUI_TA_CENTER);
57.     FRAMEWIN_AddCloseButton(hWin, FRAMEWIN_BUTTON_RIGHT, 0);
58.     FRAMEWIN_AddMaxButton(hWin, FRAMEWIN_BUTTON_RIGHT, 1);
59.     FRAMEWIN_AddMinButton(hWin, FRAMEWIN_BUTTON_RIGHT, 2);
60.     FRAMEWIN_SetTitleHeight(hWin,35);
61.    
62.     //
63.     //GUI_ID_BUTTON0
64.     //
65.     BUTTON_SetFont(WM_GetDialogItem(hWin,GUI_ID_BUTTON0),&GUI_FontHZ32);
66.    
67.     //
68.     //GUI_ID_TEXT0
69.     //
70.      TEXT_SetTextColor(WM_GetDialogItem(hWin,GUI_ID_TEXT0), GUI_RED);
71.     TEXT_SetFont(WM_GetDialogItem(hWin,GUI_ID_TEXT0),&GUI_FontHZ12);
72.      TEXT_SetTextColor(WM_GetDialogItem(hWin,GUI_ID_TEXT1), GUI_YELLOW);
73.      TEXT_SetFont(WM_GetDialogItem(hWin,GUI_ID_TEXT1),&GUI_FontHZ16);
74.      TEXT_SetTextColor(WM_GetDialogItem(hWin,GUI_ID_TEXT2), GUI_BLUE);
75.      TEXT_SetFont(WM_GetDialogItem(hWin,GUI_ID_TEXT2),&GUI_FontHZ24);
76.      TEXT_SetTextColor(WM_GetDialogItem(hWin,GUI_ID_TEXT3), GUI_ORANGE);
77.      TEXT_SetFont(WM_GetDialogItem(hWin,GUI_ID_TEXT3),&GUI_FontHZ32);
78. }
80. /*
81. *********************************************************************************************************
82. *    函 数 名: _cbCallback
83. *    功能说明: 对话框回调函数
84. *    形    参: pMsg  消息指针
85. *    返 回 值: 无
86. *********************************************************************************************************
87. */
88. static void _cbCallback(WM_MESSAGE * pMsg)
89. {
90.     int NCode, Id;
91.     WM_HWIN hWin = pMsg->hWin;
92.     switch (pMsg->MsgId)
93.     {
94.         case WM_PAINT:
95.             PaintDialog(pMsg);
96.             break;
97.         
98.         case WM_INIT_DIALOG:
99.             InitDialog(pMsg);
100.             break;
101.         
102.         case WM_KEY:
103.             switch (((WM_KEY_INFO*)(pMsg->Data.p))->Key)
104.             {
105.                 case GUI_KEY_ESCAPE:
106.                     GUI_EndDialog(hWin, 1);
107.                     break;
108.                   
109.                 case GUI_KEY_ENTER:
110.                     GUI_EndDialog(hWin, 0);
111.                     break;
112.             }
113.             break;
114.             
115.         case WM_NOTIFY_PARENT:
116.             Id = WM_GetId(pMsg->hWinSrc);
117.             NCode = pMsg->Data.v;      
118.             switch (Id)
119.             {
120.                 case GUI_ID_OK:
121.                     if(NCode==WM_NOTIFICATION_RELEASED)
122.                         GUI_EndDialog(hWin, 0);
123.                     break;
124.                      
125.                 case GUI_ID_CANCEL:
126.                     if(NCode==WM_NOTIFICATION_RELEASED)
127.                         GUI_EndDialog(hWin, 0);
128.                     break;
129.             }
130.             break;
131.             
132.         default:
133.             WM_DefaultProc(pMsg);
134.     }
135. }
137. /*
138. *********************************************************************************************************
139. *    函 数 名: LoadFontLib()
140. *    功能说明: 从SD卡中加载字库文件到SPI FLASH
141. *    形    参: 无      
142. *    返 回 值: 无
143. *********************************************************************************************************
144. */
145. void LoadFontLib(void)
146. {
147.      float FinishPecent;
148.     uint32_t Count = 0;
149.      uint16_t y, i;
150.      uint8_t ucState;
151.      char cDispBuf[80];
153.    
154.      /* 清屏 */
155.      GUI_SetBkColor(GUI_BLUE);
156.      GUI_Clear();
157.    
158.      /* 设置字体 */
159.      GUI_SetFont(GUI_FONT_20_1);
161.     y = 0;
162.      /* 第1步：显示操作说明 ***************************************************************/
163.      GUI_DispStringAt("SPI Flash Chinese character Lab", 0, y);
164.      y += 20;
165.    
166.      GUI_DispStringAt("1. Please make sure the font.bin is saved in SD", 0, y);
167.      y += 20;
168.    
169.      GUI_DispStringAt("2. if the font.bin is not saved in SD, this lab will fail", 0, y);
170.      y += 20;
171.    
172.      /* 等待10s后开始进行复制，方便客户看屏幕上的显示信息 */
173.      for(i = 0; i < 11; i++)
174.      {
175.          sprintf(cDispBuf, "3. 10 seconds will start, %ds..  ", 10 - i);
176.          GUI_DispStringAt(cDispBuf, 0, y);
177.          GUI_Delay(1000);
178.      }
179.      y += 20;
180.    
181.    
182.      /* 第2步：打开文件 ***************************************************************/
183.      result = f_open(&file, "font.bin", FA_OPEN_EXISTING | FA_READ);
184.      if (result !=  FR_OK)
185.      {
186.          GUI_DispStringAt("font.bin open failed", 0, y);
187.          y += 20;
188.      }
190.      /* 第3步：复制SD卡中字库文件font.bin到SPI FLASH **********************************/
191.      for(;;)
192.      {
193.          /* 读取一个扇区的数据到buf */
194.          result = f_read(&file, &tempbuf, g_tSF.PageSize, &bw);
195.         
196.          /* 读取出错或者读取完毕，退出 */
197.          if ((result != FR_OK)||bw == 0)
198.          {
199.               break;
200.          }
201.         
202.          /* 写数据到SPI FLASH */
203.          ucState = sf_WriteBuffer(tempbuf, Count*g_tSF.PageSize, g_tSF.PageSize);
204.         
205.          /* 如果返回0，表示复制失败 */
206.          if(ucState == 0)
207.          {
208.               GUI_DispStringAt("copy failed                  ", 0, y);
209.               break;
210.          }
211.         
212.           /* 显示复制进度 */
213.          Count = Count + 1;
214.          FinishPecent = (float)(Count* g_tSF.PageSize) / file.fsize;
215.          sprintf(cDispBuf, "copying:%02d%%", (uint8_t)(FinishPecent*100));
216.          GUI_DispStringAt(cDispBuf, 0, y);
217.      }
218.    
219.      /* 等待1秒后开始进去emWin主界面 */
220.      GUI_Delay(1000);
221. }
223. /*
224. *********************************************************************************************************
225. *    函 数 名: MainTask
226. *    功能说明: GUI主函数
227. *    形    参: 无
228. *    返 回 值: 无
229. *********************************************************************************************************
230. */
231. void MainTask(void)
232. {
233.      /* 初始化 */
234.      GUI_Init();
235.       
236.      /*
237.       关于多缓冲和窗口内存设备的设置说明
238.         1. 使能多缓冲是调用的如下函数，用户要在LCDConf_Lin_Template.c文件中配置了多缓冲，调用此函数才有效：
239.            WM_MULTIBUF_Enable(1);
240.         2. 窗口使能使用内存设备是调用函数：WM_SetCreateFlags(WM_CF_MEMDEV);
241.         3. 如果emWin的配置多缓冲和窗口内存设备都支持，二选一即可，且务必优先选择使用多缓冲，实际使用
242.            STM32F429BIT6 + 32位SDRAM + RGB565/RGB888平台测试，多缓冲可以有效的降低窗口移动或者滑动时的撕裂
243.            感，并有效的提高流畅性，通过使能窗口使用内存设备是做不到的。
244.         4. 所有emWin例子默认是开启三缓冲。
245.      */
246.      WM_MULTIBUF_Enable(1);
248.      /*
249.        触摸校准函数默认是注释掉的，电阻屏需要校准，电容屏无需校准。如果用户需要校准电阻屏的话，执行
250.         此函数即可，会将触摸校准参数保存到EEPROM里面，以后系统上电会自动从EEPROM里面加载。
251.      */
252.     //TOUCH_Calibration();
253.    
254.      /* 初始化使用GUI以前，先将字库从SD卡中加载到SP FLASH里面 */
255.      LoadFontLib();
256.    
257.      /* 调用此函数会自动的刷新桌面窗口 */
258.      WM_SetDesktopColor(GUI_BLUE);
260.      /* 创建对话框 */
261.      GUI_CreateDialogBox(_aDialogCreate, GUI_COUNTOF(_aDialogCreate), &_cbCallback, 0, 0, 0);
262.    
263.      while(1)
264.      {
265.          GUI_Delay(10);
266.      }
267. }

复制代码

席萌0209

25.7 实验例程说明（裸机）


配套例子：
     V6-533_STemWin实验_全字库实现，GB2312编码（裸机）
实验目的：
    1.     学习emWin的GB2312编码全字库的使用方法。
    2.     emWin功能的实现在MainTask.c文件里面。
支持点阵：
    1.     支持12点阵，16点阵，24点阵以及32点阵汉字。
    2.     6X12点阵的ASCII，8X16点阵的ASCII，12X24点阵的ASCII，16X32点阵的ASCII
字库存储方式：
    1.     字库存储到SPI FLASH里面。
实验步骤：
    1.     将字库文件font.bin放到SD卡根目录中，系统上电后会将其加载到SPI FLASH里面。
    2.     板子上电后会有一个加载进度指示，存储到SPI FLASH成功后会显示一个对话框。
实验注意：
    1.     实验所需的字库文件font.bin已经存储到本工程的Doc文件夹下，使用此例子前，请务必将这个文件存储到SD卡根目录中，并将SD卡插到开发板上面。
STemWin界面显示效果：
    800*480分辨率界面效果。

STemWin动态内存配置：
    GUIConf.c文件中的配置如下：

1. #define EX_SRAM   1/*1 used extern sram, 0 used internal sram */
3. #if EX_SRAM
4. #define GUI_NUMBYTES  (1024*1024*8)
5. #else
6. #define GUI_NUMBYTES  (100*1024)
7. #endif

复制代码

    通过宏定义来配置使用内部SRAM还是外部的SDRAM做为emWin的动态内存，当配置：
#define EX_SRAM    1 表示使用外部SDRAM作为emWin动态内存，大小8MB。
#define EX_SRAM    0 表示使用内部SRAM作为emWin动态内存，大小100KB。
默认情况下，本教程配套的所有emWin例子都是用外部SDRAM作为emWin动态内存。
STemWin底层接口配置：
    LCDConf_Lin_Template.c文件中共12项emWin配置：

1. /*
2. **********************************************************************************************************
3.                                           用户可以配置的选项
4. **********************************************************************************************************
5. */
6. /* 0. 在官方代码的基础上再做优化，官方的部分函数效率低，耗内存, 0表示优化 */
7. #define emWin_Optimize   0
9. /*
10.   1. 显示屏的物理分辨率，驱动已经做了显示屏自适应，支持4.3寸，5寸和7寸屏
11.      这里填写自适应显示屏中的最大分辨率。
12. */
13. #define XSIZE_PHYS       800
14. #define YSIZE_PHYS       480
16. /* 2. 多缓冲 / 虚拟屏，多缓冲和虚拟屏不可同时使用，emWin不支持 */
17. #define NUM_BUFFERS      3 /* 定义多缓冲个数，仅可以设置1,2和3，也就是最大支持三缓冲 */
18. #define NUM_VSCREENS     1 /* 定义虚拟屏个数 */
20. /* 3. 没有图层激活时，背景色设置, 暂时未用到 */
21. #define BK_COLOR         GUI_DARKBLUE
23. /*
24.    4. 重定义图层数，对于STM32F429/439，用户可以选择一个图层或者两个图层，不支持三图层
25.       (1). 设置GUI_NUM_LAYERS = 1时，即仅使用图层1时，默认触摸值是发送给图层1的。
26.        (2). 设置GUI_NUM_LAYERS = 2时，即图层1和图层2都已经使能，此时图层2是顶层，
27.             用户需要根据自己的使用情况设置如下两个地方。
28.             a. 在bsp_touch.c文件中的函数TOUCH_InitHard里面设置参数State.Layer = 1，1就表示
29.                给图层2发送触摸值。
30.             b. 调用GUI_Init函数后，调用函数GUI_SelectLayer(1), 设置当前操作的是图层2。
31. */
32. #undef  GUI_NUM_LAYERS
33. #define GUI_NUM_LAYERS    1
35. /*
36.    5. 设置图层1和图层2对应的显存地址
37.       (1) EXT_SDRAM_ADDR 是SDRAM的首地址。
38.       (2) LCD_LAYER0_FRAME_BUFFER 是图层1的显存地址。
39.        (3) LCD_LAYER1_FRAME_BUFFER 是图层2的显存地址。
40.        (4) 每个图层的显存大小比较考究，这里进行下简单的说明。
41.            如果用户选择的颜色模式 = 32位色ARGB8888，显存的大小：
42.            XSIZE_PHYS * YSIZE_PHYS * 4 * NUM_VSCREENS * NUM_BUFFERS
43.          
44.            颜色模式 = 24位色RGB888，显存的大小：
45.            XSIZE_PHYS * YSIZE_PHYS * 3 * NUM_VSCREENS * NUM_BUFFERS
46.          
47.            颜色模式 = 16位色RGB566，ARGB1555, ARGB4444，AL88，那么显存的大小就是：
48.            XSIZE_PHYS * YSIZE_PHYS * 2 * NUM_VSCREENS * NUM_BUFFERS
50.            颜色模式 = 8位色L8，AL44，那么显存的大小就是：
51.            XSIZE_PHYS * YSIZE_PHYS * 1 * NUM_VSCREENS * NUM_BUFFERS  
52.      
53.       这里为了方便起见，将开发板配套的16MB的SDRAM前8MB分配给LCD显存使用，后8MB用于emWin动态内存。
54.        对于24位色，16位色，8位色，用户可以对其使能三缓冲，并且使能双图层。但是32位色也使能三缓冲和双
55.        图层的话会超出8MB，所以用户根据自己的情况做显存和emWin动态内存的分配调整。
56.          举一个例子，对于800*480分辨率的显示屏，使能32位色，三缓冲，那么最终一个图层需要的大小就是
57.       800 * 480 * 4 * 3  = 4.394MB的空间，如果是双图层，已经超出8MB的分配范围。
58.      
59.       (5)为了方便起见，图层2的宏定义LCD_LAYER1_FRAME_BUFFER中的参数4是按照32位色设置的，如果用户的图层1
60.          使用的是8位色，这里填数字1,如果是16位色，这里填2，如果是24位色，这里填3。
61. */
62. #define LCD_LAYER0_FRAME_BUFFER  EXT_SDRAM_ADDR
63. #define LCD_LAYER1_FRAME_BUFFER  (LCD_LAYER0_FRAME_BUFFER + XSIZE_PHYS * YSIZE_PHYS * 4 * NUM_VSCREENS *
64. NUM_BUFFERS)
66. /*
67.    6. STM32F429/439支持的颜色模式，所有模式都支持，用户可任意配置。
68.       特别注意如下两个问题：
69.        (1) 如果用户选择了ARGB8888或者RGB888模式，LCD闪烁比较厉害的话，
70.            请降低LTDC的时钟大小，在文件bsp_tft_429.c的函数LCD_ConfigLTDC里面设置。
71.            a. 一般800*480分辨率的显示屏，ARGB8888或者RGB888模式LTDC时钟选择10-20MHz即可。
72.            b. 480*272分辨率的可以高些，取20MHz左右即可。
73.        (2) 16位色或者8位色模式，LTDC的时钟频率一般可以比24位色或者32位色的高一倍。
74. */
75. #define _CM_ARGB8888      1
76. #define _CM_RGB888        2
77. #define _CM_RGB565        3
78. #define _CM_ARGB1555      4
79. #define _CM_ARGB4444      5
80. #define _CM_L8            6
81. #define _CM_AL44          7
82. #define _CM_AL88          8
84. /* 7. 配置图层1的颜色模式和分辨率大小 */
85. #define COLOR_MODE_0      _CM_RGB565
86. #define XSIZE_0           XSIZE_PHYS
87. #define YSIZE_0           YSIZE_PHYS
89. /* 8. 配置图层2的的颜色模式和分辨率大小 */
90. #define COLOR_MODE_1      _CM_RGB565
91. #define XSIZE_1           XSIZE_PHYS
92. #define YSIZE_1           YSIZE_PHYS
94. /* 9. 单图层情况下，根据用户选择的颜色模式可自动选择图层1的emWin的驱动和颜色模式 */
95. #if   (COLOR_MODE_0 == _CM_ARGB8888)
96.   #define COLOR_CONVERSION_0 GUICC_M8888I
97.   #define DISPLAY_DRIVER_0   GUIDRV_LIN_32
98. #elif (COLOR_MODE_0 == _CM_RGB888)
99.   #define COLOR_CONVERSION_0 GUICC_M888
100.   #define DISPLAY_DRIVER_0   GUIDRV_LIN_24
101. #elif (COLOR_MODE_0 == _CM_RGB565)
102.   #define COLOR_CONVERSION_0 GUICC_M565
103.   #define DISPLAY_DRIVER_0   GUIDRV_LIN_16
104. #elif (COLOR_MODE_0 == _CM_ARGB1555)
105.   #define COLOR_CONVERSION_0 GUICC_M1555I
106.   #define DISPLAY_DRIVER_0   GUIDRV_LIN_16
107. #elif (COLOR_MODE_0 == _CM_ARGB4444)
108.   #define COLOR_CONVERSION_0 GUICC_M4444I
109.   #define DISPLAY_DRIVER_0   GUIDRV_LIN_16
110. #elif (COLOR_MODE_0 == _CM_L8)
111.   #define COLOR_CONVERSION_0 GUICC_8666
112.   #define DISPLAY_DRIVER_0   GUIDRV_LIN_8
113. #elif (COLOR_MODE_0 == _CM_AL44)
114.   #define COLOR_CONVERSION_0 GUICC_1616I
115.   #define DISPLAY_DRIVER_0   GUIDRV_LIN_8
116. #elif (COLOR_MODE_0 == _CM_AL88)
117.   #define COLOR_CONVERSION_0 GUICC_88666I
118.   #define DISPLAY_DRIVER_0   GUIDRV_LIN_16
119. #else
120.   #error Illegal color mode 0!
121. #endif
123. /* 10. 双图层情况下，根据用户选择的颜色模式可自动选择图层2的emWin的驱动和颜色模式 */
124. #if (GUI_NUM_LAYERS > 1)
126. #if   (COLOR_MODE_1 == _CM_ARGB8888)
127.   #define COLOR_CONVERSION_1 GUICC_M8888I
128.   #define DISPLAY_DRIVER_1   GUIDRV_LIN_32
129. #elif (COLOR_MODE_1 == _CM_RGB888)
130.   #define COLOR_CONVERSION_1 GUICC_M888
131.   #define DISPLAY_DRIVER_1   GUIDRV_LIN_24
132. #elif (COLOR_MODE_1 == _CM_RGB565)
133.   #define COLOR_CONVERSION_1 GUICC_M565
134.   #define DISPLAY_DRIVER_1   GUIDRV_LIN_16
135. #elif (COLOR_MODE_1 == _CM_ARGB1555)
136.   #define COLOR_CONVERSION_1 GUICC_M1555I
137.   #define DISPLAY_DRIVER_1   GUIDRV_LIN_16
138. #elif (COLOR_MODE_1 == _CM_ARGB4444)
139.   #define COLOR_CONVERSION_1 GUICC_M4444I
140.   #define DISPLAY_DRIVER_1   GUIDRV_LIN_16
141. #elif (COLOR_MODE_1 == _CM_L8)
142.   #define COLOR_CONVERSION_1 GUICC_8666
143.   #define DISPLAY_DRIVER_1   GUIDRV_LIN_8
144. #elif (COLOR_MODE_1 == _CM_AL44)
145.   #define COLOR_CONVERSION_1 GUICC_1616I
146.   #define DISPLAY_DRIVER_1   GUIDRV_LIN_8
147. #elif (COLOR_MODE_1 == _CM_AL88)
148.   #define COLOR_CONVERSION_1 GUICC_88666I
149.   #define DISPLAY_DRIVER_1   GUIDRV_LIN_16
150. #else
151.   #error Illegal color mode 1!
152. #endif
154. #else
156. #undef XSIZE_0
157. #undef YSIZE_0
158. #define XSIZE_0       XSIZE_PHYS
159. #define YSIZE_0       YSIZE_PHYS
161. #endif
163. /*11. 配置选项检测，防止配置错误或者某些选项没有配置 */
164. #ifndef   XSIZE_PHYS
165.   #error Physical X size of display is not defined!
166. #endif
167. #ifndef   YSIZE_PHYS
168.   #error Physical Y size of display is not defined!
169. #endif
170. #ifndef   NUM_VSCREENS
171.   #define NUM_VSCREENS 1
172. #else
173.   #if (NUM_VSCREENS <= 0)
174.     #error At least one screeen needs to be defined!
175.   #endif
176. #endif
177. #if (NUM_VSCREENS > 1) && (NUM_BUFFERS > 1)
178.   #error Virtual screens and multiple buffers are not allowed!
179. #endif

复制代码

    对于这12个配置选项，注释说明已经比较详细。默认情况下，本教程配套的emWin例子都是用的三缓冲，RGB565格式，且仅使用单图层。
程序设计：
栈大小分配：
    系统栈大小在startup_stm32f429_439xx.s文件中配置：

    栈大小的单位是字节，那么这里配置的系统栈大小就是8192字节。
主函数初始化：

1. /*
2. *********************************************************************************************************
3. *    函 数 名: main
4. *    功能说明: 标准c程序入口。
5. *    形    参: 无
6. *    返 回 值: 无
7. *********************************************************************************************************
8. */
9. int main (void)
10. {   
11.      /* 初始化外设 */
12.      bsp_Init();
14.      /* 进入emWin主函数 */
15.      MainTask();
16. }

复制代码

硬件外设初始化
    硬件外设的初始化是在bsp.c文件实现：

1. /*
2. *********************************************************************************************************
3. *    函 数 名: bsp_Init
4. *    功能说明: 初始化所有的硬件设备。该函数配置CPU寄存器和外设的寄存器并初始化一些全局变量。只需要调用一次
5. *    形    参：无
6. *    返 回 值: 无
7. *********************************************************************************************************
8. */
9. void bsp_Init(void)
10. {
11.      /*
12.          由于ST固件库的启动文件已经执行了CPU系统时钟的初始化，所以不必再次重复配置系统时钟。
13.          启动文件配置了CPU主时钟频率、内部Flash访问速度和可选的外部SRAM FSMC初始化。
15.          系统时钟缺省配置为168MHz，如果需要更改，可以修改 system_stm32f4xx.c 文件
16.      */
17.      /* 使能CRC 因为使用STemWin前必须要使能 */
18.     RCC_AHB1PeriphClockCmd(RCC_AHB1Periph_CRC, ENABLE);
19.    
20.      /* 优先级分组设置为4，可配置0-15级抢占式优先级，0级子优先级，即不存在子优先级。*/
21.      NVIC_PriorityGroupConfig(NVIC_PriorityGroup_4);
22.    
23.      SystemCoreClockUpdate();    /* 根据PLL配置更新系统时钟频率变量 SystemCoreClock */
25.      bsp_InitUart();        /* 初始化串口 */
26.      bsp_InitKey();         /* 初始化按键变量（必须在 bsp_InitTimer() 之前调用） */
27.    
28.      bsp_InitExtIO();       /* FMC总线上扩展了32位输出IO, 操作LED等外设必须初始化 */
29.      bsp_InitLed();         /* 初始LED指示灯端口 */
30.    
31.      bsp_InitI2C();         /* 配置I2C总线 */
32.      bsp_InitSPIBus();       /* 配置SPI总线 */
33.    
34.      bsp_InitSFlash();       /* 初始化SPI Flash */
35.    
36.      bsp_InitExtSDRAM();   /* 初始化SDRAM */
37.      bsp_DetectLcdType();  /* 检测触摸板和LCD面板型号, 结果存在全局变量 g_TouchType, g_LcdType */
38.    
39.      TOUCH_InitHard();    /* 初始化配置触摸芯片 */
40.      LCD_ConfigLTDC();     /* 初始化配置LTDC */
41.    
42.      result = f_mount(&fs, "0:/", 0);     /* 挂载文件系统 */
43. }

复制代码

emWin功能的具体实现（在MainTask.c文件里面）：

1. #include "MainTask.h"
2. #include "bsp.h"
5. /*
6. *********************************************************************************************************
7. *                                             变量
8. *********************************************************************************************************
9. */
10. uint8_t tempbuf[4096];  /* 从SD卡读取数据的缓冲 */
13. /*
14. *********************************************************************************************************
15. *                                               对话框信息
16. *********************************************************************************************************
17. */
18. static const GUI_WIDGET_CREATE_INFO _aDialogCreate[] = {
19.     { FRAMEWIN_CreateIndirect,  "安富莱电子",     0,          0,  0,  480, 272,FRAMEWIN_CF_MOVEABLE, 0},
20.      { BUTTON_CreateIndirect,    "安富莱电子",     GUI_ID_BUTTON0,  10, 150, 400, 50, 0, 0},
21.     { TEXT_CreateIndirect,      "安富莱电子AaＡａ-12点阵半角全角",   GUI_ID_TEXT0,   0, 10, 480, 33, 0,0},
22.     { TEXT_CreateIndirect,      "安富莱电子AaＡａ-16点阵半角全角",   GUI_ID_TEXT1,   0, 40, 480, 33, 0,0},
23.     { TEXT_CreateIndirect,      "安富莱电子AaＡａ-24点阵半角全角",   GUI_ID_TEXT2,   0, 70, 480, 72, 0,0},
24.      { TEXT_CreateIndirect,      "安富莱电子AaＡａ-32点阵半全角",     GUI_ID_TEXT3,   0, 100, 480, 72, 0,0},
25. };
27. /*
28. *********************************************************************************************************
29. *    函 数 名: PaintDialog
30. *    功能说明: 重绘
31. *    形    参：pMsg  消息指针
32. *    返 回 值: 无
33. *********************************************************************************************************
34. */
35. void PaintDialog(WM_MESSAGE * pMsg)
36. {
37. //    WM_HWIN hWin = pMsg->hWin;
38.    
39. }
41. /*
42. *********************************************************************************************************
43. *    函 数 名: InitDialog
44. *    功能说明: 对话框初始化
45. *    形    参：pMsg  消息指针
46. *    返 回 值: 无
47. *********************************************************************************************************
48. */
49. void InitDialog(WM_MESSAGE * pMsg)
50. {
51.     WM_HWIN hWin = pMsg->hWin;
52.     //
53.     //FRAMEWIN
54.     //
55.     FRAMEWIN_SetFont(hWin,&GUI_FontHZ24);
56.     FRAMEWIN_SetTextAlign(hWin,GUI_TA_VCENTER|GUI_TA_CENTER);
57.     FRAMEWIN_AddCloseButton(hWin, FRAMEWIN_BUTTON_RIGHT, 0);
58.     FRAMEWIN_AddMaxButton(hWin, FRAMEWIN_BUTTON_RIGHT, 1);
59.     FRAMEWIN_AddMinButton(hWin, FRAMEWIN_BUTTON_RIGHT, 2);
60.     FRAMEWIN_SetTitleHeight(hWin,35);
61.    
62.     //
63.     //GUI_ID_BUTTON0
64.     //
65.     BUTTON_SetFont(WM_GetDialogItem(hWin,GUI_ID_BUTTON0),&GUI_FontHZ32);
66.    
67.     //
68.     //GUI_ID_TEXT0
69.     //
70.      TEXT_SetTextColor(WM_GetDialogItem(hWin,GUI_ID_TEXT0), GUI_RED);
71.     TEXT_SetFont(WM_GetDialogItem(hWin,GUI_ID_TEXT0),&GUI_FontHZ12);
72.      TEXT_SetTextColor(WM_GetDialogItem(hWin,GUI_ID_TEXT1), GUI_YELLOW);
73.      TEXT_SetFont(WM_GetDialogItem(hWin,GUI_ID_TEXT1),&GUI_FontHZ16);
74.      TEXT_SetTextColor(WM_GetDialogItem(hWin,GUI_ID_TEXT2), GUI_BLUE);
75.      TEXT_SetFont(WM_GetDialogItem(hWin,GUI_ID_TEXT2),&GUI_FontHZ24);
76.      TEXT_SetTextColor(WM_GetDialogItem(hWin,GUI_ID_TEXT3), GUI_ORANGE);
77.      TEXT_SetFont(WM_GetDialogItem(hWin,GUI_ID_TEXT3),&GUI_FontHZ32);
78. }
80. /*
81. *********************************************************************************************************
82. *    函 数 名: _cbCallback
83. *    功能说明: 对话框回调函数
84. *    形    参: pMsg  消息指针
85. *    返 回 值: 无
86. *********************************************************************************************************
87. */
88. static void _cbCallback(WM_MESSAGE * pMsg)
89. {
90.     int NCode, Id;
91.     WM_HWIN hWin = pMsg->hWin;
92.     switch (pMsg->MsgId)
93.     {
94.         case WM_PAINT:
95.             PaintDialog(pMsg);
96.             break;
97.         
98.         case WM_INIT_DIALOG:
99.             InitDialog(pMsg);
100.             break;
101.         
102.         case WM_KEY:
103.             switch (((WM_KEY_INFO*)(pMsg->Data.p))->Key)
104.             {
105.                 case GUI_KEY_ESCAPE:
106.                     GUI_EndDialog(hWin, 1);
107.                     break;
108.                   
109.                 case GUI_KEY_ENTER:
110.                     GUI_EndDialog(hWin, 0);
111.                     break;
112.             }
113.             break;
114.             
115.         case WM_NOTIFY_PARENT:
116.             Id = WM_GetId(pMsg->hWinSrc);
117.             NCode = pMsg->Data.v;      
118.             switch (Id)
119.             {
120.                 case GUI_ID_OK:
121.                     if(NCode==WM_NOTIFICATION_RELEASED)
122.                         GUI_EndDialog(hWin, 0);
123.                     break;
124.                      
125.                 case GUI_ID_CANCEL:
126.                     if(NCode==WM_NOTIFICATION_RELEASED)
127.                         GUI_EndDialog(hWin, 0);
128.                     break;
129.             }
130.             break;
131.             
132.         default:
133.             WM_DefaultProc(pMsg);
134.     }
135. }
137. /*
138. *********************************************************************************************************
139. *    函 数 名: LoadFontLib()
140. *    功能说明: 从SD卡中加载字库文件到SPI FLASH
141. *    形    参: 无      
142. *    返 回 值: 无
143. *********************************************************************************************************
144. */
145. void LoadFontLib(void)
146. {
147.      float FinishPecent;
148.     uint32_t Count = 0;
149.      uint16_t y, i;
150.      uint8_t ucState;
151.      char cDispBuf[80];
153.    
154.      /* 清屏 */
155.      GUI_SetBkColor(GUI_BLUE);
156.      GUI_Clear();
157.    
158.      /* 设置字体 */
159.      GUI_SetFont(GUI_FONT_20_1);
161.     y = 0;
162.      /* 第1步：显示操作说明 ***************************************************************/
163.      GUI_DispStringAt("SPI Flash Chinese character Lab", 0, y);
164.      y += 20;
165.    
166.      GUI_DispStringAt("1. Please make sure the font.bin is saved in SD", 0, y);
167.      y += 20;
168.    
169.      GUI_DispStringAt("2. if the font.bin is not saved in SD, this lab will fail", 0, y);
170.      y += 20;
171.    
172.      /* 等待10s后开始进行复制，方便客户看屏幕上的显示信息 */
173.      for(i = 0; i < 11; i++)
174.      {
175.          sprintf(cDispBuf, "3. 10 seconds will start, %ds..  ", 10 - i);
176.          GUI_DispStringAt(cDispBuf, 0, y);
177.          GUI_Delay(1000);
178.      }
179.      y += 20;
180.    
181.    
182.      /* 第2步：打开文件 ***************************************************************/
183.      result = f_open(&file, "font.bin", FA_OPEN_EXISTING | FA_READ);
184.      if (result !=  FR_OK)
185.      {
186.          GUI_DispStringAt("font.bin open failed", 0, y);
187.          y += 20;
188.      }
190.      /* 第3步：复制SD卡中字库文件font.bin到SPI FLASH **********************************/
191.      for(;;)
192.      {
193.          /* 读取一个扇区的数据到buf */
194.          result = f_read(&file, &tempbuf, g_tSF.PageSize, &bw);
195.         
196.          /* 读取出错或者读取完毕，退出 */
197.          if ((result != FR_OK)||bw == 0)
198.          {
199.               break;
200.          }
201.         
202.          /* 写数据到SPI FLASH */
203.          ucState = sf_WriteBuffer(tempbuf, Count*g_tSF.PageSize, g_tSF.PageSize);
204.         
205.          /* 如果返回0，表示复制失败 */
206.          if(ucState == 0)
207.          {
208.               GUI_DispStringAt("copy failed                  ", 0, y);
209.               break;
210.          }
211.         
212.           /* 显示复制进度 */
213.          Count = Count + 1;
214.          FinishPecent = (float)(Count* g_tSF.PageSize) / file.fsize;
215.          sprintf(cDispBuf, "copying:%02d%%", (uint8_t)(FinishPecent*100));
216.          GUI_DispStringAt(cDispBuf, 0, y);
217.      }
218.    
219.      /* 等待1秒后开始进去emWin主界面 */
220.      GUI_Delay(1000);
221. }
223. /*
224. *********************************************************************************************************
225. *    函 数 名: MainTask
226. *    功能说明: GUI主函数
227. *    形    参: 无
228. *    返 回 值: 无
229. *********************************************************************************************************
230. */
231. void MainTask(void)
232. {
233.      /* 初始化 */
234.      GUI_Init();
235.       
236.      /*
237.       关于多缓冲和窗口内存设备的设置说明
238.         1. 使能多缓冲是调用的如下函数，用户要在LCDConf_Lin_Template.c文件中配置了多缓冲，调用此函数才有效：
239.            WM_MULTIBUF_Enable(1);
240.         2. 窗口使能使用内存设备是调用函数：WM_SetCreateFlags(WM_CF_MEMDEV);
241.         3. 如果emWin的配置多缓冲和窗口内存设备都支持，二选一即可，且务必优先选择使用多缓冲，实际使用
242.            STM32F429BIT6 + 32位SDRAM + RGB565/RGB888平台测试，多缓冲可以有效的降低窗口移动或者滑动时的撕裂
243.            感，并有效的提高流畅性，通过使能窗口使用内存设备是做不到的。
244.         4. 所有emWin例子默认是开启三缓冲。
245.      */
246.      WM_MULTIBUF_Enable(1);
248.      /*
249.        触摸校准函数默认是注释掉的，电阻屏需要校准，电容屏无需校准。如果用户需要校准电阻屏的话，执行
250.         此函数即可，会将触摸校准参数保存到EEPROM里面，以后系统上电会自动从EEPROM里面加载。
251.      */
252.     //TOUCH_Calibration();
253.    
254.      /* 初始化使用GUI以前，先将字库从SD卡中加载到SP FLASH里面 */
255.      LoadFontLib();
256.    
257.      /* 调用此函数会自动的刷新桌面窗口 */
258.      WM_SetDesktopColor(GUI_BLUE);
260.      /* 创建对话框 */
261.      GUI_CreateDialogBox(_aDialogCreate, GUI_COUNTOF(_aDialogCreate), &_cbCallback, 0, 0, 0);
262.    
263.      while(1)
264.      {
265.          GUI_Delay(10);
266.      }
267. }

复制代码

席萌0209

25.8   总结


    本章节为大家讲解的GB2312编码格式字体是可以用于项目实战的，对于习惯了GB2312编码的用户来说是个很好的选择。这种方式的字体可以存储到任何外部存储介质中。