Relintai/texture_packer
1
0
Fork 0
mirror of https://github.com/Relintai/texture_packer.git synced 2024-11-12 10:15:16 +01:00
Code Issues Packages Projects Releases Wiki Activity
A c++ Godot engine module, to layer, pack, and merge textures at runtime.
33 Commits 2 Branches 0 Tags 151 KiB
C++ 97.8%
C 1.8%
Python 0.4%
92e35aa199
Go to file
Relintai 92e35aa199 Readme.md.
2019-10-22 16:56:22 +02:00
doc_classes Docs setup. 2019-10-22 02:10:35 +02:00
rectpack2D Implemented reference counting. 2019-10-21 23:18:06 +02:00
texture_resource Fixed bindings, and now the importers work. The Merger can use this Texture type by default. 2019-10-22 15:09:47 +02:00
.gitignore Initial Skeleton. 2019-10-20 21:19:00 +02:00
config.py Docs setup. 2019-10-22 02:10:35 +02:00
LICENSE Initial commit 2019-10-20 21:04:56 +02:00
README.md Readme.md. 2019-10-22 16:56:22 +02:00
register_types.cpp Added the new resource, and it's importer to the build, and fixed compile. 2019-10-22 11:53:49 +02:00
register_types.h Renamed the module to texture_packer. 2019-10-21 21:05:02 +02:00
SCsub Added the new resource, and it's importer to the build, and fixed compile. 2019-10-22 11:53:49 +02:00
texture_merger.cpp Added missing editor_hint check. 2019-10-22 01:07:53 +02:00
texture_merger.h Added missing editor_hint check. 2019-10-22 01:07:53 +02:00
texture_packer.cpp Added a variant vector binding to TextureMerger. It will merge all textures on set. Added contains_texture to TexturePacker. Logic fixes in querying textures in TexturePacker. 2019-10-22 00:52:59 +02:00
texture_packer.h Added a variant vector binding to TextureMerger. It will merge all textures on set. Added contains_texture to TexturePacker. Logic fixes in querying textures in TexturePacker. 2019-10-22 00:52:59 +02:00

README.md

Texture Packer for the Godot Engine

This is a texture packer engine module, for the Godot Engine.

Internally it uses the legacy version of rectpack2D. (https://github.com/TeamHypersomnia/rectpack2D)

Building

  1. Get the source code for the Godot Engine.

  2. go into Godot's modules directory.

cd godot/modules/

  1. clone this repository

git clone https://github.com/Relintai/texture_packer texture_packer

  1. Build Godot. (https://docs.godotengine.org/en/latest/development/compiling/index.html)

Features and Usage

The module contains:

TexturePacker

This is the class that can merge textures. Add every thexture xou want into it using it's API, and then call merge().

Supports filters, custom background color, margins.

The keep_original_atlases option:

If you set this to true, and then add AtlasTextures, TexturePacker will change the added ones after the bake. You can use this for example to bake gui textures together, without changing the resources everywhere at runtime.

Note: I only recommend using this if your ui textures change during runtime, if they don't just make an atlas yourself.

TextureMerger

A Node that can bake textures for you. It uses TexturePacker internally.

PackerImageResource

This is a simple Texture, which just cuntains an imported Image.

Useful for textures you only keep for baking, as this class will not register it's data into the VisualServer.

The module also contains an editor plugin which can import textures as this Resource.

To access it, click on a texture, switch to the import tab, and in the "Import As" Dropdown, select "Packer Image Recource".