@woosh/meep-engine 2.145.0 → 2.146.0

package/package.json

@@ -6,7 +6,7 @@
   "description": "Pure JavaScript game engine. Fully featured and production ready.",
   "type": "module",
   "author": "Alexander Goldring",
-  "version": "2.145.0",
+  "version": "2.146.0",
   "main": "build/meep.module.js",
   "module": "build/meep.module.js",
   "exports": {

package/src/core/geom/3d/shape/HeightMapShape3D.d.ts

@@ -4,8 +4,17 @@
  * The shape is a closed solid bounded below by the plane perpendicular to
  * {@link orientation} (the "floor") and above by a height-field surface
  * defined by a {@link Sampler2D}. Heights are sampled with Catmull-Rom
- * filtering ({@link Sampler2D#sampleChannelCatmullRomUV}), matching what
- * the terrain system uses for geometry construction.
+ * filtering ({@link Sampler2D#sampleChannelCatmullRomUV}) — the *same* cubic
+ * the terrain renderer uses (`sampleChannelBicubicUV` expands to the
+ * identical Catmull-Rom weights, with the matching `u·width − 0.5` UV
+ * convention), so the collision and render surfaces coincide at every point
+ * they both sample.
+ *
+ * They differ only in *tessellation density*: the renderer lays out
+ * `size × resolution` segments per side, while collision defaults to one
+ * quad per sampler cell. {@link tessellation} closes that gap — set it > 1
+ * to subdivide each sampler cell into N×N sub-cells so the contact surface
+ * approaches render fidelity even when the sampler is deliberately coarse.
  *
  * Local frame layout:
  *   - The orientation vector defines the local "up" axis (unit).
@@ -34,9 +43,12 @@ export class HeightMapShape3D extends AbstractShape3D {
      * @param {number} size_y maximum heightmap height (along orientation)
      * @param {number} size_z footprint extent along basis-v
      * @param {Vector3} [orientation] defaults to +Y
+     * @param {number} [tessellation] collision sub-cells per sampler cell per
+     *   axis; non-negative integer, defaults to 1 (one quad per sampler cell).
+     *   See {@link HeightMapShape3D#tessellation}.
      * @returns {HeightMapShape3D}
      */
-    static from(sampler: Sampler2D, size_x: number, size_y: number, size_z: number, orientation?: Vector3): HeightMapShape3D;
+    static from(sampler: Sampler2D, size_x: number, size_y: number, size_z: number, orientation?: Vector3, tessellation?: number): HeightMapShape3D;
     /**
      * Unit vector defining the local "up" axis (the direction the
      * heightmap's surface faces). Default is +Y.
@@ -60,6 +72,24 @@ export class HeightMapShape3D extends AbstractShape3D {
      * @type {Sampler2D | null}
      */
     sampler: Sampler2D | null;
+    /**
+     * Collision tessellation factor: the narrowphase splits each sampler
+     * cell into `tessellation × tessellation` sub-cells before emitting
+     * collision triangles, sampling the same Catmull-Rom filter at the
+     * finer sub-cell corners. `1` (the default) is one quad per sampler
+     * cell — the legacy behaviour. Larger values let a coarse sampler's
+     * contact surface approach the rendered mesh's fidelity.
+     *
+     * Non-negative integer (validated by {@link HeightMapShape3D.from});
+     * cost is O(N²) per cell, so the caller owns the fidelity/cost
+     * trade-off. `0` yields no collision triangles — the degenerate empty
+     * case, mirroring a zero footprint size. Affects only triangle
+     * enumeration — the continuous queries ({@link sample_height_at_uv},
+     * {@link signed_distance_at_point}, {@link nearest_point_on_surface})
+     * read the smooth filter directly and are unaffected.
+     * @type {number}
+     */
+    tessellation: number;
     /**
      * Cached orthonormal basis [u_x,u_y,u_z, v_x,v_y,v_z, n_x,n_y,n_z]
      * built from {@link orientation}. Updated lazily by {@link _ensure_basis}.

package/src/core/geom/3d/shape/HeightMapShape3D.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"HeightMapShape3D.d.ts","sourceRoot":"","sources":["../../../../../../src/core/geom/3d/shape/HeightMapShape3D.js"],"names":[],"mappings":"AAMA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH;IA4CI;;;;;;;;OAQG;IACH,wCANW,MAAM,UACN,MAAM,UACN,MAAM,gBACN,OAAO,GACL,gBAAgB,CAmB5B;IAlEG;;;;;OAKG;IACH,sBAFU,OAAO,CAEsB;IAEvC;;;;;;;OAOG;IACH,eAFU,OAAO,CAEe;IAEhC;;;;;OAKG;IACH,SAFU,YAAY,IAAI,CAEP;IAEnB;;;;;OAKG;IACH,eAAiC;IAGjC,6BAA+B;IAC/B,6BAA+B;IAC/B,6BAA+B;IA+BnC;;;;;;;;;OASG;IACH,sBA+CC;IAED;;;;;;OAMG;IACH,yBAJW,MAAM,OACN,MAAM,GACJ,MAAM,CAIlB;IAED;;;;;;;;OAQG;IACH,8BALW,MAAM,MACN,MAAM,MACN,MAAM,GACJ,MAAM,CAelB;IAED,wCA8BC;IAED,oCA2BC;IAED;;;;;;;;OAQG;IACH,6CAmBC;IAED;;;;OAIG;IACH,4DA2BC;IAED;;;;;;;;;OASG;IACH,qGAEC;IAED,kFAiBC;IA6CD;;;OAGG;IACH,cAHW,gBAAgB,GACd,OAAO,CAgBnB;IAcL;;;;;;OAMG;IACH,6BAFU,OAAO,CAE4B;CAT5C;gCA3a+B,sBAAsB;wBAD9B,kBAAkB"}
+{"version":3,"file":"HeightMapShape3D.d.ts","sourceRoot":"","sources":["../../../../../../src/core/geom/3d/shape/HeightMapShape3D.js"],"names":[],"mappings":"AAMA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACH;IA+DI;;;;;;;;;;;OAWG;IACH,wCATW,MAAM,UACN,MAAM,UACN,MAAM,gBACN,OAAO,iBACP,MAAM,GAGJ,gBAAgB,CAqB5B;IA1FG;;;;;OAKG;IACH,sBAFU,OAAO,CAEsB;IAEvC;;;;;;;OAOG;IACH,eAFU,OAAO,CAEe;IAEhC;;;;;OAKG;IACH,SAFU,YAAY,IAAI,CAEP;IAEnB;;;;;;;;;;;;;;;;OAgBG;IACH,cAFU,MAAM,CAEK;IAErB;;;;;OAKG;IACH,eAAiC;IAGjC,6BAA+B;IAC/B,6BAA+B;IAC/B,6BAA+B;IAoCnC;;;;;;;;;OASG;IACH,sBA+CC;IAED;;;;;;OAMG;IACH,yBAJW,MAAM,OACN,MAAM,GACJ,MAAM,CAIlB;IAED;;;;;;;;OAQG;IACH,8BALW,MAAM,MACN,MAAM,MACN,MAAM,GACJ,MAAM,CAelB;IAED,wCA8BC;IAED,oCA2BC;IAED;;;;;;;;OAQG;IACH,6CAmBC;IAED;;;;OAIG;IACH,4DA2BC;IAED;;;;;;;;;OASG;IACH,qGAEC;IAED,kFAiBC;IA6CD;;;OAGG;IACH,cAHW,gBAAgB,GACd,OAAO,CAiBnB;IAeL;;;;;;OAMG;IACH,6BAFU,OAAO,CAE4B;CAT5C;gCA9c+B,sBAAsB;wBAD9B,kBAAkB"}