reze-engine 0.55.13 → 0.55.14

package/dist/camera.d.ts

@@ -19,15 +19,16 @@ export declare class Camera {
     private canvas;
     private inputLocked;
     /**
-     * Panning is refused while the orbit rides a bone (Engine.setCameraFollow).
+     * Where a pan goes while the orbit rides a bone (Engine.setCameraFollow).
      *
      * A pan moves `target`, and the follow rewrites `target` from the bone every
-     * frame — so the drag was already going nowhere, it just spent a frame
-     * fighting for it and read as the camera stuttering under the pointer.
-     * Refusing it says the same thing the follow already means: while the shot is
-     * on somebody, where it points is theirs to decide.
+     * frame — so a pan into the target went nowhere, and read as the camera
+     * stuttering under the pointer. While following, the engine points this at
+     * the follow's OFFSET from the bone, and a pan moves that instead: the shot
+     * stays on her, and the drag decides where beside her it sits. Null while
+     * the target is free.
      */
-    panLocked: boolean;
+    panSink: Vec3 | null;
     private isDragging;
     private mouseButton;
     private lastMousePos;

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;AAyBpD,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;;;oFAGgF;IAChF,IAAI,EAAE,MAAM,CAAiB;IAC7B,GAAG,EAAE,MAAM,CAAU;IACrB;+EAC2E;IAC3E,SAAS,UAAQ;IAGjB,OAAO,CAAC,MAAM,CAAiC;IAC/C,OAAO,CAAC,WAAW,CAAiB;IACpC;;;;;;;;OAQG;IACH,SAAS,EAAE,OAAO,CAAQ;IAC1B,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;IACxC;;;;;;;;;;;OAWG;IACH,IAAI,EAAE,MAAM,CAAI;IAGhB,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;;;;;;;;;;OAUG;IACH,OAAO,IAAI,UAAU;IAuBrB,UAAU,CAAC,IAAI,EAAE,UAAU,GAAG,IAAI;IAelC,OAAO,CAAC,MAAM;IAUd;;;;;;;;;;;OAWG;IACH,cAAc,IAAI,IAAI;IAItB,aAAa,IAAI,IAAI;IAqErB,OAAO,CAAC,gBAAgB;IA0CxB,OAAO,CAAC,SAAS;IAiBjB,kFAAkF;IAClF,OAAO,CAAC,mBAAmB;IAK3B;;;;;;;;;;;;;;;OAeG;IACH,OAAO,CAAC,oBAAoB;IAM5B,mBAAmB,IAAI,IAAI;IAW3B,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;AAyBpD,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;;;oFAGgF;IAChF,IAAI,EAAE,MAAM,CAAiB;IAC7B,GAAG,EAAE,MAAM,CAAU;IACrB;+EAC2E;IAC3E,SAAS,UAAQ;IAGjB,OAAO,CAAC,MAAM,CAAiC;IAC/C,OAAO,CAAC,WAAW,CAAiB;IACpC;;;;;;;;;OASG;IACH,OAAO,EAAE,IAAI,GAAG,IAAI,CAAO;IAC3B,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;IACxC;;;;;;;;;;;OAWG;IACH,IAAI,EAAE,MAAM,CAAI;IAGhB,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;;;;;;;;;;OAUG;IACH,OAAO,IAAI,UAAU;IAuBrB,UAAU,CAAC,IAAI,EAAE,UAAU,GAAG,IAAI;IAelC,OAAO,CAAC,MAAM;IAUd;;;;;;;;;;;OAWG;IACH,cAAc,IAAI,IAAI;IAItB,aAAa,IAAI,IAAI;IAqErB,OAAO,CAAC,gBAAgB;IA0CxB,OAAO,CAAC,SAAS;IAwBjB,kFAAkF;IAClF,OAAO,CAAC,mBAAmB;IAK3B;;;;;;;;;;;;;;;OAeG;IACH,OAAO,CAAC,oBAAoB;IAM5B,mBAAmB,IAAI,IAAI;IAW3B,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

@@ -37,15 +37,16 @@ export class Camera {
         this.canvas = null;
         this.inputLocked = false;
         /**
-         * Panning is refused while the orbit rides a bone (Engine.setCameraFollow).
+         * Where a pan goes while the orbit rides a bone (Engine.setCameraFollow).
          *
          * A pan moves `target`, and the follow rewrites `target` from the bone every
-         * frame — so the drag was already going nowhere, it just spent a frame
-         * fighting for it and read as the camera stuttering under the pointer.
-         * Refusing it says the same thing the follow already means: while the shot is
-         * on somebody, where it points is theirs to decide.
+         * frame — so a pan into the target went nowhere, and read as the camera
+         * stuttering under the pointer. While following, the engine points this at
+         * the follow's OFFSET from the bone, and a pan moves that instead: the shot
+         * stays on her, and the drag decides where beside her it sits. Null while
+         * the target is free.
          */
-        this.panLocked = false;
+        this.panSink = null;
         this.isDragging = false;
         this.mouseButton = null; // Track which mouse button is pressed (0 = left, 2 = right)
         this.lastMousePos = { x: 0, y: 0 };
@@ -311,7 +312,14 @@ export class Camera {
         // Vertical movement: drag up pans up (positive up vector)
         const panRight = right.scale(-deltaX * panDistance);
         const panUp = up.scale(deltaY * panDistance);
-        // Update target position smoothly
+        // Into the follow's offset while the shot rides a bone — see panSink.
+        const sink = this.panSink;
+        if (sink) {
+            sink.x += panRight.x + panUp.x;
+            sink.y += panRight.y + panUp.y;
+            sink.z += panRight.z + panUp.z;
+            return;
+        }
         this.target = this.target.add(panRight).add(panUp);
     }
     /** Far plane grows with zoom-out so big floors / distant geometry stay visible */
@@ -405,8 +413,7 @@ export class Camera {
         const deltaY = e.clientY - this.lastMousePos.y;
         if (this.mouseButton === 2) {
             // Right-click: pan the camera target
-            if (!this.panLocked)
-                this.panCamera(deltaX, deltaY);
+            this.panCamera(deltaX, deltaY);
         }
         else {
             // Left-click (or default): rotate the camera
@@ -512,8 +519,7 @@ export class Camera {
             if (isPanGesture) {
                 // Primary gesture is pan (two-finger drag)
                 // Use panning similar to right-click pan
-                if (!this.panLocked)
-                    this.panCamera(midpointDeltaX, midpointDeltaY);
+                this.panCamera(midpointDeltaX, midpointDeltaY);
             }
             // Update tracking values
             this.lastPinchDistance = distance;

package/dist/engine.js

@@ -6585,23 +6585,23 @@ export class Engine {
         this.camera.attachControl(this.canvas);
     }
     setCameraTarget(modelOrVec, boneName, offset) {
-        // panLocked tracks the BINDING, on every path that changes it — a target
-        // set to a fixed point is pannable again, and forgetting it here is how the
-        // pan stays dead after the follow was turned off. See Camera.panLocked.
+        // panSink tracks the BINDING, on every path that changes it — a target set
+        // after a follow would otherwise still send pans into an offset nothing
+        // reads any more. See Camera.panSink.
         if (modelOrVec === null) {
-            this.camera.panLocked = false;
+            this.camera.panSink = null;
             this.cameraTargetModel = null;
             return;
         }
         if ("x" in modelOrVec && "y" in modelOrVec && "z" in modelOrVec) {
-            this.camera.panLocked = false;
+            this.camera.panSink = null;
             this.cameraTargetModel = null;
             this.camera.target.x = modelOrVec.x;
             this.camera.target.y = modelOrVec.y;
             this.camera.target.z = modelOrVec.z;
             return;
         }
-        this.camera.panLocked = true;
+        this.camera.panSink = this.cameraTargetOffset;
         this.cameraTargetModel = modelOrVec;
         this.cameraTargetBoneName = boneName ?? "";
         this.cameraTargetOffset.x = offset?.x ?? 0;
@@ -6611,8 +6611,8 @@ export class Engine {
     /** Souls-style follow cam: orbit center tracks a model bone each frame. Shorthand for setCameraTarget(model, boneName, offset). */
     setCameraFollow(model, boneName, offset, smoothing) {
         // Panning sets the very thing the follow overwrites each frame, so it is
-        // refused for as long as the shot is riding a bone. See Camera.panLocked.
-        this.camera.panLocked = model !== null;
+        // goes to the offset for as long as the shot is riding a bone. See Camera.panSink.
+        this.camera.panSink = model !== null ? this.cameraTargetOffset : null;
         if (model === null) {
             this.cameraTargetModel = null;
             return;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "reze-engine",
-  "version": "0.55.13",
+  "version": "0.55.14",
   "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

@@ -45,15 +45,16 @@ export class Camera {
   private canvas: HTMLCanvasElement | null = null
   private inputLocked: boolean = false
   /**
-   * Panning is refused while the orbit rides a bone (Engine.setCameraFollow).
+   * Where a pan goes while the orbit rides a bone (Engine.setCameraFollow).
    *
    * A pan moves `target`, and the follow rewrites `target` from the bone every
-   * frame — so the drag was already going nowhere, it just spent a frame
-   * fighting for it and read as the camera stuttering under the pointer.
-   * Refusing it says the same thing the follow already means: while the shot is
-   * on somebody, where it points is theirs to decide.
+   * frame — so a pan into the target went nowhere, and read as the camera
+   * stuttering under the pointer. While following, the engine points this at
+   * the follow's OFFSET from the bone, and a pan moves that instead: the shot
+   * stays on her, and the drag decides where beside her it sits. Null while
+   * the target is free.
    */
-  panLocked: boolean = false
+  panSink: Vec3 | null = null
   private isDragging: boolean = false
   private mouseButton: number | null = null // Track which mouse button is pressed (0 = left, 2 = right)
   private lastMousePos = { x: 0, y: 0 }
@@ -337,7 +338,14 @@ export class Camera {
     const panRight = right.scale(-deltaX * panDistance)
     const panUp = up.scale(deltaY * panDistance)
 
-    // Update target position smoothly
+    // Into the follow's offset while the shot rides a bone — see panSink.
+    const sink = this.panSink
+    if (sink) {
+      sink.x += panRight.x + panUp.x
+      sink.y += panRight.y + panUp.y
+      sink.z += panRight.z + panUp.z
+      return
+    }
     this.target = this.target.add(panRight).add(panUp)
   }
 
@@ -440,7 +448,7 @@ export class Camera {
 
     if (this.mouseButton === 2) {
       // Right-click: pan the camera target
-      if (!this.panLocked) this.panCamera(deltaX, deltaY)
+      this.panCamera(deltaX, deltaY)
     } else {
       // Left-click (or default): rotate the camera
       this.alpha += deltaX * this.angularSensitivity
@@ -559,7 +567,7 @@ export class Camera {
       if (isPanGesture) {
         // Primary gesture is pan (two-finger drag)
         // Use panning similar to right-click pan
-        if (!this.panLocked) this.panCamera(midpointDeltaX, midpointDeltaY)
+        this.panCamera(midpointDeltaX, midpointDeltaY)
       }
 
       // Update tracking values

package/src/engine.ts

@@ -7897,23 +7897,23 @@ export class Engine {
   /** Bind camera orbit center to a model's bone (Souls-style follow cam). Pass null to unbind. */
   setCameraTarget(model: Model | null, boneName: string, offset?: Vec3): void
   setCameraTarget(modelOrVec: Model | Vec3 | null, boneName?: string, offset?: Vec3): void {
-    // panLocked tracks the BINDING, on every path that changes it — a target
-    // set to a fixed point is pannable again, and forgetting it here is how the
-    // pan stays dead after the follow was turned off. See Camera.panLocked.
+    // panSink tracks the BINDING, on every path that changes it — a target set
+    // after a follow would otherwise still send pans into an offset nothing
+    // reads any more. See Camera.panSink.
     if (modelOrVec === null) {
-      this.camera.panLocked = false
+      this.camera.panSink = null
       this.cameraTargetModel = null
       return
     }
     if ("x" in modelOrVec && "y" in modelOrVec && "z" in modelOrVec) {
-      this.camera.panLocked = false
+      this.camera.panSink = null
       this.cameraTargetModel = null
       this.camera.target.x = modelOrVec.x
       this.camera.target.y = modelOrVec.y
       this.camera.target.z = modelOrVec.z
       return
     }
-    this.camera.panLocked = true
+    this.camera.panSink = this.cameraTargetOffset
     this.cameraTargetModel = modelOrVec
     this.cameraTargetBoneName = boneName ?? ""
     this.cameraTargetOffset.x = offset?.x ?? 0
@@ -7924,8 +7924,8 @@ export class Engine {
   /** Souls-style follow cam: orbit center tracks a model bone each frame. Shorthand for setCameraTarget(model, boneName, offset). */
   setCameraFollow(model: Model | null, boneName?: string, offset?: Vec3, smoothing?: number): void {
     // Panning sets the very thing the follow overwrites each frame, so it is
-    // refused for as long as the shot is riding a bone. See Camera.panLocked.
-    this.camera.panLocked = model !== null
+    // goes to the offset for as long as the shot is riding a bone. See Camera.panSink.
+    this.camera.panSink = model !== null ? this.cameraTargetOffset : null
     if (model === null) {
       this.cameraTargetModel = null
       return