@configura/babylon-view 1.4.0 → 1.5.0-alpha.0

package/dist/camera/CfgOrbitalCamera.d.ts

@@ -1,69 +1,69 @@
-import { ArcRotateCamera } from "@babylonjs/core/Cameras/arcRotateCamera.js";
-import { Scene } from "@babylonjs/core/scene.js";
-import { Observable } from "@configura/web-utilities";
-import { CfgBoundingBox } from "../utilities/CfgBoundingBox.js";
-import { CfgOrbitalCameraControlProps } from "./CfgOrbitalCameraControlProps.js";
-export declare const MAX_UPPER_BETA_LIMIT: number;
-export declare const MIN_LOWER_BETA_LIMIT = 0.1;
-/**
- * @param fov Field of view, in radians. Default value degToRad(30).
- * @param mouseWheelSpeedFactor The higher the slower movement. Default value 200.
- * @param pinchZoomFactor The higher the slower zoom (really dolly). Default value 100.
- * @param keyboardSpeedFactor The higher the faster movement. Default value 0.002.
- * @param pointerSpeedFactor The higher the slower movement. Default value 2000.
- * @param inertia How fast does speed decline. Must be less than 1. Default value 0.93.
- * @param keepCameraFromGettingTooCloseFactor How much further than closest corner is near limit. 1.5 means 50% further. Default value 1.5.
- * @param significantBoundingBoxSizeChangeShrinkFactor How much shrink in size along any axis (X+, X-, Y+, Y-, Z+ or Z-) will make the the zoom reset. Default value 0.4 (40%).
- * @param significantBoundingBoxSizeChangeGrowFactor How much growth in size along any axis (X+, X-, Y+, Y-, Z+ or Z-) will make the the zoom reset. Default value 0.1 (10%).
- */
-export declare type CfgOrbitalCameraConfig = {
-    fov: number;
-    mouseWheelSpeedFactor: number;
-    pinchZoomFactor: number;
-    keyboardSpeedFactor: number;
-    pointerSpeedFactor: number;
-    inertia: number;
-    keepCameraFromGettingTooCloseFactor: number;
-    significantBoundingBoxSizeChangeShrinkFactor: number;
-    significantBoundingBoxSizeChangeGrowFactor: number;
-};
-declare abstract class WorkaroundCfgOrbitalCamera extends ArcRotateCamera {
-    abstract radius: number;
-}
-export declare class CfgOrbitalCamera extends WorkaroundCfgOrbitalCamera {
-    private _canvas;
-    constructor(scene: Scene, _canvas: HTMLElement, config?: Partial<CfgOrbitalCameraConfig>);
-    dispose(): void;
-    protected _config: CfgOrbitalCameraConfig;
-    private _currentBoundingBox;
-    private _latestSignificantChangeBoundingBox;
-    private _currentMinDistanceToKeepCameraOutOfModel;
-    private _currentMinDistanceToFitModelInView;
-    private _orbitalCameraControlObservable;
-    private _previousOrbitalCameraControlProps;
-    _disableSubFloorCam: boolean;
-    set disableSubFloorCam(v: boolean);
-    _lowestAllowedCameraHeight: number | undefined;
-    set lowestAllowedCameraHeight(v: number | undefined);
-    get lowestAllowedCameraHeight(): number | undefined;
-    disableAutomaticSizing: boolean;
-    disableZoom: boolean;
-    private _externalControlHasHappened;
-    forceRadius(r: number): void;
-    private _radius;
-    set radius(r: number);
-    get radius(): number;
-    private get _orbitalCameraControlProps();
-    private _boundNotifyCameraControlListeners;
-    frameRenderNeeded(): boolean;
-    private _notifyCameraControlListeners;
-    get cameraControlObservable(): Observable<CfgOrbitalCameraControlProps>;
-    setContentBoundingBox(newBoundingBox: CfgBoundingBox, force: boolean): void;
-    _applyAdaptToContentBoundingBox(force: boolean): void;
-    refreshCameraNearFar(): void;
-    private _applyNoSneakPeeking;
-    private _updateCameraLimits;
-    private _calculateNoPeekingLimit;
-}
-export {};
+import { ArcRotateCamera } from "@babylonjs/core/Cameras/arcRotateCamera.js";
+import { Scene } from "@babylonjs/core/scene.js";
+import { Observable } from "@configura/web-utilities";
+import { CfgBoundingBox } from "../utilities/CfgBoundingBox.js";
+import { CfgOrbitalCameraControlProps } from "./CfgOrbitalCameraControlProps.js";
+export declare const MAX_UPPER_BETA_LIMIT: number;
+export declare const MIN_LOWER_BETA_LIMIT = 0.1;
+/**
+ * @param fov Field of view, in radians. Default value degToRad(30).
+ * @param mouseWheelSpeedFactor The higher the slower movement. Default value 200.
+ * @param pinchZoomFactor The higher the slower zoom (really dolly). Default value 100.
+ * @param keyboardSpeedFactor The higher the faster movement. Default value 0.002.
+ * @param pointerSpeedFactor The higher the slower movement. Default value 2000.
+ * @param inertia How fast does speed decline. Must be less than 1. Default value 0.93.
+ * @param keepCameraFromGettingTooCloseFactor How much further than closest corner is near limit. 1.5 means 50% further. Default value 1.5.
+ * @param significantBoundingBoxSizeChangeShrinkFactor How much shrink in size along any axis (X+, X-, Y+, Y-, Z+ or Z-) will make the the zoom reset. Default value 0.4 (40%).
+ * @param significantBoundingBoxSizeChangeGrowFactor How much growth in size along any axis (X+, X-, Y+, Y-, Z+ or Z-) will make the the zoom reset. Default value 0.1 (10%).
+ */
+export declare type CfgOrbitalCameraConfig = {
+    fov: number;
+    mouseWheelSpeedFactor: number;
+    pinchZoomFactor: number;
+    keyboardSpeedFactor: number;
+    pointerSpeedFactor: number;
+    inertia: number;
+    keepCameraFromGettingTooCloseFactor: number;
+    significantBoundingBoxSizeChangeShrinkFactor: number;
+    significantBoundingBoxSizeChangeGrowFactor: number;
+};
+declare abstract class WorkaroundCfgOrbitalCamera extends ArcRotateCamera {
+    abstract radius: number;
+}
+export declare class CfgOrbitalCamera extends WorkaroundCfgOrbitalCamera {
+    private _canvas;
+    constructor(scene: Scene, _canvas: HTMLElement, config?: Partial<CfgOrbitalCameraConfig>);
+    dispose(): void;
+    protected _config: CfgOrbitalCameraConfig;
+    private _currentBoundingBox;
+    private _latestSignificantChangeBoundingBox;
+    private _currentMinDistanceToKeepCameraOutOfModel;
+    private _currentMinDistanceToFitModelInView;
+    private _orbitalCameraControlObservable;
+    private _previousOrbitalCameraControlProps;
+    _disableSubFloorCam: boolean;
+    set disableSubFloorCam(v: boolean);
+    _lowestAllowedCameraHeight: number | undefined;
+    set lowestAllowedCameraHeight(v: number | undefined);
+    get lowestAllowedCameraHeight(): number | undefined;
+    disableAutomaticSizing: boolean;
+    disableZoom: boolean;
+    private _externalControlHasHappened;
+    forceRadius(r: number): void;
+    private _radius;
+    set radius(r: number);
+    get radius(): number;
+    private get _orbitalCameraControlProps();
+    private _boundNotifyCameraControlListeners;
+    frameRenderNeeded(): boolean;
+    private _notifyCameraControlListeners;
+    get cameraControlObservable(): Observable<CfgOrbitalCameraControlProps>;
+    setContentBoundingBox(newBoundingBox: CfgBoundingBox, force: boolean): void;
+    _applyAdaptToContentBoundingBox(force: boolean): void;
+    refreshCameraNearFar(): void;
+    private _applyNoSneakPeeking;
+    private _updateCameraLimits;
+    private _calculateNoPeekingLimit;
+}
+export {};
 //# sourceMappingURL=CfgOrbitalCamera.d.ts.map

package/dist/camera/CfgOrbitalCamera.js

@@ -1,250 +1,250 @@
-import { ArcRotateCamera } from "@babylonjs/core/Cameras/arcRotateCamera.js";
-import { Vector3 } from "@babylonjs/core/Maths/math.vector.js";
-import { degToRad, Observable } from "@configura/web-utilities";
-import { CfgBoundingBox } from "../utilities/CfgBoundingBox.js";
-import { boundingBoxesAreSignificantlyDifferent, measureLongestDistanceToCorner, } from "../utilities/utilities3D.js";
-import { CfgArcRotateCameraPointersInput } from "./CfgArcRotateCameraPointersInput.js";
-import { orbitalCameraControlPropsEquals, } from "./CfgOrbitalCameraControlProps.js";
-const NEAREST_ALLOWED_TO_BETA_LIMITS = 0.1;
-export const MAX_UPPER_BETA_LIMIT = Math.PI - NEAREST_ALLOWED_TO_BETA_LIMITS;
-export const MIN_LOWER_BETA_LIMIT = NEAREST_ALLOWED_TO_BETA_LIMITS;
-const defaultOrbitalCameraConfig = {
-    fov: degToRad(30),
-    mouseWheelSpeedFactor: 200,
-    pinchZoomFactor: 100,
-    inertia: 0.93,
-    keyboardSpeedFactor: 0.002,
-    pointerSpeedFactor: 2000,
-    keepCameraFromGettingTooCloseFactor: 1.5,
-    significantBoundingBoxSizeChangeShrinkFactor: 0.4,
-    significantBoundingBoxSizeChangeGrowFactor: 0.1,
-};
-// This is a workaround as you are not allowed to override fields with accessors.
-// By adding this abstract field this becomes possible. This is a hack.
-class WorkaroundCfgOrbitalCamera extends ArcRotateCamera {
-}
-export class CfgOrbitalCamera extends WorkaroundCfgOrbitalCamera {
-    constructor(scene, _canvas, config) {
-        super("CfgOrbitalCamera", 0, degToRad(90), 50, new Vector3(0, 0, 0), scene);
-        this._canvas = _canvas;
-        this._currentBoundingBox = new CfgBoundingBox();
-        this._latestSignificantChangeBoundingBox = new CfgBoundingBox();
-        this._disableSubFloorCam = false;
-        this._lowestAllowedCameraHeight = undefined;
-        this.disableAutomaticSizing = false;
-        this.disableZoom = false;
-        this._externalControlHasHappened = false;
-        this._radius = 0;
-        this._boundNotifyCameraControlListeners = () => {
-            this._notifyCameraControlListeners();
-        };
-        this.attachControl(_canvas, // This parameters is not actually used for anything. But still required.
-        false, // No panning with keyboard
-        false // No panning with mouse
-        );
-        // Workaround for touch issues on iOS, see comments in CfgArcRotateCameraPointersInput.ts
-        this.inputs.removeByType("ArcRotateCameraPointersInput");
-        this.inputs.add(new CfgArcRotateCameraPointersInput());
-        // Make sure to disable all forms of "panning", which for the ArcRotateCamera is defined
-        // as movement sideways without rotation to keep the camera centered on the target.
-        // The settings above for attachControl will not disable two-finger touch.
-        this.panningAxis = Vector3.Zero();
-        this.panningDistanceLimit = 0;
-        this.panningSensibility = 0;
-        this.panningInertia = 0;
-        this._config = Object.assign(Object.assign({}, defaultOrbitalCameraConfig), config);
-        const keyboardInput = this.inputs.attached["keyboard"];
-        keyboardInput.angularSpeed = this._config.keyboardSpeedFactor;
-        this.fov = this._config.fov;
-        this.inertia = this._config.inertia;
-        this.angularSensibilityX = this.angularSensibilityY = this._config.pointerSpeedFactor;
-        this.onViewMatrixChangedObservable.add(this._boundNotifyCameraControlListeners);
-    }
-    dispose() {
-        this.detachControl(this._canvas);
-        this.onViewMatrixChangedObservable.removeCallback(this._boundNotifyCameraControlListeners);
-        super.dispose();
-    }
-    set disableSubFloorCam(v) {
-        this._disableSubFloorCam = v;
-    }
-    set lowestAllowedCameraHeight(v) {
-        this._lowestAllowedCameraHeight = v;
-    }
-    get lowestAllowedCameraHeight() {
-        if (this._lowestAllowedCameraHeight !== undefined) {
-            if (this._disableSubFloorCam) {
-                return Math.max(0, this._lowestAllowedCameraHeight);
-            }
-            return this._lowestAllowedCameraHeight;
-        }
-        if (this._disableSubFloorCam) {
-            return 0;
-        }
-        return undefined;
-    }
-    forceRadius(r) {
-        this._radius = r;
-    }
-    set radius(r) {
-        if (this.disableZoom) {
-            return;
-        }
-        this._radius = r;
-    }
-    get radius() {
-        return this._radius;
-    }
-    get _orbitalCameraControlProps() {
-        return {
-            distance: this.radius,
-            yaw: this.alpha,
-            pitch: this.beta,
-        };
-    }
-    frameRenderNeeded() {
-        const externalControlHasHappened = this._externalControlHasHappened;
-        if (externalControlHasHappened) {
-            this._externalControlHasHappened = false;
-        }
-        return (this.useAutoRotationBehavior ||
-            externalControlHasHappened ||
-            this.inertialAlphaOffset !== 0 ||
-            this.inertialBetaOffset !== 0 ||
-            this.inertialPanningX !== 0 ||
-            this.inertialPanningY !== 0 ||
-            this.inertialRadiusOffset !== 0);
-    }
-    _notifyCameraControlListeners() {
-        if (this._orbitalCameraControlObservable === undefined) {
-            return;
-        }
-        const orbitalCameraControlProps = this._orbitalCameraControlProps;
-        if (this._previousOrbitalCameraControlProps !== undefined &&
-            orbitalCameraControlPropsEquals(this._previousOrbitalCameraControlProps, orbitalCameraControlProps)) {
-            return;
-        }
-        this._orbitalCameraControlObservable.notifyAll(orbitalCameraControlProps, this._orbitalCameraControlObservable);
-        this._previousOrbitalCameraControlProps = orbitalCameraControlProps;
-    }
-    get cameraControlObservable() {
-        if (this._orbitalCameraControlObservable === undefined) {
-            this._orbitalCameraControlObservable = new Observable();
-            this._orbitalCameraControlObservable.listen((c) => {
-                const { distance, yaw, pitch } = c;
-                let change = false;
-                if (distance !== undefined && distance !== this.radius) {
-                    this.forceRadius(distance);
-                    change = true;
-                }
-                if (yaw !== undefined && yaw !== this.alpha) {
-                    this.alpha = yaw;
-                    change = true;
-                }
-                if (pitch !== undefined && pitch !== this.beta) {
-                    this.beta = pitch;
-                    change = true;
-                }
-                if (change) {
-                    this._externalControlHasHappened = true;
-                    this._notifyCameraControlListeners();
-                }
-            }, this._orbitalCameraControlObservable);
-        }
-        return this._orbitalCameraControlObservable;
-    }
-    setContentBoundingBox(newBoundingBox, force) {
-        this._currentBoundingBox = newBoundingBox;
-        const significantChange = boundingBoxesAreSignificantlyDifferent(this._latestSignificantChangeBoundingBox, newBoundingBox, this._config.significantBoundingBoxSizeChangeShrinkFactor, this._config.significantBoundingBoxSizeChangeGrowFactor);
-        if (!significantChange && !force) {
-            return;
-        }
-        this._latestSignificantChangeBoundingBox = newBoundingBox;
-        this._applyAdaptToContentBoundingBox(force);
-        this._applyNoSneakPeeking();
-    }
-    _applyAdaptToContentBoundingBox(force) {
-        const bb = this._currentBoundingBox;
-        if (bb.isEmpty) {
-            return;
-        }
-        // Keeps the camera from recomputing angles
-        const pre = [this.alpha, this.beta];
-        this.target = bb.center;
-        if (this.disableAutomaticSizing) {
-            return;
-        }
-        [this.alpha, this.beta] = pre;
-        this._updateCameraLimits();
-        const minDistanceToFitModelInView = this._currentMinDistanceToFitModelInView;
-        const minDistanceToKeepCameraOutOfModel = this._currentMinDistanceToKeepCameraOutOfModel;
-        if (minDistanceToFitModelInView !== undefined) {
-            if (force || this.radius < minDistanceToFitModelInView) {
-                this.forceRadius(minDistanceToFitModelInView);
-            }
-        }
-        if (minDistanceToKeepCameraOutOfModel !== undefined &&
-            minDistanceToFitModelInView !== undefined) {
-            this.lowerRadiusLimit =
-                minDistanceToKeepCameraOutOfModel *
-                    this._config.keepCameraFromGettingTooCloseFactor;
-            this.upperRadiusLimit = minDistanceToFitModelInView * 2;
-            this.wheelPrecision =
-                this._config.mouseWheelSpeedFactor / minDistanceToKeepCameraOutOfModel;
-            this.pinchPrecision = this._config.pinchZoomFactor / minDistanceToKeepCameraOutOfModel;
-            this.speed = minDistanceToKeepCameraOutOfModel * 0.1;
-        }
-    }
-    refreshCameraNearFar() {
-        const minDistanceToKeepCameraOutOfModel = this._currentMinDistanceToKeepCameraOutOfModel;
-        if (minDistanceToKeepCameraOutOfModel === undefined) {
-            return;
-        }
-        const cameraDistance = this.radius;
-        const extraSpaceFactor = 1.5; // Because when zooming fast it seems the limits do not keep up
-        const graceDistance = minDistanceToKeepCameraOutOfModel * extraSpaceFactor;
-        this.minZ = cameraDistance - graceDistance;
-        this.maxZ = cameraDistance + graceDistance;
-    }
-    _applyNoSneakPeeking() {
-        //It might be impolite to look at a Cfg models underside
-        const noPeekLimit = this._calculateNoPeekingLimit();
-        if (noPeekLimit === undefined || !isFinite(noPeekLimit)) {
-            this.upperBetaLimit = MAX_UPPER_BETA_LIMIT;
-            return;
-        }
-        this.upperBetaLimit = Math.min(MAX_UPPER_BETA_LIMIT, Math.PI / 2 - noPeekLimit);
-    }
-    _updateCameraLimits() {
-        const bb = this._currentBoundingBox;
-        const fovVertical = this.fov;
-        const aspect = this.getEngine().getScreenAspectRatio();
-        const bbAdjustedForCameraPosition = bb.clone().translate(this.target.negate());
-        const longestDistanceToCornerInXYZSpace = measureLongestDistanceToCorner(bbAdjustedForCameraPosition, [0, 1, 2]);
-        const longestDistanceToCornerInXZPlane = measureLongestDistanceToCorner(bbAdjustedForCameraPosition, [0, 2]);
-        const fovHorizontalRad = 2 * Math.atan(Math.tan(fovVertical / 2) * aspect);
-        const maxAllowedHeight = longestDistanceToCornerInXYZSpace * 2;
-        const maxAllowedWidth = longestDistanceToCornerInXZPlane * 2; //Because the model can not be tilted, only spun
-        const minDistanceToFitInViewFromWidth = maxAllowedWidth / (2 * Math.tan(fovHorizontalRad / 2));
-        const minDistanceToFitInViewFromHeight = maxAllowedHeight / (2 * Math.tan(fovVertical / 2));
-        const minDistanceToFitModelInView = Math.max(minDistanceToFitInViewFromWidth, minDistanceToFitInViewFromHeight);
-        this._currentMinDistanceToKeepCameraOutOfModel = isFinite(longestDistanceToCornerInXYZSpace)
-            ? longestDistanceToCornerInXYZSpace
-            : undefined;
-        this._currentMinDistanceToFitModelInView = isFinite(minDistanceToFitModelInView)
-            ? minDistanceToFitModelInView
-            : undefined;
-    }
-    _calculateNoPeekingLimit() {
-        const bb = this._currentBoundingBox;
-        if (bb.isEmpty || this.lowestAllowedCameraHeight === undefined) {
-            return undefined;
-        }
-        const bottomDepth = bb.minimum.y -
-            this.target.y +
-            (bb.maximum.y - bb.minimum.y) * this.lowestAllowedCameraHeight;
-        const cameraDistance = this.radius;
-        const lowestAngleUnderHorizonRad = Math.asin(bottomDepth / cameraDistance);
-        return lowestAngleUnderHorizonRad;
-    }
-}
+import { ArcRotateCamera } from "@babylonjs/core/Cameras/arcRotateCamera.js";
+import { Vector3 } from "@babylonjs/core/Maths/math.vector.js";
+import { degToRad, Observable } from "@configura/web-utilities";
+import { CfgBoundingBox } from "../utilities/CfgBoundingBox.js";
+import { boundingBoxesAreSignificantlyDifferent, measureLongestDistanceToCorner, } from "../utilities/utilities3D.js";
+import { CfgArcRotateCameraPointersInput } from "./CfgArcRotateCameraPointersInput.js";
+import { orbitalCameraControlPropsEquals, } from "./CfgOrbitalCameraControlProps.js";
+const NEAREST_ALLOWED_TO_BETA_LIMITS = 0.1;
+export const MAX_UPPER_BETA_LIMIT = Math.PI - NEAREST_ALLOWED_TO_BETA_LIMITS;
+export const MIN_LOWER_BETA_LIMIT = NEAREST_ALLOWED_TO_BETA_LIMITS;
+const defaultOrbitalCameraConfig = {
+    fov: degToRad(30),
+    mouseWheelSpeedFactor: 200,
+    pinchZoomFactor: 100,
+    inertia: 0.93,
+    keyboardSpeedFactor: 0.002,
+    pointerSpeedFactor: 2000,
+    keepCameraFromGettingTooCloseFactor: 1.5,
+    significantBoundingBoxSizeChangeShrinkFactor: 0.4,
+    significantBoundingBoxSizeChangeGrowFactor: 0.1,
+};
+// This is a workaround as you are not allowed to override fields with accessors.
+// By adding this abstract field this becomes possible. This is a hack.
+class WorkaroundCfgOrbitalCamera extends ArcRotateCamera {
+}
+export class CfgOrbitalCamera extends WorkaroundCfgOrbitalCamera {
+    constructor(scene, _canvas, config) {
+        super("CfgOrbitalCamera", 0, degToRad(90), 50, new Vector3(0, 0, 0), scene);
+        this._canvas = _canvas;
+        this._currentBoundingBox = new CfgBoundingBox();
+        this._latestSignificantChangeBoundingBox = new CfgBoundingBox();
+        this._disableSubFloorCam = false;
+        this._lowestAllowedCameraHeight = undefined;
+        this.disableAutomaticSizing = false;
+        this.disableZoom = false;
+        this._externalControlHasHappened = false;
+        this._radius = 0;
+        this._boundNotifyCameraControlListeners = () => {
+            this._notifyCameraControlListeners();
+        };
+        this.attachControl(_canvas, // This parameters is not actually used for anything. But still required.
+        false, // No panning with keyboard
+        false // No panning with mouse
+        );
+        // Workaround for touch issues on iOS, see comments in CfgArcRotateCameraPointersInput.ts
+        this.inputs.removeByType("ArcRotateCameraPointersInput");
+        this.inputs.add(new CfgArcRotateCameraPointersInput());
+        // Make sure to disable all forms of "panning", which for the ArcRotateCamera is defined
+        // as movement sideways without rotation to keep the camera centered on the target.
+        // The settings above for attachControl will not disable two-finger touch.
+        this.panningAxis = Vector3.Zero();
+        this.panningDistanceLimit = 0;
+        this.panningSensibility = 0;
+        this.panningInertia = 0;
+        this._config = Object.assign(Object.assign({}, defaultOrbitalCameraConfig), config);
+        const keyboardInput = this.inputs.attached["keyboard"];
+        keyboardInput.angularSpeed = this._config.keyboardSpeedFactor;
+        this.fov = this._config.fov;
+        this.inertia = this._config.inertia;
+        this.angularSensibilityX = this.angularSensibilityY = this._config.pointerSpeedFactor;
+        this.onViewMatrixChangedObservable.add(this._boundNotifyCameraControlListeners);
+    }
+    dispose() {
+        this.detachControl(this._canvas);
+        this.onViewMatrixChangedObservable.removeCallback(this._boundNotifyCameraControlListeners);
+        super.dispose();
+    }
+    set disableSubFloorCam(v) {
+        this._disableSubFloorCam = v;
+    }
+    set lowestAllowedCameraHeight(v) {
+        this._lowestAllowedCameraHeight = v;
+    }
+    get lowestAllowedCameraHeight() {
+        if (this._lowestAllowedCameraHeight !== undefined) {
+            if (this._disableSubFloorCam) {
+                return Math.max(0, this._lowestAllowedCameraHeight);
+            }
+            return this._lowestAllowedCameraHeight;
+        }
+        if (this._disableSubFloorCam) {
+            return 0;
+        }
+        return undefined;
+    }
+    forceRadius(r) {
+        this._radius = r;
+    }
+    set radius(r) {
+        if (this.disableZoom) {
+            return;
+        }
+        this._radius = r;
+    }
+    get radius() {
+        return this._radius;
+    }
+    get _orbitalCameraControlProps() {
+        return {
+            distance: this.radius,
+            yaw: this.alpha,
+            pitch: this.beta,
+        };
+    }
+    frameRenderNeeded() {
+        const externalControlHasHappened = this._externalControlHasHappened;
+        if (externalControlHasHappened) {
+            this._externalControlHasHappened = false;
+        }
+        return (this.useAutoRotationBehavior ||
+            externalControlHasHappened ||
+            this.inertialAlphaOffset !== 0 ||
+            this.inertialBetaOffset !== 0 ||
+            this.inertialPanningX !== 0 ||
+            this.inertialPanningY !== 0 ||
+            this.inertialRadiusOffset !== 0);
+    }
+    _notifyCameraControlListeners() {
+        if (this._orbitalCameraControlObservable === undefined) {
+            return;
+        }
+        const orbitalCameraControlProps = this._orbitalCameraControlProps;
+        if (this._previousOrbitalCameraControlProps !== undefined &&
+            orbitalCameraControlPropsEquals(this._previousOrbitalCameraControlProps, orbitalCameraControlProps)) {
+            return;
+        }
+        this._orbitalCameraControlObservable.notifyAll(orbitalCameraControlProps, this._orbitalCameraControlObservable);
+        this._previousOrbitalCameraControlProps = orbitalCameraControlProps;
+    }
+    get cameraControlObservable() {
+        if (this._orbitalCameraControlObservable === undefined) {
+            this._orbitalCameraControlObservable = new Observable();
+            this._orbitalCameraControlObservable.listen((c) => {
+                const { distance, yaw, pitch } = c;
+                let change = false;
+                if (distance !== undefined && distance !== this.radius) {
+                    this.forceRadius(distance);
+                    change = true;
+                }
+                if (yaw !== undefined && yaw !== this.alpha) {
+                    this.alpha = yaw;
+                    change = true;
+                }
+                if (pitch !== undefined && pitch !== this.beta) {
+                    this.beta = pitch;
+                    change = true;
+                }
+                if (change) {
+                    this._externalControlHasHappened = true;
+                    this._notifyCameraControlListeners();
+                }
+            }, this._orbitalCameraControlObservable);
+        }
+        return this._orbitalCameraControlObservable;
+    }
+    setContentBoundingBox(newBoundingBox, force) {
+        this._currentBoundingBox = newBoundingBox;
+        const significantChange = boundingBoxesAreSignificantlyDifferent(this._latestSignificantChangeBoundingBox, newBoundingBox, this._config.significantBoundingBoxSizeChangeShrinkFactor, this._config.significantBoundingBoxSizeChangeGrowFactor);
+        if (!significantChange && !force) {
+            return;
+        }
+        this._latestSignificantChangeBoundingBox = newBoundingBox;
+        this._applyAdaptToContentBoundingBox(force);
+        this._applyNoSneakPeeking();
+    }
+    _applyAdaptToContentBoundingBox(force) {
+        const bb = this._currentBoundingBox;
+        if (bb.isEmpty) {
+            return;
+        }
+        // Keeps the camera from recomputing angles
+        const pre = [this.alpha, this.beta];
+        this.target = bb.center;
+        if (this.disableAutomaticSizing) {
+            return;
+        }
+        [this.alpha, this.beta] = pre;
+        this._updateCameraLimits();
+        const minDistanceToFitModelInView = this._currentMinDistanceToFitModelInView;
+        const minDistanceToKeepCameraOutOfModel = this._currentMinDistanceToKeepCameraOutOfModel;
+        if (minDistanceToFitModelInView !== undefined) {
+            if (force || this.radius < minDistanceToFitModelInView) {
+                this.forceRadius(minDistanceToFitModelInView);
+            }
+        }
+        if (minDistanceToKeepCameraOutOfModel !== undefined &&
+            minDistanceToFitModelInView !== undefined) {
+            this.lowerRadiusLimit =
+                minDistanceToKeepCameraOutOfModel *
+                    this._config.keepCameraFromGettingTooCloseFactor;
+            this.upperRadiusLimit = minDistanceToFitModelInView * 2;
+            this.wheelPrecision =
+                this._config.mouseWheelSpeedFactor / minDistanceToKeepCameraOutOfModel;
+            this.pinchPrecision = this._config.pinchZoomFactor / minDistanceToKeepCameraOutOfModel;
+            this.speed = minDistanceToKeepCameraOutOfModel * 0.1;
+        }
+    }
+    refreshCameraNearFar() {
+        const minDistanceToKeepCameraOutOfModel = this._currentMinDistanceToKeepCameraOutOfModel;
+        if (minDistanceToKeepCameraOutOfModel === undefined) {
+            return;
+        }
+        const cameraDistance = this.radius;
+        const extraSpaceFactor = 1.5; // Because when zooming fast it seems the limits do not keep up
+        const graceDistance = minDistanceToKeepCameraOutOfModel * extraSpaceFactor;
+        this.minZ = cameraDistance - graceDistance;
+        this.maxZ = cameraDistance + graceDistance;
+    }
+    _applyNoSneakPeeking() {
+        //It might be impolite to look at a Cfg models underside
+        const noPeekLimit = this._calculateNoPeekingLimit();
+        if (noPeekLimit === undefined || !isFinite(noPeekLimit)) {
+            this.upperBetaLimit = MAX_UPPER_BETA_LIMIT;
+            return;
+        }
+        this.upperBetaLimit = Math.min(MAX_UPPER_BETA_LIMIT, Math.PI / 2 - noPeekLimit);
+    }
+    _updateCameraLimits() {
+        const bb = this._currentBoundingBox;
+        const fovVertical = this.fov;
+        const aspect = this.getEngine().getScreenAspectRatio();
+        const bbAdjustedForCameraPosition = bb.clone().translate(this.target.negate());
+        const longestDistanceToCornerInXYZSpace = measureLongestDistanceToCorner(bbAdjustedForCameraPosition, [0, 1, 2]);
+        const longestDistanceToCornerInXZPlane = measureLongestDistanceToCorner(bbAdjustedForCameraPosition, [0, 2]);
+        const fovHorizontalRad = 2 * Math.atan(Math.tan(fovVertical / 2) * aspect);
+        const maxAllowedHeight = longestDistanceToCornerInXYZSpace * 2;
+        const maxAllowedWidth = longestDistanceToCornerInXZPlane * 2; //Because the model can not be tilted, only spun
+        const minDistanceToFitInViewFromWidth = maxAllowedWidth / (2 * Math.tan(fovHorizontalRad / 2));
+        const minDistanceToFitInViewFromHeight = maxAllowedHeight / (2 * Math.tan(fovVertical / 2));
+        const minDistanceToFitModelInView = Math.max(minDistanceToFitInViewFromWidth, minDistanceToFitInViewFromHeight);
+        this._currentMinDistanceToKeepCameraOutOfModel = isFinite(longestDistanceToCornerInXYZSpace)
+            ? longestDistanceToCornerInXYZSpace
+            : undefined;
+        this._currentMinDistanceToFitModelInView = isFinite(minDistanceToFitModelInView)
+            ? minDistanceToFitModelInView
+            : undefined;
+    }
+    _calculateNoPeekingLimit() {
+        const bb = this._currentBoundingBox;
+        if (bb.isEmpty || this.lowestAllowedCameraHeight === undefined) {
+            return undefined;
+        }
+        const bottomDepth = bb.minimum.y -
+            this.target.y +
+            (bb.maximum.y - bb.minimum.y) * this.lowestAllowedCameraHeight;
+        const cameraDistance = this.radius;
+        const lowestAngleUnderHorizonRad = Math.asin(bottomDepth / cameraDistance);
+        return lowestAngleUnderHorizonRad;
+    }
+}

package/dist/camera/CfgOrbitalCameraControlProps.d.ts

@@ -1,7 +1,7 @@
-export interface CfgOrbitalCameraControlProps {
-    distance?: number;
-    yaw?: number;
-    pitch?: number;
-}
-export declare function orbitalCameraControlPropsEquals(left: CfgOrbitalCameraControlProps, right: CfgOrbitalCameraControlProps): boolean;
+export interface CfgOrbitalCameraControlProps {
+    distance?: number;
+    yaw?: number;
+    pitch?: number;
+}
+export declare function orbitalCameraControlPropsEquals(left: CfgOrbitalCameraControlProps, right: CfgOrbitalCameraControlProps): boolean;
 //# sourceMappingURL=CfgOrbitalCameraControlProps.d.ts.map