bersk/yaap
1
0
Fork 0
Code Issues Pull requests Projects Releases Wiki Activity

Update dependencies, refresh README.md, add build scripts for linux(& macos?)

Browse source
This commit is contained in:
Stefan Stefanov 2026-01-02 15:06:34 +02:00
parent 3f1c523ad9
commit faf42da522
12 changed files with 53 additions and 158 deletions
Download patch file Download diff file Expand all files Collapse all files

31
README.md
View file

@ -1,20 +1,29 @@
# YAAP
Yet-Another-Atlas-Packer by Stefan Stefanov
Yet-Another-Atlas-Packer by bersK (Stefan Stefanov)
## Usage & requirements
> [!IMPORTANT]
> Pull this repo with `--recursive`, the `odin-aseprite` library is pulled in as a submodule.
* At least odin compiler version `dev-2025-07:204edd0fc`
* Build the `libtinyfiledialog` library in the `vendors/dialog` fold
## Description
> [!NOTE]
> Quite frankly if you want automatic atlas packing I would suggest using `stb_rect_pack` directly & an aseprite plugin for exporting your assets in a proper format for packing. Using this atlas packer in an automated fashion is not quite possible and slower as a workflow. I would only use it for experiment projects or places where having a built in atlas packer is not practical.
Simple atlas packer for .aseprite files. Generates metadata and potentially embeds in an output source file of your choosing.
Simple atlas packer for `.aseprite` files. Generates a packed png & metadata in the form of json and/or source files(cpp, odin, etc...).
> [!CAUTION]
> Does not handle palette files currently.
Uses `stb_rect_pack` from the `stb` family of header libraries & `raylib` for rendering/UI. Here's a quick preview on [youtube](https://youtu.be/4_dKq7G57Lw) of the application.
Uses `stb_rect_pack` for the image packing & `raylib` for the UI.
<a href="https://youtu.be/4_dKq7G57Lw">
<img src="https://raw.githubusercontent.com/bersK/yaap/master/repo_assets/image.png" />
<a/>
A quick preview on [youtube](https://youtu.be/4_dKq7G57Lw).
The goal of the tool is to take in multiple aseprite files and pack them into a single atlas, outputting metadata in the process in the form of
JSON and/or source files for direct use in odin (or other languages through a customization file).
<img src="https://raw.githubusercontent.com/bersK/yaap/master/repo_assets/image.png" />
I'm using a library for marshalling the aseprite files found [here](https://github.com/blob1807/odin-aseprite) on github.
Project template provided by Karl Zylinski found [here](https://github.com/karl-zylinski/odin-raylib-hot-reload-game-template) on github.
## Dependencies
* odin-aseprite [github](https://github.com/blob1807/odin-aseprite)
* raylib (`vendor/raylib`, [link](https://github.com/odin-lang/Odin/tree/master/vendor/raylib))
* stb_rect_pack (`vendor/stb/rect_pack`, [link](https://github.com/odin-lang/Odin/tree/master/vendor/stb/rect_pack))