yaap/README.md

1.5 KiB

YAAP

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

Since we need to download/compile some 3rd party dependencies in the vendors folder we need to call scripts/setup.[sh|bat] to compile libtinydialog & download the already compiled clay binaries and bindings.

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 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 for the image packing & raylib for the UI.

A quick preview on youtube.

Dependencies

  • odin-aseprite github
  • raylib (vendor/raylib, link)
  • stb_rect_pack (vendor/stb/rect_pack, link)