Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
branch: master

README.md

TMX LOADER FOR ANDROID

Second beta release - 0.8.1 Written by David Iserovich

Decision of distribution license pending, meanwhile you are free to use the code if you attribute credit.

Tiled http://www.mapeditor.org/

The map editor Tiled produce files in .tmx format which is xml-based.

This library and its classes allow the loading of tmx files into a TileMapData object, and allow the creating of an Android Bitmap based on said TileMapData object

USAGE

TMXLoader/src/davidiserovich/TMXLoader/ contains the main source files. TMXLoader/assets/ contains an example tmx file and its tileset image.

Both directories are regular Eclipse Android projects, and can be imported.

The main activity TMXLoaderActivity in TMXLoaderExample uses the TileMapData object and Canvas to create a Bitmap containing the arrangment of tiles that the tmx specifies.

To use

-To import in Eclipse, choose File->Import->General->Existing Projects Into Workspace and select the folder of TMXLoader.

-To try the example app, do the same for the TMXLoaderExample directory

  • Right click the TMXLoader project you now have, choose Properties, select Android, and make sure Is Library is checked

  • To use TMXLoader in a project, go to the project's Android properties as above, and add a reference to TMXLoader

  • Import davidiserovich.TMXLoader.* and you should be ready to go!

FEATURE RESTRICTIONS/TODO

  • The only tilemap layout supported is 0 border, 0 margins, 0 spacing.

  • Map objects are not yet supported.

  • Tile rotations are not yet supported.

  • The only supported data format is CSV (This can be set in Tiled in Edit->Preferences->Store Tile Data As: CSV)


CHANGES

6/20/2012 - 0.8.1

  • Separated Bitmap rendering into TMXLoader.java
  • Added support for layer selection
  • Changed project type to Android Library
  • Moved sample code into new, related project

TODO

  • Javadoc
  • Compressed file support
  • Other/newer TMX features
Something went wrong with that request. Please try again.