Class PhysicsCharacter

All Implemented Interfaces:
Comparable<NativePhysicsObject>

public class PhysicsCharacter extends PhysicsCollisionObject
A collision object for simplified character simulation, based on Bullet's btKinematicCharacterController.
  • Field Details

    • logger2

      public static final Logger logger2
      message logger for this class
  • Constructor Details

    • PhysicsCharacter

      public PhysicsCharacter(ConvexShape shape, float stepHeight)
      Instantiate a responsive character with the specified CollisionShape and step height.
      Parameters:
      shape - the desired shape (not null, convex, alias created)
      stepHeight - the maximum amount of vertical movement without jumping or falling (in physics-space units)
  • Method Details

    • getAngularDamping

      public float getAngularDamping()
      Determine this character's angular damping.
      Returns:
      the viscous damping ratio (0→no damping, 1→critically damped)
    • getAngularVelocity

      public Vector3f getAngularVelocity(Vector3f storeResult)
      Determine this character's angular velocity.
      Parameters:
      storeResult - storage for the result (modified if not null)
      Returns:
      the velocity vector (either storeResult or a new vector, not null)
    • getControllerId

      public long getControllerId()
      Determine the ID of the btKinematicCharacterController. Used internally.
      Returns:
      the unique identifier (not zero)
    • getFallSpeed

      public float getFallSpeed()
      Determine this character's maximum fall speed (terminal velocity).
      Returns:
      the speed (in physics-space units per second)
    • getGravity

      public Vector3f getGravity(Vector3f storeResult)
      Determine this character's gravitational acceleration.
      Parameters:
      storeResult - storage for the result (modified if not null)
      Returns:
      an acceleration vector (in physics-space units per second squared, direction opposite the "up" vector, either storeResult or a new vector, not null)
    • getJumpSpeed

      public float getJumpSpeed()
      Determine this character's jump speed.
      Returns:
      the speed (in physics-space units per second)
    • getLinearDamping

      public float getLinearDamping()
      Determine this character's linear damping.
      Returns:
      the viscous damping ratio (0→no damping, 1→critically damped)
    • getLinearVelocity

      public Vector3f getLinearVelocity(Vector3f storeResult)
      Determine the linear velocity of this character's center.
      Parameters:
      storeResult - storage for the result (modified if not null)
      Returns:
      a vector (either storeResult or a new vector, not null)
    • getMaxPenetrationDepth

      public float getMaxPenetrationDepth()
      Determine this character's maximum penetration depth.
      Returns:
      the depth (in physics-space units)
    • getMaxSlope

      public float getMaxSlope()
      Determine this character's maximum slope angle.
      Returns:
      the angle relative to the horizontal (in radians)
    • getStepHeight

      public float getStepHeight()
      Determine this character's step height.
      Returns:
      the maximum amount of vertical movement without jumping or falling (in physics-space units)
    • getUpDirection

      public Vector3f getUpDirection(Vector3f storeResult)
      Determine this character's "up" direction.
      Parameters:
      storeResult - storage for the result (modified if not null)
      Returns:
      a unit vector (in physics-space coordinates, in the direction opposite the gravity vector, either storeResult or a new vector, not null)
    • getWalkDirection

      public Vector3f getWalkDirection(Vector3f storeResult)
      Determine the character's walk offset.
      Parameters:
      storeResult - storage for the result (modified if not null)
      Returns:
      an offset vector (either storeResult or a new vector, not null)
    • isUsingGhostSweepTest

      public boolean isUsingGhostSweepTest()
      Test whether the ghost's convex-sweep test is in use.
      Returns:
      true if using the ghost's test, otherwise false
    • jump

      public void jump()
      Jump in the "up" direction.
    • jump

      public void jump(Vector3f direction)
      Jump in the specified direction.
      Parameters:
      direction - desired jump direction (not null, unaffected) or (0,0,0) to jump in the "up" direction
    • onGround

      public boolean onGround()
      Test whether this character is on the ground.
      Returns:
      true if on the ground, otherwise false
    • reset

      public void reset(PhysicsSpace space)
      Reset this character, including its velocity.
      Parameters:
      space - (not null)
    • setAngularDamping

      public void setAngularDamping(float damping)
      Alter this character's angular damping.
      Parameters:
      damping - the desired viscous damping ratio (0→no damping, 1→critically damped, default=0)
    • setAngularVelocity

      public void setAngularVelocity(Vector3f angularVelocity)
      Alter this character's angular velocity.
      Parameters:
      angularVelocity - the desired angular velocity vector (not null, unaffected)
    • setCollisionShape

      public void setCollisionShape(CollisionShape collisionShape)
      Apply the specified CollisionShape to this character. Note that the character should not be in any PhysicsSpace while changing shape; the character gets rebuilt on the physics side.
      Overrides:
      setCollisionShape in class PhysicsCollisionObject
      Parameters:
      collisionShape - the shape to apply (not null, convex, alias created)
    • setContactResponse

      public void setContactResponse(boolean newState)
      Enable/disable this character's contact response.
      Parameters:
      newState - true to respond to contact forces, false to ignore them (default=true)
    • setFallSpeed

      public void setFallSpeed(float fallSpeed)
      Alter this character's maximum fall speed (terminal velocity).
      Parameters:
      fallSpeed - the desired speed (in physics-space units per second, default=55)
    • setGravity

      public void setGravity(float downwardAcceleration)
      Alter the character's gravitational acceleration without altering its "up" vector.
      Parameters:
      downwardAcceleration - the desired downward acceleration (in physics-space units per second squared, default=29.4)
    • setGravity

      public void setGravity(Vector3f gravity)
      Alter this character's gravitational acceleration. This may also alter its "up" vector.
      Parameters:
      gravity - the desired acceleration vector (in physics-space units per second squared, not null, unaffected, default=(0,-29.4,0))
    • setJumpSpeed

      public void setJumpSpeed(float jumpSpeed)
      Alter this character's jump speed.
      Parameters:
      jumpSpeed - the desired speed (in physics-space units per second, default=10)
    • setLinearDamping

      public void setLinearDamping(float damping)
      Alter this character's linear damping.
      Parameters:
      damping - the desired viscous damping ratio (0→no damping, 1→critically damped, default=0)
    • setLinearVelocity

      public void setLinearVelocity(Vector3f velocity)
      Alter the linear velocity of this character's center.
      Parameters:
      velocity - the desired velocity vector (not null)
    • setMaxPenetrationDepth

      public void setMaxPenetrationDepth(float depth)
      Alter this character's maximum penetration depth.
      Parameters:
      depth - the desired depth (in physics-space units, default=0.2)
    • setMaxSlope

      public void setMaxSlope(float slopeRadians)
      Alter this character's maximum slope angle.
      Parameters:
      slopeRadians - the desired angle above to the horizontal plane (in radians, ≥0, ≤Pi/2, default=Pi/4)
    • setPhysicsLocation

      public void setPhysicsLocation(Vector3f location)
      Directly alter this character's location. (This is equivalent to warp(com.jme3.math.Vector3f).)
      Parameters:
      location - the desired location (not null, finite, unaffected)
    • setPhysicsLocationDp

      public void setPhysicsLocationDp(Vec3d location)
      Directly alter this character's location.
      Parameters:
      location - the desired location (not null, finite, unaffected)
    • setStepHeight

      public void setStepHeight(float height)
      Alter this character's step height.
      Parameters:
      height - the desired maximum amount of vertical movement without jumping or falling (in physics-space units, default=1)
    • setSweepTest

      public void setSweepTest(boolean useGhostSweepTest)
      Alter which convex-sweep test is used.
      Parameters:
      useGhostSweepTest - true to use the ghost's test, false to use the world's test (default=true)
    • setUp

      public void setUp(Vector3f direction)
      Alter this character's "up" direction. This may also alter its gravity vector.
      Parameters:
      direction - the desired direction (not null, not zero, unaffected, default=(0,1,0))
    • setWalkDirection

      public void setWalkDirection(Vector3f offset)
      Alter this character's walk offset. The offset must be perpendicular to the "up" direction. It will continue to be applied until altered again.
      Parameters:
      offset - the desired location increment for each simulation step (in physics-space coordinates, not null, unaffected, default=(0,0,0))
    • warp

      public void warp(Vector3f location)
      Directly alter the location of this character's center.
      Parameters:
      location - the desired physics location (not null, finite, unaffected)