ShapeSettings: add 2 public methods

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

@@ -40,9 +40,31 @@ protected ShapeSettings() {
     // new methods exposed
 
     /**
-     * Generate a shape from these settings.
+     * Invoke this method after altering the settings but before generating any
+     * new shapes.
+     */
+    public void clearCachedResult() {
+        long settingsVa = va();
+        clearCachedResult(settingsVa);
+    }
+
+    /**
+     * Generate a {@code ShapeResult} from these settings.
      *
-     * @return a new instance
+     * @return a new JVM object with a new native object assigned
+     */
+    public ShapeResult create() {
+        long settingsVa = va();
+        long resultVa = create(settingsVa);
+        ShapeResult result = new ShapeResult(resultVa, true);
+
+        return result;
+    }
+
+    /**
+     * Generate a {@code Shape} from these settings.
+     *
+     * @return a new JVM object
      */
     abstract public Shape createShape();
     // *************************************************************************
@@ -63,5 +85,9 @@ public int getRefCount() {
     // *************************************************************************
     // native private methods
 
+    native private static void clearCachedResult(long settingsVa);
+
+    native private static long create(long settingsVa);
+
     native private static int getRefCount(long settingsVa);
 }

src/main/native/glue/ShapeSettings.cpp

@@ -29,6 +29,31 @@ SOFTWARE.
 
 using namespace JPH;
 
+/*
+ * Class:     com_github_stephengold_joltjni_ShapeSettings
+ * Method:    clearCachedResult
+ * Signature: (J)V
+ */
+JNIEXPORT void JNICALL Java_com_github_stephengold_joltjni_ShapeSettings_clearCachedResult
+  (JNIEnv *, jclass, jlong settingsVa) {
+    ShapeSettings * const pSettings = reinterpret_cast<ShapeSettings *> (settingsVa);
+    pSettings->ClearCachedResult();
+}
+
+/*
+ * Class:     com_github_stephengold_joltjni_ShapeSettings
+ * Method:    create
+ * Signature: (J)J
+ */
+JNIEXPORT jlong JNICALL Java_com_github_stephengold_joltjni_ShapeSettings_create
+  (JNIEnv *, jclass, jlong settingsVa) {
+    const ShapeSettings * const pSettings
+            = reinterpret_cast<ShapeSettings *> (settingsVa);
+    ShapeSettings::ShapeResult *pResult = new ShapeSettings::ShapeResult();
+    *pResult = pSettings->Create();
+    return reinterpret_cast<jlong> (pResult);
+}
+
 /*
  * Class:     com_github_stephengold_joltjni_ShapeSettings
  * Method:    getRefCount