Bài 2 : Entity - Làm việc với Sprite

Sprite là một phần mở rộng của Entity (xem bài mở đâu). Thường được dùng để vẽ các bức ảnh tỉnh lên scene. Bài này mình sẽ hướng dẫn cách vẽ một sprite lên scene và các phương thức thường dùng của nó.
Download ảnh bên dưới và copy vào thư mục assets trong project.

Lấy ví dụ ở bài hướng dẫn trước .Đầu tiên, mình sẽ load resources của sprite mà mình muốn vẽ như sau :
- Khởi tạo 2 biến

1. private BitmapTextureAtlas mBitmapTextureAtlas;
2. private ITextureRegion mPlayerTextureRegion;

    -BitmapTextureAtlas đinh nghĩa một vùng kết cấu hình chữ nhật với chiều dài và chiều rộng xác định. TextureRegion đinh nghĩa cụ thể hình ảnh được hiển thị trong BitmapTextureAtlas  . Bạn có thể hiểu BitmapTextureAtlas giống như một cái hộp, và TextureRegion là vật màn trong cái hộp đó. Vì vậy TextureRegion không thể có kích thước lớn hơn BitmapTextureAtlas. Vì vậy kích thước hình ảnh mà bạn định nghĩa trong TextureRegion phải bé hơn kích thước của BitmapTextureAtlas.
    - Trong phương thức onCreateResources khởi tạo các biến như sau:

1. mBitmapTextureAtlas = new BitmapTextureAtlas(this.getTextureManager(), 214, 320);
2. //214 chiều rộng + độ cao của ảnh
3. mPlayerTextureRegion = BitmapTextureAtlasTextureRegionFactory.createFromAsset(this.mBitmapTextureAtlas, this, "minion.png", 0, 0);
4.  mBitmapTextureAtlas.load();

Lưu ý : 0,0 tọa độ được vẽ trên BitmapTextureAtlas. Bạn có thể hình dung như sau :

     - Màu đỏ là vùng được BitmapTextureAtlas định nghĩa. Màu vàng là vùng TextureRegion được hiển thị theo các tọa độ khác nhau.

Nếu bạn đặt ảnh trong folder con của assets thêm phương thức sau để xác định đường dẫn cho anh :

1. BitmapTextureAtlasTextureRegionFactory
2. .setAssetBasePath("path");

Sau khi đã load texture tạo một đối tượng Sprite .Có rất nhiều contructor cho bạn lựa chọn mình thường tạo Sprite sử dụng contructor như sau:

1. Sprite image = new Sprite(0, 0, mPlayerTextureRegion, mEngine.getVertexBufferObjectManager());

Và vẽ ảnh này lên scene:

1. currentScene.attachChild(image);

Sau đây mình liệt kê một số phương thức thường dùng để hỗ trợ trong việc vẽ sprite lên scene :
- setPosition : set theo vị trí của Entity khác hoặc theo tọa độ x,y.
- setAlpha : chỉnh độ trong suốt .
- setScale : phóng to, thu nhỏ.
- setFlipped : lật ảnh 180 độ theo chiều x và y.
- setSize : chỉnh size của sprite.
- setVisible : ẩn hoặc hiển thị sprite.
- setZIndex : chỉnh vị trí sprite theo tọa độ Z khá quan trong khi bạn làm với nhiều layer.

Sau đây là toàn bộ code sau khi hoàn thành :

1. public class  MyGameActivity extends BaseGameActivity {
2. private Camera mCamera;// tạo camera, lưu ý camera không thể thay đổi
3. private int CAMERA_HEIGHT = 720;// khai báo chiều cao cho camera
4. private int CAMERA_WIDTH = 480;// khai báo chiều dọc cho camera
5. private BitmapTextureAtlas mBitmapTextureAtlas;
6. private ITextureRegion mPlayerTextureRegion;
7. 
   
8. @Override
9. public EngineOptions onCreateEngineOptions() {
10. // Cài đặt EngineOptions với 1 camera. Ngoài ra bạn có thể tùy chọn có
11. // music,sound hay có Multi Touch
12. 
    
13. mCamera = new BoundCamera(0, 0, CAMERA_WIDTH, CAMERA_HEIGHT);
14. EngineOptions eni = new EngineOptions(true,
15. ScreenOrientation.PORTRAIT_SENSOR, new FillResolutionPolicy(),
16. this.mCamera); // set fullscreen = true , theo chiều dọc =
17. // PORTRAIT_SENSOR, full màn hình = new
18. // FillResolutionPolicy()
19. eni.getAudioOptions().setNeedsMusic(true);// set game có music
20. eni.getAudioOptions().setNeedsSound(true);// set game có Sound
21. eni.getTouchOptions().setNeedsMultiTouch(true);
22. if (MultiTouch.isSupported(this)) {
23. if (MultiTouch.isSupportedDistinct(this)) {
24. } else {
25. }
26. } else {
27. Toast.makeText(
28. this,
29. "Sorry your device does NOT support MultiTouch!\n\n(Falling back to SingleTouch.)\n\nControls are placed at different vertical locations.",
30. Toast.LENGTH_LONG).show();
31. } // set game co multi touch
32. return eni;
33. }
34. 
    
35. @Override
36. public void onCreateResources(
37. OnCreateResourcesCallback pOnCreateResourcesCallback)
38. throws Exception {
39. mBitmapTextureAtlas = new BitmapTextureAtlas(this.getTextureManager(),
40. 214, 320);
41. // 214 chiều rộng + độ cao của ảnh
42. mPlayerTextureRegion = BitmapTextureAtlasTextureRegionFactory
43. .createFromAsset(this.mBitmapTextureAtlas, this, "minion.png",
44. 0, 0);
45. mBitmapTextureAtlas.load();
46. // Tạo tất cả các Resources. Load các Resourt như ảnh, font chữ,
47. // music,sound.
48. // Phần này mình sẽ hướng dẫn ở các bài sau. Thêm câu lệnh sau
49. pOnCreateResourcesCallback.onCreateResourcesFinished();
50. }
51. 
    
52. @Override
53. public void onCreateScene(OnCreateSceneCallback pOnCreateSceneCallback)
54. throws Exception {
55. // Tạo scene và attach các thứ mà bạn vẽ vào scene
56. Sprite image = new Sprite(0, 0, mPlayerTextureRegion,
57. mEngine.getVertexBufferObjectManager());
58. Scene currentScene = new Scene();
59. currentScene.attachChild(image);
60. pOnCreateSceneCallback.onCreateSceneFinished(currentScene);
61. }
62. 
    
63. @Override
64. public void onPopulateScene(Scene pScene,
65. OnPopulateSceneCallback pOnPopulateSceneCallback) throws Exception {
66. // Attach các thứ mà bạn thường xuyên hiển thị trên Scene.
67. pOnPopulateSceneCallback.onPopulateSceneFinished();
68. }
69. }