import { toRadians } from './geo/index.js'; import { cameraOf, findCamera, frameOf } from './render/rendererOf.js'; import { holdContinuousRender, releaseContinuousRender, } from './renderGovernor.js'; /** * OrbitController — smooth orbit around a target point. * Uses the frame port's preRender for frame-rate-independent 60fps updates. * Toggle with O key; auto-stops on POI/city change. */ export class OrbitController { constructor(viewer) { this.viewer = viewer; this.active = false; this.target = null; this.radius = 500; this.pitch = -30; this.speed = 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, ECEF metres * @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) return; // Asked for each frame, not kept: a renderer bound meanwhile replaces // the port. const pose = cameraOf(this.viewer).pose(); this.target = targetCartesian; this.radius = options.radius || this.radius; this.pitch = options.pitch || this.pitch; this.speed = 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 = pose.heading; let lastTime = Date.now(); this._removeListener = frameOf(this.viewer).on('preRender', () => { if (!this.active) return; const now = Date.now(); const dt = (now - lastTime) / 1000; lastTime = now; this.angle += this.speed * dt; cameraOf(this.viewer).lookAt(this.target, { heading: this.angle, pitch: 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 findCamera(this.viewer)?.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; } }