Files
gods-eye-view/src/layers/satellites/lifecycle.js
T
Denis Groshev be326fdcf4 Station dots stand until the model is ready; the model is released when undrawn
The station's, the tracked and the docked dots are handed to the model only
once the renderer reports it ready, so the station no longer goes dark while
the file loads, or for good when it fails to. Turning the layer off releases
the model's draw set at once, and a minute out of range or hidden releases
it too, giving its GPU memory back; the next approach asks for it again.
2026-11-17 16:25:04 +01:00

222 lines
8.5 KiB
JavaScript

import { frameOf } from '../../render/rendererOf.js';
import {
ISS_NORAD,
ISS_OVERLAY_SOURCE_ID,
SATELLITE_COVERAGE_MS,
} from './policy.js';
import { worldClock } from '../../time/worldClock.js';
export function createLifecycle({
state: layerState,
services,
parts,
source,
}) {
const { clearFocusTarget } = services.focus;
// While on with a catalog, satellites can be shown at any time in reach of
// their element sets. Registered once; off, the layer has no time to show,
// and each step tells the clock once it has settled.
const clockSource = {
id: 'satellites',
coverage: () => {
if (!layerState._enabled || !layerState._catalog.size) return null;
const now = worldClock.wallNow();
return {
start: now - SATELLITE_COVERAGE_MS,
end: now + SATELLITE_COVERAGE_MS,
};
},
};
// Unregistered on destroy, so a page that builds the app again holds no old layer; init
// registers it again.
let uncover = worldClock.register(clockSource);
const { holdContinuousRender, releaseContinuousRender } = services.render;
const { registerPickOwner, unregisterPickOwner } = services.picking;
/** Run the shared per-frame tick before each frame draws. */
function onEachFrame(frame) {
return frame.on('preRender', (t) => parts.rendering._preRenderTick(t));
}
const methods = {
// Catalog data refresh; propagation remains preRender-owned.
async init(viewer) {
uncover ??= worldClock.register(clockSource);
// Asked first: a viewer without one fails before anything is built.
const frame = frameOf(viewer);
parts.catalog._abortActiveUpdates();
clearFocusTarget('satellites');
for (const model of parts.stationModels ?? [])
model._destroyStationModel();
layerState._viewer = viewer;
layerState._catalog = new Map();
layerState._points = new Map();
layerState._detectionObjects = new Map();
layerState._orbitPaths = new Map();
layerState._count = 0;
layerState._lastUpdate = null;
layerState._coreStale = false;
layerState._denseStale = false;
layerState._trackedNorad = null;
parts.tracking._cancelPendingTrackingRestore();
layerState._trackedEntity = null;
layerState._trackedFrameNumber = -1;
layerState._trackedFrameGeo = null;
layerState._trackedFrameNowForTest = null;
// The new catalog's points and rings carry no hold.
layerState._cockpitHiddenPoints = new Set();
layerState._cockpitHiddenPath = null;
layerState._cockpitHiddenDot = false;
layerState._lastFocusUpdate = 0;
layerState._activeFocusCount = 0;
layerState._enabled = false;
layerState._overlayHost.clearSource(ISS_OVERLAY_SOURCE_ID);
layerState._overlayHost.setVisible(ISS_OVERLAY_SOURCE_ID, false);
// Dense extras rebuild via update() when _params.catalog === 'dense'
// (the catalog-mode preference itself is sticky across init/destroy).
layerState._denseIds = [];
layerState._denseCursor = 0;
layerState._denseLoadPromise = null;
layerState._denseLoadToken++;
layerState._denseStatus = 'idle';
layerState._denseError = null;
layerState._catalogRevision++;
layerState.coverageChanged();
// The sets the satellite dots, the tracked dot and the rings draw in
parts.rendering._attach(viewer);
parts.interaction._installClickHandler(viewer);
// Pre-render listener for real-time position updates
// (fleet propagation + tracked per-frame dot + orbit ring GMST rotation)
layerState._preRenderListener = onEachFrame(frame);
console.log('[Data:Satellites] Initialized');
},
enable(viewer) {
layerState._enabled = true;
holdContinuousRender('satellites'); // per-frame animator (perf wave 2)
parts.rendering._setPointsShown(
parts.controls.satelliteVisualsVisible(
layerState._enabled,
layerState._params.showPoints,
),
);
// Orbit rings + persistent ISS host label — show them; the ISS's ring
// follows its class (and its tracking).
for (const noradId of layerState._orbitPaths.keys())
parts.rendering._setOrbitPathShown(
noradId,
noradId === ISS_NORAD
? parts.controls._issOrbitVisible()
: parts.controls.satelliteVisualsVisible(
layerState._enabled,
layerState._params.showOrbits,
),
);
parts.labels._syncIssOverlay();
// Re-attach input handlers and preRender propagation
parts.interaction._installClickHandler(viewer);
// Pick-ownership (H2): satellite dot ids are numeric NORAD catalog numbers;
// the registry hands predicates String()-coerced ids, so match via Number().
registerPickOwner('satellites', (pickedId) => {
const norad = Number(pickedId);
return Number.isFinite(norad) && layerState._points.has(norad);
});
if (!layerState._preRenderListener && viewer) {
layerState._preRenderListener = onEachFrame(frameOf(viewer));
}
parts.tracking._applyPendingTrackingRestore();
layerState.coverageChanged();
},
disable(viewer) {
parts.catalog._abortActiveUpdates();
parts.tracking._cancelPendingTrackingRestore();
layerState._enabled = false;
releaseContinuousRender('satellites');
parts.rendering._setPointsShown(false);
parts.rendering._setOrbitPathsShown(false);
for (const model of parts.stationModels ?? [])
model._updateStationModel(); // off: releases the model
parts.tracking._clearTracking();
parts.stationPanel?._syncStationPanel(); // off: takes the panel down
parts.labels._syncIssOverlay();
// Remove click handler + keydown listener + preRender propagation while disabled
layerState._clickSubscription?.();
layerState._clickSubscription = null;
if (layerState._trackedEntityChangedRemove) {
layerState._trackedEntityChangedRemove();
layerState._trackedEntityChangedRemove = null;
}
document.removeEventListener('keydown', parts.interaction._onKeyDown);
unregisterPickOwner('satellites');
if (layerState._preRenderListener) {
layerState._preRenderListener();
layerState._preRenderListener = null;
}
layerState.coverageChanged();
},
destroy(viewer) {
parts.catalog._abortActiveUpdates();
uncover?.();
uncover = null;
releaseContinuousRender('satellites'); // direct-destroy path (perf wave 2 fix)
layerState._enabled = false;
parts.tracking._clearTracking();
parts.tracking._cancelPendingTrackingRestore();
layerState._clickSubscription?.();
layerState._clickSubscription = null;
if (layerState._trackedEntityChangedRemove) {
layerState._trackedEntityChangedRemove();
layerState._trackedEntityChangedRemove = null;
}
document.removeEventListener('keydown', parts.interaction._onKeyDown);
unregisterPickOwner('satellites');
if (layerState._preRenderListener) {
layerState._preRenderListener();
layerState._preRenderListener = null;
}
layerState._overlayHost.clearSource(ISS_OVERLAY_SOURCE_ID);
layerState._overlayHost.setVisible(ISS_OVERLAY_SOURCE_ID, false);
for (const model of parts.stationModels ?? [])
model._destroyStationModel();
parts.stationPanel?._destroyStationPanel();
// The dots', tracked dot's and rings' sets are disposed of
parts.rendering._detach(viewer);
layerState._points.clear();
layerState._detectionObjects.clear();
layerState._orbitPaths.clear();
layerState._catalog.clear();
layerState._denseIds = [];
layerState._denseCursor = 0;
layerState._denseLoadToken++;
layerState._denseStatus = 'idle';
layerState._denseError = null;
layerState._catalogRevision++;
layerState._rowControlsListener = null;
layerState._count = 0;
layerState._lastUpdate = null;
layerState._coreStale = false;
layerState._denseStale = false;
layerState._lastError = null;
layerState._lastFocusUpdate = 0;
layerState._activeFocusCount = 0;
layerState._trackingRefreshEpoch += 1;
layerState._lastTrackingRefreshOutcome = {
epoch: layerState._trackingRefreshEpoch,
status: 'destroyed',
failedGroups: [],
};
layerState._viewer = null;
layerState.coverageChanged();
},
};
return { methods };
}