Class JoinedBodyControl

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

public class JoinedBodyControl extends AbstractPhysicsControl
A custom PhysicsControl for a dynamic rigid body that can be joined to other bodies. When the Control is removed from a space, all its joints are automatically destroyed.
  • Field Details

    • logger3

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

    • JoinedBodyControl

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

      public JoinedBodyControl(CollisionShape bodyShape, float mass)
      Instantiate an enabled Control in dynamic mode.
      bodyShape - the desired shape for the rigid body (not null, alias created)
      mass - the desired mass for the rigid body (gt;0)
  • Method Details

    • getRigidBody

      public PhysicsRigidBody getRigidBody()
      Access the rigid body managed by this Control.
      the pre-existing rigid body (not null)
    • isKinematic

      public boolean isKinematic()
      Test whether the body is in kinematic mode.
      true if in kinematic mode, otherwise false (in dynamic mode)
    • setKinematic

      public void setKinematic(boolean newSetting)
      Transition the body from kinematic mode to dynamic mode or vice versa.
      newSetting - true→set kinematic mode, false→set dynamic mode (default=false)
    • addPhysics

      protected void addPhysics()
      Add all managed physics objects to the PhysicsSpace.
      Specified by:
      addPhysics in class AbstractPhysicsControl
    • 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
      cloneFields in class AbstractPhysicsControl
      cloner - the Cloner that's cloning this Control (not null, modified)
      original - the instance from which this Control was shallow-cloned (not null, unaffected)
    • createSpatialData

      protected void createSpatialData(com.jme3.scene.Spatial spatial)
      Create spatial-dependent data. Invoked when this Control is added to a Spatial.
      Specified by:
      createSpatialData in class AbstractPhysicsControl
      spatial - the controlled Spatial (not null, alias created)
    • 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
      read in class AbstractPhysicsControl
      importer - (not null)
      IOException - from the importer
    • removePhysics

      protected void removePhysics()
      Remove all managed physics objects from the PhysicsSpace.
      Specified by:
      removePhysics in class AbstractPhysicsControl
    • removeSpatialData

      protected void removeSpatialData(com.jme3.scene.Spatial spatial)
      Destroy spatial-dependent data. Invoked when this Control is removed from its Spatial.
      Specified by:
      removeSpatialData in class AbstractPhysicsControl
      spatial - the Spatial to which this Control was added (unused)
    • setPhysicsLocation

      public void setPhysicsLocation(com.jme3.math.Vector3f newLocation)
      Translate the body instantly to the specified location.
      Specified by:
      setPhysicsLocation in class AbstractPhysicsControl
      newLocation - the desired location (in physics-space coordinates, not null, finite, unaffected)
    • setPhysicsRotation

      protected void setPhysicsRotation(com.jme3.math.Quaternion newOrientation)
      Rotate the body instantly to the specified orientation.
      Specified by:
      setPhysicsRotation in class AbstractPhysicsControl
      newOrientation - the desired orientation (in physics-space coordinates, not null, not zero, unaffected)
    • 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.
      tpf - the time interval between frames (in seconds, ≥0)
    • 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
      write in class AbstractPhysicsControl
      exporter - (not null)
      IOException - from the exporter