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

Class ShapeSettings

java.lang.Object
com.github.stephengold.joltjni.JoltPhysicsObject
com.github.stephengold.joltjni.SerializableObject
com.github.stephengold.joltjni.ShapeSettings
All Implemented Interfaces:
ConstJoltPhysicsObject, ConstSerializableObject, ConstShapeSettings, RefTarget, AutoCloseable, Comparable<JoltPhysicsObject>
Direct Known Subclasses:
CompoundShapeSettings, ConvexShapeSettings, DecoratedShapeSettings, EmptyShapeSettings, HeightFieldShapeSettings, MeshShapeSettings, PlaneShapeSettings
public abstract class ShapeSettings extends SerializableObject implements ConstShapeSettings
Settings used to construct a Shape.

  • Method Details

    • clearCachedResult

      public void clearCachedResult()
      Invoke this method after altering the settings but before generating any new shapes.

    • cloneShapeSettings

      public static ShapeSettings cloneShapeSettings(ConstShapeSettings original)
      Instantiate a clone of the specified settings.
      Parameters:
      original - the settings to clone (not null, unaffected)
      Returns:
      a new JVM object with a new native object assigned

    • setVirtualAddressAsCoOwner

      protected final void setVirtualAddressAsCoOwner(long settingsVa, EShapeSubType shapeSubType)
      Assign a native object (assuming there's none already assigned), designate the JVM object as a co-owner, and assign a subtype.
      Parameters:
      settingsVa - the virtual address of the native object to assign (not zero)
      shapeSubType - the desired subtype (not null)

    • create

      public ShapeResult create()
      Generate a ShapeResult from these settings.
      Specified by:
      create in interface ConstShapeSettings
      Returns:
      a new JVM object with a new native object assigned

    • toRefC

      public ShapeSettingsRefC toRefC()
      Create a counted reference to the native ShapeSettings.
      Specified by:
      toRefC in interface ConstShapeSettings
      Returns:
      a new JVM object with a new native object assigned

    • getRefCount

      public int getRefCount()
      Count the active references to the native ShapeSettings. The settings are unaffected.
      Specified by:
      getRefCount in interface ConstShapeSettings
      Specified by:
      getRefCount in interface RefTarget
      Returns:
      the count (≥0)

    • setEmbedded

      public void setEmbedded()
      Mark the native ShapeSettings as embedded.
      Specified by:
      setEmbedded in interface RefTarget

    • toRef

      public ShapeSettingsRef toRef()
      Create a counted reference to the native ShapeSettings.
      Specified by:
      toRef in interface RefTarget
      Returns:
      a new JVM object with a new native object assigned