mirror of
https://github.com/bilawalsidhu/gods-eye-view.git
synced 2026-11-17 00:32:21 +00:00
129 lines
4.5 KiB
JavaScript
129 lines
4.5 KiB
JavaScript
/**
|
|
* One-click camera transfer for layer-owned world targets.
|
|
*/
|
|
import { WGS84, eastNorthUp, framePoint, toRadians } from './geo/index.js';
|
|
import { findCamera } from './render/rendererOf.js';
|
|
import {
|
|
keptViewFrom,
|
|
SELECTION_FOLLOW_TRANSITION_S,
|
|
} from './data/trackedCamera.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 }),
|
|
sighting: Object.freeze({ radiusM: 250, rangeM: 2500, pitchDeg: -40 }),
|
|
// A stopped train's one fly-to, and the frame a moving train is followed
|
|
// in (src/layers/rail/follow.js): the train and the track either side.
|
|
train: Object.freeze({ radiusM: 200, rangeM: 2500, pitchDeg: -35 }),
|
|
'sighting-area': Object.freeze({
|
|
radiusM: 11000,
|
|
rangeM: 60000,
|
|
pitchDeg: -55,
|
|
}),
|
|
});
|
|
|
|
/** 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;
|
|
// These 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 = Math.hypot(position.x, position.y, position.z);
|
|
return Number.isFinite(magnitude) && magnitude >= WGS84.radii.z * 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. A target with
|
|
* `keepView` (a click on it) keeps the camera's distance and angle: the eye
|
|
* moves, on a straight path, to where it sees the target in the centre with
|
|
* the view it has now (`keptViewFrom`). Any other is framed by its kind
|
|
* (`WORLD_FOCUS_FRAMING`).
|
|
*/
|
|
export function flyToWorldTarget(viewer, target = {}) {
|
|
const camera = findCamera(viewer);
|
|
const framing = WORLD_FOCUS_FRAMING[target.kind];
|
|
if (!camera || !framing || !isValidWorldFocusTarget(target)) return false;
|
|
const pose = camera.pose();
|
|
const kept = target.keepView ? keptViewFrom(pose, target.position) : null;
|
|
camera.cancelFlight();
|
|
if (kept) {
|
|
camera.flyTo(framePoint(eastNorthUp(target.position), kept), {
|
|
orientation: { direction: pose.direction, up: pose.up },
|
|
durationS:
|
|
target.durationSec > 0
|
|
? target.durationSec
|
|
: SELECTION_FOLLOW_TRANSITION_S,
|
|
easing: 'cubicInOut',
|
|
// Below both ends: no arc, so the camera does not climb on the way.
|
|
maxHeight: 0,
|
|
});
|
|
return true;
|
|
}
|
|
const heading = Number.isFinite(pose.heading) ? pose.heading : 0;
|
|
const duration =
|
|
target.durationSec > 0
|
|
? target.durationSec
|
|
: WORLD_CLICK_FOCUS_DURATION_SEC;
|
|
camera.flyToBounds(
|
|
{ center: target.position, radius: framing.radiusM },
|
|
{
|
|
offset: {
|
|
heading,
|
|
pitch: toRadians(framing.pitchDeg),
|
|
range: framing.rangeM,
|
|
},
|
|
durationS: duration,
|
|
easing: 'cubicInOut',
|
|
},
|
|
);
|
|
return true;
|
|
}
|