https://github.com/crashinvaders/gdx-texture-packer-gui
A simple way to pack and manage texture atlases for libGDX game framework.
https://github.com/crashinvaders/gdx-texture-packer-gui
libgdx texture-atlas texture-packing texturepacker utility
Last synced: 11 days ago
JSON representation
A simple way to pack and manage texture atlases for libGDX game framework.
- Host: GitHub
- URL: https://github.com/crashinvaders/gdx-texture-packer-gui
- Owner: crashinvaders
- License: apache-2.0
- Created: 2016-08-16T13:33:22.000Z (over 8 years ago)
- Default Branch: master
- Last Pushed: 2024-08-09T12:17:06.000Z (8 months ago)
- Last Synced: 2025-03-28T11:08:22.409Z (18 days ago)
- Topics: libgdx, texture-atlas, texture-packing, texturepacker, utility
- Language: Java
- Homepage:
- Size: 23.9 MB
- Stars: 638
- Watchers: 21
- Forks: 76
- Open Issues: 14
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGES.md
- License: LICENSE
Awesome Lists containing this project
- awesome-libgdx - Texture Packer GUI - A simple way to pack and manage texture atlases for libGDX game framework. (Resources / Others)
README
A simple utility to help you pack and manage texture atlases for [libGDX game framework](https://github.com/libgdx/libgdx).
It's mostly just a visual wrapper over [libGDX TexturePacker](https://libgdx.com/wiki/tools/texture-packer)
and provides some extra features.
This project is a successor of [Aurelien Ribon's application](https://web.archive.org/web/20170803205402/http://www.aurelienribon.com/blog/2012/06/texturepacker-gui-support-for-multiple-packs/) with the whole new GUI and features.
### Using the App
Just download the most recent version of the installer/distribution matching your OS from the [releases page](https://github.com/crashinvaders/gdx-texture-packer-gui/releases) and follow the installer instructions.
Or simply download the distribution files archive, extract, and read `./readme.txt` for further details.
### System Requirements
The app works on any major desktop OS (Linux, macOS, Windows), where Java is available.
The requirements are as follows:
1. Java Runtime Environment (JRE 8.0 and up) should be installed on your system (`java` command is available from the command-line interface).
2. OpenGL (2.0 and up) compatible video drivers.
All major changes are listed in [this file](https://github.com/crashinvaders/gdx-texture-packer-gui/blob/master/CHANGES).
### Command Line
The app has a headless batch mode that allows automation.
For example, to pack a specific atlas from the project:
```shell
gdx-texture-packer --batch --project "/path/to/project.tpproj" --atlases "atlas_name" "another_atlas_name"
```
Here's a tool to compress any PNG/JPEG image to a KTX2/Basis texture.
```shell
gdx-texture-packer --basis-pack --container ktx2 --format uastc "/path/to/any.png|jpg"
```
Learn more about CLI options from the help message:
```shell
gdx-texture-packer --help
```
### Backlog
See what features are currently planned on the project's [Trello board](https://trello.com/b/mugauAoC)
### Releases
New versions come out when the application gets significant new features or important fixes.
You can see all available versions from the [releases page](https://github.com/crashinvaders/gdx-texture-packer-gui/releases).
### Contribution and Contact
Contributions are highly appreciated. You can help either by making a PR or reporting bugs/suggestions by creating new issues.
If you have any questions/ideas, and you think they don't fit the standard GitHub issue format, you are always welcome to contact me directly at [email protected]
Also, you can participate in translation. It can be done by translating all the strings in [bundle.properties](https://github.com/crashinvaders/gdx-texture-packer-gui/blob/master/assets/i18n/bundle.properties) and saving a copy as bundle_XX.properties, where XX is your language code.