Stories: reach the globe through the renderer's ports

Main now keeps Cesium behind the renderer contract, so Stories stops
reaching Cesium and the viewer directly.

- Camera: flights, the -60 degree story framing, cancel, the pose saved
  on open and put back on Close go through the camera port; a follow is
  released with stopFollowing.
- Pins: placed in the frame port's postRender from the query port's
  projection and horizon test, still written straight to each pin's
  transform on every drawn frame.
- Tile settling: a continuous-render hold until the globe port reports
  the base settled, for at most 10 s.
- Clock: Close and Back to Explore put back the page's world clock (live,
  or the time it showed, playing on), and leave a clock that is still
  where it should be alone.
- Card images: drawn from Esri World Imagery's own Web Mercator tiles
  while the Esri map stack is active, read as images; no Cesium imagery
  provider is touched.
- THUMBNAIL: the director hands captureStoryThumb the frame port and the
  renderer's canvas, so the scene document's module stays renderer-free.
- Credits: Stories places and keeps visible the application's credit
  line (#gev-credits) and its list as well as the renderer's own display.
- Tests fake the ports instead of a Cesium viewer, and cover pins per
  frame, the flights, the settling bound and the clock restore; the
  share link tests Stories added build their manager over a camera port.
This commit is contained in:
Manjunath committed 2026-11-16 20:43:53 +05:30
1 parent 9e9ce1db22
commit b8e622aac8
15 files changed
+695 -376

No files matched your search

+16 -11
View File
@@ -1,7 +1,8 @@
/**
* A scene's Stories card thumbnail: captured from the globe, stored as a data
* URL. The scene document validates with this module, so it reaches no
* browser globals; callers hand it the viewer and a canvas factory.
* browser globals and no renderer; callers hand it the renderer's frame port,
* its canvas and a canvas factory.
*/
export const STORY_THUMB_WIDTH = 320;
@@ -107,25 +108,29 @@ export function encodeStoryThumb(source, createCanvas) {
/**
* Capture the globe as it is drawn now. The WebGL canvas has no
* preserveDrawingBuffer, so it is read inside the next postRender, while the
* frame is still in the drawing buffer; a render is requested for it.
* @param {object} viewer Cesium viewer (its `scene`).
* preserveDrawingBuffer, so it is read inside the next postRender of the
* renderer's frame port, while the frame is still in the drawing buffer; a
* render is requested for it.
* @param {{frame?: import('../render/contract/frame').FramePort | null,
* canvas?: HTMLCanvasElement | null}} globe The renderer's frame port and
* the canvas it draws in, as the caller found them for its scene.
* @param {object} options
* @param {() => HTMLCanvasElement} options.createCanvas Makes an empty canvas.
* @param {number} [options.timeoutMs] Give up when no frame is drawn.
* @returns {Promise<string>} JPEG data URL.
*/
export function captureStoryThumb(viewer, { createCanvas, timeoutMs = 3000 }) {
const scene = viewer?.scene;
if (!scene?.postRender || !scene.canvas)
return Promise.reject(new Error('Globe not ready'));
export function captureStoryThumb(
{ frame, canvas } = {},
{ createCanvas, timeoutMs = 3000 },
) {
if (!frame || !canvas) return Promise.reject(new Error('Globe not ready'));
return new Promise((resolve, reject) => {
let timer = null;
const remove = scene.postRender.addEventListener(() => {
const remove = frame.on('postRender', () => {
remove();
clearTimeout(timer);
try {
resolve(encodeStoryThumb(scene.canvas, createCanvas));
resolve(encodeStoryThumb(canvas, createCanvas));
} catch (error) {
reject(error);
}
@@ -134,6 +139,6 @@ export function captureStoryThumb(viewer, { createCanvas, timeoutMs = 3000 }) {
remove();
reject(new Error('No frame was drawn'));
}, timeoutMs);
scene.requestRender?.();
frame.requestRender('story-thumb');
});
}