@woosh/meep-engine 3.0.0 → 3.0.1

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

@@ -1,281 +1,282 @@
-import { assert } from "../../../core/assert.js";
-import { combine_hash } from "../../../core/collection/array/combine_hash.js";
-import { plane3_normalize } from "../../../core/geom/3d/plane/plane3_normalize.js";
-import { v3_dot } from "../../../core/geom/vec3/v3_dot.js";
-import { computeHashFloat } from "../../../core/primitives/numbers/computeHashFloat.js";
-import { Transform } from "../../../engine/ecs/transform/Transform.js";
-import { mat4 } from "gl-matrix";
-
-let id_counter = 0;
-
-/**
- * ref: Gribb-Hartmann
- * Updates frustum planes from a View-Projection matrix.
- * Geared for Reverse-Z (WebGPU/DirectX range [0,1]).
- * @param {Float32Array} planes
- * @param {Float32Array} vp ViewProjection matrix
- */
-function construct_frustum_planes(planes, vp) {
-    // Left Plane (w + x)
-    // Row 3 + Row 0
-    plane3_normalize(
-        planes, 0,
-        vp[3] + vp[0],
-        vp[7] + vp[4],
-        vp[11] + vp[8],
-        vp[15] + vp[12]
-    );
-
-    // Right Plane (w - x)
-    // Row 3 - Row 0
-    plane3_normalize(
-        planes, 4,
-        vp[3] - vp[0],
-        vp[7] - vp[4],
-        vp[11] - vp[8],
-        vp[15] - vp[12]
-    );
-
-    // Bottom Plane (w + y)
-    // Row 3 + Row 1
-    plane3_normalize(
-        planes, 8,
-        vp[3] + vp[1],
-        vp[7] + vp[5],
-        vp[11] + vp[9],
-        vp[15] + vp[13]
-    );
-
-    // Top Plane (w - y)
-    // Row 3 - Row 1
-    plane3_normalize(
-        planes, 12,
-        vp[3] - vp[1],
-        vp[7] - vp[5],
-        vp[11] - vp[9],
-        vp[15] - vp[13]
-    );
-
-    // Near Plane (Reverse-Z: z <= w -> w - z >= 0)
-    // Row 3 - Row 2
-    plane3_normalize(
-        planes, 16,
-        vp[3] - vp[2],
-        vp[7] - vp[6],
-        vp[11] - vp[10],
-        vp[15] - vp[14]
-    );
-
-    // Far Plane (Reverse-Z: z >= 0)
-    // Row 2 ONLY (Not Row 3 + Row 2)
-    plane3_normalize(
-        planes, 20,
-        vp[2],      // x
-        vp[6],      // y
-        vp[10],     // z
-        vp[14]      // w
-    );
-}
-
-export class Camera {
-    /**
-     * @readonly
-     */
-    #id = id_counter++;
-
-    transform = new Transform();
-
-    view_matrix = mat4.create();
-    projection_matrix = mat4.create();
-    view_projection_matrix = mat4.create();
-
-    /**
-     * World-space view frustum.
-     * @type {Float32Array}
-     */
-    frustum = new Float32Array(24);
-
-    /**
-     * Near clipping plane
-     * @type {number}
-     */
-    #near = 0.1;
-
-    /**
-     * NOTE: For perspective, we use infinite Z projection, so this value only controls culling and not clipping
-     * @type {number}
-     */
-    #far = 2000;
-
-    /**
-     * Width / Height
-     * @type {number}
-     */
-    #aspect = 1;
-
-    set near(v) {
-        this.#near = v;
-    }
-
-    get near() {
-        return this.#near;
-    }
-
-    set far(v) {
-        this.#far = v;
-    }
-
-    get far() {
-        return this.#far;
-    }
-
-    set aspect(v) {
-        assert.isNumber(v, "aspect");
-        assert.notNaN(v, "aspect");
-
-        this.#aspect = v;
-    }
-
-    get aspect() {
-        return this.#aspect
-    }
-
-    get isReverseZ() {
-        return true;
-    }
-
-    get isInfiniteFar() {
-        return false;
-    }
-
-    /**
-     *
-     * @param {Camera} other
-     */
-    copy(other) {
-
-        this.#near = other.#near;
-        this.#far = other.#far;
-
-        this.#aspect = other.#aspect;
-
-        this.frustum.set(other.frustum);
-        this.transform.copy(other.transform);
-        this.view_matrix.set(other.view_matrix);
-        this.projection_matrix.set(other.projection_matrix);
-        this.view_projection_matrix.set(other.view_projection_matrix);
-    }
-
-    clone() {
-        const r = new this.constructor();
-
-        r.copy(this);
-
-        assert.ok(r.equals(this), 'implementation of .copy is faulty');
-
-        return r;
-    }
-
-    get id() {
-        return this.#id
-    }
-
-    hash() {
-        return combine_hash(
-            computeHashFloat(this.#near),
-            computeHashFloat(this.#far),
-            computeHashFloat(this.#aspect),
-        );
-    }
-
-    /**
-     *
-     * @param {Camera} other
-     */
-    equals(other) {
-        return this.near === other.near
-            && this.far === other.far
-            && this.aspect === other.aspect
-            && this.transform.equals(other.transform)
-            ;
-    }
-
-    update_matrices() {
-
-        this.update_projection();
-
-        this.update_view_matrix();
-    }
-
-    update_projection() {
-
-    }
-
-    update_view_matrix() {
-        // Direct access to the Float32Array buffer
-        const m = this.transform.matrix;
-        const out = this.view_matrix;
-
-        // 1. Extract Camera Position
-        const px = m[12];
-        const py = m[13];
-        const pz = m[14];
-
-        // 2. Extract Basis Vectors from World Matrix
-        // Column 0 = Right (X)
-        const rx = m[0];
-        const ry = m[1];
-        const rz = m[2];
-
-        // Column 1 = Up (Y)
-        const ux = m[4];
-        const uy = m[5];
-        const uz = m[6];
-
-        // Column 2 = Forward (Z)
-        const fx = m[8];
-        const fy = m[9];
-        const fz = m[10];
-
-        // 3. Construct View Matrix (Inverse Rotation * Negative Translation)
-        // rotating around UP (Y) axis 180 degrees
-        out[0] = -rx;
-        out[4] = -ry;
-        out[8] = -rz;
-
-        out[1] = ux;
-        out[5] = uy;
-        out[9] = uz;
-
-        out[2] = -fx;
-        out[6] = -fy;
-        out[10] = -fz;
-
-        // Row 3: Translation
-        out[12] = v3_dot(px, py, pz, rx, ry, rz);
-        out[13] = -v3_dot(px, py, pz, ux, uy, uz);
-        out[14] = v3_dot(px, py, pz, fx, fy, fz);
-
-        // Homogeneous Identity
-        out[3] = 0;
-        out[7] = 0;
-        out[11] = 0;
-        out[15] = 1;
-    }
-
-    update_frustum() {
-
-        construct_frustum_planes(this.frustum, this.view_projection_matrix);
-
-    }
-
-    update() {
-
-        this.update_matrices();
-
-        mat4.multiply(this.view_projection_matrix, this.projection_matrix, this.view_matrix);
-
-        this.update_frustum();
-
-    }
+import { assert } from "../../../core/assert.js";
+import { combine_hash } from "../../../core/collection/array/combine_hash.js";
+import { m4_allocate } from "../../../core/geom/3d/mat4/m4_allocate.js";
+import { m4_multiply } from "../../../core/geom/3d/mat4/m4_multiply.js";
+import { plane3_normalize } from "../../../core/geom/3d/plane/plane3_normalize.js";
+import { v3_dot } from "../../../core/geom/vec3/v3_dot.js";
+import { computeHashFloat } from "../../../core/primitives/numbers/computeHashFloat.js";
+import { Transform } from "../../../engine/ecs/transform/Transform.js";
+
+let id_counter = 0;
+
+/**
+ * ref: Gribb-Hartmann
+ * Updates frustum planes from a View-Projection matrix.
+ * Geared for Reverse-Z (WebGPU/DirectX range [0,1]).
+ * @param {Float32Array} planes
+ * @param {Float32Array} vp ViewProjection matrix
+ */
+function construct_frustum_planes(planes, vp) {
+    // Left Plane (w + x)
+    // Row 3 + Row 0
+    plane3_normalize(
+        planes, 0,
+        vp[3] + vp[0],
+        vp[7] + vp[4],
+        vp[11] + vp[8],
+        vp[15] + vp[12]
+    );
+
+    // Right Plane (w - x)
+    // Row 3 - Row 0
+    plane3_normalize(
+        planes, 4,
+        vp[3] - vp[0],
+        vp[7] - vp[4],
+        vp[11] - vp[8],
+        vp[15] - vp[12]
+    );
+
+    // Bottom Plane (w + y)
+    // Row 3 + Row 1
+    plane3_normalize(
+        planes, 8,
+        vp[3] + vp[1],
+        vp[7] + vp[5],
+        vp[11] + vp[9],
+        vp[15] + vp[13]
+    );
+
+    // Top Plane (w - y)
+    // Row 3 - Row 1
+    plane3_normalize(
+        planes, 12,
+        vp[3] - vp[1],
+        vp[7] - vp[5],
+        vp[11] - vp[9],
+        vp[15] - vp[13]
+    );
+
+    // Near Plane (Reverse-Z: z <= w -> w - z >= 0)
+    // Row 3 - Row 2
+    plane3_normalize(
+        planes, 16,
+        vp[3] - vp[2],
+        vp[7] - vp[6],
+        vp[11] - vp[10],
+        vp[15] - vp[14]
+    );
+
+    // Far Plane (Reverse-Z: z >= 0)
+    // Row 2 ONLY (Not Row 3 + Row 2)
+    plane3_normalize(
+        planes, 20,
+        vp[2],      // x
+        vp[6],      // y
+        vp[10],     // z
+        vp[14]      // w
+    );
+}
+
+export class Camera {
+    /**
+     * @readonly
+     */
+    #id = id_counter++;
+
+    transform = new Transform();
+
+    view_matrix = m4_allocate();
+    projection_matrix = m4_allocate();
+    view_projection_matrix = m4_allocate();
+
+    /**
+     * World-space view frustum.
+     * @type {Float32Array}
+     */
+    frustum = new Float32Array(24);
+
+    /**
+     * Near clipping plane
+     * @type {number}
+     */
+    #near = 0.1;
+
+    /**
+     * NOTE: For perspective, we use infinite Z projection, so this value only controls culling and not clipping
+     * @type {number}
+     */
+    #far = 2000;
+
+    /**
+     * Width / Height
+     * @type {number}
+     */
+    #aspect = 1;
+
+    set near(v) {
+        this.#near = v;
+    }
+
+    get near() {
+        return this.#near;
+    }
+
+    set far(v) {
+        this.#far = v;
+    }
+
+    get far() {
+        return this.#far;
+    }
+
+    set aspect(v) {
+        assert.isNumber(v, "aspect");
+        assert.notNaN(v, "aspect");
+
+        this.#aspect = v;
+    }
+
+    get aspect() {
+        return this.#aspect
+    }
+
+    get isReverseZ() {
+        return true;
+    }
+
+    get isInfiniteFar() {
+        return false;
+    }
+
+    /**
+     *
+     * @param {Camera} other
+     */
+    copy(other) {
+
+        this.#near = other.#near;
+        this.#far = other.#far;
+
+        this.#aspect = other.#aspect;
+
+        this.frustum.set(other.frustum);
+        this.transform.copy(other.transform);
+        this.view_matrix.set(other.view_matrix);
+        this.projection_matrix.set(other.projection_matrix);
+        this.view_projection_matrix.set(other.view_projection_matrix);
+    }
+
+    clone() {
+        const r = new this.constructor();
+
+        r.copy(this);
+
+        assert.ok(r.equals(this), 'implementation of .copy is faulty');
+
+        return r;
+    }
+
+    get id() {
+        return this.#id
+    }
+
+    hash() {
+        return combine_hash(
+            computeHashFloat(this.#near),
+            computeHashFloat(this.#far),
+            computeHashFloat(this.#aspect),
+        );
+    }
+
+    /**
+     *
+     * @param {Camera} other
+     */
+    equals(other) {
+        return this.near === other.near
+            && this.far === other.far
+            && this.aspect === other.aspect
+            && this.transform.equals(other.transform)
+            ;
+    }
+
+    update_matrices() {
+
+        this.update_projection();
+
+        this.update_view_matrix();
+    }
+
+    update_projection() {
+
+    }
+
+    update_view_matrix() {
+        // Direct access to the Float32Array buffer
+        const m = this.transform.matrix;
+        const out = this.view_matrix;
+
+        // 1. Extract Camera Position
+        const px = m[12];
+        const py = m[13];
+        const pz = m[14];
+
+        // 2. Extract Basis Vectors from World Matrix
+        // Column 0 = Right (X)
+        const rx = m[0];
+        const ry = m[1];
+        const rz = m[2];
+
+        // Column 1 = Up (Y)
+        const ux = m[4];
+        const uy = m[5];
+        const uz = m[6];
+
+        // Column 2 = Forward (Z)
+        const fx = m[8];
+        const fy = m[9];
+        const fz = m[10];
+
+        // 3. Construct View Matrix (Inverse Rotation * Negative Translation)
+        // rotating around UP (Y) axis 180 degrees
+        out[0] = -rx;
+        out[4] = -ry;
+        out[8] = -rz;
+
+        out[1] = ux;
+        out[5] = uy;
+        out[9] = uz;
+
+        out[2] = -fx;
+        out[6] = -fy;
+        out[10] = -fz;
+
+        // Row 3: Translation
+        out[12] = v3_dot(px, py, pz, rx, ry, rz);
+        out[13] = -v3_dot(px, py, pz, ux, uy, uz);
+        out[14] = v3_dot(px, py, pz, fx, fy, fz);
+
+        // Homogeneous Identity
+        out[3] = 0;
+        out[7] = 0;
+        out[11] = 0;
+        out[15] = 1;
+    }
+
+    update_frustum() {
+
+        construct_frustum_planes(this.frustum, this.view_projection_matrix);
+
+    }
+
+    update() {
+
+        this.update_matrices();
+
+        m4_multiply(this.view_projection_matrix, this.projection_matrix, this.view_matrix);
+
+        this.update_frustum();
+
+    }
 }