com.jme3.ai.agents.behaviors.npc.steering

Class SeparationBehavior

java.lang.Object

com.jme3.scene.control.AbstractControl

com.jme3.ai.agents.behaviors.Behavior

com.jme3.ai.agents.behaviors.npc.steering.AbstractSteeringBehavior

com.jme3.ai.agents.behaviors.npc.steering.AbstractStrengthSteeringBehavior

com.jme3.ai.agents.behaviors.npc.steering.SeparationBehavior

All Implemented Interfaces:

com.jme3.export.Savable, com.jme3.scene.control.Control

public class SeparationBehavior
extends AbstractStrengthSteeringBehavior

Separation steering behavior gives a character the ability to maintain a certain separation distance from others nearby. This can be used to prevent characters from crowding together.

For each nearby character, a repulsive force is computed by subtracting the positions of our character and the nearby character, normalizing, and then applying a 1/r weighting. (That is, the position offset vector is scaled by 1/r^2.)". "These repulsive forces for each nearby character are summed together to produce the overall steering force.

The supplied neighbours should only be the nearby neighbours in the field of view of the character that is steering. It is good to ignore anything behind the character."

Version:

1.3.2

Author:

Jesús Martín Berlanga

Field Summary

Fields inherited from class com.jme3.ai.agents.behaviors.npc.steering.AbstractSteeringBehavior

timePerFrame, velocity

Fields inherited from class com.jme3.ai.agents.behaviors.Behavior

agent

Fields inherited from class com.jme3.scene.control.AbstractControl

enabled, spatial

Constructor Summary

Constructors

Constructor and Description
SeparationBehavior(Agent agent, java.util.List<GameEntity> initialObstacles)
SeparationBehavior(Agent agent, java.util.List<GameEntity> initialObstacles, float minDistance)
SeparationBehavior(Agent agent, java.util.List<GameEntity> initialObstacles, float minDistance, com.jme3.scene.Spatial spatial)
SeparationBehavior(Agent agent, java.util.List<GameEntity> initialObstacles, com.jme3.scene.Spatial spatial)

Method Summary

Methods

Modifier and Type	Method and Description
protected com.jme3.math.Vector3f	calculateRawSteering() If a behavior class extend from CompoundSteeringBehaviour instead of AbstractSteeringBehavior, it must implement this method instead of calculateSteering().
void	setMinDistance(float minDistance)
void	setObstacles(java.util.List<GameEntity> obstacles)
void	setObstaclesFromTeam(Team team)

Methods inherited from class com.jme3.ai.agents.behaviors.npc.steering.AbstractStrengthSteeringBehavior

calculateSteering, setupStrengthControl, setupStrengthControl, setupStrengthControl, setupStrengthControl, setupStrengthControl, turnOffStrengthControl

Methods inherited from class com.jme3.ai.agents.behaviors.npc.steering.AbstractSteeringBehavior

agentTotalMass, calculateNewVelocity, controlUpdate, convertToGameEntities, getBrakingFactor, getTimePerFrame, getVelocity, rotateAgent, setBrakingFactor, setTimePerFrame, setVelocity

Methods inherited from class com.jme3.ai.agents.behaviors.Behavior

controlRender

Methods inherited from class com.jme3.scene.control.AbstractControl

cloneForSpatial, getSpatial, isEnabled, read, render, setEnabled, setSpatial, update, write

Methods inherited from class java.lang.Object

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

Constructor Detail

SeparationBehavior

public SeparationBehavior(Agent agent,
                  java.util.List<GameEntity> initialObstacles)

Parameters:

agent - To whom behavior belongs.

initialObstacles - Initializes a list with the obstacles from the agent want to be separated

SeparationBehavior

public SeparationBehavior(Agent agent,
                  java.util.List<GameEntity> initialObstacles,
                  com.jme3.scene.Spatial spatial)

Parameters:

spatial - active spatial during excecution of behavior

See Also:

SeparationBehavior(com.jme3.ai.agents.Agent, java.util.List)

SeparationBehavior

public SeparationBehavior(Agent agent,
                  java.util.List<GameEntity> initialObstacles,
                  float minDistance)

Parameters:

minDistance - Min. distance from center to center to consider an obstacle

See Also:

SeparationBehavior(com.jme3.ai.agents.Agent, java.util.List)

SeparationBehavior

public SeparationBehavior(Agent agent,
                  java.util.List<GameEntity> initialObstacles,
                  float minDistance,
                  com.jme3.scene.Spatial spatial)

Parameters:

spatial - active spatial during excecution of behaviour

See Also:

SeparationBehavior(com.jme3.ai.agents.Agent, java.util.List, float)

Method Detail

calculateRawSteering

protected com.jme3.math.Vector3f calculateRawSteering()

Description copied from class: AbstractStrengthSteeringBehavior

If a behavior class extend from CompoundSteeringBehaviour instead of AbstractSteeringBehavior, it must implement this method instead of calculateSteering().

Specified by:

calculateRawSteering in class AbstractStrengthSteeringBehavior

Returns:

See Also:

AbstractSteeringBehavior.calculateSteering()

setMinDistance

public void setMinDistance(float minDistance)

setObstacles

public void setObstacles(java.util.List<GameEntity> obstacles)

setObstaclesFromTeam

public void setObstaclesFromTeam(Team team)