Differences

This shows you the differences between two versions of the page.

--- development:aseprite [2023/08/29 17:35] – clyde
+++ development:aseprite [2023/12/17 18:52] (current) – [Using the SDK] clyde
@@ Line 66: / Line 66: @@
 ===== Using the SDK =====
-This section will cover the workflow to prepare sprite files for games made with the [[https://github.com/clydeshaffer/gametank_sdk|GameTank SDK]]. The SDK includes scripts that perform the flipping and clipping of your BMP files for you, as well as compressing the data and generating macros you can use in your code to load the images into Sprite RAM.
+The GameTank SDK includes scripts for automatically converting and compressing your image files using Zopfli.
-Additionally, the SDK supports frame data that can be exported along with your sprite sheets. This has the benefit of leveraging Aseprite's packing features to store animation frames of different sizes efficiently.
+This section will cover the settings and export options needed to take full advantage of the SDK's conversion script and animation API.
-{{ :development:tbc.png?nolink&200 |}}
+{{ :development:screenshot_2023-12-17_132035.png?400|}}
+The SDK supports animated sequences as packed sprite sheets that don't need to be aligned to a grid, using a framedata file exported alongside the bitmap.
+The canvas on the source file can be as big as your largest animation frame needs to be, and the export/conversion process will handle trimming individual frames. The center of the canvas will be treated as the pivot point for your sprite across its animation frames. You should keep the .ase or .aseprite original file separate from the asset folder you'll be exporting to. A good place for this would be to create an "art" folder in your project and store it there.
+The export dialog we'll use is "Export Sprite Sheet" under the File -> Export submenu.
+{{:development:screenshot_2023-12-17_133151.png?400|}}
+On the Layout tab, sheet type should be set to "Packed" and the constraints set to "Fixed Width" for 128px.  The total height should end up smaller than 128px.
+{{:development:screenshot_2023-12-17_132355.png?400|}}
+On the Borders tab select Trim Cels to pack the frames based on their bounding box size, taking transparent areas into account.
+{{:development:screenshot_2023-12-17_132430.png?400|}}
+{{ :development:screenshot_2023-12-17_132441.png?400|}}
+Finally on the Output tab check the Output File and JSON Data boxes. Make sure that the image output file is a BMP instead of the PNG default. In your SDK project save this into a subfolder of the "assets" folder, such as "assets/player/chara_hero.bmp".
+The JSON file should be saved in the same folder as the BMP. It can have any name, but generally using the same name apart from the .json extension will make it easier to remember the two files are associated.
+The drop down should be switched from "Hash" to "Array".
+{{:development:screenshot_2023-12-17_132519.png?400|}}
+After adding, removing, moving, or resizing files in the assets folder use the <code>make import</code> command to update your project.