Files
gods-eye-view/src/library/camera.js
T
Sameh Khamis e3865f462f Merge origin/main into the renderer-contract branch: the procedural fleet models drawn through the renderer's model sets
Aircraft, military, local ADS-B, vessel, transit and rail models come from
the fleet model set, loaded up front and drawn life size through the draw
port's models sets; no layer touches the viewer or Cesium outside
src/render/cesium/. The models capability gains glTF bytes (gltf), a
per-axis stretch (axisScale), a colour for tinted parts (maskColor) and a
cut below the origin (clip: 'belowOrigin'), with conformance checks.

Main's rail layer and Data Library are ported to the ports; the CCTV
footprint probe keeps the globe-terrain clamp through the query port.
2026-11-13 14:14:42 -08:00

74 lines
2.4 KiB
JavaScript

/**
* "Zoom to layer" for Data Library layers. Callers run this inside the
* shell's immediate navigation (`runImmediateNavigation('layer', …)`), so
* Cockpit can refuse it and the current follow owner is released first.
* The flight goes through the renderer's camera port.
*/
import { cancelCameraArrival } from '../data/cameraArrival.js';
import { findCamera } from '../render/rendererOf.js';
import { isWorldScale, padExtent } from './extent.js';
/** Camera height for a world-scale layer: the whole globe in view. */
const WORLD_HEIGHT_M = 20_000_000;
/** Where a view-bounded zoom lands, as a share of the layer's altitude. */
const VIEW_LANDING_FRACTION = 0.6;
/**
* Fly the camera to frame an extent, looking straight down, north up.
* @param {object} viewer
* @param {{ west: number, south: number, east: number, north: number, maxAltitudeM?: number }} extent
* `maxAltitudeM` marks a view-bounded layer's limit.
* @param {{ reducedMotion?: boolean }} [options]
* @returns {boolean} Whether a flight started.
*/
export function flyToLibraryExtent(
viewer,
extent,
{
reducedMotion = globalThis.matchMedia?.('(prefers-reduced-motion: reduce)')
?.matches === true,
} = {},
) {
const camera = findCamera(viewer);
if (!camera?.flyTo || !extent) return false;
cancelCameraArrival(viewer);
const box = padExtent(extent);
const options = { durationS: reducedMotion ? 0 : 1.6 };
// A view-bounded layer loads only below its altitude: land straight above
// its sample area, low enough for the layer to load.
if (Number.isFinite(extent.maxAltitudeM)) {
camera.flyTo(
{
lon: (extent.west + extent.east) / 2,
lat: (extent.south + extent.north) / 2,
height: extent.maxAltitudeM * VIEW_LANDING_FRACTION,
},
options,
);
return true;
}
if (isWorldScale(box)) {
const lon = (box.west + box.east) / 2;
const lat = (box.south + box.north) / 2;
camera.flyTo(
{ lon: lon > 180 ? lon - 360 : lon, lat, height: WORLD_HEIGHT_M },
options,
);
return true;
}
// A rectangle whose west is east of its east crosses the antimeridian.
const wrap = (lon) => (lon > 180 ? lon - 360 : lon < -180 ? lon + 360 : lon);
camera.flyTo(
{
rect: {
west: wrap(box.west),
south: box.south,
east: wrap(box.east),
north: box.north,
},
},
options,
);
return true;
}