textureAtlasTools

A set of tools for slicing a texture atlas to individual components and merging back

Description

These tools simplify the approach for upscaling a texture atlas. The workflow would be something like this:

• manually select some tiles in the texture atlas (that are placed in difficult positions)
• add them to a json file following this pattern: json file; you can use any image editing tool such as GIMP to manually select and inspect the location, width and height of each selection
• run the tool with the split; this will automatically create a folder with separate files from the selections, as well a [basefilename]_sliced.png file containing the texture without the sliced files
• manually upscale all the resulting files with the correct transparency / seamless mode, including the [basefilename]_sliced.png from the previous step. it is important to use the same scale factor for all the files. you can leave some of the files unscaled (including the basefile), in this case they will be automatically scaled using nearest neighbor filtering
• run the tool with the merge action; this will automatically add back the separated upscaled tiles to the upscaled texture atlas. [basefilename]_final.png will be created

Tips & tricks

• the slices can have any suffix in the filename, such as 8x8@128x16-4x_UltraFArt_v3_Fine.png; this filename will take precedence over the default 8x8@128x16.png
• there can be multiple upscaled versions; the last slice with the last alphabetical filename will be loaded

TODO

• proper error handling
• code cleanup
• automatically detect the proper scale factor
• automatically generate the slicing .json file. or, at least try to

Use it at your own risk