! IMPORTANT ! This is a PopcornFX v1 page. PopcornFX v2 documentation can be found here

Overview

The atlas builder is the tool used to generate Popcorn's atlas files.
It currently can't be launched directly from the main popcorn editor.

You can find it alongside "PK-Editor.exe", for example in: "C:\Program Files (x86)\Persistant Studios\PopcornFx\Binaries_Release\AtlasBuilder.exe"

Atlas definition format, pkat files

The atlas definition files (.pkat files) are simple text files, usually with the same name as the atlas texture, with a .pkat extension, and contain:

one line per sub-texture
4 values per line, separated by commas
the decimal point is a dot, not a comma
the values are normalized texture coordinates, between 0.0 and 1.0
the values are in the following order: left corner, top corner, right corner, bottom corner

for example, for a 2*2 texture atlas containing 4 equal-sized squared textures, the atlas definition file would look like:

0, 0, 0.5, 0.5
0.5, 0, 1, 0.5
0, 0.5, 0.5, 1
0.5, 0.5, 1, 1

Of course, the sub-rectangles can be anything, the whole texture doesn't have to be covered entirely either:

0,     0, 0.333, 0.5
0.333, 0, 0.667, 0.5
0.667, 0, 1,     0.5

Right-click Save As:

...

Atlas_32x32.pkat