Processes a directory of Tile Maps, compressing each tile set contained in any map once.

Parameters

args:String[]

args[0]: the input directory containing the tmx/tmj files (and tile sets, and imagelayer imaged relative to the path listed in the tmx file). args[1]: The output directory for the tmx/tmj files, should be empty before running. args[2]: The location of the TiledMap Project File. args[2-5] options

You can either run the TiledMapPacker#main(String[]) method or reference this class in your own project and call this method. If working with libGDX sources, you can also run this file to create a run configuration then export it as a Runnable Jar. To run from a nightly build:

Linux / OS X
java -cp gdx.jar:gdx-natives.jar:gdx-backend-lwjgl.jar:gdx-backend-lwjgl-natives.jar:gdx-tiled-preprocessor.jar:extensions/gdx-tools/gdx-tools.jar com.badlogic.gdx.tiledmappacker.TiledMapPacker inputDir [outputDir] [projectFilePath] [--strip-unused] [--combine-tilesets] [-v]

Windows
java -cp gdx.jar;gdx-natives.jar;gdx-backend-lwjgl.jar;gdx-backend-lwjgl-natives.jar;gdx-tiled-preprocessor.jar;extensions/gdx-tools/gdx-tools.jar com.badlogic.gdx.tiledmappacker.TiledMapPacker inputDir [outputDir] [projectFilePath] [--strip-unused] [--combine-tilesets] [-v]

Keep in mind that this preprocessor will need to load the maps by using the TmxMapLoader or TmjMapLoader loader and this in turn will need a valid OpenGL context to work. Process a directory containing TMX or TMJ map files representing Tiled maps and produce multiple, or a single, TextureAtlas as well as new processed TMX/TMJ map files, correctly referencing the generated TextureAtlas by using the "atlas" custom map property and newly generated image source region names if using imagelayers in your map

Processes a directory of Tiled .tmx or .tmj map files, optionally including subdirectories, and outputs updated map files and a texture atlas. This method is intended for usage from external callers such as build scripts or other Java classes. Keep in mind that this preprocessor will need to load the maps by using the TmxMapLoader or TmjMapLoader loader and this in turn will need a valid OpenGL context to work.

Parameters

texturePackerSettings:TexturePacker.Settings

the Settings used for packing textures (e.g., padding, filtering, etc.)

inputDirPath:String

the path to the directory containing map files (.tmx or .tmj); must not be null or empty

outputDirPath:String

optional path where processed map files and the atlas will be written; if empty or null, defaults to "../output/" relative to input

prjtFilePath:String

optional path to a Tiled project file, used when maps require loading a custom tiled project file can be left "" or null

Exceptions

IOException:

if a file cannot be read or written

IllegalArgumentException:

if inputDirPath is null or blank