@zephyr3d/scene 0.9.21 → 0.9.23

package/dist/camera/perspectivecamera.js

@@ -1,6 +1,7 @@
 import { Camera } from './camera.js';
 import { Matrix4x4 } from '@zephyr3d/base';
 import { getDevice, getEngine } from '../app/api.js';
+import { calculateVerticalFov } from '../utility/physical.js';
 
 /**
  * Perspective camera class
@@ -12,6 +13,11 @@ import { getDevice, getEngine } from '../app/api.js';
     _aspect;
     _autoAspect;
     _window;
+    _projectionMode;
+    _focalLengthMm;
+    _sensorWidthMm;
+    _sensorHeightMm;
+    _sensorFit;
     /**
    * Creates an instance of PerspectiveCamera
    * @param scene - The scene that the camera belongs to.
@@ -27,8 +33,66 @@ import { getDevice, getEngine } from '../app/api.js';
         this._far = far;
         this._autoAspect = true;
         this._window = null;
+        this._projectionMode = 'fov';
+        this._focalLengthMm = 50;
+        this._sensorWidthMm = 36;
+        this._sensorHeightMm = 24;
+        this._sensorFit = 'horizontal';
         this._invalidate(true);
     }
+    /** Perspective projection parameterization. */ get projectionMode() {
+        return this._projectionMode;
+    }
+    set projectionMode(val) {
+        const mode = val === 'physical' ? 'physical' : 'fov';
+        if (mode !== this._projectionMode) {
+            this._projectionMode = mode;
+            this._invalidate(true);
+        }
+    }
+    /** Physical focal length in millimeters. */ get focalLengthMm() {
+        return this._focalLengthMm;
+    }
+    set focalLengthMm(val) {
+        const focalLength = Math.max(0.0001, val);
+        if (focalLength !== this._focalLengthMm) {
+            this._focalLengthMm = focalLength;
+            this._invalidate(true);
+        }
+    }
+    /** Physical sensor width in millimeters. */ get sensorWidthMm() {
+        return this._sensorWidthMm;
+    }
+    set sensorWidthMm(val) {
+        const width = Math.max(0.0001, val);
+        if (width !== this._sensorWidthMm) {
+            this._sensorWidthMm = width;
+            this._invalidate(true);
+        }
+    }
+    /** Physical sensor height in millimeters. */ get sensorHeightMm() {
+        return this._sensorHeightMm;
+    }
+    set sensorHeightMm(val) {
+        const height = Math.max(0.0001, val);
+        if (height !== this._sensorHeightMm) {
+            this._sensorHeightMm = height;
+            this._invalidate(true);
+        }
+    }
+    /** Sensor dimension kept fixed while fitting the viewport aspect ratio. */ get sensorFit() {
+        return this._sensorFit;
+    }
+    set sensorFit(val) {
+        const fit = val === 'vertical' ? 'vertical' : 'horizontal';
+        if (fit !== this._sensorFit) {
+            this._sensorFit = fit;
+            this._invalidate(true);
+        }
+    }
+    /** Effective vertical field of view used by the projection matrix. */ get effectiveFovY() {
+        return this._projectionMode === 'physical' ? calculateVerticalFov(this._focalLengthMm, this._sensorWidthMm, this._sensorHeightMm, this._aspect, this._sensorFit) : this._fovY;
+    }
     /** Sub-window of the frustum */ get window() {
         return this._window;
     }
@@ -94,6 +158,7 @@ import { getDevice, getEngine } from '../app/api.js';
     /**
    * {@inheritDoc Camera.setPerspective}
    */ setPerspective(fovY, aspect, zNear, zFar) {
+        this._projectionMode = 'fov';
         this._aspect = aspect;
         this._fovY = fovY;
         this._near = zNear;
@@ -118,6 +183,7 @@ import { getDevice, getEngine } from '../app/api.js';
                 super.setProjectionMatrix(matrix);
                 this._aspect = matrix.getAspect();
                 this._fovY = matrix.getFov();
+                this._projectionMode = 'fov';
                 this._near = matrix.getNearPlane();
                 this._far = matrix.getFarPlane();
             } else {
@@ -132,10 +198,11 @@ import { getDevice, getEngine } from '../app/api.js';
         super.render(scene);
     }
     /** @internal */ _computeProj() {
+        const fovY = this.effectiveFovY;
         if (this.adapted) {
-            this.calcAdaptedPerspectiveProjection(this._fovY, this._near, this._far, this._projMatrix);
+            this.calcAdaptedPerspectiveProjection(fovY, this._near, this._far, this._projMatrix);
         } else {
-            const h = this._near * Math.tan(this._fovY * 0.5);
+            const h = this._near * Math.tan(fovY * 0.5);
             const w = h * this._aspect;
             let left = -w;
             let right = w;

package/dist/camera/perspectivecamera.js.map

@@ -1 +1 @@
-{"version":3,"file":"perspectivecamera.js","sources":["../../src/camera/perspectivecamera.ts"],"sourcesContent":["import { Camera } from './camera';\r\nimport type { Scene } from '../scene/scene';\r\nimport type { Immutable, Nullable } from '@zephyr3d/base';\r\nimport { Matrix4x4 } from '@zephyr3d/base';\r\nimport { getDevice, getEngine } from '../app/api';\r\n\r\n/**\r\n * Perspective camera class\r\n * @public\r\n */\r\nexport class PerspectiveCamera extends Camera {\r\n  /** @internal */\r\n  private _near: number;\r\n  private _far: number;\r\n  private _fovY: number;\r\n  private _aspect: number;\r\n  private _autoAspect: boolean;\r\n  private _window: Nullable<number[]>;\r\n  /**\r\n   * Creates an instance of PerspectiveCamera\r\n   * @param scene - The scene that the camera belongs to.\r\n   * @param fovY - A radian value indicates the field of view in Y axis\r\n   * @param aspect - Aspect ratio of the perspective transform\r\n   * @param near - The near clip plane\r\n   * @param far - The far clip plane\r\n   */\r\n  constructor(scene: Nullable<Scene>, fovY = Math.PI / 3, near = 1, far = 1000, aspect = 1) {\r\n    super(scene);\r\n    this._fovY = fovY;\r\n    this._aspect = aspect;\r\n    this._near = near;\r\n    this._far = far;\r\n    this._autoAspect = true;\r\n    this._window = null;\r\n    this._invalidate(true);\r\n  }\r\n  /** Sub-window of the frustum */\r\n  get window(): Nullable<Immutable<number[]>> {\r\n    return this._window;\r\n  }\r\n  set window(val: Nullable<number[]>) {\r\n    this._window = val?.slice() ?? null;\r\n    this._invalidate(true);\r\n  }\r\n  /** Automatically calculate aspect ratio before render according to current viewport */\r\n  get autoAspect() {\r\n    return this._autoAspect;\r\n  }\r\n  set autoAspect(val) {\r\n    this._autoAspect = !!val;\r\n  }\r\n  /** The near clip plane */\r\n  get near() {\r\n    return this._near;\r\n  }\r\n  set near(val) {\r\n    if (val !== this._near) {\r\n      this._near = val;\r\n      this._invalidate(true);\r\n    }\r\n  }\r\n  /** The far clip plane */\r\n  get far() {\r\n    return this._far;\r\n  }\r\n  set far(val) {\r\n    if (val !== this._far) {\r\n      this._far = val;\r\n      this._invalidate(true);\r\n    }\r\n  }\r\n  /** Radian value indicates the field of view in Y axis */\r\n  get fovY() {\r\n    return this._fovY;\r\n  }\r\n  set fovY(val) {\r\n    if (val !== this._fovY) {\r\n      this._fovY = val;\r\n      this._invalidate(true);\r\n    }\r\n  }\r\n  /** Aspect ratio of the perspective transform */\r\n  get aspect() {\r\n    return this._aspect;\r\n  }\r\n  set aspect(val) {\r\n    if (val !== this._aspect) {\r\n      this._aspect = val;\r\n      this._invalidate(true);\r\n    }\r\n  }\r\n  /** Adjust aspect ratio according to viewport settings of the camera */\r\n  adjustAspectRatio() {\r\n    if (this.viewport) {\r\n      this.aspect = this.viewport[2] / this.viewport[3];\r\n    } else {\r\n      if (!this.adapted || getDevice().getFramebuffer()) {\r\n        const vp = getDevice().getViewport();\r\n        this.aspect = vp.width / vp.height;\r\n      } else {\r\n        const transform = getEngine().screen.transform;\r\n        this.aspect = transform.viewportWidth / transform.viewportHeight;\r\n      }\r\n    }\r\n  }\r\n  /**\r\n   * {@inheritDoc Camera.setPerspective}\r\n   */\r\n  setPerspective(fovY: number, aspect: number, zNear: number, zFar: number) {\r\n    this._aspect = aspect;\r\n    this._fovY = fovY;\r\n    this._near = zNear;\r\n    this._far = zFar;\r\n    this._invalidate(true);\r\n    return this;\r\n  }\r\n  /**\r\n   * Not valid for PerspectiveCamera\r\n   *\r\n   * @remarks\r\n   * This method is only valid for {@link Camera} class or {@link OrthoCamera} class.\r\n   */\r\n  setOrtho(_left: number, _right: number, _bottom: number, _top: number, _near: number, _far: number): this {\r\n    throw new Error(`setOrtho() not allowed on PerspectiveCamera`);\r\n  }\r\n  /**\r\n   * Setup a projection matrix for the camera\r\n   * @param matrix - The projection matrix\r\n   */\r\n  setProjectionMatrix(matrix: Matrix4x4) {\r\n    if (matrix !== this._projMatrix) {\r\n      if (matrix?.isPerspective()) {\r\n        super.setProjectionMatrix(matrix);\r\n        this._aspect = matrix.getAspect();\r\n        this._fovY = matrix.getFov();\r\n        this._near = matrix.getNearPlane();\r\n        this._far = matrix.getFarPlane();\r\n      } else {\r\n        throw new Error(\r\n          `PerspectiveCamera.setProjectionMatrix(): param is not a perspective projection matrix`\r\n        );\r\n      }\r\n    }\r\n  }\r\n  /** {@inheritDoc Camera.render} */\r\n  render(scene: Scene) {\r\n    if (this._autoAspect) {\r\n      this.adjustAspectRatio();\r\n    }\r\n    super.render(scene);\r\n  }\r\n  /** @internal */\r\n  protected _computeProj() {\r\n    if (this.adapted) {\r\n      this.calcAdaptedPerspectiveProjection(this._fovY, this._near, this._far, this._projMatrix);\r\n    } else {\r\n      const h = this._near * Math.tan(this._fovY * 0.5);\r\n      const w = h * this._aspect;\r\n      let left = -w;\r\n      let right = w;\r\n      let top = h;\r\n      let bottom = -h;\r\n      if (this._window) {\r\n        const width = right - left;\r\n        const height = top - bottom;\r\n        left += width * this._window[0];\r\n        bottom += height * this._window[1];\r\n        right = left + width * this._window[2];\r\n        top = bottom + height * this._window[3];\r\n      }\r\n      this._projMatrix.frustum(left, right, bottom, top, this._near, this._far);\r\n    }\r\n    Matrix4x4.invert(this._projMatrix, this._invProjMatrix);\r\n  }\r\n}\r\n"],"names":["PerspectiveCamera","Camera","_far","_fovY","_aspect","_autoAspect","_window","scene","fovY","Math","PI","near","far","aspect","_near","_invalidate","window","val","slice","autoAspect","adjustAspectRatio","viewport","adapted","getDevice","getFramebuffer","vp","getViewport","width","height","transform","getEngine","screen","viewportWidth","viewportHeight","setPerspective","zNear","zFar","setOrtho","_left","_right","_bottom","_top","Error","setProjectionMatrix","matrix","_projMatrix","isPerspective","getAspect","getFov","getNearPlane","getFarPlane","render","calcAdaptedPerspectiveProjection","h","tan","w","left","right","top","bottom","frustum","Matrix4x4","invert","_invProjMatrix"],"mappings":";;;;AAMA;;;IAIO,MAAMA,iBAA0BC,SAAAA,MAAAA,CAAAA;qBAErC,KAAsB;IACdC,IAAa;IACbC,KAAc;IACdC,OAAgB;IAChBC,WAAqB;IACrBC,OAA4B;AACpC;;;;;;;AAOC,MACD,YAAYC,KAAsB,EAAEC,IAAOC,GAAAA,IAAAA,CAAKC,EAAE,GAAG,CAAC,EAAEC,IAAAA,GAAO,CAAC,EAAEC,GAAAA,GAAM,IAAI,EAAEC,MAAAA,GAAS,CAAC,CAAE;AACxF,QAAA,KAAK,CAACN,KAAAA,CAAAA;QACN,IAAI,CAACJ,KAAK,GAAGK,IAAAA;QACb,IAAI,CAACJ,OAAO,GAAGS,MAAAA;QACf,IAAI,CAACC,KAAK,GAAGH,IAAAA;QACb,IAAI,CAACT,IAAI,GAAGU,GAAAA;QACZ,IAAI,CAACP,WAAW,GAAG,IAAA;QACnB,IAAI,CAACC,OAAO,GAAG,IAAA;QACf,IAAI,CAACS,WAAW,CAAC,IAAA,CAAA;AACnB;qCAEA,IAAIC,MAAwC,GAAA;QAC1C,OAAO,IAAI,CAACV,OAAO;AACrB;IACA,IAAIU,MAAAA,CAAOC,GAAuB,EAAE;AAClC,QAAA,IAAI,CAACX,OAAO,GAAGW,GAAAA,EAAKC,KAAW,EAAA,IAAA,IAAA;QAC/B,IAAI,CAACH,WAAW,CAAC,IAAA,CAAA;AACnB;4FAEA,IAAII,UAAa,GAAA;QACf,OAAO,IAAI,CAACd,WAAW;AACzB;IACA,IAAIc,UAAAA,CAAWF,GAAG,EAAE;AAClB,QAAA,IAAI,CAACZ,WAAW,GAAG,CAAC,CAACY,GAAAA;AACvB;+BAEA,IAAIN,IAAO,GAAA;QACT,OAAO,IAAI,CAACG,KAAK;AACnB;IACA,IAAIH,IAAAA,CAAKM,GAAG,EAAE;AACZ,QAAA,IAAIA,GAAQ,KAAA,IAAI,CAACH,KAAK,EAAE;YACtB,IAAI,CAACA,KAAK,GAAGG,GAAAA;YACb,IAAI,CAACF,WAAW,CAAC,IAAA,CAAA;AACnB;AACF;8BAEA,IAAIH,GAAM,GAAA;QACR,OAAO,IAAI,CAACV,IAAI;AAClB;IACA,IAAIU,GAAAA,CAAIK,GAAG,EAAE;AACX,QAAA,IAAIA,GAAQ,KAAA,IAAI,CAACf,IAAI,EAAE;YACrB,IAAI,CAACA,IAAI,GAAGe,GAAAA;YACZ,IAAI,CAACF,WAAW,CAAC,IAAA,CAAA;AACnB;AACF;8DAEA,IAAIP,IAAO,GAAA;QACT,OAAO,IAAI,CAACL,KAAK;AACnB;IACA,IAAIK,IAAAA,CAAKS,GAAG,EAAE;AACZ,QAAA,IAAIA,GAAQ,KAAA,IAAI,CAACd,KAAK,EAAE;YACtB,IAAI,CAACA,KAAK,GAAGc,GAAAA;YACb,IAAI,CAACF,WAAW,CAAC,IAAA,CAAA;AACnB;AACF;qDAEA,IAAIF,MAAS,GAAA;QACX,OAAO,IAAI,CAACT,OAAO;AACrB;IACA,IAAIS,MAAAA,CAAOI,GAAG,EAAE;AACd,QAAA,IAAIA,GAAQ,KAAA,IAAI,CAACb,OAAO,EAAE;YACxB,IAAI,CAACA,OAAO,GAAGa,GAAAA;YACf,IAAI,CAACF,WAAW,CAAC,IAAA,CAAA;AACnB;AACF;AACA,4EACAK,iBAAoB,GAAA;QAClB,IAAI,IAAI,CAACC,QAAQ,EAAE;AACjB,YAAA,IAAI,CAACR,MAAM,GAAG,IAAI,CAACQ,QAAQ,CAAC,CAAA,CAAE,GAAG,IAAI,CAACA,QAAQ,CAAC,CAAE,CAAA;SAC5C,MAAA;AACL,YAAA,IAAI,CAAC,IAAI,CAACC,OAAO,IAAIC,SAAAA,EAAAA,CAAYC,cAAc,EAAI,EAAA;gBACjD,MAAMC,EAAAA,GAAKF,YAAYG,WAAW,EAAA;AAClC,gBAAA,IAAI,CAACb,MAAM,GAAGY,GAAGE,KAAK,GAAGF,GAAGG,MAAM;aAC7B,MAAA;AACL,gBAAA,MAAMC,SAAYC,GAAAA,SAAAA,EAAAA,CAAYC,MAAM,CAACF,SAAS;AAC9C,gBAAA,IAAI,CAAChB,MAAM,GAAGgB,UAAUG,aAAa,GAAGH,UAAUI,cAAc;AAClE;AACF;AACF;AACA;;MAGAC,cAAAA,CAAe1B,IAAY,EAAEK,MAAc,EAAEsB,KAAa,EAAEC,IAAY,EAAE;QACxE,IAAI,CAAChC,OAAO,GAAGS,MAAAA;QACf,IAAI,CAACV,KAAK,GAAGK,IAAAA;QACb,IAAI,CAACM,KAAK,GAAGqB,KAAAA;QACb,IAAI,CAACjC,IAAI,GAAGkC,IAAAA;QACZ,IAAI,CAACrB,WAAW,CAAC,IAAA,CAAA;AACjB,QAAA,OAAO,IAAI;AACb;AACA;;;;;AAKC,MACDsB,QAASC,CAAAA,KAAa,EAAEC,MAAc,EAAEC,OAAe,EAAEC,IAAY,EAAE3B,KAAa,EAAEZ,IAAY,EAAQ;AACxG,QAAA,MAAM,IAAIwC,KAAAA,CAAM,CAAC,2CAA2C,CAAC,CAAA;AAC/D;AACA;;;MAIAC,mBAAAA,CAAoBC,MAAiB,EAAE;AACrC,QAAA,IAAIA,MAAW,KAAA,IAAI,CAACC,WAAW,EAAE;AAC/B,YAAA,IAAID,QAAQE,aAAiB,EAAA,EAAA;AAC3B,gBAAA,KAAK,CAACH,mBAAoBC,CAAAA,MAAAA,CAAAA;AAC1B,gBAAA,IAAI,CAACxC,OAAO,GAAGwC,MAAAA,CAAOG,SAAS,EAAA;AAC/B,gBAAA,IAAI,CAAC5C,KAAK,GAAGyC,MAAAA,CAAOI,MAAM,EAAA;AAC1B,gBAAA,IAAI,CAAClC,KAAK,GAAG8B,MAAAA,CAAOK,YAAY,EAAA;AAChC,gBAAA,IAAI,CAAC/C,IAAI,GAAG0C,MAAAA,CAAOM,WAAW,EAAA;aACzB,MAAA;AACL,gBAAA,MAAM,IAAIR,KAAAA,CACR,CAAC,qFAAqF,CAAC,CAAA;AAE3F;AACF;AACF;uCAEAS,MAAO5C,CAAAA,KAAY,EAAE;QACnB,IAAI,IAAI,CAACF,WAAW,EAAE;AACpB,YAAA,IAAI,CAACe,iBAAiB,EAAA;AACxB;AACA,QAAA,KAAK,CAAC+B,MAAO5C,CAAAA,KAAAA,CAAAA;AACf;qBAEA,YAAyB,GAAA;QACvB,IAAI,IAAI,CAACe,OAAO,EAAE;AAChB,YAAA,IAAI,CAAC8B,gCAAgC,CAAC,IAAI,CAACjD,KAAK,EAAE,IAAI,CAACW,KAAK,EAAE,IAAI,CAACZ,IAAI,EAAE,IAAI,CAAC2C,WAAW,CAAA;SACpF,MAAA;YACL,MAAMQ,CAAAA,GAAI,IAAI,CAACvC,KAAK,GAAGL,IAAK6C,CAAAA,GAAG,CAAC,IAAI,CAACnD,KAAK,GAAG,GAAA,CAAA;AAC7C,YAAA,MAAMoD,CAAIF,GAAAA,CAAAA,GAAI,IAAI,CAACjD,OAAO;AAC1B,YAAA,IAAIoD,OAAO,CAACD,CAAAA;AACZ,YAAA,IAAIE,KAAQF,GAAAA,CAAAA;AACZ,YAAA,IAAIG,GAAML,GAAAA,CAAAA;AACV,YAAA,IAAIM,SAAS,CAACN,CAAAA;YACd,IAAI,IAAI,CAAC/C,OAAO,EAAE;AAChB,gBAAA,MAAMqB,QAAQ8B,KAAQD,GAAAA,IAAAA;AACtB,gBAAA,MAAM5B,SAAS8B,GAAMC,GAAAA,MAAAA;AACrBH,gBAAAA,IAAAA,IAAQ7B,KAAQ,GAAA,IAAI,CAACrB,OAAO,CAAC,CAAE,CAAA;AAC/BqD,gBAAAA,MAAAA,IAAU/B,MAAS,GAAA,IAAI,CAACtB,OAAO,CAAC,CAAE,CAAA;AAClCmD,gBAAAA,KAAAA,GAAQD,OAAO7B,KAAQ,GAAA,IAAI,CAACrB,OAAO,CAAC,CAAE,CAAA;AACtCoD,gBAAAA,GAAAA,GAAMC,SAAS/B,MAAS,GAAA,IAAI,CAACtB,OAAO,CAAC,CAAE,CAAA;AACzC;AACA,YAAA,IAAI,CAACuC,WAAW,CAACe,OAAO,CAACJ,IAAMC,EAAAA,KAAAA,EAAOE,MAAQD,EAAAA,GAAAA,EAAK,IAAI,CAAC5C,KAAK,EAAE,IAAI,CAACZ,IAAI,CAAA;AAC1E;QACA2D,SAAUC,CAAAA,MAAM,CAAC,IAAI,CAACjB,WAAW,EAAE,IAAI,CAACkB,cAAc,CAAA;AACxD;AACF;;;;"}
+{"version":3,"file":"perspectivecamera.js","sources":["../../src/camera/perspectivecamera.ts"],"sourcesContent":["import { Camera } from './camera';\r\nimport type { Scene } from '../scene/scene';\r\nimport type { Immutable, Nullable } from '@zephyr3d/base';\r\nimport { Matrix4x4 } from '@zephyr3d/base';\r\nimport { getDevice, getEngine } from '../app/api';\r\nimport { calculateVerticalFov } from '../utility/physical';\r\nimport type { CameraProjectionMode, CameraSensorFit } from '../utility/physical';\r\n\r\n/**\r\n * Perspective camera class\r\n * @public\r\n */\r\nexport class PerspectiveCamera extends Camera {\r\n  /** @internal */\r\n  private _near: number;\r\n  private _far: number;\r\n  private _fovY: number;\r\n  private _aspect: number;\r\n  private _autoAspect: boolean;\r\n  private _window: Nullable<number[]>;\r\n  private _projectionMode: CameraProjectionMode;\r\n  private _focalLengthMm: number;\r\n  private _sensorWidthMm: number;\r\n  private _sensorHeightMm: number;\r\n  private _sensorFit: CameraSensorFit;\r\n  /**\r\n   * Creates an instance of PerspectiveCamera\r\n   * @param scene - The scene that the camera belongs to.\r\n   * @param fovY - A radian value indicates the field of view in Y axis\r\n   * @param aspect - Aspect ratio of the perspective transform\r\n   * @param near - The near clip plane\r\n   * @param far - The far clip plane\r\n   */\r\n  constructor(scene: Nullable<Scene>, fovY = Math.PI / 3, near = 1, far = 1000, aspect = 1) {\r\n    super(scene);\r\n    this._fovY = fovY;\r\n    this._aspect = aspect;\r\n    this._near = near;\r\n    this._far = far;\r\n    this._autoAspect = true;\r\n    this._window = null;\r\n    this._projectionMode = 'fov';\r\n    this._focalLengthMm = 50;\r\n    this._sensorWidthMm = 36;\r\n    this._sensorHeightMm = 24;\r\n    this._sensorFit = 'horizontal';\r\n    this._invalidate(true);\r\n  }\r\n  /** Perspective projection parameterization. */\r\n  get projectionMode() {\r\n    return this._projectionMode;\r\n  }\r\n  set projectionMode(val: CameraProjectionMode) {\r\n    const mode = val === 'physical' ? 'physical' : 'fov';\r\n    if (mode !== this._projectionMode) {\r\n      this._projectionMode = mode;\r\n      this._invalidate(true);\r\n    }\r\n  }\r\n  /** Physical focal length in millimeters. */\r\n  get focalLengthMm() {\r\n    return this._focalLengthMm;\r\n  }\r\n  set focalLengthMm(val: number) {\r\n    const focalLength = Math.max(0.0001, val);\r\n    if (focalLength !== this._focalLengthMm) {\r\n      this._focalLengthMm = focalLength;\r\n      this._invalidate(true);\r\n    }\r\n  }\r\n  /** Physical sensor width in millimeters. */\r\n  get sensorWidthMm() {\r\n    return this._sensorWidthMm;\r\n  }\r\n  set sensorWidthMm(val: number) {\r\n    const width = Math.max(0.0001, val);\r\n    if (width !== this._sensorWidthMm) {\r\n      this._sensorWidthMm = width;\r\n      this._invalidate(true);\r\n    }\r\n  }\r\n  /** Physical sensor height in millimeters. */\r\n  get sensorHeightMm() {\r\n    return this._sensorHeightMm;\r\n  }\r\n  set sensorHeightMm(val: number) {\r\n    const height = Math.max(0.0001, val);\r\n    if (height !== this._sensorHeightMm) {\r\n      this._sensorHeightMm = height;\r\n      this._invalidate(true);\r\n    }\r\n  }\r\n  /** Sensor dimension kept fixed while fitting the viewport aspect ratio. */\r\n  get sensorFit() {\r\n    return this._sensorFit;\r\n  }\r\n  set sensorFit(val: CameraSensorFit) {\r\n    const fit = val === 'vertical' ? 'vertical' : 'horizontal';\r\n    if (fit !== this._sensorFit) {\r\n      this._sensorFit = fit;\r\n      this._invalidate(true);\r\n    }\r\n  }\r\n  /** Effective vertical field of view used by the projection matrix. */\r\n  get effectiveFovY() {\r\n    return this._projectionMode === 'physical'\r\n      ? calculateVerticalFov(\r\n          this._focalLengthMm,\r\n          this._sensorWidthMm,\r\n          this._sensorHeightMm,\r\n          this._aspect,\r\n          this._sensorFit\r\n        )\r\n      : this._fovY;\r\n  }\r\n  /** Sub-window of the frustum */\r\n  get window(): Nullable<Immutable<number[]>> {\r\n    return this._window;\r\n  }\r\n  set window(val: Nullable<number[]>) {\r\n    this._window = val?.slice() ?? null;\r\n    this._invalidate(true);\r\n  }\r\n  /** Automatically calculate aspect ratio before render according to current viewport */\r\n  get autoAspect() {\r\n    return this._autoAspect;\r\n  }\r\n  set autoAspect(val) {\r\n    this._autoAspect = !!val;\r\n  }\r\n  /** The near clip plane */\r\n  get near() {\r\n    return this._near;\r\n  }\r\n  set near(val) {\r\n    if (val !== this._near) {\r\n      this._near = val;\r\n      this._invalidate(true);\r\n    }\r\n  }\r\n  /** The far clip plane */\r\n  get far() {\r\n    return this._far;\r\n  }\r\n  set far(val) {\r\n    if (val !== this._far) {\r\n      this._far = val;\r\n      this._invalidate(true);\r\n    }\r\n  }\r\n  /** Radian value indicates the field of view in Y axis */\r\n  get fovY() {\r\n    return this._fovY;\r\n  }\r\n  set fovY(val) {\r\n    if (val !== this._fovY) {\r\n      this._fovY = val;\r\n      this._invalidate(true);\r\n    }\r\n  }\r\n  /** Aspect ratio of the perspective transform */\r\n  get aspect() {\r\n    return this._aspect;\r\n  }\r\n  set aspect(val) {\r\n    if (val !== this._aspect) {\r\n      this._aspect = val;\r\n      this._invalidate(true);\r\n    }\r\n  }\r\n  /** Adjust aspect ratio according to viewport settings of the camera */\r\n  adjustAspectRatio() {\r\n    if (this.viewport) {\r\n      this.aspect = this.viewport[2] / this.viewport[3];\r\n    } else {\r\n      if (!this.adapted || getDevice().getFramebuffer()) {\r\n        const vp = getDevice().getViewport();\r\n        this.aspect = vp.width / vp.height;\r\n      } else {\r\n        const transform = getEngine().screen.transform;\r\n        this.aspect = transform.viewportWidth / transform.viewportHeight;\r\n      }\r\n    }\r\n  }\r\n  /**\r\n   * {@inheritDoc Camera.setPerspective}\r\n   */\r\n  setPerspective(fovY: number, aspect: number, zNear: number, zFar: number) {\r\n    this._projectionMode = 'fov';\r\n    this._aspect = aspect;\r\n    this._fovY = fovY;\r\n    this._near = zNear;\r\n    this._far = zFar;\r\n    this._invalidate(true);\r\n    return this;\r\n  }\r\n  /**\r\n   * Not valid for PerspectiveCamera\r\n   *\r\n   * @remarks\r\n   * This method is only valid for {@link Camera} class or {@link OrthoCamera} class.\r\n   */\r\n  setOrtho(_left: number, _right: number, _bottom: number, _top: number, _near: number, _far: number): this {\r\n    throw new Error(`setOrtho() not allowed on PerspectiveCamera`);\r\n  }\r\n  /**\r\n   * Setup a projection matrix for the camera\r\n   * @param matrix - The projection matrix\r\n   */\r\n  setProjectionMatrix(matrix: Matrix4x4) {\r\n    if (matrix !== this._projMatrix) {\r\n      if (matrix?.isPerspective()) {\r\n        super.setProjectionMatrix(matrix);\r\n        this._aspect = matrix.getAspect();\r\n        this._fovY = matrix.getFov();\r\n        this._projectionMode = 'fov';\r\n        this._near = matrix.getNearPlane();\r\n        this._far = matrix.getFarPlane();\r\n      } else {\r\n        throw new Error(\r\n          `PerspectiveCamera.setProjectionMatrix(): param is not a perspective projection matrix`\r\n        );\r\n      }\r\n    }\r\n  }\r\n  /** {@inheritDoc Camera.render} */\r\n  render(scene: Scene) {\r\n    if (this._autoAspect) {\r\n      this.adjustAspectRatio();\r\n    }\r\n    super.render(scene);\r\n  }\r\n  /** @internal */\r\n  protected _computeProj() {\r\n    const fovY = this.effectiveFovY;\r\n    if (this.adapted) {\r\n      this.calcAdaptedPerspectiveProjection(fovY, this._near, this._far, this._projMatrix);\r\n    } else {\r\n      const h = this._near * Math.tan(fovY * 0.5);\r\n      const w = h * this._aspect;\r\n      let left = -w;\r\n      let right = w;\r\n      let top = h;\r\n      let bottom = -h;\r\n      if (this._window) {\r\n        const width = right - left;\r\n        const height = top - bottom;\r\n        left += width * this._window[0];\r\n        bottom += height * this._window[1];\r\n        right = left + width * this._window[2];\r\n        top = bottom + height * this._window[3];\r\n      }\r\n      this._projMatrix.frustum(left, right, bottom, top, this._near, this._far);\r\n    }\r\n    Matrix4x4.invert(this._projMatrix, this._invProjMatrix);\r\n  }\r\n}\r\n"],"names":["PerspectiveCamera","Camera","_far","_fovY","_aspect","_autoAspect","_window","_projectionMode","_focalLengthMm","_sensorWidthMm","_sensorHeightMm","_sensorFit","scene","fovY","Math","PI","near","far","aspect","_near","_invalidate","projectionMode","val","mode","focalLengthMm","focalLength","max","sensorWidthMm","width","sensorHeightMm","height","sensorFit","fit","effectiveFovY","calculateVerticalFov","window","slice","autoAspect","adjustAspectRatio","viewport","adapted","getDevice","getFramebuffer","vp","getViewport","transform","getEngine","screen","viewportWidth","viewportHeight","setPerspective","zNear","zFar","setOrtho","_left","_right","_bottom","_top","Error","setProjectionMatrix","matrix","_projMatrix","isPerspective","getAspect","getFov","getNearPlane","getFarPlane","render","calcAdaptedPerspectiveProjection","h","tan","w","left","right","top","bottom","frustum","Matrix4x4","invert","_invProjMatrix"],"mappings":"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"}