【STemWin教程】第25章 Sprites

席萌0209

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

第25章 Sprites

    本期教程主要是跟大家讲解sprite的显示，这里讲的sprite跟第23章讲的游标是类似的，只是这里的游标是可以任意跑动的，可以根据程序设置跑动的路径。
    25. 1 介绍
    25. 2 模拟器上演示sprite例子
    25. 3总结
25.1 介绍
    emWin sprite作为一种纯粹的软件解决方案实现。使用emWin sprite不需要额外的硬件。它们可以显示、移动和删除，而不影响当前可见的图形项目。
存储器要求
    每个sprite都需要一个存储器区，用于保存sprite后面的显示数据，以便在移动或删除sprite时能恢复背景显示。另外需要一个存储区，用作颜色缓存。颜色缓存的大小取决于sprite图像中使用的颜色数量。因此，sprite需要的全部字节数可以按以下等式计算：
    SizeOfSpriteObject (~30 bytes) +(XSize * YSize + NumberOfBitmapColors) * REQUIRED_BYTES_PER_PIXEL
Sprite的最大数目
    emWin并不限制同时可见的sprite的数量。具体取决于可用存储器的大小。
性能
    需要注意的是，绘制sprite比绘制简单的位图需要耗费更多计算资源，因为需要处理背景数据以及与其他sprite的交叉点。
叠置顺序
    叠置顺序是对有重叠的二维对象 （此处为sprite）的排序。当两个sprite重叠时，它们的叠置顺序决定了哪个sprite位于另一个sprite的上方。最后创建的sprite位于最上面。

25.2 模拟器上演示sprite例子
    模拟器中有一个例子专门做了sprite的演示，这个例子位置在：

此DEMO的实际代码如下：

1. /*********************************************************************
2. *
3. *       Dolphin bitmap arrays
4. */
5. GUI_CONST_STORAGE GUI_BITMAP * _apImages_0[] = {(1)
6. &bmDolphin_00,
7. &bmDolphin_01,
8. &bmDolphin_02,
9. &bmDolphin_03,
10. &bmDolphin_04,
11. };
13. GUI_CONST_STORAGE GUI_BITMAP * _apImages_1[] = {   (2)
14. &bmDolphin_10,
15. &bmDolphin_11,
16. &bmDolphin_12,
17. &bmDolphin_13,
18. &bmDolphin_14,
19. };
21. /*********************************************************************
22. *
23. *       Sprite array
24. */
25. static SPRITE _aSprite[] = {
26.   { -90,  20, 10,  3, GUI_COUNTOF(_apImages_1), _apImages_1},
27.   { 290, 150, -8, -2, GUI_COUNTOF(_apImages_0), _apImages_0},
28. };
30. /*********************************************************************
31. *
32. *       Static code
33. *
34. **********************************************************************
35. */
36. /*********************************************************************
37. *
38. *       _MoveSprite
39. */
40. static void _MoveSprite(SPRITE * pSprite) {
41.   //
42.   // Set new index
43.   //
44.   pSprite->Index += 1;
45.   if (pSprite->Index >= pSprite->NumImages) { (3)
46.     pSprite->Index = 0;
47.   }
48.   //
49.   // Adjust X-position
50.   //
51.   pSprite->xPos += pSprite->dx;(4)
52.   if (pSprite->xPos > 320) {
53.     pSprite->xPos = -1L * pSprite->apImages[pSprite->Index]->XSize;
54.   }
55.   if (pSprite->xPos < -1L * pSprite->apImages[pSprite->Index]->XSize) {
56.     pSprite->xPos = 320;
57.   }
58.   //
59.   // Adjust Y-position
60.   //
61.   pSprite->yPos += pSprite->dy;  (5)
62.   if (pSprite->yPos < 0) {
63.     pSprite->dy = -pSprite->dy;
64.   }
65.   if (pSprite->yPos > (240 - pSprite->apImages[pSprite->Index]->YSize)) {
66.     pSprite->dy = -1 * pSprite->dy;
67.   }
68.   //
69.   // Change sprite
70.   //(6)
71.   GUI_SPRITE_SetBitmapAndPosition(pSprite->hSprite, pSprite->apImages[pSprite->Index], pSprite->xPos, pSprite->yPos);
72. }
74. /*********************************************************************
75. *
76. *       _ShowSprites
77. */
78. static void _ShowSprites(void) {
79.   unsigned i;
81.   //
82.   // Create the sprites
83.   //
84.   for (i = 0; i < GUI_COUNTOF(_aSprite); i++) {  (7)
85.     _aSprite[i].hSprite = GUI_SPRITE_Create(_aSprite[i].apImages[0], _aSprite[i].xPos, _aSprite[i].yPos);
86.   }
87.   //
88.   // Move them forever...
89.   //
90.   while (1) {
91.     for (i = 0; i < GUI_COUNTOF(_aSprite); i++) {
92.       _MoveSprite(&_aSprite[i]);
93.       GUI_Delay(100);
94.     }
95.   }
96. }
98. /*********************************************************************
99. *
100. *       _DrawBackground
101. */
102. static void _DrawBackground(void) {
103.   GUI_DrawGradientV(0, 0, 319, 239, 0xffffff, 0xff0000);  // Draw background gradient
104.   GUI_SetTextMode(GUI_TM_TRANS);
105.   GUI_SetFont(&GUI_Font24B_ASCII);
106.   GUI_SetColor(GUI_BLACK);
107.   GUI_DispStringHCenterAt("Showing sprites...", 160, 20); // Draw sample text
108.   GUI_DrawBitmap(&bmSeggerLogoLarge, 60, 80);             // Draw company logo
109. }
111. /*********************************************************************
112. *
113. *       Public code
114. *
115. **********************************************************************
116. */
117. /*********************************************************************
118. *
119. *       MainTask
120. */
121. void MainTask(void) {
122.   GUI_Init();        // Initialize emWin
123.   _DrawBackground(); // Draw background
124.   _ShowSprites();    // Show sprites
125. }

复制代码

1. 这里面的5个位图是用于sprite显示的，通过这5张图的切换实现动态效果。Sprite对位图的要求如下：
   n 不得压缩。
   n 必须透明。
   n 应是基于调色板的位置，为1、2、4或8bpp。
    这个要求跟前面讲的游标是一样的。
2. 和上面讲的一样。
3. 实现5幅sprite图的切换。
4. 调整sprite显示的X轴位置。
5. 调整sprite显示的Y轴位置。
6. 显示sprite。
7. 创建sprite。
    实际显示效果如下：

25.3 总结
   本期教程有一个问题还没有解决，就是如何生成这种8bpp还带透明的图片数据，这个问题有待解决。