import * as Cesium from 'cesium'; import { CCTV_FOCUS_RESULT } from './policy.js'; import { cameraOf } from '../../render/rendererOf.js'; export function createNavigation({ state: layerState, services, parts, source, }) { /** * Finds the camera closest to the Cesium viewer's current position. * @returns {string|null} Camera ID of the nearest camera, or null. */ function nearestCameraIdToViewer() { const carto = layerState._viewer?.camera?.positionCartographic; if (!carto || !layerState._records.length) return null; const lat = Cesium.Math.toDegrees(carto.latitude); const lon = Cesium.Math.toDegrees(carto.longitude); let best = null; for (const record of layerState._records) { const distKm = parts.model.haversineKm( lat, lon, record.camera.lat, record.camera.lon, ); if (!best || distKm < best.distKm) { best = { id: record.camera.id, distKm }; } } return best?.id || null; } /** * Flies the Cesium viewer camera to frame the specified CCTV camera, * looking along its heading from above. * @param {Cesium.Viewer|null} viewer Cesium viewer that owns the camera. * @param {Object|null} record CCTV camera runtime record. * @param {number} [duration=2.2] - Flight duration in seconds. * @returns {'focused'|'no-active-camera'|'tracking-holds-view'|'cockpit-active'} Focus result. */ function focusCctvRecord(viewer, record, duration = 2.2) { if (!viewer || !record) return CCTV_FOCUS_RESULT.NO_ACTIVE_CAMERA; if ( typeof document !== 'undefined' && document.body?.classList.contains('cockpit-mode') ) { console.debug('[Data:CCTV] focus ignored while cockpit owns the camera'); return CCTV_FOCUS_RESULT.COCKPIT_ACTIVE; } if (viewer.trackedEntity) { console.debug( '[Data:CCTV] focus ignored while a tracked entity owns the camera', ); return CCTV_FOCUS_RESULT.TRACKING_HOLDS_VIEW; } const { camera } = record; const range = Math.max(280, camera.rangeM * 1.18); cameraOf(viewer).flyToBounds( { center: record.position, radius: Math.max(40, camera.rangeM * 0.36) }, { offset: { heading: parts.model.toRad(camera.headingDeg), pitch: parts.model.toRad(-22), range, }, durationS: Math.max(0.2, duration || 0), easing: 'cubicInOut', }, ); return CCTV_FOCUS_RESULT.FOCUSED; } function focusCamera(cameraId, duration = 2.2) { return focusCctvRecord( layerState._viewer, layerState._recordById.get(cameraId), duration, ); } /** * Advances to the next camera if auto-hop is enabled and the hop interval * has elapsed. If the viewer has panned to a new region since the last hop, * snaps to the nearest camera instead of cycling sequentially. * @param {number} nowMs - Current timestamp in milliseconds. */ function maybeAutoHop(nowMs) { if ( !layerState._autoHop || layerState._autoHopSuspended || !layerState._enabled || layerState._records.length < 2 ) return; if (nowMs - layerState._lastHopAt < layerState._autoHopSec * 1000) return; const viewKey = parts.model.currentViewContext(); const viewChanged = viewKey !== layerState._lastViewContext; layerState._lastViewContext = viewKey; if (viewChanged) { const nearest = nearestCameraIdToViewer(); if (nearest && nearest !== layerState._activeCameraId) { // Use setActiveCamera so the full activation path runs (obstruction // probe, projection runtime, geometry rewrite) — previously bypassed // with a bare assignment parts.selection.setActiveCamera(nearest); layerState._lastHopAt = nowMs; return; } } const nextIdx = cctvCycleIndex( layerState._records.findIndex( (record) => record.camera.id === layerState._activeCameraId, ), 1, layerState._records.length, ); parts.selection.setActiveCamera(layerState._records[nextIdx].camera.id); layerState._lastHopAt = nowMs; } /** * Resolves a catalog cycle target, including the explicit no-selection state. * NEXT from null selects the first record; PREV selects the last. * @param {number} currentIdx * @param {number} step * @param {number} count * @returns {number} */ function cctvCycleIndex(currentIdx, step, count) { const total = Number.isFinite(count) ? Math.floor(count) : 0; if (total <= 0) return -1; const delta = Number.isFinite(step) ? Math.trunc(step) : 1; if (!Number.isFinite(currentIdx) || currentIdx < 0) { return delta < 0 ? total - 1 : 0; } return (((Math.floor(currentIdx) + delta) % total) + total) % total; } return { nearestCameraIdToViewer, focusCctvRecord, focusCamera, maybeAutoHop, cctvCycleIndex, }; }