feat(globe): engine members and the viewer bridge for the shell

Contract: camera.position(result?) and camera.height() for per-frame
readers, render.request(reason?), maps.releasePhotorealTiles, sources
with a caller-owned ready provider, isGlobeEngine. engine.maps now hides
every tileset it has shown, lets the last imagery/photoreal call win, and
setPhotorealTiles(null) restores the last base imagery and its credit
instead of leaving the photoreal credit on a bare globe.

Cesium engine: reads the Viewer camera/canvas aliases, detaches bridged
events through the remover Cesium returns, raises frame timestamps
without allocating, re-aims the horizon occluder only when the camera
moved, and renders the scene directly when the governor governs another
viewer (or none yet). engineFromViewer returns the registered scene
engine of a viewer, else builds and caches one. The render governor stays
the Cesium render backend under engine.render and gains
isRenderGovernorInstalled.
This commit is contained in:
German Khokhlov committed 2026-10-15 18:18:19 +04:00
1 parent a5c98c6b07
commit 58a196374f
26 files changed
+657 -45

No files matched your search

@@ -0,0 +1,46 @@
import test from 'node:test';
import assert from 'node:assert/strict';
import { isGlobeEngine } from '../contract.js';
import { createFakeEngine } from '../testing/fakeEngine.js';
import { engineFromViewer, registerViewerEngine } from './engineFromViewer.js';
import { createFakeViewer } from './testing/fakeViewer.mjs';
test('a viewer without a registered engine gets one built once and cached', () => {
const viewer = createFakeViewer();
const engine = engineFromViewer(viewer);
assert.equal(isGlobeEngine(engine), true);
assert.equal(engine.kind, 'cesium');
assert.equal(engineFromViewer(viewer), engine);
assert.deepEqual(viewer.calls, [], 'building it changes nothing');
assert.notEqual(engineFromViewer(createFakeViewer()), engine);
});
test('the engine registered for a viewer is the one returned', () => {
const viewer = createFakeViewer();
const engine = createFakeEngine();
const unregister = registerViewerEngine(viewer, engine);
assert.equal(engineFromViewer(viewer), engine);
unregister();
const built = engineFromViewer(viewer);
assert.notEqual(built, engine);
unregister();
assert.equal(
engineFromViewer(viewer),
built,
'a stale unregister keeps the new one',
);
});
test('an engine passes through, and no viewer is no engine', () => {
const engine = createFakeEngine();
assert.equal(engineFromViewer(engine), engine);
assert.equal(engineFromViewer(null), null);
assert.equal(engineFromViewer(undefined), null);
});
test('isGlobeEngine tells engines from viewers', () => {
assert.equal(isGlobeEngine(createFakeEngine()), true);
assert.equal(isGlobeEngine(createFakeViewer()), false);
assert.equal(isGlobeEngine(null), false);
assert.equal(isGlobeEngine({ kind: 'cesium' }), false);
});