Tutorial 04b - Sprite2D

Sprite2D - 一個簡化版的顯示方示，用以取代 3D 顯示物件，可以省去許多額外的計算及資源。此物件在場景中，永遠是面對著 Camera 的。舉例來說，天上的星星、水中的魚、森林裡的樹，都可以利用 Sprite2D 來顯示。

重點API：
sandy.util.LoaderQueue
sandy.core.scenegraph.Sprite2D
sandy.events.QueueEvent

1. package
2. {
3. import flash.display.Bitmap;
4. import flash.display.Sprite;
5. import flash.events.Event;
6. import flash.events.KeyboardEvent;
7. import flash.events.MouseEvent;
8. import flash.net.URLRequest;
9. import sandy.core.Scene3D;
10. import sandy.core.scenegraph.Camera3D;
11. import sandy.core.scenegraph.Group;
12. import sandy.core.scenegraph.Sprite2D;
13. import sandy.events.QueueEvent;
14. import sandy.util.LoaderQueue;
15. 
    
16. public class Example004b extends Sprite
17. {
18. private var scene:Scene3D;
19. private var camera:Camera3D;
20. // Utility class for 載入外部資源
21. private var queue:LoaderQueue;
22. /** numTree 將影響 CPU 的效能 **/
23. private var numTree:Number = 50;
25. public function Example004b()
26. {
27. // 產生一 LoaderQueue 物件
28. queue = new LoaderQueue();
29. // 將欲載入資源之Unique名稱及路徑，加入 queue 中
30. queue.add("tree", new URLRequest("asset/tree.gif"));
31. // 為 queue 物件新增監聽事件 - 當資源載入完成時，
32. // 執行 loadComplete Function
33. queue.addEventListener(
34. QueueEvent.QUEUE_COMPLETE,
35. loadComplete);
36. // 為 queue 物件新增監聽事件 - 當載入資源發生錯誤時，
37. // 執行 loadError Function
38. queue.addEventListener(
39. QueueEvent.QUEUE_LOADER_ERROR,
40. loadError);
41. // 開始載入外部資源
42. queue.start();
43. }
44. 
    
45. public function loadComplete(evt:QueueEvent):void
46. {
47. // 產生 Camera3D 物件
48. camera = new Camera3D(600, 300);
49. camera.y = 10;
50. camera.z = -300;
51. 
    
52. // 產生 Group 物件
53. var root:Group = createScene();
54. 
    
55. // 產生 Scene3D 物件，並將 Camera3D 及 Group 加入場景
56. scene = new Scene3D("scene", this, camera, root);
57. // 設定當物件超出場景之外時，將不會被畫出
58. scene.rectClipping = true;
59. 
    
60. addEventListener(Event.ENTER_FRAME,
61. enterFrameHandler);
62. stage.addEventListener(KeyboardEvent.KEY_DOWN,
63. keyPressHandler);
64. stage.addEventListener(MouseEvent.MOUSE_MOVE,
65. mouseMoveHandler);
66. }
67. 
    
68. public function loadError(evt:QueueEvent):void
69. {
70. trace("load resource error");
71. }
72. 
    
73. private function createScene():Group
74. {
75. // 產生根 Group 物件
76. var g:Group = new Group();
77. 
    
78. // 產生 Sprite2D 物件
79. for (var i:Number = 0; i <>
80. {
81. // 將載入 queue 物件中的資源取出
82. var bit:Bitmap =
83. new Bitmap(queue.data["tree"].bitmapData);
84. // 產生 Sprite2D 物件，並設置其參數，分別為
85. // Unique名稱，顯示物件 (DisplayObject) 及 縮放比率
86. var s:Sprite2D = new Sprite2D("tree" + i, bit, 1);
87. // 隨機設定 Sprite2D 的 x, y, z 座標位置
88. s.x = Math.random() * 600 - 300;
89. s.y = 0;
90. s.z = Math.random() * 600;
91. 
    
92. g.addChild(s);
93. }
94. 
    
95. return g;
96. }
98. private function enterFrameHandler(evt:Event):void
99. {
100. scene.render();
101. }
103. private function keyPressHandler(evt:KeyboardEvent):void
104. {
105. // 調整 camera 鏡頭之遠近
106. switch(evt.keyCode)
107. {
108. case KeyboardEvent.KEY_UP:
109. camera.moveForward(5);
110. break;
111. case KeyboardEvent.KEY_DOWN:
112. camera.moveForward( -5);
113. break;
114. }
115. }
117. private function mouseMoveHandler(evt:MouseEvent):void
118. {
119. // 隨滑鼠移動設置 camera 之方向
120. camera.pan = (evt.stageX - 300 / 2) / 10;
121. camera.tilt = (evt.stageY - 300 / 2) / 20;
122. }
123. }
124. }

程式碼出處：http://www.flashsandy.org/tutorials/3.0/sandy_cs3_tut042