add the TwoBodyConstraintSettingsRef class

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

@@ -23,6 +23,7 @@ of this software and associated documentation files (the "Software"), to deal
 
 import com.github.stephengold.joltjni.enumerate.EConstraintSubType;
 import com.github.stephengold.joltjni.readonly.ConstConstraintSettings;
+import com.github.stephengold.joltjni.template.Ref;
 import com.github.stephengold.joltjni.template.RefTarget;
 
 /**
@@ -306,7 +307,7 @@ public void setEmbedded() {
      * @return a new JVM object with a new native object assigned
      */
     @Override
-    public ConstraintSettingsRef toRef() {
+    public Ref toRef() {
         long settingsVa = va();
         long refVa = toRef(settingsVa);
         ConstraintSettingsRef result = new ConstraintSettingsRef(refVa, true);

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

@@ -67,8 +67,27 @@ public TwoBodyConstraint create(Body body1, Body body2) {
         return result;
     }
     // *************************************************************************
-    // native private methods
+    // ConstraintSettings methods
 
-    native private static long createConstraint(
+    /**
+     * Create a counted reference to the native {@code ConstraintSettings}.
+     *
+     * @return a new JVM object with a new native object assigned
+     */
+    @Override
+    public TwoBodyConstraintSettingsRef toRef() {
+        long settingsVa = va();
+        long refVa = toRef(settingsVa);
+        TwoBodyConstraintSettingsRef result
+                = new TwoBodyConstraintSettingsRef(refVa, true);
+
+        return result;
+    }
+    // *************************************************************************
+    // native methods
+
+    native static long createConstraint(
             long settingsVa, long body1Va, long body2Va);
+
+    native private static long toRef(long settingsVa);
 }

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

@@ -0,0 +1,134 @@
+/*
+Copyright (c) 2024 Stephen Gold
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+ */
+package com.github.stephengold.joltjni;
+
+import com.github.stephengold.joltjni.template.Ref;
+
+/**
+ * A counted reference to a {@code TwoBodyConstraintSettings} object. (native
+ * type: {@code Ref<TwoBodyConstraintSettings>})
+ *
+ * @author Stephen Gold [email protected]
+ */
+final public class TwoBodyConstraintSettingsRef extends Ref {
+    // *************************************************************************
+    // constructors
+
+    /**
+     * Instantiate an empty reference.
+     */
+    public TwoBodyConstraintSettingsRef() {
+        long refVa = createEmpty();
+        setVirtualAddress(refVa, () -> free(refVa));
+    }
+
+    /**
+     * Instantiate a reference with the specified native object assigned.
+     *
+     * @param refVa the virtual address of the native object to assign (not
+     * zero)
+     * @param owner {@code true} &rarr; make the JVM object the owner,
+     * {@code false} &rarr; it isn't the owner
+     */
+    TwoBodyConstraintSettingsRef(long refVa, boolean owner) {
+        Runnable freeingAction = owner ? () -> free(refVa) : null;
+        setVirtualAddress(refVa, freeingAction);
+    }
+    // *************************************************************************
+    // new methods exposed
+
+    /**
+     * Create a constraint using the settings. The settings are unaffected.
+     *
+     * @param body1 the desired first body (not null)
+     * @param body2 the desired 2nd body (not null)
+     * @return a new constraint
+     */
+    public TwoBodyConstraint create(Body body1, Body body2) {
+        long settingsVa = targetVa();
+        long body1Va = body1.va();
+        long body2Va = body2.va();
+        long constraintVa = TwoBodyConstraintSettings.createConstraint(
+                settingsVa, body1Va, body2Va);
+        TwoBodyConstraint result
+                = (TwoBodyConstraint) Constraint.newConstraint(constraintVa);
+
+        return result;
+    }
+    // *************************************************************************
+    // Ref methods
+
+    /**
+     * Temporarily access the referenced {@code TwoBodyConstraintSettings}.
+     *
+     * @return a new JVM object with the pre-existing native object assigned
+     */
+    @Override
+    public TwoBodyConstraintSettings getPtr() {
+        long settingsVa = targetVa();
+        TwoBodyConstraintSettings result
+                = (TwoBodyConstraintSettings) ConstraintSettings
+                        .newConstraintSettings(settingsVa);
+
+        return result;
+    }
+
+    /**
+     * Return the address of the native {@code TwoBodyConstraintSettings}. No
+     * objects are affected.
+     *
+     * @return a virtual address (not zero)
+     */
+    @Override
+    public long targetVa() {
+        long refVa = va();
+        long result = getPtr(refVa);
+
+        return result;
+    }
+
+    /**
+     * Create another counted reference to the native
+     * {@code TwoBodyConstraintSettings}.
+     *
+     * @return a new JVM object with a new native object assigned
+     */
+    @Override
+    public TwoBodyConstraintSettingsRef toRef() {
+        long refVa = va();
+        long copyVa = copy(refVa);
+        TwoBodyConstraintSettingsRef result
+                = new TwoBodyConstraintSettingsRef(copyVa, true);
+
+        return result;
+    }
+    // *************************************************************************
+    // native private methods
+
+    native private static long copy(long refVa);
+
+    native private static long createEmpty();
+
+    native private static void free(long refVa);
+
+    native private static long getPtr(long refVa);
+}

src/main/native/glue/t/TwoBodyConstraintSettings.cpp

@@ -25,10 +25,19 @@ SOFTWARE.
  */
 #include "Jolt/Jolt.h"
 #include "Jolt/Physics/Constraints/TwoBodyConstraint.h"
+
 #include "auto/com_github_stephengold_joltjni_TwoBodyConstraintSettings.h"
+#include "auto/com_github_stephengold_joltjni_TwoBodyConstraintSettingsRef.h"
+#include "glue/glue.h"
 
 using namespace JPH;
 
+IMPLEMENT_REF(TwoBodyConstraintSettings,
+  Java_com_github_stephengold_joltjni_TwoBodyConstraintSettingsRef_copy,
+  Java_com_github_stephengold_joltjni_TwoBodyConstraintSettingsRef_createEmpty,
+  Java_com_github_stephengold_joltjni_TwoBodyConstraintSettingsRef_free,
+  Java_com_github_stephengold_joltjni_TwoBodyConstraintSettingsRef_getPtr)
+
 /*
  * Class:     com_github_stephengold_joltjni_TwoBodyConstraintSettings
  * Method:    createConstraint
@@ -42,4 +51,19 @@ JNIEXPORT jlong JNICALL Java_com_github_stephengold_joltjni_TwoBodyConstraintSet
     Body * const pBody2 = reinterpret_cast<Body *> (body2Va);
     TwoBodyConstraint * const pResult = pSettings->Create(*pBody1, *pBody2);
     return reinterpret_cast<jlong> (pResult);
-}
+}
+
+/*
+ * Class:     com_github_stephengold_joltjni_TwoBodyConstraintSettings
+ * Method:    toRef
+ * Signature: (J)J
+ */
+JNIEXPORT jlong JNICALL Java_com_github_stephengold_joltjni_TwoBodyConstraintSettings_toRef
+  (JNIEnv *, jclass, jlong settingsVa) {
+    TwoBodyConstraintSettings * const pSettings
+            = reinterpret_cast<TwoBodyConstraintSettings *> (settingsVa);
+    Ref<TwoBodyConstraintSettings> * const pResult
+            = new Ref<TwoBodyConstraintSettings>(pSettings);
+    TRACE_NEW("Ref<TwoBodyConstraintSettings>", pResult)
+    return reinterpret_cast<jlong> (pResult);
+}