com.badlogic.gdx.ai.steer.proximities

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

java.lang.Object

com.badlogic.gdx.ai.steer.proximities.ProximityBase<T>

com.badlogic.gdx.ai.steer.proximities.RadiusProximity<T>

Type Parameters:

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

All Implemented Interfaces:

Proximity<T>

public class RadiusProximity<T extends com.badlogic.gdx.math.Vector<T>>
extends ProximityBase<T>

A RadiusProximity elaborates any agents contained in the specified list that are within the radius of the owner.

Note that this implementation checks the AI time of the current frame through the GdxAI.getTimepiece().getTime() method in order to calculate neighbors only once per frame (assuming delta time is always greater than 0, if time has changed the frame has changed too). This means that

• if you forget to update the timepiece on each frame the proximity instance will be calculated only the very first time, which is not what you want of course.
• ideally the timepiece should be updated before the proximity is updated by the Proximity.findNeighbors(ProximityCallback) method.

Nested Class Summary

Nested classes/interfaces inherited from interface com.badlogic.gdx.ai.steer.Proximity

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

Field Summary

Fields

Modifier and Type	Field and Description
protected float	radius The radius of this proximity.

Fields inherited from class com.badlogic.gdx.ai.steer.proximities.ProximityBase

agents, owner

Constructor Summary

Constructors

Constructor and Description
RadiusProximity(Steerable<T> owner, java.lang.Iterable<? extends Steerable<T>> agents, float radius) Creates a RadiusProximity for the specified owner, agents and radius.

Method Summary

Modifier and Type	Method and Description
int	findNeighbors(Proximity.ProximityCallback<T> callback) Finds the agents that are within the immediate area of the owner.
float	getRadius() Returns the radius of this proximity.
void	setRadius(float radius) Sets the radius of this proximity.

Methods inherited from class com.badlogic.gdx.ai.steer.proximities.ProximityBase

getAgents, getOwner, setAgents, setOwner

Methods inherited from class java.lang.Object

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

Field Detail

radius

protected float radius

The radius of this proximity.

Constructor Detail

RadiusProximity

public RadiusProximity(Steerable<T> owner,
                       java.lang.Iterable<? extends Steerable<T>> agents,
                       float radius)

Creates a RadiusProximity for the specified owner, agents and radius.

Parameters:

owner - the owner of this proximity

agents - the agents

radius - the radius of the cone area

Method Detail

getRadius

public float getRadius()

Returns the radius of this proximity.

setRadius

public void setRadius(float radius)

Sets the radius of this proximity.

findNeighbors

public int findNeighbors(Proximity.ProximityCallback<T> callback)

Description copied from interface: Proximity

Finds the agents that are within the immediate area of the owner. Each of those agents is passed to the reportNeighbor method of the specified callback.

Returns:

the number of neighbors found.