Package com.jme3.bullet.collision.shapes.infos

Class ChildCollisionShape

java.lang.Object
com.jme3.bullet.collision.shapes.infos.ChildCollisionShape
All Implemented Interfaces:
com.jme3.export.Savable, com.jme3.util.clone.JmeCloneable, Cloneable
public class ChildCollisionShape extends Object implements com.jme3.util.clone.JmeCloneable, com.jme3.export.Savable
An element in a CompoundCollisionShape, consisting of a (non-compound) base shape, offset and rotated with respect to its parent.

Despite its name, it is not a subtype of CollisionShape!

  • Field Summary

    Fields
    Modifier and Type
    Field
    Description
    static final Logger
    logger
    message logger for this class

  • Constructor Summary

    Constructors
    Modifier
    Constructor
    Description
    protected
    ChildCollisionShape()
    No-argument constructor needed by SavableClassUtil.
     
    ChildCollisionShape(com.jme3.math.Vector3f offset, CollisionShape shape)
    Instantiate a child without any rotation.
     
    ChildCollisionShape(com.jme3.math.Vector3f offset, com.jme3.math.Matrix3f rotation, CollisionShape shape)
    Instantiate a child for use in a compound shape.

  • Method Summary

    Modifier and Type
    Method
    Description
    void
    cloneFields(com.jme3.util.clone.Cloner cloner, Object original)
    Callback from Cloner to convert this shallow-cloned element into a deep-cloned one, using the specified Cloner and original to resolve copied fields.
    com.jme3.math.Vector3f
    copyOffset(com.jme3.math.Vector3f storeResult)
    Copy the translation in the parent's coordinate system.
    com.jme3.math.Quaternion
    copyRotation(com.jme3.math.Quaternion storeResult)
    Copy the rotation in the parent's coordinate system.
    com.jme3.math.Matrix3f
    copyRotationMatrix(com.jme3.math.Matrix3f storeResult)
    Copy the rotation in the parent's coordinate system.
    com.jme3.math.Transform
    copyTransform(com.jme3.math.Transform storeResult)
    Copy the Transform relative to the parent's coordinate system.
    CollisionShape
    getShape()
    Access the base shape.
    ChildCollisionShape
    jmeClone()
    Create a shallow clone for the JME cloner.
    void
    read(com.jme3.export.JmeImporter importer)
    De-serialize this child from the specified importer, for example when loading from a J3O file.
    void
    setTransform(com.jme3.math.Vector3f offset, com.jme3.math.Matrix3f rotation)
    Alter the child's coordinate transform copy.
    ChildCollisionShape[]
    split(com.jme3.math.Triangle parentTriangle)
    Attempt to divide this child into 2 children.
    void
    write(com.jme3.export.JmeExporter exporter)
    Serialize this child to the specified exporter, for example when saving to a J3O file.

    Methods inherited from class java.lang.Object

    clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

  • Field Details

    • logger

      public static final Logger logger
      message logger for this class

  • Constructor Details

    • ChildCollisionShape

      protected ChildCollisionShape()
      No-argument constructor needed by SavableClassUtil.

    • ChildCollisionShape

      public ChildCollisionShape(com.jme3.math.Vector3f offset, com.jme3.math.Matrix3f rotation, CollisionShape shape)
      Instantiate a child for use in a compound shape.
      Parameters:
      offset - the desired translation in the parent's coordinate system (not null, unaffected)
      rotation - the desired rotation in the parent's coordinate system (not null, unaffected)
      shape - the base shape (not null, not a compound shape, alias created)

    • ChildCollisionShape

      public ChildCollisionShape(com.jme3.math.Vector3f offset, CollisionShape shape)
      Instantiate a child without any rotation.
      Parameters:
      offset - the desired translation in the parent's coordinate system (not null, unaffected)
      shape - the base shape (not null, not a compound shape, alias created)

  • Method Details

    • copyOffset

      public com.jme3.math.Vector3f copyOffset(com.jme3.math.Vector3f storeResult)
      Copy the translation in the parent's coordinate system.
      Parameters:
      storeResult - storage for the result (modified if not null)
      Returns:
      a translation vector (either storeResult or a new vector, not null)

    • copyRotation

      public com.jme3.math.Quaternion copyRotation(com.jme3.math.Quaternion storeResult)
      Copy the rotation in the parent's coordinate system.
      Parameters:
      storeResult - storage for the result (modified if not null)
      Returns:
      a Quaternion (either storeResult or a new Quaternion, not null)

    • copyRotationMatrix

      public com.jme3.math.Matrix3f copyRotationMatrix(com.jme3.math.Matrix3f storeResult)
      Copy the rotation in the parent's coordinate system.
      Parameters:
      storeResult - storage for the result (modified if not null)
      Returns:
      a rotation matrix (either storeResult or a new matrix, not null)

    • copyTransform

      public com.jme3.math.Transform copyTransform(com.jme3.math.Transform storeResult)
      Copy the Transform relative to the parent's coordinate system.
      Parameters:
      storeResult - storage for the result (modified if not null)
      Returns:
      a Transform with scale=1 (either storeResult or a new instance, not null)

    • getShape

      public CollisionShape getShape()
      Access the base shape.
      Returns:
      the pre-existing shape (not null)

    • setTransform

      public void setTransform(com.jme3.math.Vector3f offset, com.jme3.math.Matrix3f rotation)
      Alter the child's coordinate transform copy. For internal use only.
      Parameters:
      offset - the desired translation relative to the parent (not null, unaffected)
      rotation - the desired rotation relative to the parent (not null, unaffected)
      See Also:

    • split

      public ChildCollisionShape[] split(com.jme3.math.Triangle parentTriangle)
      Attempt to divide this child into 2 children. The base shape must be splittable.
      Parameters:
      parentTriangle - a triangle that defines the splitting plane (in parent's shape coordinates, not null, unaffected)
      Returns:
      a pair of children, the first element on the triangle's minus side and the 2nd element on its plus side; either element may be null, indicating an empty child

    • cloneFields

      public void cloneFields(com.jme3.util.clone.Cloner cloner, Object original)
      Callback from Cloner to convert this shallow-cloned element 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
      Parameters:
      cloner - the Cloner that's cloning this element (not null)
      original - the instance from which this element was shallow-cloned (unused)

    • jmeClone

      public ChildCollisionShape jmeClone()
      Create a shallow clone for the JME cloner.
      Specified by:
      jmeClone in interface com.jme3.util.clone.JmeCloneable
      Returns:
      a new instance

    • read

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

    • write

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