ConstCharacterBase: add another getShape() signature

Author: stephengold

src/main/java/com/github/stephengold/joltjni/CharacterBase.java

@@ -241,6 +241,19 @@ public ConstShape getShape() {
         return result;
     }
 
+    /**
+     * Update the specified counted reference to refer to the character's shape.
+     * The character is unaffected.
+     *
+     * @param storeRef storage for the reference (not {@code null}, modified)
+     */
+    @Override
+    public void getShape(ShapeRefC storeRef) {
+        long characterVa = va();
+        long refVa = storeRef.va();
+        getShapeUpdate(characterVa, refVa);
+    }
+
     /**
      * Copy the character's "up" direction. The character is unaffected.
      *
@@ -352,6 +365,8 @@ native static void getGroundVelocity(
 
     native static long getShape(long characterVa);
 
+    native static void getShapeUpdate(long characterVa, long refVa);
+
     native static void getUp(long characterVa, FloatBuffer storeFloats);
 
     native static boolean isSlopeTooSteep(

src/main/java/com/github/stephengold/joltjni/CharacterRef.java

@@ -660,6 +660,19 @@ public ConstShape getShape() {
         return result;
     }
 
+    /**
+     * Update the specified counted reference to refer to the character's shape.
+     * The character is unaffected.
+     *
+     * @param storeRef storage for the reference (not {@code null}, modified)
+     */
+    @Override
+    public void getShape(ShapeRefC storeRef) {
+        long characterVa = targetVa();
+        long refVa = storeRef.va();
+        CharacterBase.getShapeUpdate(characterVa, refVa);
+    }
+
     /**
      * Generate a TransformedShape that represents the volume occupied by the
      * character, using the locking body interface. The character is unaffected.

src/main/java/com/github/stephengold/joltjni/CharacterRefC.java

@@ -482,6 +482,19 @@ public ConstShape getShape() {
         return result;
     }
 
+    /**
+     * Update the specified counted reference to refer to the character's shape.
+     * The character is unaffected.
+     *
+     * @param storeRef storage for the reference (not {@code null}, modified)
+     */
+    @Override
+    public void getShape(ShapeRefC storeRef) {
+        long characterVa = targetVa();
+        long refVa = storeRef.va();
+        CharacterBase.getShapeUpdate(characterVa, refVa);
+    }
+
     /**
      * Generate a TransformedShape that represents the volume occupied by the
      * character, using the locking body interface. The character is unaffected.

src/main/java/com/github/stephengold/joltjni/CharacterVirtualRef.java

@@ -741,6 +741,19 @@ public ConstShape getShape() {
         return result;
     }
 
+    /**
+     * Update the specified counted reference to refer to the character's shape.
+     * The character is unaffected.
+     *
+     * @param storeRef storage for the reference (not {@code null}, modified)
+     */
+    @Override
+    public void getShape(ShapeRefC storeRef) {
+        long characterVa = targetVa();
+        long refVa = storeRef.va();
+        CharacterBase.getShapeUpdate(characterVa, refVa);
+    }
+
     /**
      * Copy the local offset applied to the shape. The character is unaffected.
      *

src/main/java/com/github/stephengold/joltjni/CharacterVirtualRefC.java

@@ -569,6 +569,19 @@ public ConstShape getShape() {
         return result;
     }
 
+    /**
+     * Update the specified counted reference to refer to the character's shape.
+     * The character is unaffected.
+     *
+     * @param storeRef storage for the reference (not {@code null}, modified)
+     */
+    @Override
+    public void getShape(ShapeRefC storeRef) {
+        long characterVa = targetVa();
+        long refVa = storeRef.va();
+        CharacterBase.getShapeUpdate(characterVa, refVa);
+    }
+
     /**
      * Copy the local offset applied to the shape. The character is unaffected.
      *

src/main/java/com/github/stephengold/joltjni/readonly/ConstCharacterBase.java

@@ -22,6 +22,7 @@ of this software and associated documentation files (the "Software"), to deal
 package com.github.stephengold.joltjni.readonly;
 
 import com.github.stephengold.joltjni.RVec3;
+import com.github.stephengold.joltjni.ShapeRefC;
 import com.github.stephengold.joltjni.StateRecorder;
 import com.github.stephengold.joltjni.Vec3;
 import com.github.stephengold.joltjni.enumerate.EGroundState;
@@ -122,6 +123,14 @@ public interface ConstCharacterBase extends ConstJoltPhysicsObject {
      */
     ConstShape getShape();
 
+    /**
+     * Update the specified counted reference to refer to the character's shape.
+     * The character is unaffected.
+     *
+     * @param storeRef storage for the reference (not {@code null}, modified)
+     */
+    void getShape(ShapeRefC storeRef);
+
     /**
      * Copy the character's "up" direction. The character is unaffected.
      *

src/main/native/glue/ch/CharacterBase.cpp

@@ -185,6 +185,19 @@ JNIEXPORT jlong JNICALL Java_com_github_stephengold_joltjni_CharacterBase_getSha
     return reinterpret_cast<jlong> (pResult);
 }
 
+/*
+ * Class:     com_github_stephengold_joltjni_CharacterBase
+ * Method:    getShapeUpdate
+ * Signature: (JJ)V
+ */
+JNIEXPORT void JNICALL Java_com_github_stephengold_joltjni_CharacterBase_getShapeUpdate
+  (JNIEnv *, jclass, jlong characterVa, jlong refVa) {
+    const CharacterBase * const pCharacter
+            = reinterpret_cast<CharacterBase *> (characterVa);
+    RefConst<Shape> * const pRef = reinterpret_cast<RefConst<Shape> *> (refVa);
+    (*pRef) = pCharacter->GetShape();
+}
+
 /*
  * Class:     com_github_stephengold_joltjni_CharacterBase
  * Method:    getUp