@onerjs/core 8.31.0 → 8.31.2

package/Cameras/geospatialCamera.js

@@ -1,66 +1,193 @@
 import { GeospatialCameraInputsManager } from "./geospatialCameraInputsManager.js";
 import { Vector3, Matrix, TmpVectors } from "../Maths/math.vector.js";
 import { Epsilon } from "../Maths/math.constants.js";
-import { Scalar } from "../Maths/math.scalar.js";
 import { Camera } from "./camera.js";
-import { Ray } from "../Culling/ray.js";
+import { GeospatialLimits } from "./Limits/geospatialLimits.js";
+import { ComputeLocalBasisToRefs, GeospatialCameraMovement } from "./geospatialCameraMovement.js";
+import { Vector3CopyToRef, Vector3Dot } from "../Maths/math.vector.functions.js";
+import { Clamp } from "../Maths/math.scalar.functions.js";
+import { InterpolatingBehavior } from "../Behaviors/Cameras/interpolatingBehavior.js";
 /**
  * @experimental
  * This camera's movements are limited to a camera orbiting a globe, and as the API evolves it will introduce conversions between cartesian coordinates and true lat/long/alt
  *
  * Please note this is marked as experimental and the API (including the constructor!) will change until we remove that flag
- *
- * Still TODO:
- * - Pitch/yaw limits, input speeds
- * - ZoomToPoint
- * - Conversion between lat/long/alt and cartesian coordinates
  */
 export class GeospatialCamera extends Camera {
+    constructor(name, scene, options, pickPredicate) {
+        super(name, new Vector3(), scene);
+        // Temp vars
+        this._tempPosition = new Vector3();
+        this._viewMatrix = new Matrix();
+        this._lookAtVector = new Vector3();
+        this._flyToTargets = new Map();
+        this._center = new Vector3();
+        this._yaw = 0;
+        this._pitch = 0;
+        this._radius = 0;
+        this._tempVect = new Vector3();
+        this._tempEast = new Vector3();
+        this._tempNorth = new Vector3();
+        this._tempUp = new Vector3();
+        this._limits = new GeospatialLimits(options.planetRadius);
+        this._resetToDefault(this._limits);
+        this._flyingBehavior = new InterpolatingBehavior();
+        this.addBehavior(this._flyingBehavior);
+        this.movement = new GeospatialCameraMovement(scene, this._limits, this.position, this.center, this._lookAtVector, pickPredicate);
+        this.pickPredicate = pickPredicate;
+        this.inputs = new GeospatialCameraInputsManager(this);
+        this.inputs.addMouse().addMouseWheel().addKeyboard();
+    }
     /** The point on the globe that we are anchoring around. If no alternate rotation point is supplied, this will represent the center of screen*/
     get center() {
-        // NOTE that for now we are falling back to target if no pick on globe (because that shouldn't happen with current implemented inputs)
-        // but eventually we want to return a point on the globe even if the camera is looking off into space
-        return this._pickAlongLook?.pickedPoint ?? this._target;
+        return this._center;
+    }
+    /**
+     * Sets the camera position to orbit around a new center point
+     * @param center The world position (ECEF) to orbit around
+     */
+    set center(center) {
+        this._center.copyFromFloats(center.x, center.y, center.z);
+        this._setOrientation(this._yaw, this._pitch, this._radius, this._center);
+    }
+    /**
+     * Gets the camera's yaw (rotation around the geocentric normal) in radians
+     */
+    get yaw() {
+        return this._yaw;
+    }
+    /**
+     * Sets the camera's yaw (rotation around the geocentric normal)
+     * @param yaw The desired yaw angle in radians (0 = north, π/2 = east)
+     */
+    set yaw(yaw) {
+        this._setOrientation(yaw, this.pitch, this.radius, this.center);
     }
-    /** Target of camera when looking along lookAtVector from current position. This does not necessarily represent a point on the globe */
-    get _target() {
-        return this.position.addToRef(this._lookAtVector, this._tempPosition);
+    /**
+     * Gets the camera's pitch (angle from looking straight at globe)
+     * Pitch is measured from looking straight down at planet center:
+     * - zero pitch = looking straight at planet center (down)
+     * - positive pitch = tilting up away from planet
+     * - π/2 pitch = looking at horizon (perpendicular to geocentric normal)
+     */
+    get pitch() {
+        return this._pitch;
+    }
+    /**
+     * Sets the camera's pitch (angle from looking straight at globe)
+     * @param pitch The desired pitch angle in radians (0 = looking at planet center, π/2 = looking at horizon)
+     */
+    set pitch(pitch) {
+        this._setOrientation(this.yaw, pitch, this.radius, this.center);
+    }
+    get radius() {
+        return this._radius;
+    }
+    /**
+     * Sets the camera's distance from the current center point
+     * @param radius The desired radius
+     */
+    set radius(radius) {
+        this._setOrientation(this.yaw, this.pitch, radius, this.center);
+    }
+    _checkLimits() {
+        const limits = this.limits;
+        this._yaw = Clamp(this._yaw, limits.yawMin, limits.yawMax);
+        this._pitch = Clamp(this._pitch, limits.pitchMin, limits.pitchMax);
+        this._radius = Clamp(this._radius, limits.radiusMin, limits.radiusMax);
+    }
+    _setOrientation(yaw, pitch, radius, center) {
+        this._yaw = yaw;
+        this._pitch = pitch;
+        this._radius = radius;
+        Vector3CopyToRef(center, this._center);
+        // Clamp to limits
+        this._checkLimits();
+        // Refresh local basis at center (treat these as read-only for the whole call)
+        ComputeLocalBasisToRefs(this._center, this._tempEast, this._tempNorth, this._tempUp);
+        // Trig
+        const yawScale = this._scene.useRightHandedSystem ? 1 : -1;
+        const cosYaw = Math.cos(this._yaw * yawScale);
+        const sinYaw = Math.sin(this._yaw * yawScale);
+        const sinPitch = Math.sin(this._pitch); // horizontal weight
+        const cosPitch = Math.cos(this._pitch); // vertical weight (toward center)
+        // Temps
+        const horiz = TmpVectors.Vector3[0];
+        const t1 = TmpVectors.Vector3[1];
+        const t2 = TmpVectors.Vector3[2];
+        const right = TmpVectors.Vector3[3];
+        // horizontalDirection = North*cosYaw + East*sinYaw  (avoids mutating _temp basis vectors)
+        horiz.copyFrom(this._tempNorth).scaleInPlace(cosYaw).addInPlace(t1.copyFrom(this._tempEast).scaleInPlace(sinYaw));
+        // look = horiz*sinPitch - Up*cosPitch
+        this._lookAtVector.copyFrom(horiz).scaleInPlace(sinPitch).addInPlace(t2.copyFrom(this._tempUp).scaleInPlace(-cosPitch)).normalize(); // keep it unit
+        // Build an orthonormal up aligned with geocentric Up
+        // right = normalize(cross(upRef, look))
+        Vector3.CrossToRef(this._tempUp, this._lookAtVector, right);
+        // up = normalize(cross(look, right))
+        Vector3.CrossToRef(this._lookAtVector, right, this.upVector);
+        // Position = center - look * radius  (preserve unit look)
+        this._tempVect.copyFrom(this._lookAtVector).scaleInPlace(-this._radius);
+        this._tempPosition.copyFrom(this._center).addInPlace(this._tempVect);
+        this._position.copyFrom(this._tempPosition);
+        this._isViewMatrixDirty = true;
     }
     /** The point around which the camera will geocentrically rotate. Uses center (pt we are anchored to) if no alternateRotationPt is defined */
     get _geocentricRotationPt() {
-        return this._alternateRotationPt ?? this.center;
+        return this.movement.alternateRotationPt ?? this.center;
     }
-    constructor(name, scene, options, pickPredicate) {
-        super(name, Vector3.Zero(), scene);
-        this._resetToDefault(options);
-        this.pickPredicate = pickPredicate;
-        this.inputs = new GeospatialCameraInputsManager(this);
-        this.inputs.addMouse().addMouseWheel();
+    /**
+     * If camera is actively in flight, will update the target properties and use up the remaining duration from original flyTo call
+     *
+     * To start a new flyTo curve entirely, call into flyToAsync again (it will stop the inflight animation)
+     * @param targetYaw
+     * @param targetPitch
+     * @param targetRadius
+     * @param targetCenter
+     */
+    updateFlyToDestination(targetYaw, targetPitch, targetRadius, targetCenter) {
+        this._flyToTargets.clear();
+        this._flyToTargets.set("yaw", targetYaw);
+        this._flyToTargets.set("pitch", targetPitch);
+        this._flyToTargets.set("radius", targetRadius);
+        this._flyToTargets.set("center", targetCenter);
+        this._flyingBehavior.updateProperties(this._flyToTargets);
+    }
+    /**
+     * Animate camera towards passed in property values. If undefined, will use current value
+     * @param targetYaw
+     * @param targetPitch
+     * @param targetRadius
+     * @param targetCenter
+     * @param flightDurationMs
+     * @param easingFunction
+     * @returns Promise that will return when the animation is complete (or interuppted by pointer input)
+     */
+    async flyToAsync(targetYaw, targetPitch, targetRadius, targetCenter, flightDurationMs = 1000, easingFunction) {
+        this._flyToTargets.clear();
+        this._flyToTargets.set("yaw", targetYaw);
+        this._flyToTargets.set("pitch", targetPitch);
+        this._flyToTargets.set("radius", targetRadius);
+        this._flyToTargets.set("center", targetCenter);
+        return await this._flyingBehavior.animatePropertiesAsync(this._flyToTargets, flightDurationMs, easingFunction);
+    }
+    get limits() {
+        return this._limits;
     }
-    _resetToDefault(options) {
+    _resetToDefault(limits) {
         // Camera configuration vars
-        this._minAltitude = options.minAltitude ?? 5;
-        this._maxAltitude = options.maxAltitude;
-        this._planetRadius = options.planetRadius;
-        this._maxCameraRadius = this._maxAltitude ? this._planetRadius + this._maxAltitude : undefined;
-        this._restingAltitude = options.restingAltitude ?? this._maxCameraRadius ?? this._planetRadius * 4;
-        this.position.copyFromFloats(0, 0, -this._restingAltitude);
-        // Input vars
-        this._perFrameGeocentricRotation = Vector3.Zero();
-        this._perFrameGeocentricTranslation = Vector3.Zero();
-        this._perFrameZoom = 0;
+        const maxCameraRadius = limits.altitudeMax !== undefined ? limits.planetRadius + limits.altitudeMax : undefined;
+        const restingAltitude = maxCameraRadius ?? limits.planetRadius * 4;
+        this.position.copyFromFloats(restingAltitude, 0, 0);
+        this._center.copyFromFloats(limits.planetRadius, 0, 0);
+        this._radius = Vector3.Distance(this.position, this.center);
         // Temp vars
-        this._tempPosition = Vector3.Zero();
-        this._tempRotationAxis = Vector3.Right(); // starting axis used to calculate pitch rotation matrix
-        this._tempRotationMatrix = Matrix.Identity();
-        this._tempGeocentricNormal = Vector3.Zero();
-        this._tempPickingRay = new Ray(this.position, this._lookAtVector);
-        this._tempPickingRay.direction = Vector3.Zero();
+        this._tempPosition = new Vector3();
         // View matrix calculation vars
-        this.upVector = Vector3.Up(); // Up vector of the camera
-        this._lookAtVector = this.position.negate().normalize(); // Lookat vector of the camera
         this._viewMatrix = Matrix.Identity();
+        this._center.subtractToRef(this._position, this._lookAtVector).normalize(); // Lookat vector of the camera
+        this.upVector = Vector3.Up(); // Up vector of the camera (does work for -X look at)
         this._isViewMatrixDirty = true;
+        this._setOrientation(this._yaw, this._pitch, this._radius, this._center);
     }
     /** @internal */
     _getViewMatrix() {
@@ -71,12 +198,12 @@ export class GeospatialCamera extends Camera {
         // Ensure vectors are normalized
         this.upVector.normalize();
         this._lookAtVector.normalize();
-        // Calculate view matrix with camera position and target
+        // Calculate view matrix with camera position and center
         if (this.getScene().useRightHandedSystem) {
-            Matrix.LookAtRHToRef(this.position, this._target, this.upVector, this._viewMatrix);
+            Matrix.LookAtRHToRef(this.position, this._center, this.upVector, this._viewMatrix);
         }
         else {
-            Matrix.LookAtLHToRef(this.position, this._target, this.upVector, this._viewMatrix);
+            Matrix.LookAtLHToRef(this.position, this._center, this.upVector, this._viewMatrix);
         }
         return this._viewMatrix;
     }
@@ -87,133 +214,65 @@ export class GeospatialCamera extends Camera {
         }
         return true;
     }
-    /**
-     * Applies rotation correction to the camera by calculating a changeOfBasis matrix from the camera's current position to the new position
-     * and transforming the lookAt and up vectors by that matrix before updating the camera position and marking the view matrix as dirty
-     * @param newPos The camera's desired position, before correction is applied
-     */
-    _applyRotationCorrectionAndSetPos(newPos) {
-        // Compute changeOfBasis between current camera position and new position
-        ComputeChangeOfBasisToRef(this.position, newPos, this._tempRotationMatrix);
-        // Apply rotation correction to lookat/up vectors
-        Vector3.TransformNormalToRef(this._lookAtVector, this._tempRotationMatrix, this._lookAtVector);
-        Vector3.TransformNormalToRef(this.upVector, this._tempRotationMatrix, this.upVector);
-        // Apply position change and mark viewMatrix as dirty
-        this.position.copyFrom(newPos);
-        this._isViewMatrixDirty = true;
-    }
-    /**
-     * When the geocentric normal has any translation change (due to dragging), we must ensure the camera remains orbiting around the world origin
-     * We thus need to perform 2 correction steps
-     * 1. Translation correction that keeps the camera at the same radius as before the drag
-     * 2. Rotation correction that keeps the camera facing the globe (so that as we pan, the globe stays centered on screen)
-     */
     _applyGeocentricTranslation() {
         // Store pending position (without any corrections applied)
-        this.position.addToRef(this._perFrameGeocentricTranslation, this._tempPosition);
-        // 1. Calculate the altitude correction to keep camera at the same radius when applying translation
-        const tempPositionScaled = TmpVectors.Vector3[2];
-        const offset = TmpVectors.Vector3[3];
-        this._tempPosition.normalizeToRef(tempPositionScaled).scaleInPlace(this.position.length()); // what would tempPosition be if it were scaled to same radius as before
-        this._tempPosition.subtractToRef(tempPositionScaled, offset); // find offset between tempPosition and the tempScaledPosition
-        this._tempPosition.subtractInPlace(offset); // reduce tempPosition by that offset
-        // 2. Calculate the rotation correction to keep camera facing globe
-        this._applyRotationCorrectionAndSetPos(this._tempPosition);
+        this.center.addToRef(this.movement.panDeltaCurrentFrame, this._tempPosition);
+        if (!this.movement.isInterpolating) {
+            // Calculate the position correction to keep camera at the same radius when applying translation
+            this._tempPosition.normalize().scaleInPlace(this.center.length());
+        }
+        // Set center which will call _setOrientation
+        this.center = this._tempPosition;
     }
     /**
      * This rotation keeps the camera oriented towards the globe as it orbits around it. This is different from cameraCentricRotation which is when the camera rotates around its own axis
      */
     _applyGeocentricRotation() {
-        // Normalize key vectors
-        this._geocentricRotationPt.normalizeToRef(this._tempGeocentricNormal);
-        this.upVector.normalize();
-        this._lookAtVector.normalize();
-        const pitchRotationMatrix = Matrix.Identity();
-        const yawRotationMatrix = Matrix.Identity();
-        // First apply pitch
-        if (this._perFrameGeocentricRotation.x !== 0) {
-            // Compute a rotation axis that is perpendicular to both the upVector and the geocentricNormalOfPitchPoint
-            Vector3.CrossToRef(this.upVector, this._tempGeocentricNormal, this._tempRotationAxis);
-            // If upVector and geocentricNormalOfPitchPoint are parallel, fall back to cross(lookAtDirection, geocentricNormalOfPitchPoint)
-            if (this._tempRotationAxis.lengthSquared() <= Epsilon) {
-                Vector3.CrossToRef(this._lookAtVector, this._tempGeocentricNormal, this._tempRotationAxis);
-            }
-            const pitchSign = Math.sign(Vector3.Dot(this._tempGeocentricNormal, this.upVector)); // If negative, camera is upside down
-            // Since these are pointed in opposite directions, we must negate the dot product to get the proper angle
-            const currentPitch = pitchSign * Math.acos(Scalar.Clamp(-Vector3.Dot(this._lookAtVector, this._tempGeocentricNormal), -1, 1));
-            const newPitch = Scalar.Clamp(currentPitch + this._perFrameGeocentricRotation.x, 0, 0.5 * Math.PI - Epsilon);
-            // Build rotation matrix around normalized axis
-            Matrix.RotationAxisToRef(this._tempRotationAxis.normalize(), newPitch - currentPitch, pitchRotationMatrix);
+        const rotationDeltaCurrentFrame = this.movement.rotationDeltaCurrentFrame;
+        if (rotationDeltaCurrentFrame.x !== 0 || rotationDeltaCurrentFrame.y !== 0) {
+            const pitch = rotationDeltaCurrentFrame.x !== 0 ? Clamp(this._pitch + rotationDeltaCurrentFrame.x, 0, 0.5 * Math.PI - Epsilon) : this._pitch;
+            const yaw = rotationDeltaCurrentFrame.y !== 0 ? this._yaw + rotationDeltaCurrentFrame.y : this._yaw;
+            // TODO: If _geocentricRotationPt is not the center, this will need to be adjusted.
+            this._setOrientation(yaw, pitch, this._radius, this._geocentricRotationPt);
         }
-        // Then apply yaw
-        if (this._perFrameGeocentricRotation.y !== 0) {
-            Matrix.RotationAxisToRef(this._tempGeocentricNormal, this._perFrameGeocentricRotation.y, yawRotationMatrix); // this axis changes if we aren't using center of screen for tilt
-        }
-        pitchRotationMatrix.multiplyToRef(yawRotationMatrix, this._tempRotationMatrix);
-        // Offset camera to be (position-pitchPoint) distance from geocentricOrigin, apply rotation to position/up/lookat vectors, then add back the pitchPoint offset
-        this.position.subtractInPlace(this._geocentricRotationPt);
-        Vector3.TransformCoordinatesToRef(this.position, this._tempRotationMatrix, this.position);
-        Vector3.TransformNormalToRef(this.upVector, this._tempRotationMatrix, this.upVector);
-        Vector3.TransformNormalToRef(this._lookAtVector, this._tempRotationMatrix, this._lookAtVector);
-        this.position.addInPlace(this._geocentricRotationPt);
-    }
-    _clampZoomDistance(requestedDistance, pickResultDistance) {
-        // If pickResult is defined
-        if (requestedDistance > 0) {
-            if (pickResultDistance !== undefined) {
-                // If there is a pick, allow movement up to pick - minAltitude
-                if (pickResultDistance - this._minAltitude < 0) {
-                    return 0;
-                }
-                return Math.min(requestedDistance, pickResultDistance - this._minAltitude);
-            }
-            else {
-                return requestedDistance;
-            }
-        }
-        if (requestedDistance < 0) {
-            const maxZoomOut = this._maxCameraRadius ? this._maxCameraRadius - this.position.length() : Number.POSITIVE_INFINITY;
-            return Math.max(requestedDistance, -maxZoomOut);
-        }
-        return 0;
     }
-    _applyZoom(distance) {
-        const pickResult = this._scene.pick(this._scene.pointerX, this._scene.pointerY, this.pickPredicate);
-        if (pickResult.hit && pickResult.ray) {
-            // Zoom to cursor
-            this._moveCameraAlongVectorByDistance(pickResult.ray.direction, this._clampZoomDistance(distance, pickResult.distance));
-        }
-        else {
-            // If no hit under cursor, zoom along lookVector instead
-            this._moveCameraAlongVectorByDistance(this._lookAtVector, this._clampZoomDistance(distance, this._pickAlongLook?.distance));
-        }
-    }
-    _moveCameraAlongVectorByDistance(vector, distance) {
-        if (distance) {
-            vector.scaleAndAddToRef(distance, this._tempPosition);
-            this._applyRotationCorrectionAndSetPos(this._tempPosition);
-        }
-    }
-    get _pickAlongLook() {
-        this._tempPickingRay.origin.copyFrom(this.position);
-        this._tempPickingRay.direction.copyFrom(this._lookAtVector);
-        return this._scene.pickWithRay(this._tempPickingRay, this.pickPredicate);
+    _applyZoom(zoomVector, distance) {
+        // TODO this function will be re-worked shortly after checkin, becuase today it breaks down if you zoom to a point past the center
+        // (ex: tilted view zooming towards cursor near horizon where the center is closer than the cursor point).
+        // Project zoom vector onto lookAt vector to find the amount the camera-to-center distance should change.
+        // - zoom vector is normalized
+        // - distance is how much to move in this call
+        const directionDotLookAt = Vector3Dot(zoomVector, this._lookAtVector);
+        const hasRadialComponent = Math.abs(directionDotLookAt) > Epsilon;
+        const requestedRadius = hasRadialComponent ? this._radius - distance * directionDotLookAt : this._radius;
+        const newRadius = Clamp(requestedRadius, this.limits.radiusMin, this.limits.radiusMax);
+        const actualRadiusChange = newRadius - this._radius;
+        const actualDistanceChange = hasRadialComponent ? actualRadiusChange / directionDotLookAt : 0;
+        // Use this to compute new camera position and new center position.
+        const newCameraPosition = this._position.add(zoomVector.scale(-actualDistanceChange));
+        const newCenter = newCameraPosition.add(this._lookAtVector.scaleToRef(newRadius, TmpVectors.Vector3[3]));
+        // Rescale new center to maintain same altitude as the old center.
+        const currentCenterRadius = this._center.length();
+        const newCenterRadius = newCenter.length();
+        const newCenterRescale = currentCenterRadius / newCenterRadius;
+        newCenter.scaleInPlace(newCenterRescale);
+        // Apply changes
+        this._setOrientation(this._yaw, this._pitch, newRadius, newCenter);
     }
     _checkInputs() {
         this.inputs.checkInputs();
-        if (this._perFrameGeocentricTranslation.lengthSquared() > 0) {
+        // Let movement class handle all per-frame logic
+        this.movement.computeCurrentFrameDeltas();
+        if (this.movement.panDeltaCurrentFrame.lengthSquared() > 0) {
             this._applyGeocentricTranslation();
-            this._perFrameGeocentricTranslation.setAll(0);
             this._isViewMatrixDirty = true;
         }
-        if (this._perFrameGeocentricRotation.lengthSquared() > 0) {
+        if (this.movement.rotationDeltaCurrentFrame.lengthSquared() > 0) {
             this._applyGeocentricRotation();
-            this._perFrameGeocentricRotation.setAll(0);
             this._isViewMatrixDirty = true;
         }
-        if (this._perFrameZoom !== 0) {
-            this._applyZoom(this._perFrameZoom);
-            this._perFrameZoom = 0;
+        if (Math.abs(this.movement.zoomDeltaCurrentFrame) > Epsilon) {
+            this._applyZoom(this.movement.computedPerFrameZoomVector, this.movement.zoomDeltaCurrentFrame);
             this._isViewMatrixDirty = true;
         }
         super._checkInputs();
@@ -225,44 +284,4 @@ export class GeospatialCamera extends Camera {
         this.inputs.detachElement();
     }
 }
-// Helper to build east/north/up basis vectors at a world position
-function ComputeLocalBasisToRefs(worldPos, refEast, refNorth, refUp) {
-    // up = normalized position (geocentric normal)
-    refUp.copyFrom(worldPos).normalize();
-    // east = normalize(up × worldUp)
-    // (cross product of up with world Y gives east except at poles)
-    const worldUp = Vector3.Up(); // (0,1,0)
-    Vector3.CrossToRef(refUp, worldUp, refEast);
-    // at poles, cross with worldForward instead
-    if (refEast.lengthSquared() < Epsilon) {
-        Vector3.CrossToRef(refUp, Vector3.Forward(), refEast);
-    }
-    refEast.normalize();
-    // north = up × east (completes right-handed basis)
-    Vector3.CrossToRef(refUp, refEast, refNorth);
-    refNorth.normalize();
-}
-/**
- * Calculates changeOfBasis matrix from currentPos to newPos and stores it in ref
- * @param currentPos
- * @param newPos
- * @param ref
- * @returns The changeOfBasis matrix from currentPos to newPos
- */
-function ComputeChangeOfBasisToRef(currentPos, newPos, ref) {
-    const currentBasis = TmpVectors.Matrix[5];
-    const newBasis = TmpVectors.Matrix[6];
-    const inverse = TmpVectors.Matrix[7];
-    const east = TmpVectors.Vector3[3];
-    const north = TmpVectors.Vector3[4];
-    const up = TmpVectors.Vector3[5];
-    ComputeLocalBasisToRefs(currentPos, east, north, up);
-    Matrix.FromXYZAxesToRef(east, north, up, currentBasis);
-    ComputeLocalBasisToRefs(newPos, east, north, up);
-    Matrix.FromXYZAxesToRef(east, north, up, newBasis);
-    // Change of basis matrix = basis2 * basis1.inverse()
-    // (since orthonormal, inverse = transpose)
-    currentBasis.transposeToRef(inverse).multiplyToRef(newBasis, ref);
-    return ref;
-}
 //# sourceMappingURL=geospatialCamera.js.map

package/Cameras/geospatialCamera.js.map

@@ -1 +1 @@
-{"version":3,"file":"geospatialCamera.js","sourceRoot":"","sources":["../../../../dev/core/src/Cameras/geospatialCamera.ts"],"names":[],"mappings":"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","sourcesContent":["import { GeospatialCameraInputsManager } from \"./geospatialCameraInputsManager\";\r\nimport { Vector3, Matrix, TmpVectors } from \"../Maths/math.vector\";\r\nimport { Epsilon } from \"../Maths/math.constants\";\r\nimport { Scalar } from \"../Maths/math.scalar\";\r\nimport { Camera } from \"./camera\";\r\nimport { Ray } from \"../Culling/ray\";\r\nimport type { Scene } from \"../scene\";\r\nimport type { MeshPredicate } from \"../Culling/ray.core\";\r\nimport type { Nullable } from \"../types\";\r\n\r\ntype CameraOptions = {\r\n    planetRadius: number; // Radius of the planet\r\n    minAltitude?: number; // Minimum altitude of the camera above the planet surface\r\n    maxAltitude?: number; // Maximum altitude of the camera above the planet surface\r\n    restingAltitude?: number; // The altitude the camera will return to when not being actively zoomed in or out\r\n};\r\n\r\n/**\r\n * @experimental\r\n * This camera's movements are limited to a camera orbiting a globe, and as the API evolves it will introduce conversions between cartesian coordinates and true lat/long/alt\r\n *\r\n * Please note this is marked as experimental and the API (including the constructor!) will change until we remove that flag\r\n *\r\n * Still TODO:\r\n * - Pitch/yaw limits, input speeds\r\n * - ZoomToPoint\r\n * - Conversion between lat/long/alt and cartesian coordinates\r\n */\r\nexport class GeospatialCamera extends Camera {\r\n    override inputs: GeospatialCameraInputsManager;\r\n\r\n    // Changed by the inputs, reset on every frame\r\n    /** @internal */\r\n    public _perFrameGeocentricTranslation: Vector3; // Translation that keeps camera at the same radius from the center of the globe\r\n    /** @internal */\r\n    public _perFrameGeocentricRotation: Vector3; // Rotation around center (distinct from rotation around camera that can cause looking off into space)\r\n    /** @internal */\r\n    public _perFrameZoom: number;\r\n\r\n    /** If supplied, will be used when picking the globe */\r\n    public pickPredicate?: MeshPredicate;\r\n\r\n    /**\r\n     * Enables rotation around a specific point, instead of default rotation around center\r\n     * @internal\r\n     */\r\n    public _alternateRotationPt: Nullable<Vector3>;\r\n\r\n    /** The point on the globe that we are anchoring around. If no alternate rotation point is supplied, this will represent the center of screen*/\r\n    public get center(): Vector3 {\r\n        // NOTE that for now we are falling back to target if no pick on globe (because that shouldn't happen with current implemented inputs)\r\n        // but eventually we want to return a point on the globe even if the camera is looking off into space\r\n        return this._pickAlongLook?.pickedPoint ?? this._target;\r\n    }\r\n\r\n    // Temp vars\r\n    private _tempGeocentricNormal: Vector3;\r\n    private _tempRotationAxis: Vector3;\r\n    private _tempRotationMatrix: Matrix;\r\n    private _tempPickingRay: Ray;\r\n    private _tempPosition: Vector3;\r\n\r\n    private _viewMatrix: Matrix;\r\n    private _isViewMatrixDirty: boolean;\r\n    private _lookAtVector: Vector3;\r\n\r\n    // Camera configuration vars\r\n    private _planetRadius: number;\r\n    private _minAltitude: number;\r\n    private _maxAltitude?: number;\r\n    private _maxCameraRadius?: number;\r\n    private _restingAltitude: number;\r\n\r\n    /** Target of camera when looking along lookAtVector from current position. This does not necessarily represent a point on the globe */\r\n    private get _target(): Vector3 {\r\n        return this.position.addToRef(this._lookAtVector, this._tempPosition);\r\n    }\r\n\r\n    /** The point around which the camera will geocentrically rotate. Uses center (pt we are anchored to) if no alternateRotationPt is defined */\r\n    private get _geocentricRotationPt(): Vector3 {\r\n        return this._alternateRotationPt ?? this.center;\r\n    }\r\n\r\n    constructor(name: string, scene: Scene, options: CameraOptions, pickPredicate?: MeshPredicate) {\r\n        super(name, Vector3.Zero(), scene);\r\n        this._resetToDefault(options);\r\n        this.pickPredicate = pickPredicate;\r\n        this.inputs = new GeospatialCameraInputsManager(this);\r\n        this.inputs.addMouse().addMouseWheel();\r\n    }\r\n\r\n    private _resetToDefault(options: CameraOptions): void {\r\n        // Camera configuration vars\r\n        this._minAltitude = options.minAltitude ?? 5;\r\n        this._maxAltitude = options.maxAltitude;\r\n        this._planetRadius = options.planetRadius;\r\n        this._maxCameraRadius = this._maxAltitude ? this._planetRadius + this._maxAltitude : undefined;\r\n        this._restingAltitude = options.restingAltitude ?? this._maxCameraRadius ?? this._planetRadius * 4;\r\n        this.position.copyFromFloats(0, 0, -this._restingAltitude);\r\n\r\n        // Input vars\r\n        this._perFrameGeocentricRotation = Vector3.Zero();\r\n        this._perFrameGeocentricTranslation = Vector3.Zero();\r\n        this._perFrameZoom = 0;\r\n\r\n        // Temp vars\r\n        this._tempPosition = Vector3.Zero();\r\n        this._tempRotationAxis = Vector3.Right(); // starting axis used to calculate pitch rotation matrix\r\n        this._tempRotationMatrix = Matrix.Identity();\r\n        this._tempGeocentricNormal = Vector3.Zero();\r\n        this._tempPickingRay = new Ray(this.position, this._lookAtVector);\r\n        this._tempPickingRay.direction = Vector3.Zero();\r\n\r\n        // View matrix calculation vars\r\n        this.upVector = Vector3.Up(); // Up vector of the camera\r\n        this._lookAtVector = this.position.negate().normalize(); // Lookat vector of the camera\r\n        this._viewMatrix = Matrix.Identity();\r\n        this._isViewMatrixDirty = true;\r\n    }\r\n\r\n    /** @internal */\r\n    override _getViewMatrix() {\r\n        if (!this._isViewMatrixDirty) {\r\n            return this._viewMatrix;\r\n        }\r\n        this._isViewMatrixDirty = false;\r\n\r\n        // Ensure vectors are normalized\r\n        this.upVector.normalize();\r\n        this._lookAtVector.normalize();\r\n\r\n        // Calculate view matrix with camera position and target\r\n        if (this.getScene().useRightHandedSystem) {\r\n            Matrix.LookAtRHToRef(this.position, this._target, this.upVector, this._viewMatrix);\r\n        } else {\r\n            Matrix.LookAtLHToRef(this.position, this._target, this.upVector, this._viewMatrix);\r\n        }\r\n\r\n        return this._viewMatrix;\r\n    }\r\n\r\n    /** @internal */\r\n    override _isSynchronizedViewMatrix(): boolean {\r\n        if (!super._isSynchronizedViewMatrix() || this._isViewMatrixDirty) {\r\n            return false;\r\n        }\r\n        return true;\r\n    }\r\n\r\n    /**\r\n     * Applies rotation correction to the camera by calculating a changeOfBasis matrix from the camera's current position to the new position\r\n     * and transforming the lookAt and up vectors by that matrix before updating the camera position and marking the view matrix as dirty\r\n     * @param newPos The camera's desired position, before correction is applied\r\n     */\r\n    private _applyRotationCorrectionAndSetPos(newPos: Vector3): void {\r\n        // Compute changeOfBasis between current camera position and new position\r\n        ComputeChangeOfBasisToRef(this.position, newPos, this._tempRotationMatrix);\r\n\r\n        // Apply rotation correction to lookat/up vectors\r\n        Vector3.TransformNormalToRef(this._lookAtVector, this._tempRotationMatrix, this._lookAtVector);\r\n        Vector3.TransformNormalToRef(this.upVector, this._tempRotationMatrix, this.upVector);\r\n\r\n        // Apply position change and mark viewMatrix as dirty\r\n        this.position.copyFrom(newPos);\r\n        this._isViewMatrixDirty = true;\r\n    }\r\n\r\n    /**\r\n     * When the geocentric normal has any translation change (due to dragging), we must ensure the camera remains orbiting around the world origin\r\n     * We thus need to perform 2 correction steps\r\n     * 1. Translation correction that keeps the camera at the same radius as before the drag\r\n     * 2. Rotation correction that keeps the camera facing the globe (so that as we pan, the globe stays centered on screen)\r\n     */\r\n    private _applyGeocentricTranslation() {\r\n        // Store pending position (without any corrections applied)\r\n        this.position.addToRef(this._perFrameGeocentricTranslation, this._tempPosition);\r\n\r\n        // 1. Calculate the altitude correction to keep camera at the same radius when applying translation\r\n        const tempPositionScaled = TmpVectors.Vector3[2];\r\n        const offset = TmpVectors.Vector3[3];\r\n        this._tempPosition.normalizeToRef(tempPositionScaled).scaleInPlace(this.position.length()); // what would tempPosition be if it were scaled to same radius as before\r\n        this._tempPosition.subtractToRef(tempPositionScaled, offset); // find offset between tempPosition and the tempScaledPosition\r\n        this._tempPosition.subtractInPlace(offset); // reduce tempPosition by that offset\r\n\r\n        // 2. Calculate the rotation correction to keep camera facing globe\r\n        this._applyRotationCorrectionAndSetPos(this._tempPosition);\r\n    }\r\n\r\n    /**\r\n     * This rotation keeps the camera oriented towards the globe as it orbits around it. This is different from cameraCentricRotation which is when the camera rotates around its own axis\r\n     */\r\n    private _applyGeocentricRotation(): void {\r\n        // Normalize key vectors\r\n        this._geocentricRotationPt.normalizeToRef(this._tempGeocentricNormal);\r\n        this.upVector.normalize();\r\n        this._lookAtVector.normalize();\r\n\r\n        const pitchRotationMatrix = Matrix.Identity();\r\n        const yawRotationMatrix = Matrix.Identity();\r\n        // First apply pitch\r\n        if (this._perFrameGeocentricRotation.x !== 0) {\r\n            // Compute a rotation axis that is perpendicular to both the upVector and the geocentricNormalOfPitchPoint\r\n            Vector3.CrossToRef(this.upVector, this._tempGeocentricNormal, this._tempRotationAxis);\r\n\r\n            // If upVector and geocentricNormalOfPitchPoint are parallel, fall back to cross(lookAtDirection, geocentricNormalOfPitchPoint)\r\n            if (this._tempRotationAxis.lengthSquared() <= Epsilon) {\r\n                Vector3.CrossToRef(this._lookAtVector, this._tempGeocentricNormal, this._tempRotationAxis);\r\n            }\r\n\r\n            const pitchSign = Math.sign(Vector3.Dot(this._tempGeocentricNormal, this.upVector)); // If negative, camera is upside down\r\n            // Since these are pointed in opposite directions, we must negate the dot product to get the proper angle\r\n            const currentPitch = pitchSign * Math.acos(Scalar.Clamp(-Vector3.Dot(this._lookAtVector, this._tempGeocentricNormal), -1, 1));\r\n            const newPitch = Scalar.Clamp(currentPitch + this._perFrameGeocentricRotation.x, 0, 0.5 * Math.PI - Epsilon);\r\n            // Build rotation matrix around normalized axis\r\n            Matrix.RotationAxisToRef(this._tempRotationAxis.normalize(), newPitch - currentPitch, pitchRotationMatrix);\r\n        }\r\n\r\n        // Then apply yaw\r\n        if (this._perFrameGeocentricRotation.y !== 0) {\r\n            Matrix.RotationAxisToRef(this._tempGeocentricNormal, this._perFrameGeocentricRotation.y, yawRotationMatrix); // this axis changes if we aren't using center of screen for tilt\r\n        }\r\n        pitchRotationMatrix.multiplyToRef(yawRotationMatrix, this._tempRotationMatrix);\r\n\r\n        // Offset camera to be (position-pitchPoint) distance from geocentricOrigin, apply rotation to position/up/lookat vectors, then add back the pitchPoint offset\r\n        this.position.subtractInPlace(this._geocentricRotationPt);\r\n\r\n        Vector3.TransformCoordinatesToRef(this.position, this._tempRotationMatrix, this.position);\r\n        Vector3.TransformNormalToRef(this.upVector, this._tempRotationMatrix, this.upVector);\r\n        Vector3.TransformNormalToRef(this._lookAtVector, this._tempRotationMatrix, this._lookAtVector);\r\n\r\n        this.position.addInPlace(this._geocentricRotationPt);\r\n    }\r\n\r\n    private _clampZoomDistance(requestedDistance: number, pickResultDistance: number | undefined): number {\r\n        // If pickResult is defined\r\n        if (requestedDistance > 0) {\r\n            if (pickResultDistance !== undefined) {\r\n                // If there is a pick, allow movement up to pick - minAltitude\r\n                if (pickResultDistance - this._minAltitude < 0) {\r\n                    return 0;\r\n                }\r\n                return Math.min(requestedDistance, pickResultDistance - this._minAltitude);\r\n            } else {\r\n                return requestedDistance;\r\n            }\r\n        }\r\n\r\n        if (requestedDistance < 0) {\r\n            const maxZoomOut = this._maxCameraRadius ? this._maxCameraRadius - this.position.length() : Number.POSITIVE_INFINITY;\r\n            return Math.max(requestedDistance, -maxZoomOut);\r\n        }\r\n        return 0;\r\n    }\r\n\r\n    private _applyZoom(distance: number) {\r\n        const pickResult = this._scene.pick(this._scene.pointerX, this._scene.pointerY, this.pickPredicate);\r\n        if (pickResult.hit && pickResult.ray) {\r\n            // Zoom to cursor\r\n            this._moveCameraAlongVectorByDistance(pickResult.ray.direction, this._clampZoomDistance(distance, pickResult.distance));\r\n        } else {\r\n            // If no hit under cursor, zoom along lookVector instead\r\n            this._moveCameraAlongVectorByDistance(this._lookAtVector, this._clampZoomDistance(distance, this._pickAlongLook?.distance));\r\n        }\r\n    }\r\n\r\n    private _moveCameraAlongVectorByDistance(vector: Vector3, distance: number) {\r\n        if (distance) {\r\n            vector.scaleAndAddToRef(distance, this._tempPosition);\r\n            this._applyRotationCorrectionAndSetPos(this._tempPosition);\r\n        }\r\n    }\r\n\r\n    private get _pickAlongLook() {\r\n        this._tempPickingRay.origin.copyFrom(this.position);\r\n        this._tempPickingRay.direction.copyFrom(this._lookAtVector);\r\n        return this._scene.pickWithRay(this._tempPickingRay, this.pickPredicate);\r\n    }\r\n\r\n    override _checkInputs(): void {\r\n        this.inputs.checkInputs();\r\n        if (this._perFrameGeocentricTranslation.lengthSquared() > 0) {\r\n            this._applyGeocentricTranslation();\r\n            this._perFrameGeocentricTranslation.setAll(0);\r\n            this._isViewMatrixDirty = true;\r\n        }\r\n        if (this._perFrameGeocentricRotation.lengthSquared() > 0) {\r\n            this._applyGeocentricRotation();\r\n            this._perFrameGeocentricRotation.setAll(0);\r\n            this._isViewMatrixDirty = true;\r\n        }\r\n        if (this._perFrameZoom !== 0) {\r\n            this._applyZoom(this._perFrameZoom);\r\n            this._perFrameZoom = 0;\r\n            this._isViewMatrixDirty = true;\r\n        }\r\n        super._checkInputs();\r\n    }\r\n\r\n    override attachControl(noPreventDefault?: boolean): void {\r\n        this.inputs.attachElement(noPreventDefault);\r\n    }\r\n\r\n    override detachControl(): void {\r\n        this.inputs.detachElement();\r\n    }\r\n}\r\n\r\n// Helper to build east/north/up basis vectors at a world position\r\nfunction ComputeLocalBasisToRefs(worldPos: Vector3, refEast: Vector3, refNorth: Vector3, refUp: Vector3) {\r\n    // up = normalized position (geocentric normal)\r\n    refUp.copyFrom(worldPos).normalize();\r\n\r\n    // east = normalize(up × worldUp)\r\n    // (cross product of up with world Y gives east except at poles)\r\n    const worldUp = Vector3.Up(); // (0,1,0)\r\n    Vector3.CrossToRef(refUp, worldUp, refEast);\r\n\r\n    // at poles, cross with worldForward instead\r\n    if (refEast.lengthSquared() < Epsilon) {\r\n        Vector3.CrossToRef(refUp, Vector3.Forward(), refEast);\r\n    }\r\n    refEast.normalize();\r\n\r\n    // north = up × east (completes right-handed basis)\r\n    Vector3.CrossToRef(refUp, refEast, refNorth);\r\n    refNorth.normalize();\r\n}\r\n\r\n/**\r\n * Calculates changeOfBasis matrix from currentPos to newPos and stores it in ref\r\n * @param currentPos\r\n * @param newPos\r\n * @param ref\r\n * @returns The changeOfBasis matrix from currentPos to newPos\r\n */\r\nfunction ComputeChangeOfBasisToRef(currentPos: Vector3, newPos: Vector3, ref: Matrix): Matrix {\r\n    const currentBasis = TmpVectors.Matrix[5];\r\n    const newBasis = TmpVectors.Matrix[6];\r\n    const inverse = TmpVectors.Matrix[7];\r\n    const east = TmpVectors.Vector3[3];\r\n    const north = TmpVectors.Vector3[4];\r\n    const up = TmpVectors.Vector3[5];\r\n\r\n    ComputeLocalBasisToRefs(currentPos, east, north, up);\r\n    Matrix.FromXYZAxesToRef(east, north, up, currentBasis);\r\n\r\n    ComputeLocalBasisToRefs(newPos, east, north, up);\r\n    Matrix.FromXYZAxesToRef(east, north, up, newBasis);\r\n\r\n    // Change of basis matrix = basis2 * basis1.inverse()\r\n    // (since orthonormal, inverse = transpose)\r\n    currentBasis.transposeToRef(inverse).multiplyToRef(newBasis, ref);\r\n\r\n    return ref;\r\n}\r\n"]}
+{"version":3,"file":"geospatialCamera.js","sourceRoot":"","sources":["../../../../dev/core/src/Cameras/geospatialCamera.ts"],"names":[],"mappings":"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","sourcesContent":["import { GeospatialCameraInputsManager } from \"./geospatialCameraInputsManager\";\r\nimport { Vector3, Matrix, TmpVectors } from \"../Maths/math.vector\";\r\nimport { Epsilon } from \"../Maths/math.constants\";\r\nimport { Camera } from \"./camera\";\r\nimport type { Scene } from \"../scene\";\r\nimport type { MeshPredicate } from \"../Culling/ray.core\";\r\nimport type { DeepImmutable } from \"../types\";\r\nimport { GeospatialLimits } from \"./Limits/geospatialLimits\";\r\nimport { ComputeLocalBasisToRefs, GeospatialCameraMovement } from \"./geospatialCameraMovement\";\r\nimport type { IVector3Like } from \"../Maths/math.like\";\r\nimport { Vector3CopyToRef, Vector3Dot } from \"../Maths/math.vector.functions\";\r\nimport { Clamp } from \"../Maths/math.scalar.functions\";\r\nimport type { AllowedAnimValue } from \"../Behaviors/Cameras/interpolatingBehavior\";\r\nimport { InterpolatingBehavior } from \"../Behaviors/Cameras/interpolatingBehavior\";\r\nimport type { EasingFunction } from \"../Animations/easing\";\r\n\r\ntype CameraOptions = {\r\n    planetRadius: number; // Radius of the planet\r\n};\r\n\r\n/**\r\n * @experimental\r\n * This camera's movements are limited to a camera orbiting a globe, and as the API evolves it will introduce conversions between cartesian coordinates and true lat/long/alt\r\n *\r\n * Please note this is marked as experimental and the API (including the constructor!) will change until we remove that flag\r\n */\r\nexport class GeospatialCamera extends Camera {\r\n    override inputs: GeospatialCameraInputsManager;\r\n\r\n    /** If supplied, will be used when picking the globe */\r\n    public pickPredicate?: MeshPredicate;\r\n\r\n    /** Movement controller that turns input pixelDeltas into currentFrameDeltas used by camera*/\r\n    public readonly movement: GeospatialCameraMovement;\r\n\r\n    // Temp vars\r\n    private _tempPosition: Vector3 = new Vector3();\r\n\r\n    private _viewMatrix = new Matrix();\r\n    private _isViewMatrixDirty: boolean;\r\n    private _lookAtVector: Vector3 = new Vector3();\r\n\r\n    /** Behavior used for smooth flying animations */\r\n    private _flyingBehavior: InterpolatingBehavior<GeospatialCamera>;\r\n    private _flyToTargets: Map<keyof GeospatialCamera, AllowedAnimValue> = new Map();\r\n\r\n    constructor(name: string, scene: Scene, options: CameraOptions, pickPredicate?: MeshPredicate) {\r\n        super(name, new Vector3(), scene);\r\n\r\n        this._limits = new GeospatialLimits(options.planetRadius);\r\n        this._resetToDefault(this._limits);\r\n\r\n        this._flyingBehavior = new InterpolatingBehavior();\r\n        this.addBehavior(this._flyingBehavior);\r\n\r\n        this.movement = new GeospatialCameraMovement(scene, this._limits, this.position, this.center, this._lookAtVector, pickPredicate);\r\n\r\n        this.pickPredicate = pickPredicate;\r\n        this.inputs = new GeospatialCameraInputsManager(this);\r\n        this.inputs.addMouse().addMouseWheel().addKeyboard();\r\n    }\r\n\r\n    private _center: Vector3 = new Vector3();\r\n    /** The point on the globe that we are anchoring around. If no alternate rotation point is supplied, this will represent the center of screen*/\r\n    public get center(): Vector3 {\r\n        return this._center;\r\n    }\r\n\r\n    /**\r\n     * Sets the camera position to orbit around a new center point\r\n     * @param center The world position (ECEF) to orbit around\r\n     */\r\n    public set center(center: IVector3Like) {\r\n        this._center.copyFromFloats(center.x, center.y, center.z);\r\n        this._setOrientation(this._yaw, this._pitch, this._radius, this._center);\r\n    }\r\n\r\n    private _yaw: number = 0;\r\n    /**\r\n     * Gets the camera's yaw (rotation around the geocentric normal) in radians\r\n     */\r\n    public get yaw(): number {\r\n        return this._yaw;\r\n    }\r\n\r\n    /**\r\n     * Sets the camera's yaw (rotation around the geocentric normal)\r\n     * @param yaw The desired yaw angle in radians (0 = north, π/2 = east)\r\n     */\r\n    public set yaw(yaw: number) {\r\n        this._setOrientation(yaw, this.pitch, this.radius, this.center);\r\n    }\r\n\r\n    private _pitch: number = 0;\r\n\r\n    /**\r\n     * Gets the camera's pitch (angle from looking straight at globe)\r\n     * Pitch is measured from looking straight down at planet center:\r\n     * - zero pitch = looking straight at planet center (down)\r\n     * - positive pitch = tilting up away from planet\r\n     * - π/2 pitch = looking at horizon (perpendicular to geocentric normal)\r\n     */\r\n    public get pitch(): number {\r\n        return this._pitch;\r\n    }\r\n\r\n    /**\r\n     * Sets the camera's pitch (angle from looking straight at globe)\r\n     * @param pitch The desired pitch angle in radians (0 = looking at planet center, π/2 = looking at horizon)\r\n     */\r\n    public set pitch(pitch: number) {\r\n        this._setOrientation(this.yaw, pitch, this.radius, this.center);\r\n    }\r\n\r\n    private _radius: number = 0;\r\n    public get radius(): number {\r\n        return this._radius;\r\n    }\r\n\r\n    /**\r\n     * Sets the camera's distance from the current center point\r\n     * @param radius The desired radius\r\n     */\r\n    public set radius(radius: number) {\r\n        this._setOrientation(this.yaw, this.pitch, radius, this.center);\r\n    }\r\n\r\n    protected _checkLimits() {\r\n        const limits = this.limits;\r\n        this._yaw = Clamp(this._yaw, limits.yawMin, limits.yawMax);\r\n        this._pitch = Clamp(this._pitch, limits.pitchMin, limits.pitchMax);\r\n        this._radius = Clamp(this._radius, limits.radiusMin, limits.radiusMax);\r\n    }\r\n\r\n    private _tempVect = new Vector3();\r\n    private _tempEast = new Vector3();\r\n    private _tempNorth = new Vector3();\r\n    private _tempUp = new Vector3();\r\n\r\n    private _setOrientation(yaw: number, pitch: number, radius: number, center: DeepImmutable<IVector3Like>): void {\r\n        this._yaw = yaw;\r\n        this._pitch = pitch;\r\n        this._radius = radius;\r\n\r\n        Vector3CopyToRef(center, this._center);\r\n\r\n        // Clamp to limits\r\n        this._checkLimits();\r\n\r\n        // Refresh local basis at center (treat these as read-only for the whole call)\r\n        ComputeLocalBasisToRefs(this._center, this._tempEast, this._tempNorth, this._tempUp);\r\n\r\n        // Trig\r\n        const yawScale = this._scene.useRightHandedSystem ? 1 : -1;\r\n        const cosYaw = Math.cos(this._yaw * yawScale);\r\n        const sinYaw = Math.sin(this._yaw * yawScale);\r\n        const sinPitch = Math.sin(this._pitch); // horizontal weight\r\n        const cosPitch = Math.cos(this._pitch); // vertical weight (toward center)\r\n\r\n        // Temps\r\n        const horiz = TmpVectors.Vector3[0];\r\n        const t1 = TmpVectors.Vector3[1];\r\n        const t2 = TmpVectors.Vector3[2];\r\n        const right = TmpVectors.Vector3[3];\r\n\r\n        // horizontalDirection = North*cosYaw + East*sinYaw  (avoids mutating _temp basis vectors)\r\n        horiz.copyFrom(this._tempNorth).scaleInPlace(cosYaw).addInPlace(t1.copyFrom(this._tempEast).scaleInPlace(sinYaw));\r\n\r\n        // look = horiz*sinPitch - Up*cosPitch\r\n        this._lookAtVector.copyFrom(horiz).scaleInPlace(sinPitch).addInPlace(t2.copyFrom(this._tempUp).scaleInPlace(-cosPitch)).normalize(); // keep it unit\r\n\r\n        // Build an orthonormal up aligned with geocentric Up\r\n        // right = normalize(cross(upRef, look))\r\n        Vector3.CrossToRef(this._tempUp, this._lookAtVector, right);\r\n\r\n        // up = normalize(cross(look, right))\r\n        Vector3.CrossToRef(this._lookAtVector, right, this.upVector);\r\n\r\n        // Position = center - look * radius  (preserve unit look)\r\n        this._tempVect.copyFrom(this._lookAtVector).scaleInPlace(-this._radius);\r\n        this._tempPosition.copyFrom(this._center).addInPlace(this._tempVect);\r\n\r\n        this._position.copyFrom(this._tempPosition);\r\n\r\n        this._isViewMatrixDirty = true;\r\n    }\r\n\r\n    /** The point around which the camera will geocentrically rotate. Uses center (pt we are anchored to) if no alternateRotationPt is defined */\r\n    private get _geocentricRotationPt(): Vector3 {\r\n        return this.movement.alternateRotationPt ?? this.center;\r\n    }\r\n\r\n    /**\r\n     * If camera is actively in flight, will update the target properties and use up the remaining duration from original flyTo call\r\n     *\r\n     * To start a new flyTo curve entirely, call into flyToAsync again (it will stop the inflight animation)\r\n     * @param targetYaw\r\n     * @param targetPitch\r\n     * @param targetRadius\r\n     * @param targetCenter\r\n     */\r\n    public updateFlyToDestination(targetYaw?: number, targetPitch?: number, targetRadius?: number, targetCenter?: Vector3): void {\r\n        this._flyToTargets.clear();\r\n\r\n        this._flyToTargets.set(\"yaw\", targetYaw);\r\n        this._flyToTargets.set(\"pitch\", targetPitch);\r\n        this._flyToTargets.set(\"radius\", targetRadius);\r\n        this._flyToTargets.set(\"center\", targetCenter);\r\n\r\n        this._flyingBehavior.updateProperties(this._flyToTargets);\r\n    }\r\n\r\n    /**\r\n     * Animate camera towards passed in property values. If undefined, will use current value\r\n     * @param targetYaw\r\n     * @param targetPitch\r\n     * @param targetRadius\r\n     * @param targetCenter\r\n     * @param flightDurationMs\r\n     * @param easingFunction\r\n     * @returns Promise that will return when the animation is complete (or interuppted by pointer input)\r\n     */\r\n    public async flyToAsync(\r\n        targetYaw?: number,\r\n        targetPitch?: number,\r\n        targetRadius?: number,\r\n        targetCenter?: Vector3,\r\n        flightDurationMs: number = 1000,\r\n        easingFunction?: EasingFunction\r\n    ): Promise<void> {\r\n        this._flyToTargets.clear();\r\n\r\n        this._flyToTargets.set(\"yaw\", targetYaw);\r\n        this._flyToTargets.set(\"pitch\", targetPitch);\r\n        this._flyToTargets.set(\"radius\", targetRadius);\r\n        this._flyToTargets.set(\"center\", targetCenter);\r\n\r\n        return await this._flyingBehavior.animatePropertiesAsync(this._flyToTargets, flightDurationMs, easingFunction);\r\n    }\r\n\r\n    private _limits: GeospatialLimits;\r\n    public get limits(): GeospatialLimits {\r\n        return this._limits;\r\n    }\r\n\r\n    private _resetToDefault(limits: GeospatialLimits): void {\r\n        // Camera configuration vars\r\n        const maxCameraRadius = limits.altitudeMax !== undefined ? limits.planetRadius + limits.altitudeMax : undefined;\r\n        const restingAltitude = maxCameraRadius ?? limits.planetRadius * 4;\r\n        this.position.copyFromFloats(restingAltitude, 0, 0);\r\n        this._center.copyFromFloats(limits.planetRadius, 0, 0);\r\n        this._radius = Vector3.Distance(this.position, this.center);\r\n\r\n        // Temp vars\r\n        this._tempPosition = new Vector3();\r\n\r\n        // View matrix calculation vars\r\n        this._viewMatrix = Matrix.Identity();\r\n        this._center.subtractToRef(this._position, this._lookAtVector).normalize(); // Lookat vector of the camera\r\n        this.upVector = Vector3.Up(); // Up vector of the camera (does work for -X look at)\r\n        this._isViewMatrixDirty = true;\r\n\r\n        this._setOrientation(this._yaw, this._pitch, this._radius, this._center);\r\n    }\r\n\r\n    /** @internal */\r\n    override _getViewMatrix() {\r\n        if (!this._isViewMatrixDirty) {\r\n            return this._viewMatrix;\r\n        }\r\n        this._isViewMatrixDirty = false;\r\n\r\n        // Ensure vectors are normalized\r\n        this.upVector.normalize();\r\n        this._lookAtVector.normalize();\r\n\r\n        // Calculate view matrix with camera position and center\r\n        if (this.getScene().useRightHandedSystem) {\r\n            Matrix.LookAtRHToRef(this.position, this._center, this.upVector, this._viewMatrix);\r\n        } else {\r\n            Matrix.LookAtLHToRef(this.position, this._center, this.upVector, this._viewMatrix);\r\n        }\r\n\r\n        return this._viewMatrix;\r\n    }\r\n\r\n    /** @internal */\r\n    override _isSynchronizedViewMatrix(): boolean {\r\n        if (!super._isSynchronizedViewMatrix() || this._isViewMatrixDirty) {\r\n            return false;\r\n        }\r\n        return true;\r\n    }\r\n\r\n    private _applyGeocentricTranslation() {\r\n        // Store pending position (without any corrections applied)\r\n        this.center.addToRef(this.movement.panDeltaCurrentFrame, this._tempPosition);\r\n\r\n        if (!this.movement.isInterpolating) {\r\n            // Calculate the position correction to keep camera at the same radius when applying translation\r\n            this._tempPosition.normalize().scaleInPlace(this.center.length());\r\n        }\r\n        // Set center which will call _setOrientation\r\n        this.center = this._tempPosition;\r\n    }\r\n\r\n    /**\r\n     * This rotation keeps the camera oriented towards the globe as it orbits around it. This is different from cameraCentricRotation which is when the camera rotates around its own axis\r\n     */\r\n    private _applyGeocentricRotation(): void {\r\n        const rotationDeltaCurrentFrame = this.movement.rotationDeltaCurrentFrame;\r\n        if (rotationDeltaCurrentFrame.x !== 0 || rotationDeltaCurrentFrame.y !== 0) {\r\n            const pitch = rotationDeltaCurrentFrame.x !== 0 ? Clamp(this._pitch + rotationDeltaCurrentFrame.x, 0, 0.5 * Math.PI - Epsilon) : this._pitch;\r\n            const yaw = rotationDeltaCurrentFrame.y !== 0 ? this._yaw + rotationDeltaCurrentFrame.y : this._yaw;\r\n\r\n            // TODO: If _geocentricRotationPt is not the center, this will need to be adjusted.\r\n            this._setOrientation(yaw, pitch, this._radius, this._geocentricRotationPt);\r\n        }\r\n    }\r\n\r\n    private _applyZoom(zoomVector: Vector3, distance: number) {\r\n        // TODO this function will be re-worked shortly after checkin, becuase today it breaks down if you zoom to a point past the center\r\n        // (ex: tilted view zooming towards cursor near horizon where the center is closer than the cursor point).\r\n\r\n        // Project zoom vector onto lookAt vector to find the amount the camera-to-center distance should change.\r\n        // - zoom vector is normalized\r\n        // - distance is how much to move in this call\r\n        const directionDotLookAt = Vector3Dot(zoomVector, this._lookAtVector);\r\n        const hasRadialComponent = Math.abs(directionDotLookAt) > Epsilon;\r\n        const requestedRadius = hasRadialComponent ? this._radius - distance * directionDotLookAt : this._radius;\r\n        const newRadius = Clamp(requestedRadius, this.limits.radiusMin, this.limits.radiusMax);\r\n        const actualRadiusChange = newRadius - this._radius;\r\n        const actualDistanceChange = hasRadialComponent ? actualRadiusChange / directionDotLookAt : 0;\r\n\r\n        // Use this to compute new camera position and new center position.\r\n        const newCameraPosition = this._position.add(zoomVector.scale(-actualDistanceChange));\r\n        const newCenter = newCameraPosition.add(this._lookAtVector.scaleToRef(newRadius, TmpVectors.Vector3[3]));\r\n\r\n        // Rescale new center to maintain same altitude as the old center.\r\n        const currentCenterRadius = this._center.length();\r\n        const newCenterRadius = newCenter.length();\r\n        const newCenterRescale = currentCenterRadius / newCenterRadius;\r\n        newCenter.scaleInPlace(newCenterRescale);\r\n\r\n        // Apply changes\r\n        this._setOrientation(this._yaw, this._pitch, newRadius, newCenter);\r\n    }\r\n\r\n    override _checkInputs(): void {\r\n        this.inputs.checkInputs();\r\n\r\n        // Let movement class handle all per-frame logic\r\n        this.movement.computeCurrentFrameDeltas();\r\n\r\n        if (this.movement.panDeltaCurrentFrame.lengthSquared() > 0) {\r\n            this._applyGeocentricTranslation();\r\n            this._isViewMatrixDirty = true;\r\n        }\r\n        if (this.movement.rotationDeltaCurrentFrame.lengthSquared() > 0) {\r\n            this._applyGeocentricRotation();\r\n            this._isViewMatrixDirty = true;\r\n        }\r\n\r\n        if (Math.abs(this.movement.zoomDeltaCurrentFrame) > Epsilon) {\r\n            this._applyZoom(this.movement.computedPerFrameZoomVector, this.movement.zoomDeltaCurrentFrame);\r\n            this._isViewMatrixDirty = true;\r\n        }\r\n\r\n        super._checkInputs();\r\n    }\r\n\r\n    override attachControl(noPreventDefault?: boolean): void {\r\n        this.inputs.attachElement(noPreventDefault);\r\n    }\r\n\r\n    override detachControl(): void {\r\n        this.inputs.detachElement();\r\n    }\r\n}\r\n"]}

package/Cameras/geospatialCameraInputsManager.d.ts

@@ -20,4 +20,9 @@ export declare class GeospatialCameraInputsManager extends CameraInputsManager<G
      * @returns the current input manager
      */
     addMouseWheel(): GeospatialCameraInputsManager;
+    /**
+     * Add mouse wheel input support to the input manager
+     * @returns the current input manager
+     */
+    addKeyboard(): GeospatialCameraInputsManager;
 }

package/Cameras/geospatialCameraInputsManager.js

@@ -1,6 +1,7 @@
 import { CameraInputsManager } from "./cameraInputsManager.js";
 import { GeospatialCameraPointersInput } from "./Inputs/geospatialCameraPointersInput.js";
 import { GeospatialCameraMouseWheelInput } from "./Inputs/geospatialCameraMouseWheelInput.js";
+import { GeospatialCameraKeyboardInput } from "./Inputs/geospatialCameraKeyboardInput.js";
 /**
  * Default Inputs manager for the GeospatialCamera.
  * It groups all the default supported inputs for ease of use.
@@ -29,5 +30,13 @@ export class GeospatialCameraInputsManager extends CameraInputsManager {
         this.add(new GeospatialCameraMouseWheelInput());
         return this;
     }
+    /**
+     * Add mouse wheel input support to the input manager
+     * @returns the current input manager
+     */
+    addKeyboard() {
+        this.add(new GeospatialCameraKeyboardInput());
+        return this;
+    }
 }
 //# sourceMappingURL=geospatialCameraInputsManager.js.map