PhysicsSpace (jMonkeyEngine 3.5.2-stable jme3-jbullet Javadoc)

java.lang.Object
- com.jme3.bullet.PhysicsSpace

```
public class PhysicsSpace
extends java.lang.Object
```
PhysicsSpace - The central jbullet-jme physics space

Author:

normenhansen

Nested Class Summary

Nested Classes
Modifier and Type Class and Description

static class PhysicsSpace.BroadphaseType
interface with Broadphase types

Nested Classes
Modifier and Type	Class and Description
`static class`	`PhysicsSpace.BroadphaseType` interface with Broadphase types

Field Summary

Fields
Modifier and Type Field and Description

static int AXIS_X
index of the X axis

static int AXIS_Y
index of the Y axis

static int AXIS_Z
index of the Z axis

Fields
Modifier and Type	Field and Description
`static int`	`AXIS_X` index of the X axis
`static int`	`AXIS_Y` index of the Y axis
`static int`	`AXIS_Z` index of the Z axis

Constructor Summary

Constructors
Constructor and Description
`PhysicsSpace()`
`PhysicsSpace(PhysicsSpace.BroadphaseType broadphaseType)`
`PhysicsSpace(com.jme3.math.Vector3f worldMin, com.jme3.math.Vector3f worldMax)`
`PhysicsSpace(com.jme3.math.Vector3f worldMin, com.jme3.math.Vector3f worldMax, PhysicsSpace.BroadphaseType broadphaseType)`

Method Summary

All Methods Static Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`void`	`add(java.lang.Object obj)` adds an object to the physics space
`void`	`addAll(com.jme3.scene.Spatial spatial)` adds all physics controls and joints in the given spatial node to the physics space (e.g.
`void`	`addCollisionGroupListener(PhysicsCollisionGroupListener listener, int collisionGroup)` Adds a listener for a specific collision group, such a listener can disable collisions when they happen. There can be only one listener per collision group.
`void`	`addCollisionListener(PhysicsCollisionListener listener)` Adds a CollisionListener that will be informed about collision events
`void`	`addCollisionObject(PhysicsCollisionObject obj)`
`void`	`addTickListener(PhysicsTickListener listener)` Adds the specified listener to the physics tick listeners.
`void`	`applyGravity()` applies gravity value to all objects
`void`	`clearForces()` clears forces of all objects
`void`	`create()` Has to be called from the (designated) physics thread
`void`	`destroy()` destroys the current PhysicsSpace so that a new one can be created
`void`	`distributeEvents()`
`<V> java.util.concurrent.Future<V>`	`enqueue(java.util.concurrent.Callable<V> callable)` calls the callable on the next physics tick (ensuring e.g.
`static <V> java.util.concurrent.Future<V>`	`enqueueOnThisThread(java.util.concurrent.Callable<V> callable)`
`float`	`getAccuracy()` get the current accuracy of the physics computation
`PhysicsSpace.BroadphaseType`	`getBroadphaseType()`
`java.util.Collection<PhysicsCharacter>`	`getCharacterList()`
`com.bulletphysics.dynamics.DynamicsWorld`	`getDynamicsWorld()` used internally
`java.util.Collection<PhysicsGhostObject>`	`getGhostObjectList()`
`com.jme3.math.Vector3f`	`getGravity(com.jme3.math.Vector3f gravity)` Gets the gravity of the PhysicsSpace
`java.util.Collection<PhysicsJoint>`	`getJointList()`
`static PhysicsSpace`	`getPhysicsSpace()` Get the current PhysicsSpace running on this thread For parallel physics, this can also be called from the OpenGL thread to receive the PhysicsSpace
`java.util.Collection<PhysicsRigidBody>`	`getRigidBodyList()`
`int`	`getSolverNumIterations()`
`java.util.Collection<PhysicsVehicle>`	`getVehicleList()`
`com.jme3.math.Vector3f`	`getWorldMax()`
`com.jme3.math.Vector3f`	`getWorldMin()`
`java.util.List<PhysicsRayTestResult>`	`rayTest(com.jme3.math.Vector3f from, com.jme3.math.Vector3f to)` Performs a ray collision test and returns the results as a list of PhysicsRayTestResults
`java.util.List<PhysicsRayTestResult>`	`rayTest(com.jme3.math.Vector3f from, com.jme3.math.Vector3f to, java.util.List<PhysicsRayTestResult> results)` Performs a ray collision test and returns the results as a list of PhysicsRayTestResults
`void`	`remove(java.lang.Object obj)` removes an object from the physics space
`void`	`removeAll(com.jme3.scene.Spatial spatial)` Removes all physics controls and joints in the given spatial from the physics space (e.g.
`void`	`removeCollisionGroupListener(int collisionGroup)`
`void`	`removeCollisionListener(PhysicsCollisionListener listener)` Removes a CollisionListener from the list
`void`	`removeCollisionObject(PhysicsCollisionObject obj)`
`void`	`removeTickListener(PhysicsTickListener listener)`
`void`	`setAccuracy(float accuracy)` sets the accuracy of the physics computation, default=1/60s
`void`	`setBroadphaseType(PhysicsSpace.BroadphaseType broadphaseType)`
`void`	`setGravity(com.jme3.math.Vector3f gravity)` Sets the gravity of the PhysicsSpace, set before adding physics objects!
`static void`	`setLocalThreadPhysicsSpace(PhysicsSpace space)` Used internally
`void`	`setMaxSubSteps(int steps)` Sets the maximum amount of extra steps that will be used to step the physics when the fps is below the physics fps.
`void`	`setSolverNumIterations(int numIterations)` Set the number of iterations used by the contact solver.
`void`	`setWorldMax(com.jme3.math.Vector3f worldMax)` only applies for AXIS_SWEEP broadphase
`void`	`setWorldMin(com.jme3.math.Vector3f worldMin)` only applies for AXIS_SWEEP broadphase
`java.util.List<PhysicsSweepTestResult>`	`sweepTest(CollisionShape shape, com.jme3.math.Transform start, com.jme3.math.Transform end)` Performs a sweep collision test and returns the results as a list of PhysicsSweepTestResults You have to use different Transforms for start and end (at least distance greater than 0.4f).
`java.util.List<PhysicsSweepTestResult>`	`sweepTest(CollisionShape shape, com.jme3.math.Transform start, com.jme3.math.Transform end, java.util.List<PhysicsSweepTestResult> results)` Performs a sweep collision test and returns the results as a list of PhysicsSweepTestResults You have to use different Transforms for start and end (at least distance greater than 0.4f).
`void`	`update(float time)` updates the physics space
`void`	`update(float time, int maxSteps)` updates the physics space, uses maxSteps

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Field Detail
  - AXIS_X
```
public static final int AXIS_X
```
    index of the X axis
    
    See Also:
    
    Constant Field Values
  - AXIS_Y
```
public static final int AXIS_Y
```
    index of the Y axis
    
    See Also:
    
    Constant Field Values
  - AXIS_Z
```
public static final int AXIS_Z
```
    index of the Z axis
    
    See Also:
    
    Constant Field Values
- Constructor Detail
  - PhysicsSpace
```
public PhysicsSpace()
```
  - PhysicsSpace
```
public PhysicsSpace(PhysicsSpace.BroadphaseType broadphaseType)
```
  - PhysicsSpace
```
public PhysicsSpace(com.jme3.math.Vector3f worldMin,
                    com.jme3.math.Vector3f worldMax)
```
  - PhysicsSpace
```
public PhysicsSpace(com.jme3.math.Vector3f worldMin,
                    com.jme3.math.Vector3f worldMax,
                    PhysicsSpace.BroadphaseType broadphaseType)
```
- Method Detail
  - getPhysicsSpace
```
public static PhysicsSpace getPhysicsSpace()
```
    Get the current PhysicsSpace running on this thread
    For parallel physics, this can also be called from the OpenGL thread to receive the PhysicsSpace
    
    Returns:
    
    the PhysicsSpace running on this thread
  - setLocalThreadPhysicsSpace
```
public static void setLocalThreadPhysicsSpace(PhysicsSpace space)
```
    Used internally
    
    Parameters:
    
    space - which space to simulate on the current thread
  - create
```
public void create()
```
    Has to be called from the (designated) physics thread
  - update
```
public void update(float time)
```
    updates the physics space
    
    Parameters:
    
    time - the current time value
  - update
```
public void update(float time,
                   int maxSteps)
```
    updates the physics space, uses maxSteps
    
    Parameters:
    
    time - the current time value
    
    maxSteps - the maximum number of steps of size accuracy (≥1) or 0 for a single step of size timeInterval
  - distributeEvents
```
public void distributeEvents()
```
  - enqueueOnThisThread
```
public static <V> java.util.concurrent.Future<V> enqueueOnThisThread(java.util.concurrent.Callable<V> callable)
```
  - enqueue
```
public <V> java.util.concurrent.Future<V> enqueue(java.util.concurrent.Callable<V> callable)
```
    calls the callable on the next physics tick (ensuring e.g. force applying)
    
    Type Parameters:
    
    V - the return type of the Callable
    
    Parameters:
    
    callable - the Callable to invoke
    
    Returns:
    
    a new AppTask
  - add
```
public void add(java.lang.Object obj)
```
    adds an object to the physics space
    
    Parameters:
    
    obj - the PhysicsControl or Spatial with PhysicsControl to add
  - addCollisionObject
```
public void addCollisionObject(PhysicsCollisionObject obj)
```
  - remove
```
public void remove(java.lang.Object obj)
```
    removes an object from the physics space
    
    Parameters:
    
    obj - the PhysicsControl or Spatial with PhysicsControl to remove
  - removeCollisionObject
```
public void removeCollisionObject(PhysicsCollisionObject obj)
```
  - addAll
```
public void addAll(com.jme3.scene.Spatial spatial)
```
    adds all physics controls and joints in the given spatial node to the physics space (e.g. after loading from disk) - recursive if node
    
    Parameters:
    
    spatial - the rootnode containing the physics objects
  - removeAll
```
public void removeAll(com.jme3.scene.Spatial spatial)
```
    Removes all physics controls and joints in the given spatial from the physics space (e.g. before saving to disk) - recursive if node
    
    Parameters:
    
    spatial - the rootnode containing the physics objects
  - getRigidBodyList
```
public java.util.Collection<PhysicsRigidBody> getRigidBodyList()
```
  - getGhostObjectList
```
public java.util.Collection<PhysicsGhostObject> getGhostObjectList()
```
  - getCharacterList
```
public java.util.Collection<PhysicsCharacter> getCharacterList()
```
  - getJointList
```
public java.util.Collection<PhysicsJoint> getJointList()
```
  - getVehicleList
```
public java.util.Collection<PhysicsVehicle> getVehicleList()
```
  - setGravity
```
public void setGravity(com.jme3.math.Vector3f gravity)
```
    Sets the gravity of the PhysicsSpace, set before adding physics objects!
    
    Parameters:
    
    gravity - the desired acceleration vector (in physics-space coordinates, not null, unaffected, default=0,-10,0)
  - getGravity
```
public com.jme3.math.Vector3f getGravity(com.jme3.math.Vector3f gravity)
```
    Gets the gravity of the PhysicsSpace
    
    Parameters:
    
    gravity - storage for the result (modified if not null)
    
    Returns:
    
    the acceleration vector (in physics-space coordinates, either gravity or a new instance)
  - applyGravity
```
public void applyGravity()
```
    applies gravity value to all objects
  - clearForces
```
public void clearForces()
```
    clears forces of all objects
  - addTickListener
```
public void addTickListener(PhysicsTickListener listener)
```
    Adds the specified listener to the physics tick listeners. The listeners are called on each physics step, which is not necessarily each frame but is determined by the accuracy of the physics space.
    
    Parameters:
    
    listener - the listener to register (not null, alias created)
  - removeTickListener
```
public void removeTickListener(PhysicsTickListener listener)
```
  - addCollisionListener
```
public void addCollisionListener(PhysicsCollisionListener listener)
```
    Adds a CollisionListener that will be informed about collision events
    
    Parameters:
    
    listener - the CollisionListener to add
  - removeCollisionListener
```
public void removeCollisionListener(PhysicsCollisionListener listener)
```
    Removes a CollisionListener from the list
    
    Parameters:
    
    listener - the CollisionListener to remove
  - addCollisionGroupListener
```
public void addCollisionGroupListener(PhysicsCollisionGroupListener listener,
                                      int collisionGroup)
```
    Adds a listener for a specific collision group, such a listener can disable collisions when they happen.
    There can be only one listener per collision group.
    
    Parameters:
    
    listener - the listener to register (not null, alias created)
    
    collisionGroup - which group it should listen for (bitmask with exactly one bit set)
  - removeCollisionGroupListener
```
public void removeCollisionGroupListener(int collisionGroup)
```
  - rayTest
```
public java.util.List<PhysicsRayTestResult> rayTest(com.jme3.math.Vector3f from,
                                                    com.jme3.math.Vector3f to)
```
    Performs a ray collision test and returns the results as a list of PhysicsRayTestResults
    
    Parameters:
    
    from - the starting location (physics-space coordinates, not null, unaffected)
    
    to - the ending location (in physics-space coordinates, not null, unaffected)
    
    Returns:
    
    a new list of results (not null)
  - rayTest
```
public java.util.List<PhysicsRayTestResult> rayTest(com.jme3.math.Vector3f from,
                                                    com.jme3.math.Vector3f to,
                                                    java.util.List<PhysicsRayTestResult> results)
```
    Performs a ray collision test and returns the results as a list of PhysicsRayTestResults
    
    Parameters:
    
    from - the starting location (in physics-space coordinates, not null, unaffected)
    
    to - the ending location (in physics-space coordinates, not null, unaffected)
    
    results - the list to hold results (not null, modified)
    
    Returns:
    
    results
  - sweepTest
```
public java.util.List<PhysicsSweepTestResult> sweepTest(CollisionShape shape,
                                                        com.jme3.math.Transform start,
                                                        com.jme3.math.Transform end)
```
    Performs a sweep collision test and returns the results as a list of PhysicsSweepTestResults
    You have to use different Transforms for start and end (at least distance greater than 0.4f). SweepTest will not see a collision if it starts INSIDE an object and is moving AWAY from its center.
    
    Parameters:
    
    shape - the shape to sweep (not null, convex, unaffected)
    
    start - the starting physics-space transform (not null, unaffected)
    
    end - the ending physics-space transform (not null, unaffected)
    
    Returns:
    
    a new list of results
  - sweepTest
```
public java.util.List<PhysicsSweepTestResult> sweepTest(CollisionShape shape,
                                                        com.jme3.math.Transform start,
                                                        com.jme3.math.Transform end,
                                                        java.util.List<PhysicsSweepTestResult> results)
```
    Performs a sweep collision test and returns the results as a list of PhysicsSweepTestResults
    You have to use different Transforms for start and end (at least distance greater than 0.4f). SweepTest will not see a collision if it starts INSIDE an object and is moving AWAY from its center.
    
    Parameters:
    
    shape - the shape to sweep (not null, convex, unaffected)
    
    start - the starting physics-space transform (not null, unaffected)
    
    end - the ending physics-space transform (not null, unaffected)
    
    results - the list to hold results (not null, modified)
    
    Returns:
    
    results
  - destroy
```
public void destroy()
```
    destroys the current PhysicsSpace so that a new one can be created
  - getDynamicsWorld
```
public com.bulletphysics.dynamics.DynamicsWorld getDynamicsWorld()
```
    used internally
    
    Returns:
    
    the dynamicsWorld
  - getBroadphaseType
```
public PhysicsSpace.BroadphaseType getBroadphaseType()
```
  - setBroadphaseType
```
public void setBroadphaseType(PhysicsSpace.BroadphaseType broadphaseType)
```
  - setMaxSubSteps
```
public void setMaxSubSteps(int steps)
```
    Sets the maximum amount of extra steps that will be used to step the physics when the fps is below the physics fps. Doing this maintains determinism in physics. For example a maximum number of 2 can compensate for frame rates as low as 30fps when the physics has the default accuracy of 60 fps. Note that setting this value too high can make the physics drive down its own fps in case it's overloaded.
    
    Parameters:
    
    steps - The maximum number of extra steps, default is 4.
  - getAccuracy
```
public float getAccuracy()
```
    get the current accuracy of the physics computation
    
    Returns:
    
    the current accuracy
  - setAccuracy
```
public void setAccuracy(float accuracy)
```
    sets the accuracy of the physics computation, default=1/60s
    
    Parameters:
    
    accuracy - the desired time step (in seconds, default=1/60)
  - getWorldMin
```
public com.jme3.math.Vector3f getWorldMin()
```
  - setWorldMin
```
public void setWorldMin(com.jme3.math.Vector3f worldMin)
```
    only applies for AXIS_SWEEP broadphase
    
    Parameters:
    
    worldMin - the desired minimum coordinates values (not null, unaffected, default=-10k,-10k,-10k)
  - getWorldMax
```
public com.jme3.math.Vector3f getWorldMax()
```
  - setWorldMax
```
public void setWorldMax(com.jme3.math.Vector3f worldMax)
```
    only applies for AXIS_SWEEP broadphase
    
    Parameters:
    
    worldMax - the desired maximum coordinates values (not null, unaffected, default=10k,10k,10k)
  - setSolverNumIterations
```
public void setSolverNumIterations(int numIterations)
```
    Set the number of iterations used by the contact solver. The default is 10. Use 4 for low quality, 20 for high quality.
    
    Parameters:
    
    numIterations - The number of iterations used by the contact and constraint solver.
  - getSolverNumIterations
```
public int getSolverNumIterations()
```

Class PhysicsSpace

Nested Class Summary

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

AXIS_X

AXIS_Y

AXIS_Z

Constructor Detail

PhysicsSpace

PhysicsSpace

PhysicsSpace

PhysicsSpace

Method Detail

getPhysicsSpace

setLocalThreadPhysicsSpace

create

update

update

distributeEvents

enqueueOnThisThread

enqueue

add

addCollisionObject

remove

removeCollisionObject

addAll

removeAll

getRigidBodyList

getGhostObjectList

getCharacterList

getJointList

getVehicleList

setGravity

getGravity

applyGravity

clearForces

addTickListener

removeTickListener

addCollisionListener

removeCollisionListener

addCollisionGroupListener

removeCollisionGroupListener

rayTest

rayTest

sweepTest

sweepTest

destroy

getDynamicsWorld

getBroadphaseType

setBroadphaseType

setMaxSubSteps

getAccuracy

setAccuracy

getWorldMin

setWorldMin

getWorldMax

setWorldMax

setSolverNumIterations

getSolverNumIterations