Files
gods-eye-view/src/globe/cesium/engineFromViewer.js
T
German Khokhlov 12c9651a67 refactor(overlays): hand the shell's overlay host the engine, not the viewer
The controls pass the scene engine to the shell, which initializes the
world overlay on it; initWorldOverlay takes only a globe engine (a viewer
or null is refused), so the shell no longer needs a viewer for its
overlay. engineFromViewer only returns the engine registered for a viewer
(the scene engine until teardown) and never builds one, so no engine can
outlive its viewer without a destroy path. Overlay and detection tests
and the allocation worker build a Cesium engine on their mock viewers and
destroy it with them; frame allocation is unchanged.
2026-10-15 18:53:57 +04:00

33 lines
1.1 KiB
JavaScript

// The bridge for shell callers that still hold only a Cesium viewer (layers
// until phase 1c): the engine registered for that viewer. The app registers
// its scene engine (src/app/globeEngine.js) and unregisters it before
// destroying it. Nothing is ever built here, so no engine can outlive its
// viewer without a destroy path: an unregistered or torn-down viewer has none.
import { isGlobeEngine } from '../contract.js';
const engines = new WeakMap();
/**
* Make `engine` the one returned for `viewer`.
* @returns {() => void} Unregister (only while it is still the registered one).
*/
export function registerViewerEngine(viewer, engine) {
engines.set(viewer, engine);
return () => {
if (engines.get(viewer) === engine) engines.delete(viewer);
};
}
/**
* @param {object | null | undefined} viewer A Cesium viewer, or an engine
* (returned as is).
* @returns {import('../contract.js').GlobeEngine | null} The registered
* engine, or null.
*/
export function engineFromViewer(viewer) {
if (viewer == null) return null;
if (isGlobeEngine(viewer)) return viewer;
return engines.get(viewer) ?? null;
}