com.artemis

Class ArchetypeBuilder

java.lang.Object

com.artemis.ArchetypeBuilder

public class ArchetypeBuilder
extends Object

Builder for basic Archetype instances. To reap the maximum benefit of Archetypes, it's recommended to stash them away inside an manager or similar. Archetypes main advantage come from the improved insertion into systems performance. Calling edit() on the Entity returned by World.createEntity(Archetype) nullifies this optimization.

Generated archetypes provide a blueprint for quick entity creation. Instance generated entities using World.createEntity(Archetype)

Since:

0.7

Constructor Summary

Constructors

Constructor and Description
ArchetypeBuilder() Constructs an empty archetype builder.
ArchetypeBuilder(Archetype parent) Constructs an archetype builder containing the composition of the specified parent.

Method Summary

Modifier and Type	Method and Description
ArchetypeBuilder	add(Class<? extends Component>... types) Ensure this builder includes the specified component types.
ArchetypeBuilder	add(Class<? extends Component> type) Ensure this builder includes the specified component type.
Archetype	build(World world) Create a new world specific instance of Archetype based on the current state.
ArchetypeBuilder	remove(Class<? extends Component>... types) Remove the specified component from this builder, if it is present (optional operation).
ArchetypeBuilder	remove(Class<? extends Component> type) Remove the specified component from this builder, if it is present (optional operation).

Methods inherited from class java.lang.Object

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

Constructor Detail

ArchetypeBuilder

public ArchetypeBuilder(Archetype parent)

Constructs an archetype builder containing the composition of the specified parent.

Parameters:

parent - archetype composition to copy.

ArchetypeBuilder

public ArchetypeBuilder()

Constructs an empty archetype builder.

Method Detail

add

public ArchetypeBuilder add(Class<? extends Component> type)

Ensure this builder includes the specified component type.

Parameters:

type -

Returns:

This instance for chaining.

add

public ArchetypeBuilder add(Class<? extends Component>... types)

Ensure this builder includes the specified component types.

Parameters:

types -

Returns:

This instance for chaining.

remove

public ArchetypeBuilder remove(Class<? extends Component> type)

Remove the specified component from this builder, if it is present (optional operation).

Parameters:

type -

Returns:

This instance for chaining.

remove

public ArchetypeBuilder remove(Class<? extends Component>... types)

Remove the specified component from this builder, if it is present (optional operation).

Parameters:

types -

Returns:

This instance for chaining.

build

public Archetype build(World world)

Create a new world specific instance of Archetype based on the current state.

Parameters:

world - applicable domain of the Archetype.

Returns:

new Archetype based on current state