mirror of
https://github.com/bilawalsidhu/gods-eye-view.git
synced 2026-11-16 16:22:20 +00:00
The startup fly-in, orbit, world-target focus, the arrival ground guard, arrival ownership, camera sensitivity claims, landmark/viewport/globe flights and place search (with its view bias and near-view recovery) take the globe engine. Callers that still hold a viewer (voice, layers until phase 1c) reach the same engine through engineFromViewer, and arrival ownership is keyed by the engine whichever one a caller names. The ground guard yields on camera.commanded instead of patching the viewer camera itself; on Cesium that event hooks the same command methods and tracking changes, so direct Cesium callers still end it. Landmark framing reads the frustum fov from the pose's fovy and aspectRatio. Tests that built viewer doubles now run on the fake engine (or on the Cesium engine over the same double), with the same expectations.
100 lines
3.0 KiB
JavaScript
100 lines
3.0 KiB
JavaScript
import * as geo from './geo/index.js';
|
|
import { engineFromViewer } from './globe/cesium/engineFromViewer.js';
|
|
import {
|
|
holdContinuousRender,
|
|
releaseContinuousRender,
|
|
} from './renderGovernor.js';
|
|
|
|
/**
|
|
* OrbitController — smooth orbit around a target point.
|
|
* Uses the engine's preRender frames for frame-rate-independent updates.
|
|
* Toggle with O key; auto-stops on POI/city change.
|
|
*/
|
|
export class OrbitController {
|
|
/**
|
|
* @param {import('./globe/contract.js').GlobeEngine | object} engine The
|
|
* globe engine, or a viewer registered for one.
|
|
*/
|
|
constructor(engine) {
|
|
this.engine = engineFromViewer(engine);
|
|
this.active = false;
|
|
this.target = null;
|
|
this.radius = 500;
|
|
this.pitch = -30;
|
|
this.speed = geo.math.toRadians(6); // ~6°/sec → full rotation in ~60s
|
|
this.angle = 0;
|
|
this._removeListener = null;
|
|
}
|
|
|
|
/**
|
|
* Start orbiting around a target position.
|
|
* @param {{x: number, y: number, z: number}} targetCartesian - The point to orbit around
|
|
* @param {object} options
|
|
* @param {number} options.radius - Distance from target in meters
|
|
* @param {number} options.pitch - Tilt angle in degrees (negative = looking down)
|
|
* @param {number} options.speed - Degrees per second (default 6)
|
|
*/
|
|
start(targetCartesian, options = {}) {
|
|
if (!targetCartesian || !this.engine) return;
|
|
const { camera, frames } = this.engine;
|
|
|
|
this.target = targetCartesian;
|
|
this.radius = options.radius || this.radius;
|
|
this.pitch = options.pitch || this.pitch;
|
|
this.speed = geo.math.toRadians(options.speed || 6);
|
|
this.active = true;
|
|
// Orbit mutates the camera from preRender — without a hold the loop
|
|
// starves after its first idle frame. (perf wave 2)
|
|
holdContinuousRender('camera-orbit');
|
|
|
|
// Start from the camera's current heading for seamless transition
|
|
this.angle = camera.pose().heading;
|
|
|
|
let lastTime = Date.now();
|
|
this._removeListener = frames.preRender.addEventListener(() => {
|
|
if (!this.active) return;
|
|
|
|
const now = Date.now();
|
|
const dt = (now - lastTime) / 1000;
|
|
lastTime = now;
|
|
|
|
this.angle += this.speed * dt;
|
|
|
|
camera.lookAt(this.target, {
|
|
heading: this.angle,
|
|
pitch: geo.math.toRadians(this.pitch),
|
|
range: this.radius,
|
|
});
|
|
});
|
|
}
|
|
|
|
/**
|
|
* Stop orbiting. Camera freezes at current position and user regains control.
|
|
*/
|
|
stop() {
|
|
this.active = false;
|
|
releaseContinuousRender('camera-orbit');
|
|
if (this._removeListener) {
|
|
this._removeListener();
|
|
this._removeListener = null;
|
|
}
|
|
// Unlock camera for free interaction
|
|
this.engine?.camera.release();
|
|
}
|
|
|
|
/**
|
|
* Toggle orbit on/off.
|
|
* @param {{x: number, y: number, z: number}} targetCartesian - Required when starting
|
|
* @param {object} options - Passed to start()
|
|
* @returns {boolean} Whether orbit is now active
|
|
*/
|
|
toggle(targetCartesian, options) {
|
|
if (this.active) {
|
|
this.stop();
|
|
} else {
|
|
this.start(targetCartesian, options);
|
|
}
|
|
return this.active;
|
|
}
|
|
}
|