com.almasb.fxgl.gameplay

Class GameWorld

java.lang.Object

com.almasb.ents.EntityWorld

com.almasb.fxgl.gameplay.GameWorld

All Implemented Interfaces:

UpdateEventListener

public final class GameWorld
extends com.almasb.ents.EntityWorld
implements UpdateEventListener

Represents pure logical state of game. Manages all entities and their state.

Author:

Almas Baimagambetov (AlmasB) (almaslvl@gmail.com)

Property Summary

Type	Property and Description
javafx.beans.property.ObjectProperty<GameDifficulty>	gameDifficulty
javafx.beans.property.ObjectProperty<com.almasb.ents.Entity>	selectedEntity

Field Summary

Fields inherited from class com.almasb.ents.EntityWorld

entities

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	GameWorld()

Method Summary

Modifier and Type	Method and Description
void	addEventTrigger(<any> trigger) Add event trigger to the world.
javafx.beans.property.ObjectProperty<GameDifficulty>	gameDifficultyProperty()
Optional<com.almasb.ents.Entity>	getClosestEntity(com.almasb.ents.Entity entity, Predicate<com.almasb.ents.Entity> filter) Returns the closest entity to the given entity with given filter.
void	getCollidingEntities(com.almasb.gameutils.collection.Array<com.almasb.ents.Entity> result, com.almasb.ents.Entity entity) GC-friendly version of getCollidingEntities(Entity).
List<com.almasb.ents.Entity>	getCollidingEntities(com.almasb.ents.Entity entity) Returns a list of entities which colliding with given entity.
void	getEntitiesByLayer(com.almasb.gameutils.collection.Array<com.almasb.ents.Entity> result, RenderLayer layer) GC-friendly version of getEntitiesByLayer(RenderLayer).
List<com.almasb.ents.Entity>	getEntitiesByLayer(RenderLayer layer) Returns a list of entities which have the given render layer index.
void	getEntitiesByType(com.almasb.gameutils.collection.Array<com.almasb.ents.Entity> result, Enum<?>... types) GC-friendly version of getEntitiesByType(Enum[]).
List<com.almasb.ents.Entity>	getEntitiesByType(Enum<?>... types) This query only works on entities with TypeComponent.
void	getEntitiesFiltered(com.almasb.gameutils.collection.Array<com.almasb.ents.Entity> result, Predicate<com.almasb.ents.Entity> predicate) GC-friendly version of getEntitiesFiltered(Predicate).
List<com.almasb.ents.Entity>	getEntitiesFiltered(Predicate<com.almasb.ents.Entity> predicate) Returns a list of entities which are filtered by given predicate.
void	getEntitiesInRange(com.almasb.gameutils.collection.Array<com.almasb.ents.Entity> result, double minX, double minY, double maxX, double maxY) GC-friendly version of getEntitiesInRange(Rectangle2D).
List<com.almasb.ents.Entity>	getEntitiesInRange(javafx.geometry.Rectangle2D selection) Returns a list of entities which are partially or entirely in the specified rectangular selection.
Optional<com.almasb.ents.Entity>	getEntityAt(javafx.geometry.Point2D position) Returns an entity at given position.
Optional<com.almasb.ents.Entity>	getEntityByID(String name, int id) Returns an entity whose IDComponent matches given name and id.
GameDifficulty	getGameDifficulty()
Optional<com.almasb.ents.Entity>	getSelectedEntity() Returns last selected (clicked on by mouse) entity.
void	onUpdateEvent(UpdateEvent event) Called on each update tick.
void	removeEventTrigger(<any> trigger) Remove event trigger from the world.
void	reset()
javafx.beans.property.ObjectProperty<com.almasb.ents.Entity>	selectedEntityProperty()
void	setLevel(Level level) Set level to given.

Methods inherited from class com.almasb.ents.EntityWorld

addEntities, addEntity, addWorldListener, getEntities, getEntitiesByComponent, getEntitiesCopy, removeEntities, removeEntity, removeWorldListener, update

Methods inherited from class java.lang.Object

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

Property Detail

gameDifficulty

public javafx.beans.property.ObjectProperty<GameDifficulty> gameDifficultyProperty

See Also:

getGameDifficulty()

selectedEntity

public javafx.beans.property.ObjectProperty<com.almasb.ents.Entity> selectedEntityProperty

See Also:

getSelectedEntity()

Constructor Detail

GameWorld

@Inject
protected GameWorld()

Method Detail

getGameDifficulty

public GameDifficulty getGameDifficulty()

Returns:

game difficulty

gameDifficultyProperty

public javafx.beans.property.ObjectProperty<GameDifficulty> gameDifficultyProperty()

See Also:

getGameDifficulty()

onUpdateEvent

public void onUpdateEvent(UpdateEvent event)

Description copied from interface: UpdateEventListener

Called on each update tick.

Specified by:

onUpdateEvent in interface UpdateEventListener

Parameters:

event - the event data

reset

public void reset()

Overrides:

reset in class com.almasb.ents.EntityWorld

addEventTrigger

public void addEventTrigger(<any> trigger)

Add event trigger to the world.

Parameters:

trigger - the event trigger

removeEventTrigger

public void removeEventTrigger(<any> trigger)

Remove event trigger from the world.

Parameters:

trigger - the event trigger

getSelectedEntity

public Optional<com.almasb.ents.Entity> getSelectedEntity()

Returns last selected (clicked on by mouse) entity.

Returns:

selected entity

selectedEntityProperty

public javafx.beans.property.ObjectProperty<com.almasb.ents.Entity> selectedEntityProperty()

See Also:

getSelectedEntity()

setLevel

public void setLevel(Level level)

Set level to given. Resets the world. Adds all level entities to the world.

Parameters:

level - the level

getEntitiesFiltered

public List<com.almasb.ents.Entity> getEntitiesFiltered(Predicate<com.almasb.ents.Entity> predicate)

Returns a list of entities which are filtered by given predicate. Warning: object allocation.

Parameters:

predicate - filter

Returns:

new list containing entities that satisfy query filters

getEntitiesFiltered

public void getEntitiesFiltered(com.almasb.gameutils.collection.Array<com.almasb.ents.Entity> result,
                                Predicate<com.almasb.ents.Entity> predicate)

GC-friendly version of getEntitiesFiltered(Predicate).

Parameters:

result - the array to collect entities

predicate - filter

getEntitiesByType

public List<com.almasb.ents.Entity> getEntitiesByType(Enum<?>... types)

This query only works on entities with TypeComponent. If called with no arguments, all entities are returned. Warning: object allocation.

Parameters:

types - entity types

Returns:

new list containing entities that satisfy query filters

getEntitiesByType

public void getEntitiesByType(com.almasb.gameutils.collection.Array<com.almasb.ents.Entity> result,
                              Enum<?>... types)

GC-friendly version of getEntitiesByType(Enum[]).

Parameters:

result - the array to collect entities

types - entity types

getEntitiesInRange

public List<com.almasb.ents.Entity> getEntitiesInRange(javafx.geometry.Rectangle2D selection)

Returns a list of entities which are partially or entirely in the specified rectangular selection. This query only works on entities with BoundingBoxComponent. Warning: object allocation.

Parameters:

selection - Rectangle2D that describes the selection box

Returns:

new list containing entities that satisfy query filters

getEntitiesInRange

public void getEntitiesInRange(com.almasb.gameutils.collection.Array<com.almasb.ents.Entity> result,
                               double minX,
                               double minY,
                               double maxX,
                               double maxY)

GC-friendly version of getEntitiesInRange(Rectangle2D).

Parameters:

result - the array to collect entities

minX - min x

minY - min y

maxX - max x

maxY - max y

getCollidingEntities

public List<com.almasb.ents.Entity> getCollidingEntities(com.almasb.ents.Entity entity)

Returns a list of entities which colliding with given entity. Note: CollidableComponent is not considered. This query only works on entities with BoundingBoxComponent.

Parameters:

entity - the entity

Returns:

new list containing entities that satisfy query filters

getCollidingEntities

public void getCollidingEntities(com.almasb.gameutils.collection.Array<com.almasb.ents.Entity> result,
                                 com.almasb.ents.Entity entity)

GC-friendly version of getCollidingEntities(Entity).

Parameters:

result - the array to collect entities

entity - the entity

getEntitiesByLayer

public List<com.almasb.ents.Entity> getEntitiesByLayer(RenderLayer layer)

Returns a list of entities which have the given render layer index. This query only works on entities with MainViewComponent.

Parameters:

layer - render layer

Returns:

new list containing entities that satisfy query filters

getEntitiesByLayer

public void getEntitiesByLayer(com.almasb.gameutils.collection.Array<com.almasb.ents.Entity> result,
                               RenderLayer layer)

GC-friendly version of getEntitiesByLayer(RenderLayer).

Parameters:

result - the array to collect entities

layer - render layer

getClosestEntity

public Optional<com.almasb.ents.Entity> getClosestEntity(com.almasb.ents.Entity entity,
                                                         Predicate<com.almasb.ents.Entity> filter)

Returns the closest entity to the given entity with given filter. The given entity itself is never returned.

If there no entities satisfying the requirement, Optional.empty() is returned. Warning: object allocation.

Parameters:

entity - selected entity

filter - requirements

Returns:

closest entity to selected entity with type

getEntityAt

public Optional<com.almasb.ents.Entity> getEntityAt(javafx.geometry.Point2D position)

Returns an entity at given position. The position x and y must equal to entity's position x and y.

Returns Optional.empty() if no entity was found at given position. This query only works on entities with PositionComponent.

Parameters:

position - point in the world

Returns:

entity at point

getEntityByID

public Optional<com.almasb.ents.Entity> getEntityByID(String name,
                                                      int id)

Returns an entity whose IDComponent matches given name and id.

Returns Optional.empty() if no entity was found with such combination. This query only works on entities with IDComponent.

Parameters:

name - entity name

id - entity id

Returns:

entity that matches the query or Optional.empty()