BoxShape{/Settings}: alter the half-extent constraints

Author: stephengold

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

@@ -37,7 +37,7 @@ public class BoxShape extends ConvexShape {
     /**
      * Instantiate a cubic shape with the specified half extents.
      *
-     * @param halfExtent the desired half extents (≥0.05)
+     * @param halfExtent the desired half extents (>0)
      */
     public BoxShape(float halfExtent) {
         this(halfExtent, halfExtent, halfExtent);
@@ -46,22 +46,18 @@ public BoxShape(float halfExtent) {
     /**
      * Instantiate a shape with the specified half extents.
      *
-     * @param xHalfExtent the desired half extents on the local X axis
-     * (≥0.05)
-     * @param yHalfExtent the desired half extents on the local Y axis
-     * (≥0.05)
-     * @param zHalfExtent the desired half extents on the local Z axis
-     * (≥0.05)
+     * @param xHalfExtent the desired half extent on the local X axis (>0)
+     * @param yHalfExtent the desired half extent on the local Y axis (>0)
+     * @param zHalfExtent the desired half extent on the local Z axis (>0)
      */
     public BoxShape(float xHalfExtent, float yHalfExtent, float zHalfExtent) {
-        float convexRadius = Jolt.cDefaultConvexRadius;
-        assert xHalfExtent >= convexRadius : xHalfExtent;
-        assert yHalfExtent >= convexRadius : yHalfExtent;
-        assert zHalfExtent >= convexRadius : zHalfExtent;
+        assert xHalfExtent > 0f : xHalfExtent;
+        assert yHalfExtent > 0f : yHalfExtent;
+        assert zHalfExtent > 0f : zHalfExtent;
 
         long materialVa = 0L;
         long shapeVa = createBoxShape(xHalfExtent, yHalfExtent, zHalfExtent,
-                convexRadius, materialVa);
+                Jolt.cDefaultConvexRadius, materialVa);
         setVirtualAddressAsCoOwner(shapeVa);
     }
 
@@ -79,7 +75,7 @@ public BoxShape(float xHalfExtent, float yHalfExtent, float zHalfExtent) {
      * Instantiate a shape with the specified half extents.
      *
      * @param halfExtents the desired half extents on each local axis (not null,
-     * all components ≥0.05, unaffected)
+     * all components >0, unaffected)
      */
     public BoxShape(Vec3Arg halfExtents) {
         this(halfExtents, Jolt.cDefaultConvexRadius);
@@ -100,7 +96,7 @@ public BoxShape(Vec3Arg halfExtents, float convexRadius) {
      * Instantiate a shape with the specified parameters.
      *
      * @param halfExtents the desired half extents on each local axis (not null,
-     * all components ≥convexRadius, unaffected)
+     * all components >0, unaffected)
      * @param convexRadius the desired convex radius (default=0.05)
      * @param material the desired material (default=null)
      */
@@ -109,9 +105,9 @@ public BoxShape(Vec3Arg halfExtents, float convexRadius,
         float xHalfExtent = halfExtents.getX();
         float yHalfExtent = halfExtents.getY();
         float zHalfExtent = halfExtents.getZ();
-        assert xHalfExtent >= convexRadius : xHalfExtent;
-        assert yHalfExtent >= convexRadius : yHalfExtent;
-        assert zHalfExtent >= convexRadius : zHalfExtent;
+        assert xHalfExtent > 0f : xHalfExtent;
+        assert yHalfExtent > 0f : yHalfExtent;
+        assert zHalfExtent > 0f : zHalfExtent;
 
         long materialVa = (material == null) ? 0L : material.targetVa();
         long shapeVa = createBoxShape(xHalfExtent, yHalfExtent, zHalfExtent,

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

@@ -69,23 +69,22 @@ public BoxShapeSettings(float radius) {
     /**
      * Instantiate a shape with the specified half extents.
      *
-     * @param xHalfExtent the desired half extents on the local X axis
-     * (≥0.05)
-     * @param yHalfExtent the desired half extents on the local Y axis
-     * (≥0.05)
-     * @param zHalfExtent the desired half extents on the local Z axis
-     * (≥0.05)
+     * @param xHalfExtent the desired half extent on the local X axis
+     * (>0)
+     * @param yHalfExtent the desired half extent on the local Y axis
+     * (>0)
+     * @param zHalfExtent the desired half extent on the local Z axis
+     * (>0)
      */
     public BoxShapeSettings(
             float xHalfExtent, float yHalfExtent, float zHalfExtent) {
-        float convexRadius = Jolt.cDefaultConvexRadius;
-        assert xHalfExtent >= convexRadius : xHalfExtent;
-        assert yHalfExtent >= convexRadius : yHalfExtent;
-        assert zHalfExtent >= convexRadius : zHalfExtent;
+        assert xHalfExtent > 0f : xHalfExtent;
+        assert yHalfExtent > 0f : yHalfExtent;
+        assert zHalfExtent > 0f : zHalfExtent;
 
         long materialVa = 0L;
         long settingsVa = createBoxShapeSettings(xHalfExtent, yHalfExtent,
-                zHalfExtent, convexRadius, materialVa);
+                zHalfExtent, Jolt.cDefaultConvexRadius, materialVa);
         setVirtualAddressAsCoOwner(settingsVa, EShapeSubType.Box);
     }
 
@@ -113,7 +112,7 @@ public BoxShapeSettings(Vec3Arg halfExtents) {
      * Instantiate settings for the specified half extents and convex radius.
      *
      * @param halfExtents the desired half extents on each local axis (not null,
-     * all components ≥0, unaffected)
+     * all components >0, unaffected)
      * @param convexRadius the desired convex radius (≥0, default=0.05)
      */
     public BoxShapeSettings(Vec3Arg halfExtents, float convexRadius) {
@@ -125,7 +124,7 @@ public BoxShapeSettings(Vec3Arg halfExtents, float convexRadius) {
      * material.
      *
      * @param halfExtents the desired half extents on each local axis (not null,
-     * all components ≥0, unaffected)
+     * all components >0, unaffected)
      * @param convexRadius the desired convex radius (≥0, default=0.05)
      * @param material the desired surface properties (not null, unaffected) or
      * {@code null} for default properties (default=null)