特别说明：完整STemWin的1-60期教程和配套实例下载地址：链接

第9章      2-D图形库之绘制流位图

    本期主要讲解2-D图形库的绘制流位图，与C文件格式的位图相反，流位图可放在任何位置。位图流可用于创建位图。这些位图可按与C文件格式位图相同的方式使用。此外，emWin支持直接绘制基于调色板的位图流，而不必在可寻址区域（RAM或ROM）放置完整的图像。

    9. 1  生成C流文件

    9. 2  开发板上实现流位图

    9. 3  实验总结

9.1  生成C流文件

    C流文件由与C文件相同的信息组成。它与C文件相反，数据流可位于任何地方，无需编译或与项目链接。C文件支持的所有输出格式对C流文件也可用。emWin支持从数据流创建位图并直接绘制数据流。

    这里顺便说一下压缩位图，这个可看可不看，位图转换器和emWin支持在生成的源代码文件中对位图进行游程编码(RLE)压缩。如果位图包含许多水平序列的等着色像素，则RLE压缩方法最有效。高效压缩的位图将节省大量的空间。但是，不建议对摄影图像进行压缩，因为它们通常不具有相同像素的序列。也应注意，压缩图像的显示时间会稍微更长。如果要保存使用RLE压缩的位图，可在另存为C文件时，选择一种压缩输出格式：“带调色板的C，压缩”或 “不带调色板的C，压缩”。显示压缩位图无需特殊功能；与显示不压缩位图的方法相同。

    获得的压缩比将随所用位图的不同而不同。图像水平均匀性越好，压缩比越高。每个像素的位数越高，产生压缩比也越高。下面我们以下面的图片为例子生成C流文件。

    下面我们以下面的图片为例子生成C流文件。

l 第一步：打开BmpCvt.exe（位置和前面讲的GUIBulder在一个文件夹），并载入图片

l 第二步：做一下格式转换

l 第三步：另存为C流文件即可，不过另存的时候要注意

l 第四步：还有一些其它的格式，大家可以尝试一下，这里我只选择第一个作为实验。

l 第五步：然后得到如下的文件，将其放到SD卡根目录下即可

9.2  开发板上实现流位图

    下面是流位图当前支持的格式：

    GUI_CreateBitmapFromStream()这个函数支持任意格式的流位图创建，可以直接的创建咱们上面生成的流位图，如果知道流位图的格式，那么可以直接的调用特定的函数，当前支持的函数如下：

    这个东西该怎么的理解呢，这里举一个例子，咱们上面生成的那个C流文件是转换成了565格式，这里我们就可以使用函数GUI_CreateBitmapFromStream()，这个函数不管你转换成什么格式了，都可以创建的，还有一个就是GUI_CreateBitmapFromStream565(), 这个就是特定格式的转换，正好用在咱们上面转换好的C流文件。

    现在如何实现刚才那个C流文件的显示呢，我这里用三种方法显示咱们刚才生成的C流文件。

l  第一步：通过申请动态内存将C流文件加载到外部SRAM, 这里我们用的是外部2MB的SRAM做的动态内存，方法如下：

1.          /* 申请一块内存空间 并且将其清零 */
   
2. hMem = GUI_ALLOC_AllocZero(1024*512);
   
3. 
   
4.      /* 将申请到内存的句柄转换成指针类型 */
   
5.      _acBuffer2 = GUI_ALLOC_h2p(hMem);
   
6.    
   
7.      /* 打开文件 */        
   
8.      result = f_open(&file, sFilename, FA_OPEN_EXISTING | FA_READ | FA_OPEN_ALWAYS);
   
9.      if (result != FR_OK)
   
10.      {
    
11.          return;
    
12.      }
    
13. 
    
14.      result = f_read(&file, _acBuffer2, file.fsize, &bw);
    
15.      if (result != FR_OK)
    
16.      {
    
17.          return;
    
18.      }

复制代码

l  第二步：显示刚才加载到RAM中的数据。

    RAM中数据的加载有三种方法，分别如下：

方法一：直接调用函数 GUI_DrawStreamedBitmapAuto(_acBuffer2, 0, 0); 可以显示

方法二：GUI_CreateBitmapFromStream(&Bitmap,&Palette, _acBuffer2);

                GUI_DrawBitmap(&Bitmap, 0, 0);

方法三：GUI_CreateBitmapFromStream565(&Bitmap,&Palette, _acBuffer2);

                GUI_DrawBitmap(&Bitmap, 0, 0);

        实际运行代码如下：

1. #include "includes.h"
   
2. #include "MainTask.h"
   
3. 
   
4. 
   
5. #define Method3  /* 用于选择使用的显示方法 */
   
6. 
   
7. /*
   
8. *********************************************************************************************************
   
9. *    函 数 名: _ShowStreamBitmap
   
10. *    功能说明: 显示流位图
    
11. *    形    参：sFilename  要读取的文件名
    
12. *    返 回 值: 无
    
13. *********************************************************************************************************
    
14. */
    
15. static void _ShowStreamBitmap(const char * sFilename)
    
16. {
    
17.      GUI_HMEM hMem;
    
18.      char *_acBuffer2;
    
19.      BUTTON_Handle hButton;
    
20. GUI_BITMAP Bitmap;
    
21.     GUI_LOGPALETTE Palette;
    
22. 
    
23.     /* 创建一个按钮 */
    
24.     hButton = BUTTON_Create(200, 200, 300, 200, GUI_ID_OK, WM_CF_SHOW);
    
25.      /* 申请一块内存空间 并且将其清零    */
    
26.     hMem = GUI_ALLOC_AllocZero(1024*512);
    
27.      /* 将申请到内存的句柄转换成指针类型 */
    
28.      _acBuffer2 = GUI_ALLOC_h2p(hMem);
    
29.    
    
30.      /* 打开文件 */        
    
31.      result = f_open(&file, sFilename, FA_OPEN_EXISTING | FA_READ | FA_OPEN_ALWAYS);
    
32.      if (result != FR_OK)
    
33.      {
    
34.          return;
    
35.      }
    
36. 
    
37.      /* 读取文件到动态内存 */
    
38.      result = f_read(&file, _acBuffer2, file.fsize, &bw);
    
39.      if (result != FR_OK)
    
40.      {
    
41.          return;
    
42.      }
    
43. 
    
44.      /* 显示方法一 */
    
45. #if defined Method1
    
46.      GUI_DrawStreamedBitmapAuto(_acBuffer2, 15, 15);
    
47.    
    
48.      /* 显示方法二 */
    
49. #elif defined Method2
    
50.     GUI_CreateBitmapFromStream(&Bitmap, &Palette, _acBuffer2);
    
51.      GUI_DrawBitmap(&Bitmap, 15, 15);
    
52.    
    
53.      /* 显示方法三 */
    
54. #elif defined Method3
    
55.      GUI_CreateBitmapFromStream565(&Bitmap, &Palette, _acBuffer2);
    
56.      GUI_DrawBitmap(&Bitmap, 15, 15);
    
57. #endif
    
58. 
    
59.      /* 下面几个函数没有调试出来，留作以后调试 */
    
60. //   BUTTON_SetStreamedBitmap(hButton, BUTTON_CI_UNPRESSED, (const GUI_BITMAP_STREAM *)&Bitmap);
    
61. //  BUTTON_SetBitmap(hButton, BUTTON_BI_UNPRESSED, &Bitmap);
    
62. //   BUTTON_SetStreamedBitmapEx(hButton, BUTTON_BI_UNPRESSED, (const GUI_BITMAP_STREAM *)&Bitmap,0,0);
    
63.    
    
64.     /* 释放动态内存 */   
    
65.      GUI_ALLOC_Free(hMem);
    
66.      f_close(&file);
    
67. }
    
68. 
    
69. /*
    
70. *********************************************************************************************************
    
71. *    函 数 名: MainTask
    
72. *    功能说明: GUI主函数
    
73. *    形    参：无
    
74. *    返 回 值: 无
    
75. *********************************************************************************************************
    
76. */
    
77. void MainTask(void)
    
78. {   
    
79.      GUI_Init();
    
80. 
    
81.      /* 设置皮肤函数 */
    
82.      PROGBAR_SetDefaultSkin(PROGBAR_SKIN_FLEX);
    
83.      FRAMEWIN_SetDefaultSkin(FRAMEWIN_SKIN_FLEX);
    
84.      PROGBAR_SetDefaultSkin(PROGBAR_SKIN_FLEX);
    
85.      BUTTON_SetDefaultSkin(BUTTON_SKIN_FLEX);
    
86.      CHECKBOX_SetDefaultSkin(CHECKBOX_SKIN_FLEX);
    
87.      DROPDOWN_SetDefaultSkin(DROPDOWN_SKIN_FLEX);
    
88.      SCROLLBAR_SetDefaultSkin(SCROLLBAR_SKIN_FLEX);
    
89.      SLIDER_SetDefaultSkin(SLIDER_SKIN_FLEX);
    
90.      HEADER_SetDefaultSkin(HEADER_SKIN_FLEX);
    
91.      RADIO_SetDefaultSkin(RADIO_SKIN_FLEX);
    
92. 
    
93.      /* 读取并显示文件 */
    
94.      _ShowStreamBitmap("logo.dta");
    
95. 
    
96.      while(1)
    
97.      {                 
    
98.          GUI_Delay(100);      
    
99.      }
    
100. 
     
101. }

复制代码

    显示效果如下：

9.3  实验总结

    流位图在一些应用中比较有用，比如要在按钮上面显示图片，我们不需要将其用位图转换器转换成相应的C文件，并下载到内部flash进行显示，我们可以将其放到外部SD，flash等存储器进行加载显示，这个实验尝试了一下在按钮上面显示，就是显示不出来，后面有时间再做尝试。