Differences

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

--- development:aseprite [2023/08/29 16:57] – clyde
+++ development:aseprite [2023/12/17 18:52] (current) – [Using the SDK] clyde
@@ Line 52: / Line 52: @@
 {{ :development:flip_v.png?400 |}}
+Next you'll need to extract only a certain number of the last bytes of your BMP file. This certain number is the same as the total number of pixels in your image. So if your image is 128 wide and 128 tall you'll need the last 16384 bytes of the BMP file.
+On Mac and Linux this can be done with a simple terminal command:
+<code Bash>
+tail -c 16384 myfile.bmp > myfile.gtg
+</code>
+In Windows Powershell the command is a bit more verbose but this should be equivalent:
+<code Powershell>
+Get-Content -Path "myfile.bmp" -Encoding Byte | Select-Object -Last 16384 | Set-Content -Path "myfile.gtg" -Encoding Byte
+</code>
+===== Using the SDK =====
+The GameTank SDK includes scripts for automatically converting and compressing your image files using Zopfli.
+This section will cover the settings and export options needed to take full advantage of the SDK's conversion script and animation API.
+{{ :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.