特别说明：完整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. *
   ( D; x" ?) u+ S) n4 @
3. *       Dolphin bitmap arrays
   2 `. c$ I  [. @* c
4. */
   0 O, u6 y. w6 _' h4 z# q  D, D
5. GUI_CONST_STORAGE GUI_BITMAP * _apImages_0[] = {(1)
   
6. &bmDolphin_00,
   % y/ t( _( \) ~2 I. x7 M
7. &bmDolphin_01,
   3 t! x3 i" n) ~/ ?* C* g  ~  n+ @
8. &bmDolphin_02,
   
9. &bmDolphin_03,
   ) Z& @, B0 W7 d. c0 a- t2 x
10. &bmDolphin_04,
    4 \, {# x! v1 c0 ?9 j) N% N
11. };
    
12. 
    
13. GUI_CONST_STORAGE GUI_BITMAP * _apImages_1[] = {   (2)
    
14. &bmDolphin_10,
    / l$ T  z! ?& J8 s5 k& V/ O
15. &bmDolphin_11,
    # ~0 i5 D1 ?7 i& J
16. &bmDolphin_12,
    , O. {( G5 w6 K
17. &bmDolphin_13,
    
18. &bmDolphin_14,
    ) r) J) i4 L9 Z* f
19. };
    
20. 
    - z3 u1 u0 e+ ?- J% }
21. /*********************************************************************
    
22. *
    
23. *       Sprite array
    + `, t. e! q% n1 ]
24. */
    - C/ k1 `  {. e  w
25. static SPRITE _aSprite[] = {
    & d6 r; d0 G5 n
26.   { -90,  20, 10,  3, GUI_COUNTOF(_apImages_1), _apImages_1},
    
27.   { 290, 150, -8, -2, GUI_COUNTOF(_apImages_0), _apImages_0},
    
28. };
    
29. 
    : A+ C6 ]2 S- X/ c% z# t' K
30. /*********************************************************************
    
31. *
    + ^) ~6 O, Y+ V
32. *       Static code
    
33. *
    & ^5 ^0 M* S: e2 E
34. **********************************************************************
    
35. */
    
36. /*********************************************************************
    7 o, d( p1 F0 }3 T5 x
37. *
    & a3 N( q) D0 y* U
38. *       _MoveSprite
    
39. */
    
40. static void _MoveSprite(SPRITE * pSprite) {
    
41.   //
    ' c8 g9 s5 Y' O& b
42.   // Set new index
    8 _6 S1 i1 Y4 q6 [
43.   //
    * n( R- j: X# n9 z$ ~) n6 f, m
44.   pSprite->Index += 1;
    4 X; a! D. S( S
45.   if (pSprite->Index >= pSprite->NumImages) { (3)
    
46.     pSprite->Index = 0;
    
47.   }
    3 O  {5 R5 Y5 n* E' a5 ]& N- o6 ~
48.   //
    
49.   // Adjust X-position
    7 G3 d$ C* ]6 x, v
50.   //
    
51.   pSprite->xPos += pSprite->dx;(4)
    
52.   if (pSprite->xPos > 320) {
    6 R$ ^: l! s7 \) ^* i
53.     pSprite->xPos = -1L * pSprite->apImages[pSprite->Index]->XSize;
    ( E7 [0 t& M" _( s/ O% X/ P
54.   }
    
55.   if (pSprite->xPos < -1L * pSprite->apImages[pSprite->Index]->XSize) {
    
56.     pSprite->xPos = 320;
    + \: I5 D) M5 Y
57.   }
    , f' t: J/ x% i* t
58.   //
    
59.   // Adjust Y-position
    8 @4 Y" `6 w! P# H9 B6 Q
60.   //
    
61.   pSprite->yPos += pSprite->dy;  (5)
    
62.   if (pSprite->yPos < 0) {
    / L% W. E- S6 n" }& {  a
63.     pSprite->dy = -pSprite->dy;
    
64.   }
    6 t! G% F0 {# k  {* I  h
65.   if (pSprite->yPos > (240 - pSprite->apImages[pSprite->Index]->YSize)) {
    
66.     pSprite->dy = -1 * pSprite->dy;
    
67.   }
    7 |; f7 e$ k- |
68.   //
    ; J; y0 L  f' P3 X% z( i
69.   // Change sprite
    5 d$ y4 T; G- T
70.   //(6)
    
71.   GUI_SPRITE_SetBitmapAndPosition(pSprite->hSprite, pSprite->apImages[pSprite->Index], pSprite->xPos, pSprite->yPos);
    $ L4 Z" d6 d+ m8 B; u- B; A
72. }
    
73. 
    4 g5 ^& \% m6 h
74. /*********************************************************************
    
75. *
    
76. *       _ShowSprites
    
77. */
    
78. static void _ShowSprites(void) {
    
79.   unsigned i;
    # P) A( }4 v' ?& _/ O. f3 Z. P8 v
80. 
    3 I+ ~" J: s4 `5 Z% p8 s1 V
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);
    / v7 l# K! U3 |; f! u- L& R; o) p
86.   }
    - q  X  u( |7 Z5 n5 d9 h& e
87.   //
    # C: B) `" ~% y. v7 A- G1 O) r3 S
88.   // Move them forever...
      b; B1 @+ f" U# i- }
89.   //
    # s) Y4 K4 K$ H
90.   while (1) {
    
91.     for (i = 0; i < GUI_COUNTOF(_aSprite); i++) {
    1 s/ P' U1 L( |, u+ [
92.       _MoveSprite(&_aSprite[i]);
    
93.       GUI_Delay(100);
    
94.     }
    $ _5 Y5 Q8 a9 {6 p" I5 y) u
95.   }
    
96. }
    
97. 
    " c) i2 ^. N( g+ Z! m' V* m
98. /*********************************************************************
    9 [: g& |+ k/ {( f5 G, {  \
99. *
    % {! v3 R' S" z1 x; N5 _
100. *       _DrawBackground
     2 f% @3 P# C8 K# C( j+ \
101. */
     / l4 ?# e9 C) l$ M/ R$ v
102. static void _DrawBackground(void) {
     5 _/ u! _6 l/ j. X# {
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);
     . g4 B+ O8 L' x9 Z: r* Q, v
107.   GUI_DispStringHCenterAt("Showing sprites...", 160, 20); // Draw sample text
     
108.   GUI_DrawBitmap(&bmSeggerLogoLarge, 60, 80);             // Draw company logo
     
109. }
     
110. 
     
111. /*********************************************************************
     
112. *
       Y* d: n3 [8 G) e7 L' W
113. *       Public code
     & s/ i/ h7 i5 f6 Q* B* K
114. *
     " h3 a' Q0 l& M! w, H/ j) M8 F, b
115. **********************************************************************
     , S4 c& ~, k+ s; y
116. */
     
117. /*********************************************************************
     
118. *
     $ o8 [; M( x+ ?1 {8 B7 Z# R! v
119. *       MainTask
     
120. */
     - w- A( b" z( n1 Q/ L! F
121. void MainTask(void) {
     
122.   GUI_Init();        // Initialize emWin
     1 u/ P" G4 ~2 j7 f% f
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还带透明的图片数据，这个问题有待解决。

& U$ U" E) ^8 P" b  r6 x. F+ ?$ L, U2 C