Package com.jme3.bullet.debug

Class BulletDebugAppState

java.lang.Object

com.jme3.app.state.AbstractAppState

com.jme3.bullet.debug.BulletDebugAppState

All Implemented Interfaces:

AppState

public class BulletDebugAppState
extends AbstractAppState

An app state to manage a debug visualization of a physics space.

This class is shared between JBullet and Native Bullet.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static interface	BulletDebugAppState.DebugAppStateFilter	Interface to restrict which physics objects are visualized.

Field Summary

Fields

Modifier and Type	Field	Description
protected Application	app
protected AssetManager	assetManager
protected HashMap<PhysicsRigidBody,Spatial>	bodies	map rigid bodies to visualizations
protected HashMap<PhysicsCharacter,Spatial>	characters	map physics characters to visualizations
Material	DEBUG_BLUE	material for inactive rigid bodies
Material	DEBUG_GREEN	material for joints
Material	DEBUG_MAGENTA	material for vehicles and active rigid bodies
Material	DEBUG_PINK	material for physics characters
Material	DEBUG_RED
Material	DEBUG_YELLOW	material for ghosts
protected BulletDebugAppState.DebugAppStateFilter	filter	limit which objects are visualized, or null to visualize all objects
protected HashMap<PhysicsGhostObject,Spatial>	ghosts	map ghosts to visualizations
protected HashMap<PhysicsJoint,Spatial>	joints	map joints to visualizations
protected static final Logger	logger	message logger for this class
protected final Node	physicsDebugRootNode	scene-graph node to parent the geometries
protected RenderManager	rm
protected final PhysicsSpace	space	physics space to visualize (not null)
protected HashMap<PhysicsVehicle,Spatial>	vehicles	map vehicles to visualizations
protected ViewPort	viewPort	view port in which to render (not null)

Fields inherited from class com.jme3.app.state.AbstractAppState

initialized

Constructor Summary

Constructors

Constructor	Description
BulletDebugAppState(PhysicsSpace space)	Instantiate an app state to visualize the specified space.

Method Summary

Modifier and Type	Method	Description
void	cleanup()	Transition this state from terminating to detached.
DebugTools	getNewDebugTools()
void	initialize(AppStateManager stateManager, Application app)	Initialize this state prior to its 1st update.
void	render(RenderManager rm)	Render this state.
void	setFilter(BulletDebugAppState.DebugAppStateFilter filter)	Alter which objects are visualized.
void	update(float tpf)	Update this state prior to rendering.

Methods inherited from class com.jme3.app.state.AbstractAppState

getId, isEnabled, isInitialized, postRender, setEnabled, setId, stateAttached, stateDetached

Methods inherited from class java.lang.Object

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

Field Details

logger

protected static final Logger logger

message logger for this class

filter

protected BulletDebugAppState.DebugAppStateFilter filter

limit which objects are visualized, or null to visualize all objects

app

protected Application app

assetManager

protected AssetManager assetManager

space

protected final PhysicsSpace space

physics space to visualize (not null)

physicsDebugRootNode

protected final Node physicsDebugRootNode

scene-graph node to parent the geometries

viewPort

protected ViewPort viewPort

view port in which to render (not null)

rm

protected RenderManager rm

DEBUG_BLUE

public Material DEBUG_BLUE

material for inactive rigid bodies

DEBUG_RED

public Material DEBUG_RED

DEBUG_GREEN

public Material DEBUG_GREEN

material for joints

DEBUG_YELLOW

public Material DEBUG_YELLOW

material for ghosts

DEBUG_MAGENTA

public Material DEBUG_MAGENTA

material for vehicles and active rigid bodies

DEBUG_PINK

public Material DEBUG_PINK

material for physics characters

bodies

protected HashMap<PhysicsRigidBody,Spatial> bodies

map rigid bodies to visualizations

joints

protected HashMap<PhysicsJoint,Spatial> joints

map joints to visualizations

ghosts

protected HashMap<PhysicsGhostObject,Spatial> ghosts

map ghosts to visualizations

characters

protected HashMap<PhysicsCharacter,Spatial> characters

map physics characters to visualizations

vehicles

protected HashMap<PhysicsVehicle,Spatial> vehicles

map vehicles to visualizations

Constructor Details

BulletDebugAppState

public BulletDebugAppState(PhysicsSpace space)

Instantiate an app state to visualize the specified space. This constructor should be invoked only by BulletAppState.

Parameters:

space - physics space to visualize (not null, alias created)

Method Details

getNewDebugTools

public DebugTools getNewDebugTools()

setFilter

public void setFilter(BulletDebugAppState.DebugAppStateFilter filter)

Alter which objects are visualized.

Parameters:

filter - the desired filter, or null to visualize all objects

initialize

public void initialize(AppStateManager stateManager,
 Application app)

Initialize this state prior to its 1st update. Should be invoked only by a subclass or by the AppStateManager.

Specified by:

initialize in interface AppState

Overrides:

initialize in class AbstractAppState

Parameters:

stateManager - the manager for this state (not null)

app - the application which owns this state (not null)

cleanup

public void cleanup()

Transition this state from terminating to detached. Should be invoked only by a subclass or by the AppStateManager. Invoked once for each time initialize(com.jme3.app.state.AppStateManager, com.jme3.app.Application) is invoked.

Specified by:

cleanup in interface AppState

Overrides:

cleanup in class AbstractAppState

update

public void update(float tpf)

Update this state prior to rendering. Should be invoked only by a subclass or by the AppStateManager. Invoked once per frame, provided the state is attached and enabled.

Specified by:

update in interface AppState

Overrides:

update in class AbstractAppState

Parameters:

tpf - the time interval between frames (in seconds, ≥0)

render

public void render(RenderManager rm)

Render this state. Should be invoked only by a subclass or by the AppStateManager. Invoked once per frame, provided the state is attached and enabled.

Specified by:

render in interface AppState

Overrides:

render in class AbstractAppState

Parameters:

rm - the render manager (not null)