an package to create sprite sheets or sprite atlases
PyTexturePacker is an open source python package, released under the MIT License.
A subset of feature of TexturePacker has been implemented in this package.
MaxRectsBinPack algorithm is used to generate sprite sheet in this package.
MaxRectsBinPack is currently the best packing algorithm. It tries to use the least texture space by applying different heuristics when placing the sprites.
- Best-known algorithm for packing textures
- Is fast and has a high packing ratio
- Enable rotation for best results
Install Pillow with pip:
$ pip install PyTexturePacker
Here comes an example of using PyTexturePacker to pack texture images from a directory.
from PyTexturePacker import Packer def pack_test(): # create a MaxRectsBinPacker packer = Packer.create(max_width=2048, max_height=2048, bg_color=0xffffff00) # pack texture images under directory "test_case/" and name the output images as "test_case". # "%d" in output file name "test_case%d" is a placeholder, which is a multipack index, starting with 0. packer.pack("test_case/", "test_case%d")
The background color of output image. The pixels of the empty area in the output image will be filled with bg_color. The default value is 0x00000000, which is in format of “RGBA”. A tuple of values can also be accepted, like (R, G, B, A).
Choose the texture format that the output file will use, for example “.jpg”. The default texture format is “.png”.
Sets the maximum width for the texture, default is 4096.
Sets the maximum height for the texture, default is 4096.
Allows the rotating of sprites clockwise or counterclockwise by 90 degrees if they have a better fit in the texture. Might not be supported by all game/web frameworks.
Forces the texture to have a squared size.
Border padding is the space between the sprites and the border of the sprite sheet. Value adds transparent pixels around the borders of the sprite sheet. Default is 2.
Shape padding is the space between sprites. Value adds transparent pixels between sprites to avoid artifacts from neighbor sprites. The transparent pixels are not added to the sprites. Default is 2. Use a value of at least 2 to avoid dragging in pixels from neighbor sprites when using OpenGL rendering.
Adds transparent pixels to the inside of the sprite, growing it. Default is 0.
There are two uses for this:
- It can help in preventing cut-off artifacts near the edges of scaled sprites. E.g. if your sprite has a few pixels along its own boundaries, scaling the sprite up or down won’t let these pixels appear as gaps or cuts.
- It considerably reduces aliasing along the polygon edges when rotating trimmed or cropped sprites. E.g. if your sprite has many pixels along its own boundaries, it will be drawn more smoothly when rotating it.
Removes transparent pixels from a sprite’s border. This shrinks the sprite’s size, allows tighter packing of the sheet, and speeds up rendering since transparent pixels don’t need to be processed. Pixels with an alpha value below this value will be considered transparent when trimming the sprite. Allowed values: 0 to 255, default is 0. When it’s set to 0, the trim mode is disabled. Very useful for sprites with nearly invisible alpha pixels at the borders.
Adds color to transparent pixels by repeating a sprite’s outer color values. These color values can reduce artifacts around sprites and removes dark halos at transparent borders. This feature is also known as “Alpha bleeding”.
- Issue Tracker: github.com/wo1fsea/PyTexturePacker/issues
- Source Code: github.com/wo1fsea/PyTexturePacker
Any types of contribution are welcome. Thanks.
If you are having issues, please let us know. Please feel free to contact me. email: firstname.lastname@example.org
The project is released under the terms of MIT License. You may find the content of the license here, or LICENSE.txt inside the project directory.