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

Class WanderBehaviour

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.WanderBehaviour

All Implemented Interfaces:

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

Direct Known Subclasses:

RelativeWanderBehaviour

public class WanderBehaviour
extends AbstractStrengthSteeringBehaviour

This behaviour is based on a easy implementation that "generates random steering force each frame, but this produces rather uninteresting motion. It is 'twitchy' and produces no sustained turns.

Wander behaviour is steering behaviour where agent moves randomly on terrain. This is done by same calculation as seek behaviour, but difference is that target for this behaviour are random positions that changes durring time.

Version:

1.4.1

Author:

Tihomir Radosavljević, Jesús Martín Berlanga

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	WanderBehaviour.WanderWithoutWanderArea

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

Modifier and Type	Field and Description
protected com.jme3.math.Vector3f[]	area Area in which agent will wander.
protected com.jme3.math.Vector3f	targetPosition Position of target
protected float	time Current time.
protected float	timeInterval Time interval durring which target position doesn't change.

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
WanderBehaviour(Agent agent) Constructor for wander behaviour.
WanderBehaviour(Agent agent, com.jme3.scene.Spatial spatial) Constructor for wander behaviour.

Method Summary

Methods

Modifier and Type	Method and Description
protected com.jme3.math.Vector3f	calculateFullSteering() Calculate steering vector.
protected void	changeTargetPosition(float tpf) Metod for changing target position.
protected void	controlRender(com.jme3.renderer.RenderManager rm, com.jme3.renderer.ViewPort vp)
float	getTimeInterval() Get time interval for changing target position.
void	setArea(com.jme3.math.Vector3f from, com.jme3.math.Vector3f to) Setting area for wander.
void	setTimeInterval(float timeInterval) Setting time interval for changing target position.

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

Field Detail

targetPosition

protected com.jme3.math.Vector3f targetPosition

Position of target

timeInterval

protected float timeInterval

Time interval durring which target position doesn't change.

time

protected float time

Current time.

area

protected com.jme3.math.Vector3f[] area

Area in which agent will wander.

Constructor Detail

WanderBehaviour

public WanderBehaviour(Agent agent)

Constructor for wander behaviour.

Parameters:

agent - to whom behaviour belongs

WanderBehaviour

public WanderBehaviour(Agent agent,
               com.jme3.scene.Spatial spatial)

Constructor for wander behaviour.

Parameters:

agent - to whom behaviour belongs

spatial - active spatial during excecution of behaviour

Method Detail

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()

Calculate steering vector.

Specified by:

calculateFullSteering in class AbstractStrengthSteeringBehaviour

Returns:

steering vector

See Also:

AbstractSteeringBehaviour.calculateSteering()

changeTargetPosition

protected void changeTargetPosition(float tpf)

Metod for changing target position.

Parameters:

tpf - time per frame

getTimeInterval

public float getTimeInterval()

Get time interval for changing target position.

Returns:

setTimeInterval

public void setTimeInterval(float timeInterval)

Setting time interval for changing target position.

Parameters:

timeInterval -

setArea

public void setArea(com.jme3.math.Vector3f from,
           com.jme3.math.Vector3f to)

Setting area for wander.

Parameters:

from -

to -

Throws:

WanderBehaviour.WanderWithoutWanderArea - If any component from the area vectors match