ofxTexturePacker

OpenFrameworks addon for loading and rendering sprites and animated sprites generated from CodeAndWeb's TexturePacker application.

What is TexturePacker?

• Allows quick creation of sprite sheets with reference name of the original image
• Optimises rendering speed and memory usage of an App or Game
• Mutli-OS (OSX,Linux,Windows)
• Supports generating sprite sheets for different targets automatically (i.e. retina and non-retina)

What is a Sprite Sheet? http://www.codeandweb.com/what-is-a-sprite-sheet

Get Texture Packer (has free to use version) http://www.codeandweb.com/texturepacker

What this addon does?

• This addon loads the exported TexturePacker texture and format into a usable data structure for c++ and openFrameworks.

What export settings do I use in TexturePacker Application?

• Currently use "Generic XML"
• May look into getting openFrameworks offically supported and have our own defined XML format.

Why use this addon?

• Easy intergration.
• Saves memory
• Optimises rendering
• Supports animation

How to refactor an ofImage into ofxTPSprite:

// Turn:
ofImage * normal = new ofImage();
normal.loadImage("images/normal.png");
// Into:
ofxTPSprite * normal = texturePacker.getSprite("images/normal.png");

How to load an animated sprite

ofxTexturePackerPtr texturepacker;
ofxTPAnimatedSpritePtr spaceship_sprite;

texturepacker = ofxTexturePackerPtr(new ofxTexturePacker());
texturepacker->load("spaceship/spaceship.xml");
spaceship_sprite = texturepacker->getAnimatedSprite("spaceship");
spaceship_sprite->play();

Don't forget to update() your sprite.

Notes

• ofxTexturePacker loads the png image designated by the xml file using a path relative to the xml file's location.
• getAnimationNames requires that you name your sprites with a common prefix
• disable trimming if you set the pivot

Still a work in progress. Will be maintained.