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.
101 lines
3.4 KiB
JavaScript
101 lines
3.4 KiB
JavaScript
/**
|
|
* One-click camera transfer for layer-owned world targets.
|
|
*/
|
|
import * as geo from './geo/index.js';
|
|
import { engineFromViewer } from './globe/cesium/engineFromViewer.js';
|
|
|
|
export const WORLD_FOCUS_REQUEST_EVENT = 'gev:world-request-focus';
|
|
export const WORLD_CLICK_FOCUS_DURATION_SEC = 1.9;
|
|
|
|
export const WORLD_FOCUS_FRAMING = Object.freeze({
|
|
vessel: Object.freeze({ radiusM: 150, rangeM: 1200, pitchDeg: -30 }),
|
|
fire: Object.freeze({ radiusM: 400, rangeM: 3000, pitchDeg: -35 }),
|
|
});
|
|
|
|
/** Validate a layer-owned focus target before camera policy can release tracking. */
|
|
export function isValidWorldFocusTarget(detail) {
|
|
if (!detail || !WORLD_FOCUS_FRAMING[detail.kind]) return false;
|
|
if (!String(detail.id || '').trim()) return false;
|
|
const { position } = detail;
|
|
if (
|
|
!position ||
|
|
!Number.isFinite(position.x) ||
|
|
!Number.isFinite(position.y) ||
|
|
!Number.isFinite(position.z)
|
|
)
|
|
return false;
|
|
// Vessel and fire targets are surface-anchored Earth positions. Merely
|
|
// finite coordinates near the ECEF origin cannot be flown to, and must be
|
|
// rejected before the camera policy releases a current follow owner.
|
|
const magnitude = geo.cartesian3.magnitude(position);
|
|
return (
|
|
Number.isFinite(magnitude) &&
|
|
magnitude >= geo.ellipsoid.WGS84.minimumRadius * 0.95
|
|
);
|
|
}
|
|
|
|
/** Announce a valid user-click focus request. */
|
|
export function requestWorldFocus(detail, eventTarget = globalThis.window) {
|
|
if (!isValidWorldFocusTarget(detail)) return false;
|
|
if (typeof eventTarget?.dispatchEvent !== 'function') return false;
|
|
eventTarget.dispatchEvent(
|
|
new CustomEvent(WORLD_FOCUS_REQUEST_EVENT, { detail }),
|
|
);
|
|
return true;
|
|
}
|
|
|
|
/** Register one listener and return an idempotent disposer. */
|
|
export function registerWorldFocusRequestListener(eventTarget, listener) {
|
|
if (
|
|
!eventTarget?.addEventListener ||
|
|
!eventTarget?.removeEventListener ||
|
|
typeof listener !== 'function'
|
|
)
|
|
return () => {};
|
|
eventTarget.addEventListener(WORLD_FOCUS_REQUEST_EVENT, listener);
|
|
let disposed = false;
|
|
return () => {
|
|
if (disposed) return;
|
|
disposed = true;
|
|
eventTarget.removeEventListener(WORLD_FOCUS_REQUEST_EVENT, listener);
|
|
};
|
|
}
|
|
|
|
/** Route a valid request through the UI-owned camera policy. */
|
|
export function routeWorldFocusRequest(event, runExplicitFocus, fly) {
|
|
const detail = event?.detail;
|
|
if (!isValidWorldFocusTarget(detail)) return false;
|
|
if (typeof runExplicitFocus !== 'function' || typeof fly !== 'function')
|
|
return false;
|
|
return runExplicitFocus(detail, () => fly(detail));
|
|
}
|
|
|
|
/**
|
|
* Fly to a world target after ownership has been released.
|
|
* @param {import('./globe/contract.js').GlobeEngine | object | null} engine
|
|
* The globe engine, or a viewer registered for one.
|
|
*/
|
|
export function flyToWorldTarget(engine, target = {}) {
|
|
const camera = engineFromViewer(engine)?.camera;
|
|
const framing = WORLD_FOCUS_FRAMING[target.kind];
|
|
if (!camera || !framing || !isValidWorldFocusTarget(target)) return false;
|
|
const { heading: current } = camera.pose();
|
|
const heading = Number.isFinite(current) ? current : 0;
|
|
const duration =
|
|
target.durationSec > 0
|
|
? target.durationSec
|
|
: WORLD_CLICK_FOCUS_DURATION_SEC;
|
|
camera.cancelFlight();
|
|
camera.flyToSphere(
|
|
{ center: target.position, radius: framing.radiusM },
|
|
{
|
|
heading,
|
|
pitch: geo.math.toRadians(framing.pitchDeg),
|
|
range: framing.rangeM,
|
|
duration,
|
|
easing: 'cubicInOut',
|
|
},
|
|
);
|
|
return true;
|
|
}
|