Package dev.prozilla.pine.core.entity

Class Entity

java.lang.Object

dev.prozilla.pine.common.event.EventDispatcher<EntityEvent>

dev.prozilla.pine.core.entity.Entity

All Implemented Interfaces:

Lifecycle, Printable, ComponentFinder, EntityFinder

public class Entity
extends EventDispatcher<EntityEvent>
implements Lifecycle, Printable, EntityFinder, ComponentFinder

Represents a unique entity in the world with a list of components.

Field Summary

Fields

Modifier and Type	Field	Description
protected final Application	application
final List<Component>	components	Components of this entity
final int	id
protected boolean	isActive
protected final Logger	logger
protected final Scene	scene
String	tag
final Transform	transform
protected final World	world

Constructor Summary

Constructors

Constructor	Description
Entity(World world)	Creates an entity at the position (0, 0)
Entity(World world, float x, float y)	Creates an entity at the position (x, y)
Entity(World world, String name)	Creates an entity at the position (0, 0)
Entity(World world, String name, float x, float y)	Creates an entity at the position (x, y)

Method Summary

Modifier and Type	Method	Description
Entity	addChild(Entity child)	Adds a child to this entity.
Entity	addChild(Prefab prefab)	Instantiates a prefab and adds the instance as a child of this entity
void	addChildren(Entity... children)	Adds children to this entity.
<C extends Component> C	addComponent(C component)	Adds a component to this entity.
void	destroy()	Destroys this entity at the end of the game loop.
boolean	equals(Entity entity)	Checks whether two entities are equal.
Application	getApplication()
CameraData	getCamera()
Entity	getChildWithTag(String tag)
<ComponentType extends Component> ComponentType	getComponent(Class<ComponentType> componentClass)	Returns a component of a given class or null of there isn't one.
<ComponentType extends Component> ComponentType	getComponentInParent(Class<ComponentType> componentClass)
<ComponentType extends Component> ComponentType	getComponentInParent(Class<ComponentType> componentClass, boolean includeAncestors)
<ComponentType extends Component> List<ComponentType>	getComponents(Class<ComponentType> componentClass)	Returns all components of a given class.
<ComponentType extends Component> List<ComponentType>	getComponentsInChildren(Class<ComponentType> componentClass)
Input	getInput()
Logger	getLogger()
String	getName()
String	getName(String defaultName)
Entity	getParentWithTag(String tag)
Renderer	getRenderer()
Scene	getScene()
Timer	getTimer()
Tracker	getTracker()
Window	getWindow()
World	getWorld()
<ComponentType extends Component> boolean	hasComponent(Class<ComponentType> componentClass)	Checks if this entity has a component of a given class.
int	hashCode()
boolean	hasTag(String tag)
boolean	isActive()
boolean	isRegistered()
void	printHierarchy()
void	removeChild(Entity child)	Detaches a child from this entity without removing it from the world.
void	removeChildren(Entity... children)	Detaches children from this entity without removing them from the world.
void	removeComponent(Component component)	Removes a component from this entity.
void	setActive(boolean active)	Enables/disables this entity.
void	setParent(Entity parent)	Setter for the parent entity.
String	toString()	Returns a string representation of this object.

Methods inherited from class dev.prozilla.pine.common.event.EventDispatcher

addListener, invoke, removeListener, setLogger

Methods inherited from class java.lang.Object

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

Methods inherited from interface dev.prozilla.pine.common.Lifecycle

init, init, input, input, render, render, start, update, update

Methods inherited from interface dev.prozilla.pine.common.Printable

print, print

Field Details

id

public final int id

tag

public String tag

isActive

protected boolean isActive

transform

public final Transform transform

world

protected final World world

application

protected final Application application

logger

protected final Logger logger

scene

protected final Scene scene

components

public final List<Component> components

Components of this entity

Constructor Details

Entity

public Entity(World world)

Creates an entity at the position (0, 0)

Entity

public Entity(World world,
 String name)

Creates an entity at the position (0, 0)

Entity

public Entity(World world,
 float x,
 float y)

Creates an entity at the position (x, y)

Entity

public Entity(World world,
 String name,
 float x,
 float y)

Creates an entity at the position (x, y)

Method Details

destroy

public void destroy()

Destroys this entity at the end of the game loop.

Specified by:

destroy in interface Lifecycle

Overrides:

destroy in class EventDispatcher<EntityEvent>

addChild

public Entity addChild(Prefab prefab)
                throws IllegalStateException,
IllegalArgumentException

Instantiates a prefab and adds the instance as a child of this entity

Parameters:

prefab - Prefab for the child entity

Returns:

Child entity

Throws:

IllegalStateException

IllegalArgumentException

addChild

public Entity addChild(Entity child)
                throws IllegalStateException,
IllegalArgumentException

Adds a child to this entity. Also adds the child to the world if this entity is inside the world.

Parameters:

child - Entity to add as a child

Returns:

Child entity

Throws:

IllegalStateException

IllegalArgumentException

addChildren

public void addChildren(Entity... children)
                 throws IllegalStateException,
IllegalArgumentException

Adds children to this entity.

Parameters:

children - Child objects

Throws:

IllegalStateException

IllegalArgumentException

removeChild

public void removeChild(Entity child)
                 throws IllegalStateException,
IllegalArgumentException

Detaches a child from this entity without removing it from the world.

Parameters:

child - Child object

Throws:

IllegalStateException

IllegalArgumentException

removeChildren

public void removeChildren(Entity... children)
                    throws IllegalStateException,
IllegalArgumentException

Detaches children from this entity without removing them from the world.

Parameters:

children - Child entities

Throws:

IllegalStateException

IllegalArgumentException

getChildWithTag

public Entity getChildWithTag(String tag)

Specified by:

getChildWithTag in interface EntityFinder

getParentWithTag

public Entity getParentWithTag(String tag)

Specified by:

getParentWithTag in interface EntityFinder

setParent

public void setParent(Entity parent)

Setter for the parent entity.

Parameters:

parent - Parent entity

setActive

public void setActive(boolean active)

Enables/disables this entity.

isActive

public boolean isActive()

addComponent

public <C extends Component> C addComponent(C component)

Adds a component to this entity.

Parameters:

component - Component

removeComponent

public void removeComponent(Component component)

Removes a component from this entity.

Parameters:

component - Component

getComponentInParent

public <ComponentType extends Component>
ComponentType getComponentInParent(Class<ComponentType> componentClass)

Specified by:

getComponentInParent in interface ComponentFinder

getComponentInParent

public <ComponentType extends Component>
ComponentType getComponentInParent(Class<ComponentType> componentClass,
 boolean includeAncestors)

Specified by:

getComponentInParent in interface ComponentFinder

getComponentsInChildren

public <ComponentType extends Component>
List<ComponentType> getComponentsInChildren(Class<ComponentType> componentClass)

Specified by:

getComponentsInChildren in interface ComponentFinder

hasComponent

public <ComponentType extends Component> boolean hasComponent(Class<ComponentType> componentClass)

Checks if this entity has a component of a given class.

Parameters:

componentClass - Class of the component.

Returns:

True if this entity has a component of type componentClass.

getComponent

public <ComponentType extends Component>
ComponentType getComponent(Class<ComponentType> componentClass)

Returns a component of a given class or null of there isn't one.

Specified by:

getComponent in interface ComponentFinder

Parameters:

componentClass - Class of the component.

Returns:

An instance of componentClass that is attached to this entity.

getComponents

public <ComponentType extends Component>
List<ComponentType> getComponents(Class<ComponentType> componentClass)

Returns all components of a given class.

Specified by:

getComponents in interface ComponentFinder

Parameters:

componentClass - Class of the components.

Returns:

An ArrayList of instance of componentClass that are attached to this entity.

getName

public String getName()

getName

public String getName(String defaultName)

hasTag

public boolean hasTag(String tag)

getInput

public Input getInput()

getWindow

public Window getWindow()

getRenderer

public Renderer getRenderer()

getTimer

public Timer getTimer()

getTracker

public Tracker getTracker()

getApplication

public Application getApplication()

getWorld

public World getWorld()

getScene

public Scene getScene()

getCamera

public CameraData getCamera()

getLogger

public Logger getLogger()

isRegistered

public boolean isRegistered()

hashCode

public int hashCode()

Overrides:

hashCode in class Object

equals

public boolean equals(Entity entity)

Checks whether two entities are equal.

Parameters:

entity - Other entity

Returns:

True if the entities are equal

printHierarchy

public void printHierarchy()

toString

public String toString()

Description copied from interface: Printable

Returns a string representation of this object.

Specified by:

toString in interface Printable

Overrides:

toString in class Object

Returns:

String representation of this object.