Extends the Runtime-TextureAtlas library and allows it to be exported as a file. This tool requires Love2d to work, but the resulting files are not tied to Love2D. Use a custom template to change the format of the quads file to how you want it. See -template <filepath> argument on how to create your own export template, or just use the default one provided.
This tool can be fused similarly to any other love project. Follow these instructions for your platform. Note, all arguments will work the same, but love . <args>/love <ETA dir> <args> will become fused.exe <args>, etc.
Note, the default maxSize of the atlas is 16,384. You can increase or decrease this using the argument -maxSize <width> <height>
git clone https://github.com/EngineerSmith/Export-TextureAtlas --recurse-submodules
love . ./bin/in/ ./bin/out/ -removeFileExtension -extrude 1 -padding 1
love . ./bin/in/ ./bin/out/ -removeFileExtension -extrude 1 -padding 1 -fixedSize 16 16 -template ./bin/template.lua
love . ./bin/in/ ./bin/out/ -removeFileExtension -padding 2 -template ./bin/template.json
love . -input ./bin/in/ ./bin/in2/ -output ./bin/out/atlases/ -padding 2 -template ./bin/template.json
Must be one or equal number of output directories. Directories must end in / or they will be mistaken as a file name.
love . -input ./bin/in/ ./bin/in2/ -output ./bin/out/atlas1.png ./bin/out/atlas2.png
You can define the name of the atlas, if you do equal number of directories to output.
love . -input ./bin/in/ -output ./assets/atlas/image.png -dataOutput ./assets/atlas/data.json -template ./bin/in/template.json -padding 1 -extrude 1 -removeFileExtension
love . <inputDir> <outputDir> [<...>]
Required argument. Directory must exist; containing all images to add to texture atlas. You can define more than one input directory with the -input flag, if the flag supplies an input <inputDir> is not required.
Note, directory must end with \ or / or neither.
love . ./bin/in <outputDir>
love . ./assets/images/ <outputDir>
love . C:\user\Santa\game\assets\images\ <outputDir>
Required argument. The directory doesn't need to exist, once ran it will overwrite files and (hopefully) output the files within as atlas.png and data.<template extension>. If the flag -output is supplied <outputDir> is not required. If the given path is to a file, then it will name the outputted texture atlas that file, whilst the data file will be called data.<template extension>, if mulitple input and output directories are given, it will then append a number to make it a unique file. E.g. data1.lua, data2.lua, data3.png. The same happens to atlas if only one output directory is defined, but atlas is appended in place of data. E.g. atlas1.png, atlas2.png, atlas3.png
Note, file must end with an extension, otherwise it will be treated as a directory.
love . <inputDir> ./bin/out
love . <inputDir> ./assets/textureAtlas/
love . <inputDir> C:\user\Santa\game\assets\textureAtlas\
love . -input <dir1> <dir2> -output ./bin/out -> atlas1.png+data1.lua, atlas2.png+data2.lua
love . -input <dir1> <dir2> <dir3> -output ./bin/out/imageA ./bin/out/imageB.png ./bin/out/imageC.banana -> imageA/atlas1.png+imageA/data1.lua, imageB.png+data2.lua, imageC.banana+data3.lua
Note, that image3.banana will be encoded as a png file.
Optional. Where the data file is saved that is generated from the given template or the default template. If a directory is given, it will be called data.<template extension> (if there are multiple input directories then a number will be added as a prefix).
Note, file must end with an extension, otherwise it will be treated as a directory.
love . <inputDir> <outputDir> -dataOutput ./bin/quads.lua
love . -input <dir1> <dir2> -output <dir3> <dir4> -dataOutput ./bin/quadData
love . -input <dir1> <dir2> -output <dir3> -dataOutput <dir3>/dir1.lua <dir3>/dir2.lua
Optional. Padding between images on the atlas, defaults to 1. Will throw a handled error if it cannot be converted to a number.
Note, it cannot be a negative, otherwise it will be mistaken as an argument. This value does not get added onto the exported quad, but does shift its location on the atlas.
love . <inputDir> <outputDir> -padding 1
love . <inputDir> <outputDir> -padding 12
Optional. Extrudes the given image on the atlas, defaults to 0. Will throw a handled error if it cannot be converted to a number. It will use the clamp warp mode.
Note, it cannot be a negative, otherwise it will be mistaken as an argument. This value does not get added onto the exported quad, but does shift its location on the atlas.
love . <inputDir> <outputDir> -extrude 1
love . <inputDir> <outputDir> -extrude 16
Optional. Adds spacing between images on the atlas, does not add spacing between an image and the edge of the atlas.
Note, it cannot be a negative, otherwise it will be mistaken as an argument. This value does not get added onto the exported quad, but does shift its location on the atlas.
love . <inputDir> <outputDir> -spacing 1
love . <inputDir> <outputDir> -spacing 5
Optional. Uses a fixed size atlas from Runtime-TextureAtlas. All given images in a directory must be the same size. height is an optional value and will default to the required width value.
love . <inputDir> <outputDir> -fixedSize 16
love . <inputDir> <outputDir> -fixedSize 16 32
Optional. This argument will round the width and height of the atlas to the nearest power of 2 value. Note, the packing algorithms are not designed to pack to the nearest power of two, and so you may be left with additional empty space. PNG encoding used shouldn't add too much overhead to this from testing.
love . <inputDir> <outputDir> -pow2
Set the max size the atlas is allowed to reach. Must be greater than 0. If height is excluded, it will be set to the default max size of 16,384
love . <inputDir> <outputDir> -maxSize 100 100
love . <inputDir> <outputDir> -maxSize 1000
Optional. Skip a directory or a file path from being added or searched through to the texture atlas. Can use wild cards.
love . <inputDir> <outputDir> -ignore ./foo/
love . <inputDir> <outputDir> -ignore *.png
love . <inputDir> <outputDir> -ignore ./foo/ ./bar/ *.tga
Optional. This argument will remove image file extension for their given id. This could clash and overwrite other quads if you have the same image name with different extensions.
foo/bar.png becomes foo/bar
love . <inputDir> <outputDir> -removeFileExtension
Optional. This overrides the default internal templated. See Lustache for how to create a template.
Note, the file extension of the template is used to sign the file. E.g. template.lua -> quads.lua, template.json -> quads.json
The default(lua table) is as followed, and contains all available variables:
return {
quads = {
{{#quads}}
["{{{id}}}"] = {
x = {{x}},
y = {{y}},
w = {{w}},
h = {{h}}
}{{^last}},{{/last}}
{{/quads}}
},
meta = {
padding = {{meta.padding}},
extrude = {{meta.extrude}},
atlasWidth = {{meta.width}},
atlasHeight = {{meta.height}},
quadCount = {{meta.quadCount}}{{#meta.fixedSize}},
fixedSize = {
width = {{width}},
height = {{height}},
}
{{/meta.fixedSize}}
{{^meta.fixedSize}}
{{/meta.fixedSize}}
}
}
Formatted JSON example that could be used:
{
"quads": {
{{#quads}}
"{{{id}}}": {
"x": {{x}},
"y": {{y}},
"w": {{w}},
"h": {{h}}
}{{^last}},{{/last}}
{{/quads}}
},
"meta" = {
"padding": {{meta.padding}},
"extrude": {{meta.extrude}},
"atlasWidth": {{meta.width}},
"atlasHeight": {{meta.height}},
"quadCount": {{meta.quadCount}}{{#meta.fixedSize}},
"fixedSize": {
"width": {{width}},
"height": {{height}}
}
{{/meta.fixedSize}}
{{^meta.fixedSize}}
{{/meta.fixedSize}}
}
}
love . <inputDir> <outputDir> -template ./bin/in/template.lua
love . <inputDir> <outputDir> -template ./assets/textureAtlas/template.json