Class RigidBodyControl

All Implemented Interfaces:
PhysicsControl, com.jme3.export.Savable, com.jme3.scene.control.Control, com.jme3.util.clone.JmeCloneable, Cloneable, Comparable<NativePhysicsObject>

public class RigidBodyControl extends PhysicsRigidBody implements PhysicsControl
A PhysicsControl to link a PhysicsRigidBody to a Spatial.
  • Field Details

    • logger3

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

    • RigidBodyControl

      protected RigidBodyControl()
      No-argument constructor needed by SavableClassUtil.
    • RigidBodyControl

      public RigidBodyControl(float mass)
      Instantiate an enabled control. The new instance is incomplete because it lacks a collision shape, so it CANNOT be immediately added to a space. Its shape will be auto-generated when it is added to a Spatial. If the controlled spatial is a Geometry with a box or sphere mesh, a matching box or sphere CollisionShape will be generated. Otherwise CollisionShapeFactory will be used.
      Parameters:
      mass - the desired mass (≥0)
    • RigidBodyControl

      public RigidBodyControl(CollisionShape shape)
      Instantiate an enabled Control with an active/responsive dynamic rigid body, mass=1, and the specified shape.
      Parameters:
      shape - the desired shape (not null, alias created)
    • RigidBodyControl

      public RigidBodyControl(CollisionShape shape, float mass)
      Instantiate an enabled Control with a dynamic or static rigid body and the specified shape and mass.
      Parameters:
      shape - the desired shape (not null, alias created)
      mass - the desired mass (≥0)
  • Method Details

    • getSpatial

      public com.jme3.scene.Spatial getSpatial()
      Access the controlled spatial.
      Returns:
      the pre-existing Spatial, or null if none
    • isApplyPhysicsLocal

      public boolean isApplyPhysicsLocal()
      Test whether physics-space coordinates should match the spatial's local coordinates.
      Returns:
      true if matching local coordinates, false if matching world coordinates
    • isApplyScale

      public boolean isApplyScale()
      Test whether the collision-shape scale should match the spatial's scale.
      Returns:
      true if matching scales, otherwise false
    • isKinematicSpatial

      public final boolean isKinematicSpatial()
      Test whether this Control is in kinematic mode. Kinematic mode has no effect when the body isn't kinematic.
      Returns:
      true if the spatial's location and rotation would be applied to a kinematic body, otherwise false
    • setApplyPhysicsLocal

      public void setApplyPhysicsLocal(boolean applyPhysicsLocal)
      Alter whether physics-space coordinates should match the spatial's local coordinates.
      Parameters:
      applyPhysicsLocal - true→match local coordinates, false→match world coordinates (default=false)
    • setApplyScale

      public void setApplyScale(boolean setting)
      Alter whether the collision-shape scale should match the spatial's scale. CAUTION: Not all shapes can be scaled arbitrarily.

      Note that if the shape is shared (between collision objects and/or compound shapes) scaling can have unintended consequences.

      Parameters:
      setting - true → enable shape scaling (to the extent the CollisionShape supports it), false → disable shape scaling (default=false)
    • setKinematicSpatial

      public void setKinematicSpatial(boolean kinematicSpatial)
      Enable or disable kinematic mode for this Control. If both the rigid body and controlled spatial are kinematic, the spatial's location and rotation will be applied to the body during each update. Kinematic mode has no effect when the body isn't kinematic.
      Parameters:
      kinematicSpatial - true→kinematic, false→dynamic (default=true)
    • createCollisionShape

      protected void createCollisionShape()
      Set the body's CollisionShape based on the controlled spatial and its descendants.
    • cloneForSpatial

      public com.jme3.scene.control.Control cloneForSpatial(com.jme3.scene.Spatial spatial)
      Clone this Control for a different Spatial. No longer used as of JME 3.1.
      Specified by:
      cloneForSpatial in interface com.jme3.scene.control.Control
      Parameters:
      spatial - (unused)
      Returns:
      never
      Throws:
      UnsupportedOperationException - always
    • getPhysicsSpace

      public PhysicsSpace getPhysicsSpace()
      Access the PhysicsSpace to which the body is (or would be) added.
      Specified by:
      getPhysicsSpace in interface PhysicsControl
      Returns:
      the pre-existing space, or null for none
    • isEnabled

      public boolean isEnabled()
      Test whether this Control is enabled.
      Specified by:
      isEnabled in interface PhysicsControl
      Returns:
      true if enabled, otherwise false
    • render

      public void render(com.jme3.renderer.RenderManager rm, com.jme3.renderer.ViewPort vp)
      Render this Control. Invoked once per ViewPort per frame, provided the Control is added to a scene. Should be invoked only by a subclass or by the RenderManager.
      Specified by:
      render in interface com.jme3.scene.control.Control
      Parameters:
      rm - the RenderManager (unused)
      vp - the ViewPort to render (unused)
    • setEnabled

      public void setEnabled(boolean enabled)
      Enable or disable this Control.

      When the Control is disabled, the body is removed from PhysicsSpace. When the Control is enabled again, the body is moved to the current position of the Spatial and then added to the PhysicsSpace.

      Specified by:
      setEnabled in interface PhysicsControl
      Parameters:
      enabled - true→enable the Control, false→disable it
    • setPhysicsSpace

      public void setPhysicsSpace(PhysicsSpace newSpace)
      If enabled, add this control's body to the specified PhysicsSpace. If not enabled, alter where the body would be added. The body is removed from any other space it's currently in.
      Specified by:
      setPhysicsSpace in interface PhysicsControl
      Parameters:
      newSpace - where to add, or null to simply remove
    • setSpatial

      public void setSpatial(com.jme3.scene.Spatial controlledSpatial)
      Alter which Spatial is controlled. Invoked when the Control is added to or removed from a Spatial. Should be invoked only by a subclass or from Spatial. Do not invoke directly from user code.
      Specified by:
      setSpatial in interface com.jme3.scene.control.Control
      Parameters:
      controlledSpatial - the Spatial to control (or null)
    • update

      public void update(float tpf)
      Update this Control. Invoked once per frame, during the logical-state update, provided the Control is added to a scene. Do not invoke directly from user code.
      Specified by:
      update in interface com.jme3.scene.control.Control
      Parameters:
      tpf - the time interval between frames (in seconds, ≥0)
    • cloneFields

      public void cloneFields(com.jme3.util.clone.Cloner cloner, Object original)
      Callback from Cloner to convert this shallow-cloned Control into a deep-cloned one, using the specified Cloner and original to resolve copied fields.
      Specified by:
      cloneFields in interface com.jme3.util.clone.JmeCloneable
      Overrides:
      cloneFields in class PhysicsRigidBody
      Parameters:
      cloner - the Cloner that's cloning this Control (not null)
      original - the instance from which this Control was shallow-cloned (not null, unaffected)
    • read

      public void read(com.jme3.export.JmeImporter importer) throws IOException
      De-serialize this Control from the specified importer, for example when loading from a J3O file.
      Specified by:
      read in interface com.jme3.export.Savable
      Overrides:
      read in class PhysicsRigidBody
      Parameters:
      importer - (not null)
      Throws:
      IOException - from the importer
    • write

      public void write(com.jme3.export.JmeExporter exporter) throws IOException
      Serialize this Control to the specified exporter, for example when saving to a J3O file.
      Specified by:
      write in interface com.jme3.export.Savable
      Overrides:
      write in class PhysicsRigidBody
      Parameters:
      exporter - (not null)
      Throws:
      IOException - from the exporter