Tile

java.lang.Object
- org.pepsoft.worldpainter.InstanceKeeper
- - org.pepsoft.worldpainter.Tile

All Implemented Interfaces:

java.io.Serializable, java.lang.Cloneable, org.pepsoft.util.undo.UndoListener

Direct Known Subclasses:

ReadOnlyTile, TileSnapshot
```
public class Tile
extends InstanceKeeper
implements java.io.Serializable, org.pepsoft.util.undo.UndoListener, java.lang.Cloneable
```
See Also:

Serialized Form

Nested Class Summary

Nested Classes
Modifier and Type Class and Description

static interface Tile.Listener

static class Tile.TileBuffer
- Nested classes/interfaces inherited from class org.pepsoft.worldpainter.InstanceKeeper
  InstanceKeeper.InstantiationListener<T>

Nested Classes
Modifier and Type	Class and Description
`static interface`	`Tile.Listener`
`static class`	`Tile.TileBuffer`

Field Summary

Fields
Modifier and Type	Field and Description
`protected java.util.Map<Layer,java.util.BitSet>`	`bitLayerData`
`protected short[]`	`heightMap`
`protected java.util.Map<Layer,byte[]>`	`layerData`
`protected int[]`	`tallHeightMap`
`protected short[]`	`tallWaterLevel`
`protected byte[]`	`terrain`
`protected byte[]`	`waterLevel`

Constructor Summary

Constructors
Modifier	Constructor and Description
	`Tile(int x, int y, int minHeight, int maxHeight)`
`protected`	`Tile(int x, int y, int minHeight, int maxHeight, boolean init)`

Method Summary

All Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`void`	`addListener(Tile.Listener listener)`
`void`	`bufferChanged(org.pepsoft.util.undo.BufferKey<?> key)`
`void`	`clearLayerData(int x, int y, java.util.Set<Layer> excludedLayers)` Clear all layer data at a particular location (by resetting to the layer's default value), possibly with the exception of certain layers.
`void`	`clearLayerData(Layer layer)`
`boolean`	`containsOneOf(Layer... layers)`
`protected java.util.List<Layer>`	`doGetLayers(java.util.Set<Layer> additionalLayers)`
`protected float`	`doGetSlope(int x, int y)`
`protected void`	`ensureReadable(Tile.TileBuffer buffer)`
`boolean`	`equals(java.lang.Object obj)`
`java.util.List<Layer>`	`getActiveLayers(int x, int y)`
`java.util.Set<Terrain>`	`getAllTerrains()`
`int`	`getBitLayerCount(Layer layer, int x, int y, int r)` Count the number of blocks where the specified bit layer is set in a square around a particular location
`boolean`	`getBitLayerValue(Layer layer, int x, int y)`
`float`	`getDistanceToEdge(Layer layer, int x, int y, float maxDistance)`
`int`	`getFloodedCount(int x, int y, int r, boolean lava)` Count the number of blocks that are flooded in a square around a particular location
`float`	`getHeight(int x, int y)`
`float`	`getHighestHeight()`
`int`	`getHighestIntHeight()`
`int`	`getHighestRawHeight()`
`int`	`getHighestWaterLevel()`
`int`	`getIntHeight(int x, int y)`
`java.util.List<Layer>`	`getLayers()`
`java.util.List<Layer>`	`getLayers(java.util.Set<Layer> additionalLayers)` Get a list of all layers in use in the tile, as well as the set of additional layers provided, the total sorted by layer priority.
`java.util.Map<Layer,java.lang.Integer>`	`getLayersAt(int x, int y)` Gets all layers that are set at the specified location, along with their intensities or values.
`int`	`getLayerValue(Layer layer, int x, int y)`
`float`	`getLowestHeight()`
`int`	`getLowestIntHeight()`
`int`	`getLowestRawHeight()`
`int`	`getMaxHeight()`
`int`	`getMinHeight()`
`int`	`getRawHeight(int x, int y)` Get the raw height value.
`int[]`	`getRawHeightRange()`
`java.util.HashSet<Seed>`	`getSeeds()`
`float`	`getSlope(int x, int y)`
`Terrain`	`getTerrain(int x, int y)`
`int`	`getWaterLevel(int x, int y)`
`int`	`getX()`
`int`	`getY()`
`int`	`hashCode()`
`boolean`	`hasLayer(Layer layer)`
`void`	`inhibitEvents()` Stop firing events when the tile is modified, until `releaseEvents()` is invoked.
`boolean`	`isEventsInhibited()`
`boolean`	`plantSeed(Seed seed)`
`void`	`redoPerformed()`
`void`	`register(org.pepsoft.util.undo.UndoManager undoManager)`
`void`	`releaseEvents()` Release an inhibition on firing events.
`void`	`removeListener(Tile.Listener listener)`
`void`	`removeSeed(Seed seed)`
`boolean`	`repair(int minHeight, int maxHeight, java.io.PrintStream out)`
`void`	`savePointArmed()`
`void`	`savePointCreated()`
`void`	`setBitLayerValue(Layer layer, int x, int y, boolean value)`
`void`	`setHeight(int x, int y, float height)`
`void`	`setLayerValue(Layer layer, int x, int y, int value)`
`void`	`setMinMaxHeight(int minHeight, int maxHeight, HeightTransform heightTransform)`
`void`	`setRawHeight(int x, int y, int rawHeight)` Set the raw height value.
`void`	`setTerrain(int x, int y, Terrain terrain)`
`void`	`setWaterLevel(int x, int y, int waterLevel)`
`java.lang.String`	`toString()`
`Tile`	`transform(CoordinateTransform transform)` Create a new tile based on this one but horizontally transformed according to some transformation.
`void`	`undoPerformed()`
`void`	`unregister()`

Methods inherited from class org.pepsoft.worldpainter.InstanceKeeper
setInstantiationListener

Methods inherited from class java.lang.Object
clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Field Detail

heightMap
```
protected short[] heightMap
```

tallHeightMap
```
protected int[] tallHeightMap
```

terrain
```
protected byte[] terrain
```

waterLevel
```
protected byte[] waterLevel
```

tallWaterLevel
```
protected short[] tallWaterLevel
```

layerData

protected java.util.Map<Layer,byte[]> layerData

bitLayerData

protected java.util.Map<Layer,java.util.BitSet> bitLayerData

Constructor Detail

Tile

public Tile(int x,
            int y,
            int minHeight,
            int maxHeight)

Tile

protected Tile(int x,
               int y,
               int minHeight,
               int maxHeight,
               boolean init)

Method Detail
- getX
```
public int getX()
```
- getY
```
public int getY()
```
- getMinHeight
```
public int getMinHeight()
```
- getMaxHeight
```
public int getMaxHeight()
```
- setMinMaxHeight
```
public void setMinMaxHeight(int minHeight,
                            int maxHeight,
                            HeightTransform heightTransform)
```
- getIntHeight
```
public int getIntHeight(int x,
                        int y)
```
- getLowestIntHeight
```
public int getLowestIntHeight()
```
- getHighestIntHeight
```
public int getHighestIntHeight()
```
- getHeight
```
public float getHeight(int x,
                       int y)
```
- getLowestHeight
```
public float getLowestHeight()
```
- getHighestHeight
```
public float getHighestHeight()
```
- setHeight
```
public void setHeight(int x,
                      int y,
                      float height)
```
- getRawHeight
```
public int getRawHeight(int x,
                        int y)
```
  Get the raw height value. This is the height times 256 (for added precision) and zero-based rather than adjusted for minHeight.
- getLowestRawHeight
```
public int getLowestRawHeight()
```
- getHighestRawHeight
```
public int getHighestRawHeight()
```
- getRawHeightRange
```
public int[] getRawHeightRange()
```
- setRawHeight
```
public void setRawHeight(int x,
                         int y,
                         int rawHeight)
```
  Set the raw height value. This is the height times 256 (for added precision) and zero-based rather than adjusted for minHeight.
- getSlope
```
public float getSlope(int x,
                      int y)
```
- doGetSlope
```
protected final float doGetSlope(int x,
                                 int y)
```
- getTerrain
```
public Terrain getTerrain(int x,
                          int y)
```
- setTerrain
```
public void setTerrain(int x,
                       int y,
                       Terrain terrain)
```
- getAllTerrains
```
public java.util.Set<Terrain> getAllTerrains()
```
- getWaterLevel
```
public int getWaterLevel(int x,
                         int y)
```
- getHighestWaterLevel
```
public int getHighestWaterLevel()
```
- setWaterLevel
```
public void setWaterLevel(int x,
                          int y,
                          int waterLevel)
```
- getLayers
```
public java.util.List<Layer> getLayers()
```
- hasLayer
```
public boolean hasLayer(Layer layer)
```
- getActiveLayers
```
public java.util.List<Layer> getActiveLayers(int x,
                                             int y)
```
- getLayers
```
public java.util.List<Layer> getLayers(java.util.Set<Layer> additionalLayers)
```
  Get a list of all layers in use in the tile, as well as the set of additional layers provided, the total sorted by layer priority.
  
  Parameters:
  
  additionalLayers - The additional layers to include in the list.
  
  Returns:
  
  The list of all layers provided or in use on the tile, sorted by layer priority.
- doGetLayers
```
protected final java.util.List<Layer> doGetLayers(java.util.Set<Layer> additionalLayers)
```
- getBitLayerValue
```
public boolean getBitLayerValue(Layer layer,
                                int x,
                                int y)
```
- getBitLayerCount
```
public int getBitLayerCount(Layer layer,
                            int x,
                            int y,
                            int r)
```
  Count the number of blocks where the specified bit layer is set in a square around a particular location
  
  Parameters:
  
  layer - The bit layer to count.
  
  x - The X coordinate (local to the tile) of the location around which to count the layer.
  
  y - The Y coordinate (local to the tile) of the location around which to count the layer.
  
  r - The radius of the square.
  
  Returns:
  
  The number of blocks in the specified square where the specified bit layer is set.
- getLayersAt
```
public java.util.Map<Layer,java.lang.Integer> getLayersAt(int x,
                                                          int y)
```
  Gets all layers that are set at the specified location, along with their intensities or values. For bit-valued layers the intensity is zero for off, one for on.
  
  Parameters:
  
  x - The X location for which to retrieve all layers.
  
  y - The Y location for which to retrieve all layers.
  
  Returns:
  
  A map with all layers set at the specified location, mapped to their intensities or values at that location. May either be null or an empty map if no layers are present.
- getFloodedCount
```
public int getFloodedCount(int x,
                           int y,
                           int r,
                           boolean lava)
```
  Count the number of blocks that are flooded in a square around a particular location
  
  Parameters:
  
  x - The X coordinate (local to the tile) of the location around which to count flooded blocks.
  
  y - The Y coordinate (local to the tile) of the location around which to count flooded blocks.
  
  r - The radius of the square.
  
  lava - Whether to check for lava (when true) or water (when false).
  
  Returns:
  
  The number of blocks in the specified square that are flooded.
- getDistanceToEdge
```
public float getDistanceToEdge(Layer layer,
                               int x,
                               int y,
                               float maxDistance)
```
- setBitLayerValue
```
public void setBitLayerValue(Layer layer,
                             int x,
                             int y,
                             boolean value)
```
- getLayerValue
```
public int getLayerValue(Layer layer,
                         int x,
                         int y)
```
- setLayerValue
```
public void setLayerValue(Layer layer,
                          int x,
                          int y,
                          int value)
```
- clearLayerData
```
public void clearLayerData(Layer layer)
```
- clearLayerData
```
public void clearLayerData(int x,
                           int y,
                           java.util.Set<Layer> excludedLayers)
```
  Clear all layer data at a particular location (by resetting to the layer's default value), possibly with the exception of certain layers.
  
  Parameters:
  
  x - The X coordinate of the location to clear of layer data.
  
  y - The Y coordinate of the location to clear of layer data.
  
  excludedLayers - The layers to exclude, if any. May be null.
- getSeeds
```
public java.util.HashSet<Seed> getSeeds()
```
- plantSeed
```
public boolean plantSeed(Seed seed)
```
- removeSeed
```
public void removeSeed(Seed seed)
```
- addListener
```
public void addListener(Tile.Listener listener)
```
- removeListener
```
public void removeListener(Tile.Listener listener)
```
- isEventsInhibited
```
public boolean isEventsInhibited()
```
- inhibitEvents
```
public void inhibitEvents()
```
  Stop firing events when the tile is modified, until releaseEvents() is invoked. Make sure that releaseEvents() is always invoked, even if an exception is thrown, by using a try-finally statement:
  tile.inhibitEvents(); try { // modify the tile } finally { tile.releaseEvents(); }
  Note that calls to these methods may be nested, and if so, events will only be released after the final invocation of releaseEvents().
- releaseEvents
```
public void releaseEvents()
```
  Release an inhibition on firing events. Will fire all appropriate events at this time, if the tile was modified since the first invocation of inhibitEvents(), but only if this is the last invocation of releaseEvents() in a nested set.
- register
```
public void register(org.pepsoft.util.undo.UndoManager undoManager)
```
- unregister
```
public void unregister()
```
- transform
```
public Tile transform(CoordinateTransform transform)
```
  Create a new tile based on this one but horizontally transformed according to some transformation.
  
  Parameters:
  
  transform - The transform to apply.
  
  Returns:
  
  A new tile with the same contents, except transformed according to the specified transform (including the X and Y coordinates).
- repair
```
public boolean repair(int minHeight,
                      int maxHeight,
                      java.io.PrintStream out)
```
- containsOneOf
```
public boolean containsOneOf(Layer... layers)
```
- savePointArmed
```
public void savePointArmed()
```
  Specified by:
  
  savePointArmed in interface org.pepsoft.util.undo.UndoListener
- savePointCreated
```
public void savePointCreated()
```
  Specified by:
  
  savePointCreated in interface org.pepsoft.util.undo.UndoListener
- undoPerformed
```
public void undoPerformed()
```
  Specified by:
  
  undoPerformed in interface org.pepsoft.util.undo.UndoListener
- redoPerformed
```
public void redoPerformed()
```
  Specified by:
  
  redoPerformed in interface org.pepsoft.util.undo.UndoListener
- bufferChanged
```
public void bufferChanged(org.pepsoft.util.undo.BufferKey<?> key)
```
  Specified by:
  
  bufferChanged in interface org.pepsoft.util.undo.UndoListener
- equals
```
public boolean equals(java.lang.Object obj)
```
  Overrides:
  
  equals in class java.lang.Object
- hashCode
```
public int hashCode()
```
  Overrides:
  
  hashCode in class java.lang.Object
- toString
```
public java.lang.String toString()
```
  Overrides:
  
  toString in class java.lang.Object
- ensureReadable
```
protected void ensureReadable(Tile.TileBuffer buffer)
```

Class Tile

Nested Class Summary

Nested classes/interfaces inherited from class org.pepsoft.worldpainter.InstanceKeeper

Field Summary

Constructor Summary

Method Summary

Methods inherited from class org.pepsoft.worldpainter.InstanceKeeper

Methods inherited from class java.lang.Object

Field Detail

heightMap

tallHeightMap

terrain

waterLevel

tallWaterLevel

layerData

bitLayerData

Constructor Detail

Tile

Tile

Method Detail

getX

getY

getMinHeight

getMaxHeight

setMinMaxHeight

getIntHeight

getLowestIntHeight

getHighestIntHeight

getHeight

getLowestHeight

getHighestHeight

setHeight

getRawHeight

getLowestRawHeight

getHighestRawHeight

getRawHeightRange

setRawHeight

getSlope

doGetSlope

getTerrain

setTerrain

getAllTerrains

getWaterLevel

getHighestWaterLevel

setWaterLevel

getLayers

hasLayer

getActiveLayers

getLayers

doGetLayers

getBitLayerValue

getBitLayerCount

getLayersAt

getFloodedCount

getDistanceToEdge

setBitLayerValue

getLayerValue

setLayerValue

clearLayerData

clearLayerData

getSeeds

plantSeed

removeSeed

addListener

removeListener

isEventsInhibited

inhibitEvents

releaseEvents

register

unregister

transform

repair

containsOneOf

savePointArmed

savePointCreated

undoPerformed

redoPerformed

bufferChanged

equals

hashCode