mirror of
https://github.com/bilawalsidhu/gods-eye-view.git
synced 2026-11-20 18:22:25 +00:00
Bugs: - Cameras on one mount stay side by side after their geometry is built, so a click or a settled view no longer folds them back into one icon. - A count click yields to a card drawn over the marker and to another layer's object under it, waits while the cockpit or tracking holds the view, and flies at most halfway, so a long chain of cameras still splits. - The active camera's icon is never covered by a count, transparent corners of the marker no longer catch clicks, and a count hidden under the HUD keeps its lone cameras. - A lone camera joins only its nearest count and never bridges two; cameras close enough to draw as icons take part too, at their drawn icon size. - Groups across the antimeridian keep their longitude; the flight frames the highest mount; markers on ground below the ellipsoid stay visible; counts fade outside the Scope circle. - Mounts less than a metre apart count as one mount. - A drawn-terrain height survives a late fallback answer, is read for an unresolved camera and for one projected off the window, is re-read when the terrain under it finishes loading or the terrain source changes, and the read budget no longer goes to the same misses each pass. Cleanup: the glyph draws from one green SVG sprite instead of recolouring pixels, marker-only constants move next to their use, layout tests check behaviour rather than formulas, and docs and comments match the code. docs/I18N.md names the one fixed notation of count badges as an exception.
274 lines
8.4 KiB
JavaScript
274 lines
8.4 KiB
JavaScript
export function createState({ services }) {
|
|
const {
|
|
clearOverlaySource,
|
|
hitTestWorldOverlay,
|
|
setOverlayEntries,
|
|
setOverlaySourceVisible,
|
|
} = services.overlays;
|
|
const layerState = {};
|
|
|
|
// ---------------------------------------------------------------------------
|
|
// Module-scoped mutable state
|
|
// ---------------------------------------------------------------------------
|
|
|
|
layerState._viewer = null;
|
|
|
|
/** The catalog's camera icons: the icon book over their draw set. */
|
|
layerState._icons = null;
|
|
layerState._counts = null;
|
|
|
|
layerState._records = [];
|
|
|
|
layerState._recordById = new Map();
|
|
|
|
layerState._coverageEntities = [];
|
|
|
|
layerState._projectionEntities = [];
|
|
|
|
layerState._enabled = false;
|
|
|
|
layerState._activeCameraId = null;
|
|
|
|
// Advances when a user reselects the already-active camera. The geometry
|
|
// activation remains a no-op, but browser-only camera UI can retry playback.
|
|
layerState._activeCameraReselection = 0;
|
|
|
|
layerState._coverageMode = 'on';
|
|
// 'off' | 'on' (wireframes) | 'viewshed' (color-coded volumes)
|
|
|
|
layerState._showProjection = true;
|
|
|
|
layerState._autoHop = false;
|
|
|
|
// True while the active camera is the one enable() opened on and nobody has
|
|
// chosen a camera since: each settled move then re-picks the one nearest
|
|
// the view, so a share flight that lands after enable still opens nearby.
|
|
|
|
layerState._openingCameraProvisional = false;
|
|
|
|
// An explicit empty-space deselect keeps AUTO HOP configured but prevents its
|
|
// timer from silently choosing a replacement. A later explicit activation or
|
|
// AUTO HOP toggle-on releases the hold.
|
|
|
|
layerState._autoHopSuspended = false;
|
|
|
|
layerState._autoHopSec = 18;
|
|
|
|
layerState._lastHopAt = 0;
|
|
|
|
layerState._lastViewContext = '';
|
|
|
|
layerState._clickSubscription = null;
|
|
|
|
layerState._count = 0;
|
|
|
|
layerState._lastUpdate = null;
|
|
|
|
layerState._lastHealthSyncAt = 0;
|
|
|
|
layerState._lastError = null;
|
|
|
|
layerState._healthById = new Map();
|
|
|
|
layerState._calibrationById = new Map();
|
|
|
|
layerState._listeners = new Set();
|
|
|
|
layerState._projectionRaf = 0;
|
|
|
|
layerState._removeFocusAppearListener = null;
|
|
|
|
layerState._lastFocusStyleAt = 0;
|
|
|
|
/** Icons whose animated emphasis remains outside the 1.0 deadband. */
|
|
|
|
layerState._activeFocusStyleCount = 0;
|
|
|
|
// The view pass's screen-point scratch: its projection writes only x and y.
|
|
layerState._scratchViewScreen = { x: 0, y: 0 };
|
|
|
|
// Counts view passes; a record shown by the latest pass carries its number.
|
|
|
|
layerState._viewPassId = 0;
|
|
|
|
// Records whose icons the last view pass showed (see refreshHorizonCulling):
|
|
// geometry refinement, the tiles-ready completion pass and ambient cards
|
|
// work over these, not the whole catalog.
|
|
|
|
layerState._viewRecords = [];
|
|
// The view records plus the best-ranked camera of each visible cell.
|
|
layerState._pickerRecords = [];
|
|
|
|
// The active camera's coverage neighbours, including grouped ones. A
|
|
// grouping change in this cohort requires a coverage refresh.
|
|
layerState._coverageCohort = null;
|
|
// The cohort minus grouped cameras, last drawn by refreshCoverageStyles.
|
|
// These belong to the geometry working set even off screen.
|
|
layerState._coverageVisibleIds = new Set();
|
|
|
|
// View pass triggers besides camera settle: an interval while the camera
|
|
// moves, and a canvas resize observer.
|
|
|
|
layerState._viewMotionTimer = 0;
|
|
|
|
layerState._viewResizeObserver = null;
|
|
|
|
layerState._viewResizeCanvas = null;
|
|
|
|
// The camera port the moveStart/moveEnd listeners are on.
|
|
|
|
layerState._viewListenerCamera = null;
|
|
// Reruns the view pass when terrain loads or the surface changes.
|
|
layerState._surfaceListener = null;
|
|
layerState._surfaceListenerGlobe = null;
|
|
|
|
// A motion pass changed the shown set and the settle pass has not yet told
|
|
// subscribers; the camera pose the last view pass ran at.
|
|
|
|
layerState._viewUnpublished = false;
|
|
|
|
layerState._viewPose = null;
|
|
|
|
// { at, ms } — when the last motion pass ran and what it cost.
|
|
|
|
layerState._viewMotionPass = null;
|
|
|
|
// Retries the view geometry a drain left unresolved, once cells warm.
|
|
|
|
layerState._viewGeometryRetryTimer = 0;
|
|
|
|
// { key, count } — the active camera's coverage-overlap count, which the
|
|
// summary reads on every notification.
|
|
|
|
layerState._neighborCountCache = null;
|
|
|
|
// { view, active, list } — the camera picker's index uiState publishes,
|
|
// rebuilt only when the view pass or the active camera changes.
|
|
|
|
layerState._cameraIndexCache = null;
|
|
|
|
// Staggered geometry-load queue state (see startGeometryLoadQueue).
|
|
|
|
layerState._geoQueue = [];
|
|
|
|
layerState._geoQueueTimer = 0;
|
|
|
|
layerState._geoLoading = false;
|
|
|
|
layerState._geoLoadTotal = 0;
|
|
|
|
layerState._geoLoadDone = 0;
|
|
|
|
layerState._geoProgressNotifier = null;
|
|
|
|
// One-shot completion latch for shared floor resolution: the enable-time queue
|
|
// can drain while DEM cells or 3D tiles are still loading. The first update()
|
|
// tick that sees projectionTilesReady() re-enqueues unresolved records ONCE;
|
|
// shared mesh cells remain one-shot and idle ticks stay sample-free. Reset by
|
|
// startGeometryLoadQueue so each enable-time drain gets its own completion pass.
|
|
|
|
layerState._tilesReadyReenqueued = false;
|
|
|
|
// Calibration ADJUST mode (viewshed/gizmo design §3c): while true, the active
|
|
// camera renders the direct-manipulation gizmo. Reset on layer disable.
|
|
|
|
layerState._calibrationMode = false;
|
|
|
|
layerState._gizmo = null;
|
|
|
|
layerState._lastTransientNotifyAt = 0;
|
|
|
|
// Task 5: last surface regime the record geometry was recomputed for. The
|
|
// map-stack change listener compares the CURRENT regime (derived live from
|
|
// whether the renderer shows the globe) against this so bing→osm switches (same 'terrain-globe'
|
|
// regime) don't trigger a pointless full-catalog rewrite.
|
|
|
|
layerState._lastAppliedRegime = null;
|
|
|
|
// Task 5: window listener handle for the 'gev:map-stack-changed' CustomEvent
|
|
// main.js dispatches from MapStackController's onChange (removed in destroy).
|
|
|
|
layerState._mapStackListener = null;
|
|
|
|
// Field-test fix (2026-07-06): the Off of the camera's moveEnd listener for
|
|
// the horizon-culling pass (called in destroy). Event-driven only — never a per-frame loop, so
|
|
// the zero-steady-state-work invariant holds.
|
|
|
|
layerState._horizonCullListener = null;
|
|
|
|
// Ambient card tier state (2026-07-29 design). The card set is rebuilt only
|
|
// on moveEnd/enable/activation (refreshAmbientCards); frame slots are STABLE
|
|
// objects shared with the overlay host so landed frames appear without an
|
|
// entry rebuild.
|
|
|
|
layerState._cardIds = new Set();
|
|
|
|
/** @type {Map<string,{misses:number,since:number}>} */
|
|
|
|
layerState._cardGraceState = new Map();
|
|
|
|
/** @type {Map<string,{frame:*, stamp:number, failCount:number, lastAttemptAt:number}>} */
|
|
|
|
layerState._cardFrameSlots = new Map();
|
|
|
|
layerState._cardFetchTimer = 0;
|
|
|
|
/** In-flight card-frame fetch count (burst allows up to 4, steady is 1). */
|
|
|
|
layerState._cardFetchInFlightCount = 0;
|
|
|
|
/** @type {Set<HTMLImageElement>} in-flight fetches, detached on teardown. */
|
|
|
|
layerState._cardFetchImages = new Set();
|
|
|
|
/** @type {Set<string>} camera ids with an in-flight fetch (no double-fetch). */
|
|
|
|
layerState._cardFetchPendingIds = new Set();
|
|
|
|
layerState._cardFetchCount = 0;
|
|
|
|
layerState._cardLastFetchAt = 0;
|
|
|
|
layerState._cardMinFetchSpacingMs = null;
|
|
|
|
/** Pacer mode telemetry: 'burst' during cold fill, 'steady' after. */
|
|
|
|
layerState._cardFetchMode = 'steady';
|
|
|
|
layerState.DEFAULT_CCTV_OVERLAY_HOST = Object.freeze({
|
|
clearSource: clearOverlaySource,
|
|
hitTest: hitTestWorldOverlay,
|
|
setEntries: setOverlayEntries,
|
|
setVisible: setOverlaySourceVisible,
|
|
});
|
|
|
|
layerState._cctvOverlayHost = layerState.DEFAULT_CCTV_OVERLAY_HOST;
|
|
|
|
layerState._projectionOverlayOwnerId = null;
|
|
|
|
/**
|
|
* Product presentation option. Shipped behavior keeps the active camera's
|
|
* thumbnail absent because its monitor plane is the active representation.
|
|
*/
|
|
|
|
layerState._activeCameraCardEnabled = false;
|
|
|
|
/** Camera id currently holding the hover-summoned pinned card (or null). */
|
|
|
|
layerState._hoverCardId = null;
|
|
|
|
layerState._hoverReleaseTimer = 0;
|
|
|
|
layerState._hoverLastPickAt = 0;
|
|
|
|
// True between camera.moveStart and moveEnd — hover picking pauses while the
|
|
// camera is in motion (picks during a flight would fight the reselection).
|
|
|
|
layerState._cameraMoving = false;
|
|
|
|
// The Off of the camera's moveStart listener.
|
|
layerState._moveStartListener = null;
|
|
layerState._sourceAbort = null;
|
|
return layerState;
|
|
}
|