reze-engine 0.27.2 → 0.27.3

package/dist/camera.d.ts

@@ -43,6 +43,20 @@ export declare class Camera {
     setVmdDriven(enabled: boolean): void;
     /** Feed the next sampled MMD camera pose (engine calls this each frame while driving). */
     setVmdPose(pose: CameraPose): void;
+    private vmdEye;
+    /**
+     * Where the shot is actually taken from: the VMD eye while a camera VMD drives, the
+     * orbit position otherwise.
+     *
+     * `getPosition()` deliberately stays orbit-only — pan, zoom and framing reason in the
+     * spherical coordinates a camera VMD never touches. Anything asking "where is the
+     * viewer" wants THIS. Feeding the orbit position to the shader's `camera.viewPos`
+     * while rendering from the VMD camera left every view-dependent term — specular, rim,
+     * fresnel, sphere maps, the eye visibility gate — evaluated from a camera that was not
+     * the one taking the picture, with the error depending on wherever the orbit happened
+     * to be left.
+     */
+    getEyePosition(): Vec3;
     getViewMatrix(): Mat4;
     private getCameraVectors;
     private panCamera;

package/dist/camera.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"camera.d.ts","sourceRoot":"","sources":["../src/camera.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAQ,IAAI,EAAE,MAAM,QAAQ,CAAA;AACzC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAA;AAMpD,qBAAa,MAAM;IACjB,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,IAAI,CAAA;IACZ,GAAG,EAAE,MAAM,CAAA;IACX,MAAM,EAAE,MAAM,CAAI;IAClB,IAAI,EAAE,MAAM,CAAO;IACnB,GAAG,EAAE,MAAM,CAAU;IAGrB,OAAO,CAAC,MAAM,CAAiC;IAC/C,OAAO,CAAC,WAAW,CAAiB;IACpC,OAAO,CAAC,UAAU,CAAiB;IACnC,OAAO,CAAC,WAAW,CAAsB;IACzC,OAAO,CAAC,YAAY,CAAiB;IACrC,OAAO,CAAC,YAAY,CAAiB;IACrC,OAAO,CAAC,eAAe,CAAsB;IAC7C,OAAO,CAAC,UAAU,CAAiB;IACnC,OAAO,CAAC,iBAAiB,CAAY;IACrC,OAAO,CAAC,iBAAiB,CAAiB;IAC1C,OAAO,CAAC,oBAAoB,CAAY;IAGxC,kBAAkB,EAAE,MAAM,CAAQ;IAClC,cAAc,EAAE,MAAM,CAAS;IAC/B,cAAc,EAAE,MAAM,CAAO;IAC7B,cAAc,EAAE,MAAM,CAAO;IAC7B,IAAI,EAAE,MAAM,CAAO;IACnB,IAAI,EAAE,MAAM,CAAU;IACtB,cAAc,EAAE,MAAM,CAAQ;IAC9B,cAAc,EAAE,MAAM,CAAkB;IAGxC,OAAO,CAAC,QAAQ,CAAiC;IACjD,OAAO,CAAC,QAAQ,CAAiC;IAKjD,SAAS,EAAE,OAAO,CAAQ;IAC1B,OAAO,CAAC,UAAU,CAAoB;IACtC,OAAO,CAAC,YAAY,CAAoB;IACxC,OAAO,CAAC,YAAY,CAAM;IAC1B,OAAO,CAAC,SAAS,CAAc;IAC/B,OAAO,CAAC,YAAY,CAAuB;gBAE/B,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,GAAE,MAAoB;IAmBhG,WAAW,IAAI,IAAI;IAQnB;wFACoF;IACpF,YAAY,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;IAOpC,0FAA0F;IAC1F,UAAU,CAAC,IAAI,EAAE,UAAU,GAAG,IAAI;IAOlC,aAAa,IAAI,IAAI;IA0BrB,OAAO,CAAC,gBAAgB;IA0CxB,OAAO,CAAC,SAAS;IAiBjB,kFAAkF;IAClF,OAAO,CAAC,mBAAmB;IAK3B,mBAAmB,IAAI,IAAI;IAM3B,aAAa,CAAC,MAAM,EAAE,iBAAiB;IAiBvC,aAAa;IAkBb,cAAc,CAAC,MAAM,EAAE,OAAO;IAS9B,OAAO,CAAC,WAAW;IAOnB,OAAO,CAAC,WAAW;IAsBnB,OAAO,CAAC,SAAS;IAKjB,OAAO,CAAC,OAAO;IAYf,OAAO,CAAC,aAAa;IAIrB,OAAO,CAAC,YAAY;IA8BpB,OAAO,CAAC,WAAW;IAuFnB,OAAO,CAAC,UAAU;CA+BnB"}
+{"version":3,"file":"camera.d.ts","sourceRoot":"","sources":["../src/camera.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAQ,IAAI,EAAE,MAAM,QAAQ,CAAA;AACzC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAA;AAMpD,qBAAa,MAAM;IACjB,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,IAAI,CAAA;IACZ,GAAG,EAAE,MAAM,CAAA;IACX,MAAM,EAAE,MAAM,CAAI;IAClB,IAAI,EAAE,MAAM,CAAO;IACnB,GAAG,EAAE,MAAM,CAAU;IAGrB,OAAO,CAAC,MAAM,CAAiC;IAC/C,OAAO,CAAC,WAAW,CAAiB;IACpC,OAAO,CAAC,UAAU,CAAiB;IACnC,OAAO,CAAC,WAAW,CAAsB;IACzC,OAAO,CAAC,YAAY,CAAiB;IACrC,OAAO,CAAC,YAAY,CAAiB;IACrC,OAAO,CAAC,eAAe,CAAsB;IAC7C,OAAO,CAAC,UAAU,CAAiB;IACnC,OAAO,CAAC,iBAAiB,CAAY;IACrC,OAAO,CAAC,iBAAiB,CAAiB;IAC1C,OAAO,CAAC,oBAAoB,CAAY;IAGxC,kBAAkB,EAAE,MAAM,CAAQ;IAClC,cAAc,EAAE,MAAM,CAAS;IAC/B,cAAc,EAAE,MAAM,CAAO;IAC7B,cAAc,EAAE,MAAM,CAAO;IAC7B,IAAI,EAAE,MAAM,CAAO;IACnB,IAAI,EAAE,MAAM,CAAU;IACtB,cAAc,EAAE,MAAM,CAAQ;IAC9B,cAAc,EAAE,MAAM,CAAkB;IAGxC,OAAO,CAAC,QAAQ,CAAiC;IACjD,OAAO,CAAC,QAAQ,CAAiC;IAKjD,SAAS,EAAE,OAAO,CAAQ;IAC1B,OAAO,CAAC,UAAU,CAAoB;IACtC,OAAO,CAAC,YAAY,CAAoB;IACxC,OAAO,CAAC,YAAY,CAAM;IAC1B,OAAO,CAAC,SAAS,CAAc;IAC/B,OAAO,CAAC,YAAY,CAAuB;gBAE/B,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,GAAE,MAAoB;IAmBhG,WAAW,IAAI,IAAI;IAQnB;wFACoF;IACpF,YAAY,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;IAOpC,0FAA0F;IAC1F,UAAU,CAAC,IAAI,EAAE,UAAU,GAAG,IAAI;IAelC,OAAO,CAAC,MAAM;IAUd;;;;;;;;;;;OAWG;IACH,cAAc,IAAI,IAAI;IAItB,aAAa,IAAI,IAAI;IAgBrB,OAAO,CAAC,gBAAgB;IA0CxB,OAAO,CAAC,SAAS;IAiBjB,kFAAkF;IAClF,OAAO,CAAC,mBAAmB;IAK3B,mBAAmB,IAAI,IAAI;IAM3B,aAAa,CAAC,MAAM,EAAE,iBAAiB;IAiBvC,aAAa;IAkBb,cAAc,CAAC,MAAM,EAAE,OAAO;IAS9B,OAAO,CAAC,WAAW;IAOnB,OAAO,CAAC,WAAW;IAsBnB,OAAO,CAAC,SAAS;IAKjB,OAAO,CAAC,OAAO;IAYf,OAAO,CAAC,aAAa;IAIrB,OAAO,CAAC,YAAY;IA8BpB,OAAO,CAAC,WAAW;IAuFnB,OAAO,CAAC,UAAU;CA+BnB"}

package/dist/camera.js

@@ -81,22 +81,44 @@ export class Camera {
         this._vmdDistance = pose.distance;
         this.fov = pose.fov; // drives the projection
     }
+    // MMD camera: look at `target` from `distance` back, oriented by the euler rotation.
+    // forward = q·(0,0,1) (LH), up = q·(0,1,0) — read as columns 2 and 1 of the rot matrix.
+    // eye = target + forward·distance (distance is negative in VMD, so eye sits behind).
+    // Euler is NEGATED on all three axes: babylon-mmd builds the shot with
+    // RotationYawPitchRoll(-ry, -rx, -rz), and our fromEuler(rx,ry,rz) equals
+    // RotationYawPitchRoll(ry,rx,rz) — so the MMD-authentic rotation is fromEuler(-r).
+    //
+    // Leaves the rotation matrix in `_quatScratch`; getViewMatrix reads its up vector.
+    vmdEye() {
+        const r = this._vmdRotation;
+        const q = Quat.fromEuler(-r.x, -r.y, -r.z);
+        Mat4.fromQuatInto(q.x, q.y, q.z, q.w, this._quatScratch, 0);
+        const s = this._quatScratch;
+        const t = this._vmdTarget;
+        const d = this._vmdDistance;
+        return new Vec3(t.x + s[8] * d, t.y + s[9] * d, t.z + s[10] * d);
+    }
+    /**
+     * Where the shot is actually taken from: the VMD eye while a camera VMD drives, the
+     * orbit position otherwise.
+     *
+     * `getPosition()` deliberately stays orbit-only — pan, zoom and framing reason in the
+     * spherical coordinates a camera VMD never touches. Anything asking "where is the
+     * viewer" wants THIS. Feeding the orbit position to the shader's `camera.viewPos`
+     * while rendering from the VMD camera left every view-dependent term — specular, rim,
+     * fresnel, sphere maps, the eye visibility gate — evaluated from a camera that was not
+     * the one taking the picture, with the error depending on wherever the orbit happened
+     * to be left.
+     */
+    getEyePosition() {
+        return this.vmdDriven ? this.vmdEye() : this.getPosition();
+    }
     getViewMatrix() {
         if (this.vmdDriven) {
-            // MMD camera: look at `target` from `distance` back, oriented by the euler rotation.
-            // forward = q·(0,0,1) (LH), up = q·(0,1,0) — read as columns 2 and 1 of the rot matrix.
-            // eye = target + forward·distance (distance is negative in VMD, so eye sits behind).
-            // Euler is NEGATED on all three axes: babylon-mmd builds the shot with
-            // RotationYawPitchRoll(-ry, -rx, -rz), and our fromEuler(rx,ry,rz) equals
-            // RotationYawPitchRoll(ry,rx,rz) — so the MMD-authentic rotation is fromEuler(-r).
-            const r = this._vmdRotation;
-            const q = Quat.fromEuler(-r.x, -r.y, -r.z);
-            Mat4.fromQuatInto(q.x, q.y, q.z, q.w, this._quatScratch, 0);
+            const eye = this.vmdEye();
             const s = this._quatScratch;
             const t = this._vmdTarget;
-            const d = this._vmdDistance;
-            const ex = t.x + s[8] * d, ey = t.y + s[9] * d, ez = t.z + s[10] * d;
-            Mat4.lookAtInto(this._viewMat.values, ex, ey, ez, t.x, t.y, t.z, s[4], s[5], s[6]);
+            Mat4.lookAtInto(this._viewMat.values, eye.x, eye.y, eye.z, t.x, t.y, t.z, s[4], s[5], s[6]);
             return this._viewMat;
         }
         const eye = this.getPosition();

package/dist/engine.js

@@ -432,7 +432,7 @@ export class Engine {
             e.stopImmediatePropagation();
             e.preventDefault();
             // Pick threshold stays pixel-based — clicking should feel the same at any zoom.
-            const camPos = this.camera.getPosition();
+            const camPos = this.camera.getEyePosition();
             const dist = Math.max(0.01, bonePos.subtract(camPos).length());
             const worldPerPixel = (dist * Math.tan(this.camera.fov * 0.5) * 2) / Math.max(1, this.canvas.clientHeight);
             const worldThreshold = Engine.GIZMO_PICK_THRESHOLD_PX * worldPerPixel;
@@ -4387,7 +4387,7 @@ export class Engine {
     updateCameraUniforms() {
         const viewMatrix = this.camera.getViewMatrix();
         const projectionMatrix = this.camera.getProjectionMatrix();
-        const cameraPos = this.camera.getPosition();
+        const cameraPos = this.camera.getEyePosition();
         this.cameraMatrixData.set(viewMatrix.values, 0);
         this.cameraMatrixData.set(projectionMatrix.values, 16);
         this.cameraMatrixData[32] = cameraPos.x;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "reze-engine",
-  "version": "0.27.2",
+  "version": "0.27.3",
   "description": "A lightweight WebGPU engine for real-time 3D MMD/PMX model rendering",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",

package/src/camera.ts

@@ -96,22 +96,46 @@ export class Camera {
     this.fov = pose.fov // drives the projection
   }
 
+  // MMD camera: look at `target` from `distance` back, oriented by the euler rotation.
+  // forward = q·(0,0,1) (LH), up = q·(0,1,0) — read as columns 2 and 1 of the rot matrix.
+  // eye = target + forward·distance (distance is negative in VMD, so eye sits behind).
+  // Euler is NEGATED on all three axes: babylon-mmd builds the shot with
+  // RotationYawPitchRoll(-ry, -rx, -rz), and our fromEuler(rx,ry,rz) equals
+  // RotationYawPitchRoll(ry,rx,rz) — so the MMD-authentic rotation is fromEuler(-r).
+  //
+  // Leaves the rotation matrix in `_quatScratch`; getViewMatrix reads its up vector.
+  private vmdEye(): Vec3 {
+    const r = this._vmdRotation
+    const q = Quat.fromEuler(-r.x, -r.y, -r.z)
+    Mat4.fromQuatInto(q.x, q.y, q.z, q.w, this._quatScratch, 0)
+    const s = this._quatScratch
+    const t = this._vmdTarget
+    const d = this._vmdDistance
+    return new Vec3(t.x + s[8] * d, t.y + s[9] * d, t.z + s[10] * d)
+  }
+
+  /**
+   * Where the shot is actually taken from: the VMD eye while a camera VMD drives, the
+   * orbit position otherwise.
+   *
+   * `getPosition()` deliberately stays orbit-only — pan, zoom and framing reason in the
+   * spherical coordinates a camera VMD never touches. Anything asking "where is the
+   * viewer" wants THIS. Feeding the orbit position to the shader's `camera.viewPos`
+   * while rendering from the VMD camera left every view-dependent term — specular, rim,
+   * fresnel, sphere maps, the eye visibility gate — evaluated from a camera that was not
+   * the one taking the picture, with the error depending on wherever the orbit happened
+   * to be left.
+   */
+  getEyePosition(): Vec3 {
+    return this.vmdDriven ? this.vmdEye() : this.getPosition()
+  }
+
   getViewMatrix(): Mat4 {
     if (this.vmdDriven) {
-      // MMD camera: look at `target` from `distance` back, oriented by the euler rotation.
-      // forward = q·(0,0,1) (LH), up = q·(0,1,0) — read as columns 2 and 1 of the rot matrix.
-      // eye = target + forward·distance (distance is negative in VMD, so eye sits behind).
-      // Euler is NEGATED on all three axes: babylon-mmd builds the shot with
-      // RotationYawPitchRoll(-ry, -rx, -rz), and our fromEuler(rx,ry,rz) equals
-      // RotationYawPitchRoll(ry,rx,rz) — so the MMD-authentic rotation is fromEuler(-r).
-      const r = this._vmdRotation
-      const q = Quat.fromEuler(-r.x, -r.y, -r.z)
-      Mat4.fromQuatInto(q.x, q.y, q.z, q.w, this._quatScratch, 0)
+      const eye = this.vmdEye()
       const s = this._quatScratch
       const t = this._vmdTarget
-      const d = this._vmdDistance
-      const ex = t.x + s[8] * d, ey = t.y + s[9] * d, ez = t.z + s[10] * d
-      Mat4.lookAtInto(this._viewMat.values, ex, ey, ez, t.x, t.y, t.z, s[4], s[5], s[6])
+      Mat4.lookAtInto(this._viewMat.values, eye.x, eye.y, eye.z, t.x, t.y, t.z, s[4], s[5], s[6])
       return this._viewMat
     }
     const eye = this.getPosition()

package/src/engine.ts

@@ -4305,7 +4305,7 @@ export class Engine {
     e.preventDefault()
 
     // Pick threshold stays pixel-based — clicking should feel the same at any zoom.
-    const camPos = this.camera.getPosition()
+    const camPos = this.camera.getEyePosition()
     const dist = Math.max(0.01, bonePos.subtract(camPos).length())
     const worldPerPixel = (dist * Math.tan(this.camera.fov * 0.5) * 2) / Math.max(1, this.canvas.clientHeight)
     const worldThreshold = Engine.GIZMO_PICK_THRESHOLD_PX * worldPerPixel
@@ -5237,7 +5237,7 @@ export class Engine {
   private updateCameraUniforms() {
     const viewMatrix = this.camera.getViewMatrix()
     const projectionMatrix = this.camera.getProjectionMatrix()
-    const cameraPos = this.camera.getPosition()
+    const cameraPos = this.camera.getEyePosition()
     this.cameraMatrixData.set(viewMatrix.values, 0)
     this.cameraMatrixData.set(projectionMatrix.values, 16)
     this.cameraMatrixData[32] = cameraPos.x