@woosh/meep-engine 3.0.0 → 3.0.2

package/src/shade/renderer/camera/GPUCameraContext.js

@@ -1,234 +1,234 @@
-import { m4_invert } from "../../../core/geom/3d/mat4/m4_invert.js";
-import { m4_multiply } from "../../../core/geom/3d/mat4/m4_multiply.js";
-import { mat4 } from "gl-matrix";
-import { slice_flat_array } from "../util/slice_flat_array.js";
-import { queue_typed_buffer_update } from "../shader/type/queue_typed_buffer_update.js";
-import { GPUTypedBuffer } from "../buffer/GPUTypedBuffer.js";
-import { CAMERA_UNIFORM_STRUCT } from "./CAMERA_UNIFORM_STRUCT.js";
-import { compute_device_depth_to_view_space_depth_params } from "./compute_device_depth_to_view_space_depth_params.js";
-
-let id_counter = 0;
-
-export class GPUCameraContext {
-
-    #id = id_counter++;
-
-    get id() {
-        return this.#id;
-    }
-
-    /**
-     * @returns {GPUBuffer}
-     */
-    get gpu_buffer() {
-        return this.buffer.buffer;
-    }
-
-    /**
-     * @type {GPUTypedBuffer}
-     */
-    buffer;
-
-    /**
-     * @type {GPUDevice}
-     */
-    #device
-
-    /**
-     * @type {Camera}
-     */
-    #camera
-
-
-    /**
-     * Final view projection matrix will be offset by this amount in NDC units
-     * @type {Float32Array}
-     */
-    #view_offset = new Float32Array([0, 0]);
-
-    /**
-     *
-     * @type {Float32Array}
-     */
-    #view_projection_matrix = new Float32Array(16);
-
-    get view_projection_matrix() {
-        return this.#view_projection_matrix;
-    }
-
-    /**
-     *
-     * @param {number} x
-     * @param {number} y
-     */
-    setViewportOffset(x, y) {
-        this.#view_offset[0] = x;
-        this.#view_offset[1] = y;
-    }
-
-    /**
-     *
-     * @param {Camera} v
-     */
-    set camera(v) {
-        this.#camera = v;
-    }
-
-    /**
-     *
-     * @return {Camera}
-     */
-    get camera() {
-        return this.#camera;
-    }
-
-    /**
-     *
-     * @param {GPUDevice} device
-     * @param {Camera} camera
-     */
-    constructor(device, camera) {
-        this.#device = device;
-        this.#camera = camera;
-        this.initialize();
-    }
-
-    clone() {
-        const r = new GPUCameraContext(this.#device, this.#camera.clone());
-
-        r.copy(this);
-
-        return r;
-    }
-
-    /**
-     *
-     * @param {GPUCameraContext} other
-     * @param {ShadeGPUCommandContext} [command_ctx]
-     */
-    copy(other, command_ctx) {
-        this.#camera.copy(other.camera);
-
-        const device = this.#device;
-
-
-        const source = other.buffer.buffer;
-        const destination = this.buffer.buffer;
-
-
-        if (command_ctx === undefined) {
-            const encoder = device.createCommandEncoder();
-
-            encoder.copyBufferToBuffer(
-                source, 0,
-                destination, 0,
-                destination.size
-            );
-
-            device.queue.submit([encoder.finish()]);
-
-        } else {
-
-            command_ctx.copyBufferToBuffer(
-                source, 0,
-                destination, 0,
-                destination.size
-            );
-
-        }
-
-    }
-
-    initialize() {
-
-        this.buffer = GPUTypedBuffer.create({
-            device: this.#device,
-            label: `camera ${this.#id}`,
-            type: CAMERA_UNIFORM_STRUCT,
-            usage: GPUBufferUsage.STORAGE | GPUBufferUsage.UNIFORM | GPUBufferUsage.COPY_DST | GPUBufferUsage.COPY_SRC
-        });
-    }
-
-    destroy() {
-        this.buffer.destroy();
-    }
-
-    update() {
-        this.#write_update();
-    }
-
-    /**
-     *
-     */
-    #write_update() {
-
-        const camera = this.#camera;
-        camera.update();
-
-        const projection_matrix = new Float64Array(16);
-        projection_matrix.set(camera.projection_matrix);
-
-        // Signs are chosen so a positive offset shifts rendered content in the +UV direction
-        // (right/down), which is what the temporal consumers (TAA/NSS un-jitter,
-        // chunk_unjitter_uv) assume. The perspective divide negates whatever is added here:
-        // m[11] == -1 makes clip.w = -z_view, so adding c at m[8]/m[9] shifts NDC by -c —
-        // hence "-=" for x (NDC x aligns with UV x) and "+=" for y (NDC y is UV-flipped,
-        // the two negations cancel).
-        projection_matrix[8] -= this.#view_offset[0];
-        projection_matrix[9] += this.#view_offset[1];
-
-        // build view-projection matrix
-        const view_projection_matrix = this.#view_projection_matrix;
-        m4_multiply(view_projection_matrix, projection_matrix, camera.view_matrix);
-
-        const device = this.#device;
-        const queue = device.queue;
-
-        const transform_matrix = camera.transform.matrix;
-
-
-        const transform_inverse = mat4.create();
-        m4_invert(transform_inverse, transform_matrix);
-
-        const projection_matrix_inverse = mat4.create();
-        m4_invert(projection_matrix_inverse, projection_matrix);
-
-
-        const view_projection_matrix_inverse = mat4.create();
-        m4_invert(view_projection_matrix_inverse, view_projection_matrix);
-
-
-        const device_depth_to_view_space = new Float32Array(4);
-        compute_device_depth_to_view_space_depth_params(
-            device_depth_to_view_space,
-            camera,
-        );
-
-        const view_matrix_inverse = mat4.create();
-        m4_invert(view_matrix_inverse, camera.view_matrix);
-
-        queue_typed_buffer_update(
-            queue,
-            this.buffer,
-            {
-                view_matrix: camera.view_matrix,
-                view_matrix_inverse: view_matrix_inverse,
-                transform: transform_matrix,
-                transform_inverse,
-                projection_matrix,
-                projection_matrix_inverse,
-                view_projection_matrix,
-                view_projection_matrix_inverse,
-                frustum: slice_flat_array(
-                    camera.frustum,
-                    0,
-                    4,
-                    6
-                ),
-                device_depth_to_view_space,
-                clip_near_far: [camera.near, camera.far]
-            }
-        );
-
-    }
+import { m4_allocate } from "../../../core/geom/3d/mat4/m4_allocate.js";
+import { m4_invert } from "../../../core/geom/3d/mat4/m4_invert.js";
+import { m4_multiply } from "../../../core/geom/3d/mat4/m4_multiply.js";
+import { slice_flat_array } from "../util/slice_flat_array.js";
+import { queue_typed_buffer_update } from "../shader/type/queue_typed_buffer_update.js";
+import { GPUTypedBuffer } from "../buffer/GPUTypedBuffer.js";
+import { CAMERA_UNIFORM_STRUCT } from "./CAMERA_UNIFORM_STRUCT.js";
+import { compute_device_depth_to_view_space_depth_params } from "./compute_device_depth_to_view_space_depth_params.js";
+
+let id_counter = 0;
+
+export class GPUCameraContext {
+
+    #id = id_counter++;
+
+    get id() {
+        return this.#id;
+    }
+
+    /**
+     * @returns {GPUBuffer}
+     */
+    get gpu_buffer() {
+        return this.buffer.buffer;
+    }
+
+    /**
+     * @type {GPUTypedBuffer}
+     */
+    buffer;
+
+    /**
+     * @type {GPUDevice}
+     */
+    #device
+
+    /**
+     * @type {Camera}
+     */
+    #camera
+
+
+    /**
+     * Final view projection matrix will be offset by this amount in NDC units
+     * @type {Float32Array}
+     */
+    #view_offset = new Float32Array([0, 0]);
+
+    /**
+     *
+     * @type {Float32Array}
+     */
+    #view_projection_matrix = new Float32Array(16);
+
+    get view_projection_matrix() {
+        return this.#view_projection_matrix;
+    }
+
+    /**
+     *
+     * @param {number} x
+     * @param {number} y
+     */
+    setViewportOffset(x, y) {
+        this.#view_offset[0] = x;
+        this.#view_offset[1] = y;
+    }
+
+    /**
+     *
+     * @param {Camera} v
+     */
+    set camera(v) {
+        this.#camera = v;
+    }
+
+    /**
+     *
+     * @return {Camera}
+     */
+    get camera() {
+        return this.#camera;
+    }
+
+    /**
+     *
+     * @param {GPUDevice} device
+     * @param {Camera} camera
+     */
+    constructor(device, camera) {
+        this.#device = device;
+        this.#camera = camera;
+        this.initialize();
+    }
+
+    clone() {
+        const r = new GPUCameraContext(this.#device, this.#camera.clone());
+
+        r.copy(this);
+
+        return r;
+    }
+
+    /**
+     *
+     * @param {GPUCameraContext} other
+     * @param {ShadeGPUCommandContext} [command_ctx]
+     */
+    copy(other, command_ctx) {
+        this.#camera.copy(other.camera);
+
+        const device = this.#device;
+
+
+        const source = other.buffer.buffer;
+        const destination = this.buffer.buffer;
+
+
+        if (command_ctx === undefined) {
+            const encoder = device.createCommandEncoder();
+
+            encoder.copyBufferToBuffer(
+                source, 0,
+                destination, 0,
+                destination.size
+            );
+
+            device.queue.submit([encoder.finish()]);
+
+        } else {
+
+            command_ctx.copyBufferToBuffer(
+                source, 0,
+                destination, 0,
+                destination.size
+            );
+
+        }
+
+    }
+
+    initialize() {
+
+        this.buffer = GPUTypedBuffer.create({
+            device: this.#device,
+            label: `camera ${this.#id}`,
+            type: CAMERA_UNIFORM_STRUCT,
+            usage: GPUBufferUsage.STORAGE | GPUBufferUsage.UNIFORM | GPUBufferUsage.COPY_DST | GPUBufferUsage.COPY_SRC
+        });
+    }
+
+    destroy() {
+        this.buffer.destroy();
+    }
+
+    update() {
+        this.#write_update();
+    }
+
+    /**
+     *
+     */
+    #write_update() {
+
+        const camera = this.#camera;
+        camera.update();
+
+        const projection_matrix = new Float64Array(16);
+        projection_matrix.set(camera.projection_matrix);
+
+        // Signs are chosen so a positive offset shifts rendered content in the +UV direction
+        // (right/down), which is what the temporal consumers (TAA/NSS un-jitter,
+        // chunk_unjitter_uv) assume. The perspective divide negates whatever is added here:
+        // m[11] == -1 makes clip.w = -z_view, so adding c at m[8]/m[9] shifts NDC by -c —
+        // hence "-=" for x (NDC x aligns with UV x) and "+=" for y (NDC y is UV-flipped,
+        // the two negations cancel).
+        projection_matrix[8] -= this.#view_offset[0];
+        projection_matrix[9] += this.#view_offset[1];
+
+        // build view-projection matrix
+        const view_projection_matrix = this.#view_projection_matrix;
+        m4_multiply(view_projection_matrix, projection_matrix, camera.view_matrix);
+
+        const device = this.#device;
+        const queue = device.queue;
+
+        const transform_matrix = camera.transform.matrix;
+
+
+        const transform_inverse = m4_allocate();
+        m4_invert(transform_inverse, transform_matrix);
+
+        const projection_matrix_inverse = m4_allocate();
+        m4_invert(projection_matrix_inverse, projection_matrix);
+
+
+        const view_projection_matrix_inverse = m4_allocate();
+        m4_invert(view_projection_matrix_inverse, view_projection_matrix);
+
+
+        const device_depth_to_view_space = new Float32Array(4);
+        compute_device_depth_to_view_space_depth_params(
+            device_depth_to_view_space,
+            camera,
+        );
+
+        const view_matrix_inverse = m4_allocate();
+        m4_invert(view_matrix_inverse, camera.view_matrix);
+
+        queue_typed_buffer_update(
+            queue,
+            this.buffer,
+            {
+                view_matrix: camera.view_matrix,
+                view_matrix_inverse: view_matrix_inverse,
+                transform: transform_matrix,
+                transform_inverse,
+                projection_matrix,
+                projection_matrix_inverse,
+                view_projection_matrix,
+                view_projection_matrix_inverse,
+                frustum: slice_flat_array(
+                    camera.frustum,
+                    0,
+                    4,
+                    6
+                ),
+                device_depth_to_view_space,
+                clip_near_far: [camera.near, camera.far]
+            }
+        );
+
+    }
 }

package/src/shade/renderer/geometry/Geometry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Geometry.d.ts","sourceRoot":"","sources":["../../../../../src/shade/renderer/geometry/Geometry.js"],"names":[],"mappings":"4BA2BU,MAAM;;;;AAQhB;;GAEG;AACH;IAQI;;;;OAIG;IACH,iBAEC;IAED;;;OAGG;IACH,MAFU,MAAM,CAEN;IAEV;;;OAGG;IACH,YAFU,SAAS,EAAE,CAEL;IAEhB;;;OAGG;IACH,OAFU,SAAS,GAAC,IAAI,CAEX;IAEb;;;OAGG;IACH,cAFU,YAAY,CAEa;IACnC;;;OAGG;IACH,iBAFU,YAAY,CAEgB;IAEtC;;;OAGG;IACH,OAFU,MAAM,CAEM;IAOtB;;;;;;;;;;OAUG;IACH,sBAEC;IAED;;OAEG;IACH,8BAIC;IAGD;;;;OAIG;IACH,cAHW,MAAM,GAAC,aAAa,GAClB,IAAI,CAIhB;IAED;;;;OAIG;IACH,gBAHW,MAAM,GAAC,aAAa,GAClB,IAAI,CAIhB;IAED;;;;OAIG;IACH,gBAHW,MAAM,GAAC,aAAa,SACpB,OAAO,QAQjB;IAED;;;;OAIG;IACH,cAHW,MAAM,GAAC,aAAa,GAClB,OAAO,CAInB;IAED;;;;OAIG;IACH,cAHW,QAAQ,GACN,OAAO,CAYnB;IAED,eAQC;IAED;;;;OAIG;IACH,mBAHW,MAAM,GACL,SAAS,GAAC,SAAS,CAkB9B;IAED;;;;OAIG;IACH,mBAHW,MAAM,GACJ,OAAO,CAMnB;IAED;;;OAGG;IACH,wBAFW,SAAS,QAQnB;IAED;;;OAGG;IACH,wBAFW,SAAS,QASnB;IAED;;;;OAIG;IACH,sBAHW,MAAM,GACL,SAAS,GAAC,SAAS,CAiB9B;IAED;;;OAGG;IACH,kBAFY,MAAM,CAWjB;IAED;;;OAGG;IACH,iBAFY,MAAM,CAYjB;IAED;;;;OAIG;IACH,qBAFa,MAAM,CAIlB;IAED;;;OAGG;IACH,oBAIC;IAED;;OAEG;IACH,mBASC;IAED,qBAIC;IAED;;OAEG;IACH,qCAoBC;IAED,8BAaC;IAED,8BAKC;IAED,2BAeC;IAED,sBAOC;IAED,uBA4BC;IAmFD,uBAOC;IAED,wBAWC;IAED;;;OAGG;IACH,YAFW,QAAQ,QAmBlB;IAED;;;OAGG;IACH,SAFY,QAAQ,CAQnB;IAED,eAEC;IAED;;;OAGG;IACH,iCAYC;IAGL;;;OAGG;IACH,qBAFU,OAAO,CAEY;;CAN5B;0BAtkByB,gBAAgB"}
+{"version":3,"file":"Geometry.d.ts","sourceRoot":"","sources":["../../../../../src/shade/renderer/geometry/Geometry.js"],"names":[],"mappings":"4BA2BU,MAAM;;;;AAQhB;;GAEG;AACH;IAQI;;;;OAIG;IACH,iBAEC;IAED;;;OAGG;IACH,MAFU,MAAM,CAEN;IAEV;;;OAGG;IACH,YAFU,SAAS,EAAE,CAEL;IAEhB;;;OAGG;IACH,OAFU,SAAS,GAAC,IAAI,CAEX;IAEb;;;OAGG;IACH,cAFU,YAAY,CAEa;IACnC;;;OAGG;IACH,iBAFU,YAAY,CAEgB;IAEtC;;;OAGG;IACH,OAFU,MAAM,CAEM;IAOtB;;;;;;;;;;OAUG;IACH,sBAEC;IAED;;OAEG;IACH,8BAIC;IAGD;;;;OAIG;IACH,cAHW,MAAM,GAAC,aAAa,GAClB,IAAI,CAIhB;IAED;;;;OAIG;IACH,gBAHW,MAAM,GAAC,aAAa,GAClB,IAAI,CAIhB;IAED;;;;OAIG;IACH,gBAHW,MAAM,GAAC,aAAa,SACpB,OAAO,QAQjB;IAED;;;;OAIG;IACH,cAHW,MAAM,GAAC,aAAa,GAClB,OAAO,CAInB;IAED;;;;OAIG;IACH,cAHW,QAAQ,GACN,OAAO,CAYnB;IAED,eAQC;IAED;;;;OAIG;IACH,mBAHW,MAAM,GACL,SAAS,GAAC,SAAS,CAkB9B;IAED;;;;OAIG;IACH,mBAHW,MAAM,GACJ,OAAO,CAMnB;IAED;;;OAGG;IACH,wBAFW,SAAS,QAQnB;IAED;;;OAGG;IACH,wBAFW,SAAS,QASnB;IAED;;;;OAIG;IACH,sBAHW,MAAM,GACL,SAAS,GAAC,SAAS,CAiB9B;IAED;;;OAGG;IACH,kBAFY,MAAM,CAWjB;IAED;;;OAGG;IACH,iBAFY,MAAM,CAYjB;IAED;;;;OAIG;IACH,qBAFa,MAAM,CAIlB;IAED;;;OAGG;IACH,oBAIC;IAED;;OAEG;IACH,mBASC;IAED,qBAIC;IAED;;OAEG;IACH,qCAoBC;IAED,8BAaC;IAED,8BAKC;IAED,2BAeC;IAED,sBAOC;IAED,uBA4BC;IAoFD,uBAOC;IAED,wBAWC;IAED;;;OAGG;IACH,YAFW,QAAQ,QAmBlB;IAED;;;OAGG;IACH,SAFY,QAAQ,CAQnB;IAED,eAEC;IAED;;;OAGG;IACH,iCAYC;IAGL;;;OAGG;IACH,qBAFU,OAAO,CAEY;;CAN5B;0BAvkByB,gBAAgB"}

package/src/shade/renderer/geometry/Geometry.js

@@ -457,7 +457,12 @@ export class Geometry {
     }
 
     #compute_tangents_uv() {
-        // based on implementation from three.js
+        /*
+         A port of three's `BufferGeometry.computeTangents`, which is itself Lengyel's
+         per-vertex tangent method (http://www.terathon.com/code/tangent.html).
+
+         Derived from three.js (https://github.com/mrdoob/three.js), Copyright (c) 2010-2024 three.js authors, MIT licence.
+        */
 
         const index = this.index;
 
@@ -465,10 +470,6 @@ export class Geometry {
         const normal_attribute = this.getAttribute(StandardAttributes.Normal);
         const uv_attribute = this.getAttribute(StandardAttributes.TextureCoordinates0);
 
-
-        // based on http://www.terathon.com/code/tangent.html
-        // (per vertex tangents)
-
         if (index === null ||
             position_attribute === undefined ||
             normal_attribute === undefined ||

package/src/shade/renderer/geometry/primitives/make_box_geometry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"make_box_geometry.d.ts","sourceRoot":"","sources":["../../../../../../src/shade/renderer/geometry/primitives/make_box_geometry.js"],"names":[],"mappings":"AAIA;;;;;;;;;GASG;AACH,6JAFa,QAAQ,CAuIpB;yBAlJwB,gBAAgB"}
+{"version":3,"file":"make_box_geometry.d.ts","sourceRoot":"","sources":["../../../../../../src/shade/renderer/geometry/primitives/make_box_geometry.js"],"names":[],"mappings":"AAIA;;;;;;;;;GASG;AACH,6JAFa,QAAQ,CA4IpB;yBAvJwB,gBAAgB"}

package/src/shade/renderer/geometry/primitives/make_box_geometry.js

@@ -14,7 +14,12 @@ import { StandardAttributes } from "../StandardAttributes.js";
  */
 export function make_box_geometry(width = 1, height = 1, depth = 1, widthSegments = 1, heightSegments = 1, depthSegments = 1) {
 
-    // based on three.js code
+    /*
+     A port of three's `BoxGeometry` onto `Geometry`: the same subdivision and the same
+     winding, writing meep attributes instead of three ones.
+
+     Derived from three.js (https://github.com/mrdoob/three.js), Copyright (c) 2010-2024 three.js authors, MIT licence.
+    */
 
     const geo = new Geometry();
 

package/src/shade/renderer/geometry/primitives/make_cylinder_geometry.d.ts

@@ -0,0 +1,19 @@
+/**
+ * The axis runs along Y and the body is centred on the origin.
+ *
+ * `Geometry` carries no multi-material groups, so the torso and the two caps are one index run
+ * rather than three; three's cylinder splits them only to address a material array.
+ *
+ * @param {number} [radiusTop]
+ * @param {number} [radiusBottom]
+ * @param {number} [height]
+ * @param {number} [radialSegments] segments around the axis
+ * @param {number} [heightSegments] segments along the axis
+ * @param {boolean} [openEnded] leave the caps off, which makes the surface a tube rather than a solid
+ * @param {number} [thetaStart]
+ * @param {number} [thetaLength] how much of the turn to build, in radians
+ * @returns {Geometry}
+ */
+export function make_cylinder_geometry(radiusTop?: number, radiusBottom?: number, height?: number, radialSegments?: number, heightSegments?: number, openEnded?: boolean, thetaStart?: number, thetaLength?: number): Geometry;
+import { Geometry } from "../Geometry.js";
+//# sourceMappingURL=make_cylinder_geometry.d.ts.map

package/src/shade/renderer/geometry/primitives/make_cylinder_geometry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"make_cylinder_geometry.d.ts","sourceRoot":"","sources":["../../../../../../src/shade/renderer/geometry/primitives/make_cylinder_geometry.js"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;;;GAeG;AACH,mDAVW,MAAM,iBACN,MAAM,WACN,MAAM,mBACN,MAAM,mBACN,MAAM,cACN,OAAO,eACP,MAAM,gBACN,MAAM,GACJ,QAAQ,CA6NpB;yBA9OwB,gBAAgB"}