de.gurkenlabs.litiengine.environment.tilemap

Interface ICustomPropertyProvider

All Known Subinterfaces:

IImageLayer, ILayer, IMap, IMapImage, IMapObject, IMapObjectLayer, ITerrain, ITile, ITileLayer, ITileset

All Known Implementing Classes:

Blueprint, CustomPropertyProvider, GameInfo, ImageLayer, Layer, Map, MapImage, MapObject, MapObjectLayer, Terrain, Tile, TileLayer, TileOffset, Tileset

public interface ICustomPropertyProvider

The Interface ICustomPropertyProvider is providing methods to get and set custom properties.

Method Summary

Modifier and Type	Method and Description
boolean	getBoolValue(java.lang.String propertyName) Gets the boolean value of the custom property with the provided name.
boolean	getBoolValue(java.lang.String propertyName, boolean defaultValue) Gets the boolean value of the custom property with the provided name.
byte	getByteValue(java.lang.String propertyName) Gets the byte value of the custom property with the provided name.
byte	getByteValue(java.lang.String propertyName, byte defaultValue) Gets the byte value of the custom property with the provided name.
java.awt.Color	getColorValue(java.lang.String propertyName) Gets the color value of the custom property with the provided name.
java.awt.Color	getColorValue(java.lang.String propertyName, java.awt.Color defaultValue) Gets the color value of the custom property with the provided name.
double	getDoubleValue(java.lang.String propertyName) Gets the double value of the custom property with the provided name.
double	getDoubleValue(java.lang.String propertyName, double defaultValue) Gets the double value of the custom property with the provided name.
<T extends java.lang.Enum<T>> T	getEnumValue(java.lang.String propertyName, java.lang.Class<T> enumType) Gets the enum value of the custom property with the provided name.
<T extends java.lang.Enum<T>> T	getEnumValue(java.lang.String propertyName, java.lang.Class<T> enumType, T defaultValue) Gets the enum value of the custom property with the provided name.
float	getFloatValue(java.lang.String propertyName) Gets the float value of the custom property with the provided name.
float	getFloatValue(java.lang.String propertyName, float defaultValue) Gets the float value of the custom property with the provided name.
int	getIntValue(java.lang.String propertyName) Gets the int value of the custom property with the provided name.
int	getIntValue(java.lang.String propertyName, int defaultValue) Gets the int value of the custom property with the provided name.
long	getLongValue(java.lang.String propertyName) Gets the long value of the custom property with the provided name.
long	getLongValue(java.lang.String propertyName, long defaultValue) Gets the long value of the custom property with the provided name.
java.util.List<Property>	getProperties() Enumerates the custom properties for this object.
short	getShortValue(java.lang.String propertyName) Gets the short value of the custom property with the provided name.
short	getShortValue(java.lang.String propertyName, short defaultValue) Gets the short value of the custom property with the provided name.
java.lang.String	getStringValue(java.lang.String propertyName) Gets the string value of the custom property with the provided name.
java.lang.String	getStringValue(java.lang.String propertyName, java.lang.String defaultValue) Gets the string value of the custom property with the provided name.
boolean	hasCustomProperty(java.lang.String propertyName) Checks if a custom property with the given name is present.
void	setProperties(java.util.List<Property> props) Sets all of the custom properties on this object to the provided values.
void	setValue(java.lang.String propertyName, boolean value) Sets the value for the custom property with the given name to the given boolean.
void	setValue(java.lang.String propertyName, byte value) Sets the value for the custom property with the given name to the given byte.
void	setValue(java.lang.String propertyName, java.awt.Color value) Sets the value for the custom property with the given name to the given color.
void	setValue(java.lang.String propertyName, double value) Sets the value for the custom property with the given name to the given double.
void	setValue(java.lang.String propertyName, java.lang.Enum<?> value) Sets the value for the custom property with the given name to the given enum.
void	setValue(java.lang.String propertyName, float value) Sets the value for the custom property with the given name to the given float.
void	setValue(java.lang.String propertyName, int value) Sets the value for the custom property with the given name to the given int.
void	setValue(java.lang.String propertyName, long value) Sets the value for the custom property with the given name to the given long.
void	setValue(java.lang.String propertyName, short value) Sets the value for the custom property with the given name to the given short.
void	setValue(java.lang.String propertyName, java.lang.String value) Sets the value for the custom property with the given name to the given string.

Method Detail

hasCustomProperty

boolean hasCustomProperty(java.lang.String propertyName)

Checks if a custom property with the given name is present.

Parameters:

propertyName - the name of the custom property

Returns:

true if a custom property with the given name is present. False otherwise.

getStringValue

java.lang.String getStringValue(java.lang.String propertyName)

Gets the string value of the custom property with the provided name.

Parameters:

propertyName - the name of the custom property

Returns:

the string value of the custom property

getStringValue

java.lang.String getStringValue(java.lang.String propertyName,
                                java.lang.String defaultValue)

Gets the string value of the custom property with the provided name. If the value is null, the provided default value is used as a fallback.

Parameters:

propertyName - the name of the custom property

defaultValue - the fallback value in case the property value is null.

Returns:

the string value of the custom property, if present. Otherwise, the provided default value is returned.

getIntValue

int getIntValue(java.lang.String propertyName)

Gets the int value of the custom property with the provided name.

Parameters:

propertyName - the name of the custom property

Returns:

the int value of the custom property

getIntValue

int getIntValue(java.lang.String propertyName,
                int defaultValue)

Gets the int value of the custom property with the provided name. If the value is null, the provided default value is used as a fallback.

Parameters:

propertyName - the name of the custom property

defaultValue - the fallback value in case the property value is null.

Returns:

the int value of the custom property, if present. Otherwise, the provided default value is returned.

getLongValue

long getLongValue(java.lang.String propertyName)

Gets the long value of the custom property with the provided name.

Parameters:

propertyName - the name of the custom property

Returns:

the long value of the custom property

getLongValue

long getLongValue(java.lang.String propertyName,
                  long defaultValue)

Gets the long value of the custom property with the provided name. If the value is null, the provided default value is used as a fallback.

Parameters:

propertyName - the name of the custom property

defaultValue - the fallback value in case the property value is null.

Returns:

the long value of the custom property, if present. Otherwise, the provided default value is returned.

getShortValue

short getShortValue(java.lang.String propertyName)

Gets the short value of the custom property with the provided name.

Parameters:

propertyName - the name of the custom property

Returns:

the short value of the custom property

getShortValue

short getShortValue(java.lang.String propertyName,
                    short defaultValue)

Gets the short value of the custom property with the provided name. If the value is null, the provided default value is used as a fallback.

Parameters:

propertyName - the name of the custom property

defaultValue - the fallback value in case the property value is null.

Returns:

the short value of the custom property, if present. Otherwise, the provided default value is returned.

getByteValue

byte getByteValue(java.lang.String propertyName)

Gets the byte value of the custom property with the provided name.

Parameters:

propertyName - the name of the custom property

Returns:

the byte value of the custom property

getByteValue

byte getByteValue(java.lang.String propertyName,
                  byte defaultValue)

Gets the byte value of the custom property with the provided name. If the value is null, the provided default value is used as a fallback.

Parameters:

propertyName - the name of the custom property

defaultValue - the fallback value in case the property value is null.

Returns:

the byte value of the custom property, if present. Otherwise, the provided default value is returned.

getBoolValue

boolean getBoolValue(java.lang.String propertyName)

Gets the boolean value of the custom property with the provided name.

Parameters:

propertyName - the name of the custom property

Returns:

the boolean value of the custom property

getBoolValue

boolean getBoolValue(java.lang.String propertyName,
                     boolean defaultValue)

Gets the boolean value of the custom property with the provided name. If the value is null, the provided default value is used as a fallback.

Parameters:

propertyName - the name of the custom property

defaultValue - the fallback value in case the property value is null.

Returns:

the boolean value of the custom property, if present. Otherwise, the provided default value is returned.

getFloatValue

float getFloatValue(java.lang.String propertyName)

Gets the float value of the custom property with the provided name.

Parameters:

propertyName - the name of the custom property

Returns:

the float value of the custom property

getFloatValue

float getFloatValue(java.lang.String propertyName,
                    float defaultValue)

Gets the float value of the custom property with the provided name. If the value is null, the provided default value is used as a fallback.

Parameters:

propertyName - the name of the custom property

defaultValue - the fallback value in case the property value is null.

Returns:

the float value of the custom property, if present. Otherwise, the provided default value is returned.

getDoubleValue

double getDoubleValue(java.lang.String propertyName)

Gets the double value of the custom property with the provided name.

Parameters:

propertyName - the name of the custom property

Returns:

the double value of the custom property

getDoubleValue

double getDoubleValue(java.lang.String propertyName,
                      double defaultValue)

Gets the double value of the custom property with the provided name. If the value is null, the provided default value is used as a fallback.

Parameters:

propertyName - the name of the custom property

defaultValue - the fallback value in case the property value is null.

Returns:

the double value of the custom property, if present. Otherwise, the provided default value is returned.

getColorValue

java.awt.Color getColorValue(java.lang.String propertyName)

Gets the color value of the custom property with the provided name.

Parameters:

propertyName - the name of the custom property

Returns:

the color value of the custom property

getColorValue

java.awt.Color getColorValue(java.lang.String propertyName,
                             java.awt.Color defaultValue)

Gets the color value of the custom property with the provided name. If the value is null, the provided default value is used as a fallback.

Parameters:

propertyName - the name of the custom property

defaultValue - the fallback value in case the property value is null.

Returns:

the color value of the custom property, if present. Otherwise, the provided default value is returned.

getEnumValue

<T extends java.lang.Enum<T>> T getEnumValue(java.lang.String propertyName,
                                             java.lang.Class<T> enumType)

Gets the enum value of the custom property with the provided name.

Type Parameters:

T - the enum type to use

Parameters:

propertyName - the name of the custom property

enumType - a Class object for <T>

Returns:

the enum value of the custom property

getEnumValue

<T extends java.lang.Enum<T>> T getEnumValue(java.lang.String propertyName,
                                             java.lang.Class<T> enumType,
                                             T defaultValue)

Gets the enum value of the custom property with the provided name. If the value is null, the provided default value is used as a fallback.

Type Parameters:

T - the enum type to use

Parameters:

propertyName - the name of the custom property

defaultValue - the fallback value in case the property value is null.

enumType - a Class object for <T>

Returns:

the enum value of the custom property, if present. Otherwise, the provided default value is returned.

setValue

void setValue(java.lang.String propertyName,
              java.lang.String value)

Sets the value for the custom property with the given name to the given string.

Parameters:

propertyName - the name of the custom property

value - the new value

setValue

void setValue(java.lang.String propertyName,
              boolean value)

Sets the value for the custom property with the given name to the given boolean.

Parameters:

propertyName - the name of the custom property

value - the new value

setValue

void setValue(java.lang.String propertyName,
              byte value)

Sets the value for the custom property with the given name to the given byte.

Parameters:

propertyName - the name of the custom property

value - the new value

setValue

void setValue(java.lang.String propertyName,
              short value)

Sets the value for the custom property with the given name to the given short.

Parameters:

propertyName - the name of the custom property

value - the new value

setValue

void setValue(java.lang.String propertyName,
              int value)

Sets the value for the custom property with the given name to the given int.

Parameters:

propertyName - the name of the custom property

value - the new value

setValue

void setValue(java.lang.String propertyName,
              long value)

Sets the value for the custom property with the given name to the given long.

Parameters:

propertyName - the name of the custom property

value - the new value

setValue

void setValue(java.lang.String propertyName,
              float value)

Sets the value for the custom property with the given name to the given float.

Parameters:

propertyName - the name of the custom property

value - the new value

setValue

void setValue(java.lang.String propertyName,
              double value)

Sets the value for the custom property with the given name to the given double.

Parameters:

propertyName - the name of the custom property

value - the new value

setValue

void setValue(java.lang.String propertyName,
              java.awt.Color value)

Sets the value for the custom property with the given name to the given color.

Parameters:

propertyName - the name of the custom property

value - the new value

setValue

void setValue(java.lang.String propertyName,
              java.lang.Enum<?> value)

Sets the value for the custom property with the given name to the given enum.

Parameters:

propertyName - the name of the custom property

value - the new value

getProperties

java.util.List<Property> getProperties()

Enumerates the custom properties for this object.

Returns:

a complete list of custom properties for this ICustomPropertyProvider

setProperties

void setProperties(java.util.List<Property> props)

Sets all of the custom properties on this object to the provided values. Properties are added when they only exist in the provided properties, and deleted when they only exist in the current properties.

Parameters:

props - the new list of properties