com.badlogic.gdx.ai.steer.behaviors

Class Alignment<T extends com.badlogic.gdx.math.Vector<T>>

java.lang.Object

com.badlogic.gdx.ai.steer.SteeringBehavior<T>

com.badlogic.gdx.ai.steer.GroupBehavior<T>

com.badlogic.gdx.ai.steer.behaviors.Alignment<T>

Type Parameters:

T - Type of vector, either 2D or 3D, implementing the Vector interface

All Implemented Interfaces:

Proximity.ProximityCallback<T>

public class Alignment<T extends com.badlogic.gdx.math.Vector<T>>
extends GroupBehavior<T>
implements Proximity.ProximityCallback<T>

Alignment is a group behavior producing a linear acceleration that attempts to keep the owner aligned with the agents in its immediate area defined by the given Proximity. The acceleration is calculated by first iterating through all the neighbors and averaging their linear velocity vectors. This value is the desired direction, so we just subtract the owner's linear velocity to get the steering output.

Cars moving along roads demonstrate Alignment type behavior. They also demonstrate Separation as they try to keep a minimum distance from each other.

Field Summary

Fields inherited from class com.badlogic.gdx.ai.steer.GroupBehavior

proximity

Fields inherited from class com.badlogic.gdx.ai.steer.SteeringBehavior

enabled, limiter, owner

Constructor Summary

Constructors

Constructor and Description
Alignment(Steerable<T> owner, Proximity<T> proximity) Creates an Alignment behavior for the specified owner and proximity.

Method Summary

Modifier and Type	Method and Description
protected SteeringAcceleration<T>	calculateRealSteering(SteeringAcceleration<T> steering) Calculates the steering acceleration produced by this behavior and writes it to the given steering output.
boolean	reportNeighbor(Steerable<T> neighbor) The callback method used to report a neighbor.
Alignment<T>	setEnabled(boolean enabled) Sets this steering behavior on/off.
Alignment<T>	setLimiter(Limiter limiter) Sets the limiter of this steering behavior.
Alignment<T>	setOwner(Steerable<T> owner) Sets the owner of this steering behavior.

Methods inherited from class com.badlogic.gdx.ai.steer.GroupBehavior

getProximity, setProximity

Methods inherited from class com.badlogic.gdx.ai.steer.SteeringBehavior

calculateSteering, getActualLimiter, getLimiter, getOwner, isEnabled, newVector

Methods inherited from class java.lang.Object

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

Constructor Detail

Alignment

public Alignment(Steerable<T> owner,
                 Proximity<T> proximity)

Creates an Alignment behavior for the specified owner and proximity.

Parameters:

owner - the owner of this behavior

proximity - the proximity

Method Detail

calculateRealSteering

protected SteeringAcceleration<T> calculateRealSteering(SteeringAcceleration<T> steering)

Description copied from class: SteeringBehavior

Calculates the steering acceleration produced by this behavior and writes it to the given steering output.

This method is called by SteeringBehavior.calculateSteering(SteeringAcceleration) when this steering behavior is enabled.

Specified by:

calculateRealSteering in class SteeringBehavior<T extends com.badlogic.gdx.math.Vector<T>>

Parameters:

steering - the steering acceleration to be calculated.

Returns:

the calculated steering acceleration for chaining.

reportNeighbor

public boolean reportNeighbor(Steerable<T> neighbor)

Description copied from interface: Proximity.ProximityCallback

The callback method used to report a neighbor.

Specified by:

reportNeighbor in interface Proximity.ProximityCallback<T extends com.badlogic.gdx.math.Vector<T>>

Parameters:

neighbor - the reported neighbor.

Returns:

true if the given neighbor is valid; false otherwise.

setOwner

public Alignment<T> setOwner(Steerable<T> owner)

Description copied from class: SteeringBehavior

Sets the owner of this steering behavior.

Overrides:

setOwner in class SteeringBehavior<T extends com.badlogic.gdx.math.Vector<T>>

Returns:

this behavior for chaining.

setEnabled

public Alignment<T> setEnabled(boolean enabled)

Description copied from class: SteeringBehavior

Sets this steering behavior on/off.

Overrides:

setEnabled in class SteeringBehavior<T extends com.badlogic.gdx.math.Vector<T>>

Returns:

this behavior for chaining.

setLimiter

public Alignment<T> setLimiter(Limiter limiter)

Sets the limiter of this steering behavior. The given limiter must at least take care of the maximum linear acceleration.

Overrides:

setLimiter in class SteeringBehavior<T extends com.badlogic.gdx.math.Vector<T>>

Returns:

this behavior for chaining.