Module com.github.stephengold.joltjni
Package com.github.stephengold.joltjni

Class RagdollSettingsRef

java.lang.Object
com.github.stephengold.joltjni.JoltPhysicsObject
com.github.stephengold.joltjni.template.Ref
com.github.stephengold.joltjni.RagdollSettingsRef
All Implemented Interfaces:
ConstJoltPhysicsObject, ConstRagdollSettings, AutoCloseable, Comparable<JoltPhysicsObject>
public final class RagdollSettingsRef extends Ref implements ConstRagdollSettings
A counted reference to a RagdollSettings object. (native type: Ref<RagdollSettings>)

  • Constructor Details

    • RagdollSettingsRef

      public RagdollSettingsRef()
      Instantiate an empty reference.

  • Method Details

    • addAdditionalConstraint

      public void addAdditionalConstraint(AdditionalConstraint constraint)
      Add the specified constraint.
      Parameters:
      constraint - (not null)

    • calculateBodyIndexToConstraintIndex

      public void calculateBodyIndexToConstraintIndex()
      Pre-calculate the map used by getBodyIndexToConstraintIndex().

    • calculateConstraintIndexToBodyIdxPair

      public void calculateConstraintIndexToBodyIdxPair()
      Pre-calculate the map used by getConstraintIndexToBodyIdxPair().

    • calculateConstraintPriorities

      public void calculateConstraintPriorities()
      Initialize the constraint priorities so that constraints near the leaves have priority than those near the root.

    • calculateConstraintPriorities

      public void calculateConstraintPriorities(int basePriority)
      Initialize the constraint priorities so that constraints near the leaves have priority than those near the root.
      Parameters:
      basePriority - the lowest priority to use (default=0)

    • disableParentChildCollisions

      public void disableParentChildCollisions()
      Create and add collision filters to all bodies in the ragdoll and configure them so parents and children don't collide.

    • getParts

      public Part[] getParts()
      Access the parts by way of a Java array. (native attribute: mParts)
      Returns:
      a new array of new JVM objects with pre-existing native objects assigned

    • resizeParts

      public void resizeParts(int numParts)
      Resize the parts array.
      Parameters:
      numParts - the desired number of parts (≥0)

    • setSkeleton

      public void setSkeleton(Skeleton skeleton)
      Replace the skeleton. (native attribute: mSkeleton)
      Parameters:
      skeleton - the desired skeleton (not null)

    • sRestoreFromBinaryState

      public static RagdollResult sRestoreFromBinaryState(StreamIn stream)
      Read a ragdoll from the specified input stream.
      Parameters:
      stream - the stream to read from (not null)
      Returns:
      the result of the read (not null)

    • stabilize

      public boolean stabilize()
      Stabilize the constraints.
      Returns:
      true if successful, otherwise false

    • createRagdoll

      public Ragdoll createRagdoll(int groupId, long userData, PhysicsSystem physicsSystem)
      Generate a ragdoll instance from the settings, which are unaffected.
      Specified by:
      createRagdoll in interface ConstRagdollSettings
      Parameters:
      groupId - the collision group for the bodies
      userData - the desired user-data value
      physicsSystem - where to add the bodies and constraints (not null, modified)
      Returns:
      a new ragdoll instance, or null when out of bodies

    • getBodyIndicesForConstraintIndex

      public IntPair getBodyIndicesForConstraintIndex(int constraintIndex)
      Access the body-index pair for the specified constraint.
      Specified by:
      getBodyIndicesForConstraintIndex in interface ConstRagdollSettings
      Parameters:
      constraintIndex - the index of the constraint (≥0)
      Returns:
      a new JVM object with the pre-existing native object assigned

    • getConstraintIndexForBodyIndex

      public int getConstraintIndexForBodyIndex(int bodyIndex)
      Return the index of the constraint upstream from the specified body. The settings are unaffected.
      Specified by:
      getConstraintIndexForBodyIndex in interface ConstRagdollSettings
      Parameters:
      bodyIndex - index of the body in the ragdoll (≥0)
      Returns:
      the constraint index

    • getNumParts

      public int getNumParts()
      Count the parts. The settings are unaffected.
      Specified by:
      getNumParts in interface ConstRagdollSettings
      Returns:
      the count (≥0)

    • getPart

      public Part getPart(int partIndex)
      Access the part for the specified index.
      Specified by:
      getPart in interface ConstRagdollSettings
      Parameters:
      partIndex - index of the part (≥0)
      Returns:
      a new JVM object with pre-existing native object assigned

    • getSkeleton

      public Skeleton getSkeleton()
      Access the skeleton. (native attribute: mSkeleton)
      Specified by:
      getSkeleton in interface ConstRagdollSettings
      Returns:
      a new JVM object with the pre-existing native object assigned

    • saveBinaryState

      public void saveBinaryState(StreamOut stream, boolean saveShapes, boolean saveGroupFilter)
      Save the settings to the specified binary stream. The settings are unaffected.
      Specified by:
      saveBinaryState in interface ConstRagdollSettings
      Parameters:
      stream - the stream to write to (not null)
      saveShapes - if true, save the shapes
      saveGroupFilter - if true, save the group filter

    • getPtr

      public RagdollSettings getPtr()
      Access the targeted settings, if any.
      Specified by:
      getPtr in class Ref
      Returns:
      the pre-existing object, or null if the reference is empty

    • targetVaOrZero

      public long targetVaOrZero()
      Return the address of the native RagdollSettings. No objects are affected.
      Specified by:
      targetVaOrZero in interface ConstJoltPhysicsObject
      Overrides:
      targetVaOrZero in class JoltPhysicsObject
      Returns:
      the virtual address, or zero if the reference is empty

    • toRef

      public RagdollSettingsRef toRef()
      Create an additional counted reference to the targeted settings.
      Specified by:
      toRef in class Ref
      Returns:
      a new JVM object with a new native object assigned