org.mini2Dx.tiled

Class TiledMap

java.lang.Object

org.mini2Dx.tiled.TiledMap

All Implemented Interfaces:

TiledParserListener

public class TiledMap
extends Object
implements TiledParserListener

An implementation of a parsed map from Tiled

Author:

Thomas Cashman

Field Summary

Fields

Modifier and Type	Field and Description
protected List<TiledObjectGroup>	objectGroups
protected List<TileLayer>	tileLayers
protected List<Tileset>	tilesets

Constructor Summary

Constructors

Constructor and Description
TiledMap() Constructs an empty map
TiledMap(com.badlogic.gdx.files.FileHandle fileHandle) Constructs a map from a TMX file
TiledMap(com.badlogic.gdx.files.FileHandle fileHandle, boolean loadMaps) Constructs a map from a TMX file

Method Summary

Methods

Modifier and Type	Method and Description
boolean	containsProperty(String propertyName) Returns if the map contains the specified property
void	draw(Graphics g, int x, int y) Draws the entire map at the specified coordinates
void	draw(Graphics g, int x, int y, int layer) Draws a layer of the map at the specified coordinates
void	draw(Graphics g, int x, int y, int startTileX, int startTileY, int width, int height) Draws a section of the map at the specified coordinates
void	draw(Graphics g, int x, int y, int startTileX, int startTileY, int width, int height, int layer) Draws a section of a specified layer of the map at the specified coordinates
int	getHeight() Returns the height of the map in tiles
int	getLayerIndex(String name) Returns the index of the TileLayer with the given name
TiledObjectGroup	getObjectGroup(String name) Returns the TiledObjectGroup with the given name
List<TiledObjectGroup>	getObjectGroups() Returns the TiledObjectGroups of this map
Orientation	getOrientation() Returns the Orientation of this map
String	getProperty(String propertyName) Returns the value of a specified property
int	getTileHeight() Returns the height of tiles in pixels
TileLayer	getTileLayer(String name) Returns the TileLayer with the given name
List<TileLayer>	getTileLayers() Returns the TileLayers of this map
List<Tileset>	getTilesets() Returns the Tilesets of this map
int	getTileWidth() Returns the width of tiles in pixels
int	getWidth() Returns the width of the map in tiles
void	onBeginParsing(String orientation, int width, int height, int tileWidth, int tileHeight)
protected void	onLayerRendered(TileLayer layer, int startTileX, int startTileY, int width, int height) Developers can override this method to implement sprite rendering
void	onMapPropertyParsed(String propertyName, String value)
void	onObjectGroupParsed(TiledObjectGroup parsedObjectGroup)
void	onTileLayerParsed(TileLayer parsedLayer)
void	onTilePropertyParsed(int tileId, String propertyName, String value)
void	onTilesetParsed(Tileset parsedTileset)
void	setProperty(String propertyName, String value) Sets the value of a specified property

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

tilesets

protected List<Tileset> tilesets

tileLayers

protected List<TileLayer> tileLayers

objectGroups

protected List<TiledObjectGroup> objectGroups

Constructor Detail

TiledMap

public TiledMap()

Constructs an empty map

TiledMap

public TiledMap(com.badlogic.gdx.files.FileHandle fileHandle)
         throws IOException

Constructs a map from a TMX file

Parameters:

fileHandle - A FileHandle to a .tmx file

Throws:

IOException - Thrown if the map file could not be parsed

TiledMap

public TiledMap(com.badlogic.gdx.files.FileHandle fileHandle,
        boolean loadMaps)
         throws IOException

Constructs a map from a TMX file

Parameters:

fileHandle - A FileHandle to a .tmx file

loadMaps - True if the tileset images should be loaded

Throws:

IOException - Thrown if the map file could not be parsed

Method Detail

draw

public void draw(Graphics g,
        int x,
        int y)

Draws the entire map at the specified coordinates

Parameters:

g - The Graphics context available for rendering

x - The x coordinate to render at

y - The y coordinate to render at

draw

public void draw(Graphics g,
        int x,
        int y,
        int layer)

Draws a layer of the map at the specified coordinates

Parameters:

g - The Graphics context available for rendering

x - The x coordinate to render at

y - The y coordinate to render at

layer - The layer index to render

draw

public void draw(Graphics g,
        int x,
        int y,
        int startTileX,
        int startTileY,
        int width,
        int height)

Draws a section of the map at the specified coordinates

Parameters:

g - The Graphics context available for rendering

x - The x coordinate to render at

y - The y coordinate to render at

startTileX - The x tile coordinate in the map to start from

startTileY - The y tile coordinate in the map to start from

width - The amount of tiles across the x axis to render

height - The amount of tiles across the y axis to render

draw

public void draw(Graphics g,
        int x,
        int y,
        int startTileX,
        int startTileY,
        int width,
        int height,
        int layer)

Draws a section of a specified layer of the map at the specified coordinates

Parameters:

g - The Graphics context available for rendering

x - The x coordinate to render at

y - The y coordinate to render at

startTileX - The x tile coordinate in the map to start from

startTileY - The y tile coordinate in the map to start from

width - The amount of tiles across the x axis to render

height - The amount of tiles across the y axis to render

layer - The layer index to render

onLayerRendered

protected void onLayerRendered(TileLayer layer,
                   int startTileX,
                   int startTileY,
                   int width,
                   int height)

Developers can override this method to implement sprite rendering

Parameters:

layer - The TileLayer which was just rendered

startTileX - The x coordinate in tiles where rendering started

startTileY - The y coordinate in tiles where rendering started

width - The amount of tiles that were rendered along the X axis

height - The amount of tiles that were rendered along the Y axis

containsProperty

public boolean containsProperty(String propertyName)

Returns if the map contains the specified property

Parameters:

propertyName - The property name to search for

Returns:

True if the map contains the property

getProperty

public String getProperty(String propertyName)

Returns the value of a specified property

Parameters:

propertyName - The property name to search for

Returns:

Null if there is no such property

setProperty

public void setProperty(String propertyName,
               String value)

Sets the value of a specified property

Parameters:

propertyName - The property name to set the value for

value - The value of the property to set

onBeginParsing

public void onBeginParsing(String orientation,
                  int width,
                  int height,
                  int tileWidth,
                  int tileHeight)

Specified by:

onBeginParsing in interface TiledParserListener

onMapPropertyParsed

public void onMapPropertyParsed(String propertyName,
                       String value)

Specified by:

onMapPropertyParsed in interface TiledParserListener

onTilePropertyParsed

public void onTilePropertyParsed(int tileId,
                        String propertyName,
                        String value)

Specified by:

onTilePropertyParsed in interface TiledParserListener

onTilesetParsed

public void onTilesetParsed(Tileset parsedTileset)

Specified by:

onTilesetParsed in interface TiledParserListener

onTileLayerParsed

public void onTileLayerParsed(TileLayer parsedLayer)

Specified by:

onTileLayerParsed in interface TiledParserListener

onObjectGroupParsed

public void onObjectGroupParsed(TiledObjectGroup parsedObjectGroup)

Specified by:

onObjectGroupParsed in interface TiledParserListener

getTileLayer

public TileLayer getTileLayer(String name)

Returns the TileLayer with the given name

Parameters:

name - The name to search for

Returns:

Null if there is no such TileLayer

getObjectGroup

public TiledObjectGroup getObjectGroup(String name)

Returns the TiledObjectGroup with the given name

Parameters:

name - The name to search for

Returns:

Null if there is no such TiledObjectGroup

getLayerIndex

public int getLayerIndex(String name)

Returns the index of the TileLayer with the given name

Parameters:

name - The name to search for

Returns:

-1 if there is no such TileLayer

getOrientation

public Orientation getOrientation()

Returns the Orientation of this map

Returns:

getWidth

public int getWidth()

Returns the width of the map in tiles

Returns:

getHeight

public int getHeight()

Returns the height of the map in tiles

Returns:

getTileWidth

public int getTileWidth()

Returns the width of tiles in pixels

Returns:

getTileHeight

public int getTileHeight()

Returns the height of tiles in pixels

Returns:

getTilesets

public List<Tileset> getTilesets()

Returns the Tilesets of this map

Returns:

An empty list if none have been loaded

getTileLayers

public List<TileLayer> getTileLayers()

Returns the TileLayers of this map

Returns:

An empty list if none have been loaded

getObjectGroups

public List<TiledObjectGroup> getObjectGroups()

Returns the TiledObjectGroups of this map

Returns:

An empty list if none have been loaded