TexturePacker导出大图plist的工具

code'n'web – TexturePacker

TexturePacker(Pro) Manual

Table of Contents

TexturePacker(Pro) Manual................................................................................................... 1

Overview................................................................................................................................ 3

TexturePackerPro vs TexturePacker................................................................................. 3

Supported operating systems................................................................................................ 4

Installation.............................................................................................................................. 4

Batch conversion of sprites....................................................................................................6

Options...................................................................................................................................6

Specifying a layout algorithm (--algorithm)........................................................................6

Basic.................................................................................................................................. 6

MaxRects........................................................................................................................... 7

Specifying input files.......................................................................................................... 7

Smartfolders.......................................................................................................................7

Ignoring image files (--ignore-files <regexp>)....................................................................8

Removing .png and other file extensions from sprite names (--trim-sprite-names ).........8

Renaming (parts) of sprite names (--replace <rx>=<str>).................................................8

Choosing scale mode (--scale-mode <int>).....................................................................11

Creating hd and sd sheets in one run (--auto-sd)............................................................13

Trimming (--no-trim, --trim, --trim-threshold <int> )..........................................................13

© 2010 by Andreas Löw / www.code-and-web.de

code'n'web – TexturePacker

Cropping (--crop).............................................................................................................. 14

Creating heuristic masks (--heuristic-mask).................................................................... 14

Rotation (--enable-rotation, --disable-rotation)................................................................ 14

Padding............................................................................................................................15

Shape padding (--shape-padding <int>)..................................................................... 15

Border padding (--border-padding <int>).................................................................... 15

(--background-color <rrggbb>)........................................................................................ 18

Extruding (--extrude <int>)...............................................................................................18

Settings JPG quality (--jpg-quality <value>).................................................................... 19

Flipping PVR images (unity framework) –flip-pvr............................................................ 19

Testing sprites (--shape-debug).......................................................................................19

Other features...................................................................................................................... 20

Aliases............................................................................................................................. 20

............................................................................................................................................. 20

Disabling aliases (--disable-auto-alias)................................................................................20

This option disables alias creation. This option was added to keep all animation phases

Submitting bug reports.........................................................................................................32

Uninstall................................................................................................................................32

Thanks..................................................................................................................................33

Other stuff.............................................................................................................................33

© 2010 by Andreas Löw / www.code-and-web.de

code'n'web – TexturePacker

Overview

TexturePacker is a command line tool to create sprite sheets or sprite atlases without

manual interaction! Without specifying any additional options TexturePacker already

creates very good results.. But you also have enough options available to adjust things to

your needs.

Main features:

• On-The-Fly rescaling

• Robust

• Fast

• Extruding sprites for flicker free tile maps

• Automatic creation of aliases for identical images

• Smart folders for simpler updating

• Drag'n'drop sprites from finder

• Xcode integration

TexturePackerPro vs TexturePacker

TexturePackerPro and TexturePacker are the same application. The only difference is that

© 2010 by Andreas Löw / www.code-and-web.de

code'n'web – TexturePacker

demand for Windows.

Linux build are made on demand.

Installation

To install TexturePacker simply start the TexturePacker.pkg. It will install the main program

in Applications and a link for easy use in /usr/local/bin/TexturePacker.

TexturePacker and TexturePackerPro are identical software. The license destinguishes

between both versions. If you own a TexturePacker license you can test the graphical user

interface in demo mode.

TexturePacker licenses can be upgraded to TexturePackerPro.

functions are available but not extended features like image optimization or other

algorithms than Basic.

Installation of a license file

To install the license file open a shell and execute:

© 2010 by Andreas Löw / www.code-and-web.de

code'n'web – TexturePacker

The license file will be copied to

The license can also be installed using the Graphical User Interface. TexturePacker

prompts for a license if none is installed. You can also go to the Preferences menu to enter

a new license.

TexturePacker reads all png files in the assets folder and creates the texture with the

minimum area using all its default settings. Output is written to out.png and out.plist.

Help (--help)

You can get a list with all commands and information by using --help or simply calling

TexturePacker with no arguments.

If a command in this documentation does not work (due to e.g. a typo) please check with

--help.

Edit with GUI, export from Commandline

Users of TexturePackerPro can edit their sheets and save the settigns as *.tps files. You

can now update the sheets from command line by calling

© 2010 by Andreas Löw / www.code-and-web.de