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 loadTilesets) 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
com.badlogic.gdx.graphics.Color	getBackgroundColor() Returns the background Color of the map
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
Tile	getTile(int tileId) Returns the Tile for the given tile ID
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, com.badlogic.gdx.graphics.Color backgroundColor, int width, int height, int tileWidth, int tileHeight)
protected void	onLayerRendered(Graphics g, 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	onTilePropertiesParsed(Tile tile)
void	onTilesetParsed(Tileset parsedTileset)
protected boolean	preLayerRendered(Graphics g, TileLayer layer, int startTileX, int startTileY, int width, int height) Developers can override this method which is called before a layer is rendered To prevent the layer from rendering, return false from this method.
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 loadTilesets)
         throws IOException

Constructs a map from a TMX file

Parameters:

fileHandle - A FileHandle to a .tmx file

loadTilesets - 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

preLayerRendered

protected boolean preLayerRendered(Graphics g,
                       TileLayer layer,
                       int startTileX,
                       int startTileY,
                       int width,
                       int height)

Developers can override this method which is called before a layer is rendered To prevent the layer from rendering, return false from this method.

Parameters:

g - The Graphics context used for rendering

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

Returns:

True if the layer should be rendered

onLayerRendered

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

Developers can override this method to implement sprite rendering

Parameters:

g - The Graphics context used for rendering

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,
                  com.badlogic.gdx.graphics.Color backgroundColor,
                  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

onTilePropertiesParsed

public void onTilePropertiesParsed(Tile tile)

Specified by:

onTilePropertiesParsed 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

getTile

public Tile getTile(int tileId)

Returns the Tile for the given tile ID

Parameters:

tileId - The tile ID to search for

Returns:

Null if there is no Tile with the given ID

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

getBackgroundColor

public com.badlogic.gdx.graphics.Color getBackgroundColor()

Returns the background Color of the map

Returns:

null by default