Package com.jme3.bullet

Class PhysicsSpace

java.lang.Object
com.jme3.bullet.PhysicsSpace
public class PhysicsSpace extends Object

PhysicsSpace - The central jbullet-jme physics space

  • Field Details Link icon

  • Constructor Details Link icon

  • Method Details Link icon

    • getPhysicsSpace Link icon

      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 Link icon

      public static void setLocalThreadPhysicsSpace(PhysicsSpace space)
      Used internally
      Parameters:
      space - which space to simulate on the current thread

    • create Link icon

      public void create()
      Has to be called from the (designated) physics thread

    • update Link icon

      public void update(float time)
      updates the physics space
      Parameters:
      time - the current time value

    • update Link icon

      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 Link icon

      public void distributeEvents()

    • enqueueOnThisThread Link icon

      public static <V> Future<V> enqueueOnThisThread(Callable<V> callable)

    • enqueue Link icon

      public <V> Future<V> enqueue(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 Link icon

      public void add(Object obj)
      adds an object to the physics space
      Parameters:
      obj - the PhysicsControl or Spatial with PhysicsControl to add

    • addCollisionObject Link icon

      public void addCollisionObject(PhysicsCollisionObject obj)

    • remove Link icon

      public void remove(Object obj)
      removes an object from the physics space
      Parameters:
      obj - the PhysicsControl or Spatial with PhysicsControl to remove

    • removeCollisionObject Link icon

      public void removeCollisionObject(PhysicsCollisionObject obj)

    • addAll Link icon

      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 Link icon

      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 Link icon

      public Collection<PhysicsRigidBody> getRigidBodyList()

    • getGhostObjectList Link icon

      public Collection<PhysicsGhostObject> getGhostObjectList()

    • getCharacterList Link icon

      public Collection<PhysicsCharacter> getCharacterList()

    • getJointList Link icon

      public Collection<PhysicsJoint> getJointList()

    • getVehicleList Link icon

      public Collection<PhysicsVehicle> getVehicleList()

    • setGravity Link icon

      public void setGravity(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 Link icon

      public Vector3f getGravity(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 Link icon

      public void applyGravity()
      applies gravity value to all objects

    • clearForces Link icon

      public void clearForces()
      clears forces of all objects

    • addTickListener Link icon

      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 Link icon

      public void removeTickListener(PhysicsTickListener listener)

    • addCollisionListener Link icon

      public void addCollisionListener(PhysicsCollisionListener listener)
      Adds a CollisionListener that will be informed about collision events
      Parameters:
      listener - the CollisionListener to add

    • removeCollisionListener Link icon

      public void removeCollisionListener(PhysicsCollisionListener listener)
      Removes a CollisionListener from the list
      Parameters:
      listener - the CollisionListener to remove

    • addCollisionGroupListener Link icon

      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 Link icon

      public void removeCollisionGroupListener(int collisionGroup)

    • rayTest Link icon

      public List<PhysicsRayTestResult> rayTest(Vector3f from, 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 Link icon

      public List<PhysicsRayTestResult> rayTest(Vector3f from, Vector3f to, 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 Link icon

      public 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.
      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 Link icon

      public List<PhysicsSweepTestResult> sweepTest(CollisionShape shape, Transform start, Transform end, 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 Link icon

      public void destroy()
      destroys the current PhysicsSpace so that a new one can be created

    • getDynamicsWorld Link icon

      public com.bulletphysics.dynamics.DynamicsWorld getDynamicsWorld()
      used internally
      Returns:
      the dynamicsWorld

    • getBroadphaseType Link icon

      public PhysicsSpace.BroadphaseType getBroadphaseType()

    • setBroadphaseType Link icon

      public void setBroadphaseType(PhysicsSpace.BroadphaseType broadphaseType)

    • setMaxSubSteps Link icon

      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 Link icon

      public float getAccuracy()
      get the current accuracy of the physics computation
      Returns:
      the current accuracy

    • setAccuracy Link icon

      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 Link icon

      public Vector3f getWorldMin()

    • setWorldMin Link icon

      public void setWorldMin(Vector3f worldMin)
      only applies for AXIS_SWEEP broadphase
      Parameters:
      worldMin - the desired minimum coordinates values (not null, unaffected, default=-10k,-10k,-10k)

    • getWorldMax Link icon

      public Vector3f getWorldMax()

    • setWorldMax Link icon

      public void setWorldMax(Vector3f worldMax)
      only applies for AXIS_SWEEP broadphase
      Parameters:
      worldMax - the desired maximum coordinates values (not null, unaffected, default=10k,10k,10k)

    • setSolverNumIterations Link icon

      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 Link icon

      public int getSolverNumIterations()