com.jme3.ai.agents.behaviours.npc.steering

Class SeparationBehaviour

java.lang.Object

com.jme3.scene.control.AbstractControl

com.jme3.ai.agents.behaviours.Behaviour

com.jme3.ai.agents.behaviours.npc.steering.AbstractSteeringBehaviour

com.jme3.ai.agents.behaviours.npc.steering.AbstractStrengthSteeringBehaviour

com.jme3.ai.agents.behaviours.npc.steering.SeparationBehaviour

All Implemented Interfaces:

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

public class SeparationBehaviour
extends AbstractStrengthSteeringBehaviour

Brent Owens: "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

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	SeparationBehaviour.ObstacleAvoindanceWithNegativeMinDistance

Nested classes/interfaces inherited from class com.jme3.ai.agents.behaviours.npc.steering.AbstractStrengthSteeringBehaviour

AbstractStrengthSteeringBehaviour.negativeScalarMultiplier

Nested classes/interfaces inherited from class com.jme3.ai.agents.behaviours.npc.steering.AbstractSteeringBehaviour

AbstractSteeringBehaviour.IllegalBrakingFactor

Nested classes/interfaces inherited from class com.jme3.ai.agents.behaviours.Behaviour

Behaviour.behaviourNullAgentException

Field Summary

Fields inherited from class com.jme3.ai.agents.behaviours.npc.steering.AbstractSteeringBehaviour

velocity

Fields inherited from class com.jme3.ai.agents.behaviours.Behaviour

agent

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

enabled, spatial

Constructor Summary

Constructors

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

Method Summary

Methods

Modifier and Type	Method and Description
protected com.jme3.math.Vector3f	calculateFullSteering() Original steering method by Brent Owens.
protected void	controlRender(com.jme3.renderer.RenderManager rm, com.jme3.renderer.ViewPort vp)
void	setMinDistance(float minDistance)
void	setObstacles(java.util.List<Agent> obstacles)

Methods inherited from class com.jme3.ai.agents.behaviours.npc.steering.AbstractStrengthSteeringBehaviour

calculateSteering, setupStrengthControl, setupStrengthControl, setupStrengthControl, setupStrengthControl, turnOffStrengthControl

Methods inherited from class com.jme3.ai.agents.behaviours.npc.steering.AbstractSteeringBehaviour

agentTotalMass, calculateNewVelocity, controlUpdate, getBrakingFactor, getTPF, getVelocity, rotateAgent, setBrakingFactor, setTPF, setVelocity

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

SeparationBehaviour

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

Parameters:

agent - To whom behaviour belongs.

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

SeparationBehaviour

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

Parameters:

spatial - active spatial during excecution of behaviour

See Also:

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

SeparationBehaviour

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

Parameters:

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

See Also:

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

SeparationBehaviour

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

Parameters:

spatial - active spatial during excecution of behaviour

See Also:

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

Method Detail

setMinDistance

public void setMinDistance(float minDistance)

setObstacles

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

controlRender

protected void controlRender(com.jme3.renderer.RenderManager rm,
                 com.jme3.renderer.ViewPort vp)

Specified by:

controlRender in class com.jme3.scene.control.AbstractControl

calculateFullSteering

protected com.jme3.math.Vector3f calculateFullSteering()

Original steering method by Brent Owens. Adaptation to MonkeyBrains by Jesús Martín Berlanga

Specified by:

calculateFullSteering in class AbstractStrengthSteeringBehaviour

See Also:

AbstractSteeringBehaviour.calculateSteering()