PhysicsSpace (jMonkeyEngine3)

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

public class PhysicsSpace
extends java.lang.Object

PhysicsSpace - The central jbullet-jme physics space

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(Vector3f worldMin, Vector3f worldMax)`
`PhysicsSpace(Vector3f worldMin, 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(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()`
`Vector3f`	`getGravity(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()`
`Vector3f`	`getWorldMax()`
`Vector3f`	`getWorldMin()`
`java.util.List<PhysicsRayTestResult>`	`rayTest(Vector3f from, Vector3f to)` Performs a ray collision test and returns the results as a list of PhysicsRayTestResults
`java.util.List<PhysicsRayTestResult>`	`rayTest(Vector3f from, 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(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(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(Vector3f worldMax)` only applies for AXIS_SWEEP broadphase
`void`	`setWorldMin(Vector3f worldMin)` only applies for AXIS_SWEEP broadphase
`java.util.List<PhysicsSweepTestResult>`	`sweepTest(CollisionShape shape, Transform start, 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, Transform start, 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(Vector3f worldMin,
                    Vector3f worldMax)
```
  - PhysicsSpace
```
public PhysicsSpace(Vector3f worldMin,
                    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 -
  - 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 -
  - 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 -
    
    Parameters:
    
    callable -
    
    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(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(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(Vector3f gravity)
```
    Sets the gravity of the PhysicsSpace, set before adding physics objects!
    
    Parameters:
    
    gravity -
  - getGravity
```
public Vector3f getGravity(Vector3f gravity)
```
    Gets the gravity of the PhysicsSpace
    
    Parameters:
    
    gravity -
  - 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 -
  - 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 -
    
    collisionGroup -
  - removeCollisionGroupListener
```
public void removeCollisionGroupListener(int collisionGroup)
```
  - rayTest
```
public java.util.List<PhysicsRayTestResult> rayTest(Vector3f from,
                                                    Vector3f to)
```
    Performs a ray collision test and returns the results as a list of PhysicsRayTestResults
  - rayTest
```
public java.util.List<PhysicsRayTestResult> rayTest(Vector3f from,
                                                    Vector3f to,
                                                    java.util.List<PhysicsRayTestResult> results)
```
    Performs a ray collision test and returns the results as a list of PhysicsRayTestResults
  - sweepTest
```
public java.util.List<PhysicsSweepTestResult> sweepTest(CollisionShape shape,
                                                        Transform start,
                                                        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.
  - sweepTest
```
public java.util.List<PhysicsSweepTestResult> sweepTest(CollisionShape shape,
                                                        Transform start,
                                                        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.
  - 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 framerates 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 -
  - getWorldMin
```
public Vector3f getWorldMin()
```
  - setWorldMin
```
public void setWorldMin(Vector3f worldMin)
```
    only applies for AXIS_SWEEP broadphase
    
    Parameters:
    
    worldMin -
  - getWorldMax
```
public Vector3f getWorldMax()
```
  - setWorldMax
```
public void setWorldMax(Vector3f worldMax)
```
    only applies for AXIS_SWEEP broadphase
    
    Parameters:
    
    worldMax -
  - 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