MapSquare (Gridarta)

java.lang.Object
- net.sf.gridarta.model.baseobject.GameObjectContainer<G,A,R>
- - net.sf.gridarta.model.mapmodel.MapSquare<G,A,R>

All Implemented Interfaces:

java.io.Serializable, java.lang.Cloneable, java.lang.Iterable<G>
```
public class MapSquare<G extends GameObject<G,A,R>,A extends MapArchObject<A>,R extends Archetype<G,A,R>>
extends GameObjectContainer<G,A,R>
```
A single Map Square. This class is implemented in a way that changes via some modifier methods in a map square will automatically fire events in the associated MapModel. A MapSquare always knows its model. It's not possible to create a MapSquare that is not associated to a model.

The objects are stored bottom to top: GameObjectContainer.getFirst() returns the object at the bottom, GameObjectContainer.getLast() returns the object at the top of the square.

See Also:

Serialized Form

Constructor Summary

Constructors
Constructor and Description

MapSquare(MapModel<G,A,R> mapModel, int mapX, int mapY)
Creates a new instance.

Constructors
Constructor and Description
`MapSquare(MapModel<G,A,R> mapModel, int mapX, int mapY)` Creates a new instance.

Method Summary

All Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`void`	`addLightSource(MapSquare<G,A,R> mapSquare)` Adds a light emitting game object that affects this map square.
`G`	`asGameObject()` Returns this instance as a `GameObject` or `null` if this instance is not a game object.
`void`	`beginSquareChange()` Method to notify the model that a map square is about to change.
`protected MapSquare<G,A,R>`	`clone()`
`void`	`endSquareChange()` Method to notify the model that a map square was changed.
`boolean`	`equals(java.lang.Object obj)` }
`G`	`getAfterLast(GameObjectMatcher gameObjectMatcher)` Returns the game object after the last occurrence of a matching game object.
`G`	`getBeforeFirst(GameObjectMatcher gameObjectMatcher)` Returns the game object before the first occurrence of a matching game object.
`G`	`getFirst(GameObjectMatcher gameObjectMatcher)` Returns the first occurrence of a matching game object.
`G`	`getLast(GameObjectMatcher gameObjectMatcher)` Returns the last occurrence of a matching game object.
`G`	`getLastOfLeadingSpan(GameObjectMatcher gameObjectMatcher)` Returns the last game object of the initial segment of matching game objects.
`int`	`getLightRadius()` Returns the maximum light radius of all light emitting objects within this map square.
`java.awt.Point`	`getMapLocation()` Returns the coordinate on the map.
`void`	`getMapLocation(java.awt.Point pos)` Returns the coordinate on the map.
`void`	`getMapLocation(java.awt.Point pos, int dx, int dy)` Returns the coordinate with an offset on the map.
`MapModel<G,A,R>`	`getMapModel()` Returns the `MapModel` this map square is part of.
`MapSquare<G,A,R>`	`getMapSquare()` Returns the `MapSquare` of this container.
`int`	`getMapX()` Returns the x coordinate on the map.
`int`	`getMapY()` Returns the y coordinate on the map.
`int`	`hashCode()` }
`boolean`	`isLight()` Returns whether this map square is affected by any light emitting game objects.
`protected void`	`notifyBeginChange()` Notify the map model that this container is about to change.
`protected void`	`notifyEndChange()` Notify the map model that this container has changed.
`void`	`removeLightSource(MapSquare<G,A,R> mapSquare)` Removes a light emitting game object that affects this map square.
`void`	`setLightRadius(int lightRadius)` Sets the maximum light radius of all light emitting objects within this map square.
`protected void`	`setThisContainer(G gameObject)` Sets a `GameObject`'s container to this container.
`java.lang.String`	`toString()` }

Methods inherited from class net.sf.gridarta.model.baseobject.GameObjectContainer
addFirst, addLast, getFirst, getLast, getNext, getPrev, hasSameContents, insertAfter, insertBefore, isBottom, isEmpty, isTop, iterator, moveBottom, moveDown, moveTop, moveUp, recursive, remove, removeAll, replace, reverse

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

Methods inherited from interface java.lang.Iterable
forEach, spliterator

- Constructor Detail
  - MapSquare
```
public MapSquare(@NotNull
                 MapModel<G,A,R> mapModel,
                 int mapX,
                 int mapY)
```
    Creates a new instance.
    
    Parameters:
    
    mapModel - the map model this map square is part of
    
    mapX - the x coordinate of this map square within the model's grid
    
    mapY - the y coordinate of this map square within the model's grid
- Method Detail
  - getMapModel
```
@NotNull
public MapModel<G,A,R> getMapModel()
```
    Returns the MapModel this map square is part of.
    
    Returns:
    
    the map model
  - getMapX
```
public int getMapX()
```
    Returns the x coordinate on the map.
    
    Returns:
    
    the x coordinate on map
  - getMapY
```
public int getMapY()
```
    Returns the y coordinate on the map.
    
    Returns:
    
    the y coordinate on map
  - getMapLocation
```
@NotNull
public java.awt.Point getMapLocation()
```
    Returns the coordinate on the map.
    
    Returns:
    
    the coordinate on the map
  - getMapLocation
```
public void getMapLocation(@NotNull
                           java.awt.Point pos)
```
    Returns the coordinate on the map.
    
    Parameters:
    
    pos - returns the coordinate on the map
  - getMapLocation
```
public void getMapLocation(@NotNull
                           java.awt.Point pos,
                           int dx,
                           int dy)
```
    Returns the coordinate with an offset on the map.
    
    Parameters:
    
    pos - returns the coordinate on the map
    
    dx - the x offset to add to the coordinate
    
    dy - the y offset to add to the coordinate
  - getMapSquare
```
@NotNull
public MapSquare<G,A,R> getMapSquare()
```
    Returns the MapSquare of this container.
    
    Specified by:
    
    getMapSquare in class GameObjectContainer<G extends GameObject<G,A,R>,A extends MapArchObject<A>,R extends Archetype<G,A,R>>
    
    Returns:
    
    the map square of this container or null if this GameObjectContainer is not (yet?) connected to a map (a MapSquare would return itself)
  - notifyBeginChange
```
protected void notifyBeginChange()
```
    Notify the map model that this container is about to change.
    
    Specified by:
    
    notifyBeginChange in class GameObjectContainer<G extends GameObject<G,A,R>,A extends MapArchObject<A>,R extends Archetype<G,A,R>>
  - notifyEndChange
```
protected void notifyEndChange()
```
    Notify the map model that this container has changed.
    
    Specified by:
    
    notifyEndChange in class GameObjectContainer<G extends GameObject<G,A,R>,A extends MapArchObject<A>,R extends Archetype<G,A,R>>
  - clone
```
@NotNull
protected MapSquare<G,A,R> clone()
```
    Overrides:
    
    clone in class GameObjectContainer<G extends GameObject<G,A,R>,A extends MapArchObject<A>,R extends Archetype<G,A,R>>
  - setThisContainer
```
protected void setThisContainer(@NotNull
                                G gameObject)
```
    Sets a GameObject's container to this container.
    
    Specified by:
    
    setThisContainer in class GameObjectContainer<G extends GameObject<G,A,R>,A extends MapArchObject<A>,R extends Archetype<G,A,R>>
    
    Parameters:
    
    gameObject - the game object
  - asGameObject
```
@Nullable
public G asGameObject()
```
    Returns this instance as a GameObject or null if this instance is not a game object.
    
    Specified by:
    
    asGameObject in class GameObjectContainer<G extends GameObject<G,A,R>,A extends MapArchObject<A>,R extends Archetype<G,A,R>>
    
    Returns:
    
    this instance or null
  - getLast
```
@Nullable
public G getLast(@NotNull
                           GameObjectMatcher gameObjectMatcher)
```
    Returns the last occurrence of a matching game object.
    
    Parameters:
    
    gameObjectMatcher - the matcher to use
    
    Returns:
    
    the last match, or null if no such game object exists
  - getAfterLast
```
@Nullable
public G getAfterLast(@NotNull
                                GameObjectMatcher gameObjectMatcher)
```
    Returns the game object after the last occurrence of a matching game object.
    
    Parameters:
    
    gameObjectMatcher - the matcher to use
    
    Returns:
    
    the game object after the last match, or null if no such game object exists
    
    No Inspection:
    
    TypeMayBeWeakened
  - getFirst
```
@Nullable
public G getFirst(@NotNull
                            GameObjectMatcher gameObjectMatcher)
```
    Returns the first occurrence of a matching game object.
    
    Parameters:
    
    gameObjectMatcher - the matcher to use
    
    Returns:
    
    the first match, or null if no such game object exists
    
    No Inspection:
    
    TypeMayBeWeakened
  - getBeforeFirst
```
@Nullable
public G getBeforeFirst(@NotNull
                                  GameObjectMatcher gameObjectMatcher)
```
    Returns the game object before the first occurrence of a matching game object.
    
    Parameters:
    
    gameObjectMatcher - the matcher to use
    
    Returns:
    
    the game object before the first match, or null if no such game object exists
    
    No Inspection:
    
    TypeMayBeWeakened
  - getLastOfLeadingSpan
```
@Nullable
public G getLastOfLeadingSpan(@NotNull
                                        GameObjectMatcher gameObjectMatcher)
```
    Returns the last game object of the initial segment of matching game objects.
    
    Parameters:
    
    gameObjectMatcher - the matcher to use
    
    Returns:
    
    the result or null if the first game object does not match gameObjectMatcher
    
    No Inspection:
    
    TypeMayBeWeakened
  - beginSquareChange
```
public void beginSquareChange()
```
    Method to notify the model that a map square is about to change.
  - endSquareChange
```
public void endSquareChange()
```
    Method to notify the model that a map square was changed.
  - equals
```
public boolean equals(@Nullable
                      java.lang.Object obj)
```
    }
    
    Overrides:
    
    equals in class java.lang.Object
  - hashCode
```
public int hashCode()
```
    }
    
    Overrides:
    
    hashCode in class java.lang.Object
  - toString
```
@NotNull
public java.lang.String toString()
```
    }
    
    Overrides:
    
    toString in class GameObjectContainer<G extends GameObject<G,A,R>,A extends MapArchObject<A>,R extends Archetype<G,A,R>>
  - getLightRadius
```
public int getLightRadius()
```
    Returns the maximum light radius of all light emitting objects within this map square.
    
    Returns:
    
    the light radius or 0 if no light emitting objects are present
  - setLightRadius
```
public void setLightRadius(int lightRadius)
```
    Sets the maximum light radius of all light emitting objects within this map square.
    
    Parameters:
    
    lightRadius - the light radius or 0 if no light emitting objects are present
  - addLightSource
```
public void addLightSource(@NotNull
                           MapSquare<G,A,R> mapSquare)
```
    Adds a light emitting game object that affects this map square.
    
    Parameters:
    
    mapSquare - the map square that contains the game object
  - removeLightSource
```
public void removeLightSource(@NotNull
                              MapSquare<G,A,R> mapSquare)
```
    Removes a light emitting game object that affects this map square.
    
    Parameters:
    
    mapSquare - the map square that contains the game object
  - isLight
```
public boolean isLight()
```
    Returns whether this map square is affected by any light emitting game objects.
    
    Returns:
    
    whether this map square is affected by any light emitting game objects

Class MapSquare<G extends GameObject<G,A,R>,A extends MapArchObject<A>,R extends Archetype<G,A,R>>

Constructor Summary

Method Summary

Methods inherited from class net.sf.gridarta.model.baseobject.GameObjectContainer

Methods inherited from class java.lang.Object

Methods inherited from interface java.lang.Iterable

Constructor Detail

MapSquare

Method Detail

getMapModel

getMapX

getMapY

getMapLocation

getMapLocation

getMapLocation

getMapSquare

notifyBeginChange

notifyEndChange

clone

setThisContainer

asGameObject

getLast

getAfterLast

getFirst

getBeforeFirst

getLastOfLeadingSpan

beginSquareChange

endSquareChange

equals

hashCode

toString

getLightRadius

setLightRadius

addLightSource

removeLightSource

isLight