com.badlogic.gdx.scenes.scene2d

Class Action

java.lang.Object

com.badlogic.gdx.scenes.scene2d.Action

All Implemented Interfaces:

Pool.Poolable

Direct Known Subclasses:

AddAction, AddListenerAction, DelegateAction, LayoutAction, ParallelAction, RemoveAction, RemoveActorAction, RemoveListenerAction, RunnableAction, TemporalAction, TouchableAction, VisibleAction

public abstract class Action
extends java.lang.Object
implements Pool.Poolable

Actions attach to an Actor and perform some task, often over time.

Author:

Nathan Sweet

Field Summary

Fields

Modifier and Type	Field and Description
protected Actor	actor The actor this action is attached to, or null if it is not attached.

Constructor Summary

Constructors

Constructor and Description
Action()

Method Summary

Methods

Modifier and Type	Method and Description
abstract boolean	act(float delta) Updates the action based on time.
Actor	getActor()
Pool	getPool()
void	reset() Resets the optional state of this action to as if it were newly created, allowing the action to be pooled and reused.
void	restart() Sets the state of the action so it can be run again.
void	setActor(Actor actor) Sets the actor this action will be used for.
void	setPool(Pool pool) Sets the pool that the action will be returned to when removed from the actor.
java.lang.String	toString()

Methods inherited from class java.lang.Object

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

Field Detail

actor

protected Actor actor

The actor this action is attached to, or null if it is not attached.

Constructor Detail

Action

public Action()

Method Detail

act

public abstract boolean act(float delta)

Updates the action based on time. Typically this is called each frame by Actor.act(float).

Parameters:

delta - Time in seconds since the last frame.

Returns:

true if the action is done. This method may continue to be called after the action is done.

restart

public void restart()

Sets the state of the action so it can be run again.

getActor

public Actor getActor()

Returns:

null if the action is not attached to an actor.

setActor

public void setActor(Actor actor)

Sets the actor this action will be used for. This is called automatically when an action is added to an actor. This is also called with null when an action is removed from an actor. When set to null, if the action has a pool then the action is returned to the pool (which calls reset()) and the pool is set to null. If the action does not have a pool, reset() is called.

This method is not typically a good place for a subclass to query the actor's state because the action may not be executed for some time, eg it may be delayed. The actor's state is best queried in the first call to act(float). For a TemporalAction, use TemporalAction#begin().

reset

public void reset()

Resets the optional state of this action to as if it were newly created, allowing the action to be pooled and reused. State required to be set for every usage of this action or computed during the action does not need to be reset.

The default implementation calls restart().

If a subclass has optional state, it must override this method, call super, and reset the optional state.

Specified by:

reset in interface Pool.Poolable

getPool

public Pool getPool()

setPool

public void setPool(Pool pool)

Sets the pool that the action will be returned to when removed from the actor.

See Also:

setActor(Actor)

toString

public java.lang.String toString()

Overrides:

toString in class java.lang.Object