import { attachCctvVideo } from './videoPlayback.js'; import { CCTV_PROJECTION_OVERLAY_SOURCE_ID, CCTV_PROJECTION_OVERLAY_SOURCE_OPTIONS, PLANE_OUTLINE_COLOR, PROJECTION_CANVAS_WIDTH, PROJECTION_CANVAS_HEIGHT, } from './policy.js'; /** The monitor plane's alpha over its frame, as its image material had it. */ const PLANE_ALPHA = 0.95; /** A plain white image, for a plane with no media (tests). */ const WHITE_IMAGE = 'data:image/svg+xml,' + encodeURIComponent( '' + '', ); /** Copy a position's coordinates into `out`. */ function copyPosition(from, out) { out.x = from.x; out.y = from.y; out.z = from.z; return out; } export function createProjection({ state: layerState, services, parts, source, }) { const { holdContinuousRender, releaseContinuousRender } = services.render; /** * Build the protected label associated with one active monitor plane. * @param {{cameraId: string, name: string, position: object|Function}} input * @returns {Object} Shared-host presentation entry. */ function createCctvProjectionOverlayEntry({ cameraId, name, position }) { return { id: String(cameraId), position, variant: 'selected', selected: true, protected: true, paintLane: 'selected', collisionGroup: 'ambient-card', priority: Number.MAX_SAFE_INTEGER - 1, title: String(name || cameraId || 'CAMERA'), details: [], accent: '#6be8ff', interactive: false, gapPx: 6, verticalOnly: true, placement: 'above', edgeFade: 'keyhole', horizonCull: true, terrainOcclusion: false, }; } /** * Re-derives the monitor plane's placement (position, orientation, * dimensions) + label from the record's current frustum geometry, so the plane * always caps the wireframe exactly (corner rays terminate on its corners). * No-op when the record has no plane runtime (idle neighbors have no plane). * @param {Object} record - Camera record. */ function updatePlanePlacement(record) { const runtime = record?.projection; const plane = runtime?.plane; if (!plane) return; const geometry = record.frustumGeometry || parts.geometry.computeFrustumGeometry( record.camera, parts.ground.groundAltFor(record), record.probeClampRangeM, ); const positions = record.frustumPositions || parts.rendering.frustumCartesians(geometry); placePlane(plane, record.camera, geometry, positions); if (runtime.labelPosition) copyPosition(positions.label, runtime.labelPosition); parts.drawSets.writePlane(plane); } /** Pose a plane handle on the frustum's far cap. */ function placePlane(plane, camera, geometry, positions) { plane.center = positions.capCenter; plane.orientation = parts.model.planeOrientationFor( camera, positions.capCenter, ); plane.size = [geometry.halfW * 2, geometry.halfH * 2]; } /** * Give the monitor plane another image: a canvas, or the video element. * @param {Object} runtime - Projection runtime. * @param {{canvas: HTMLCanvasElement}|{video: HTMLVideoElement}} source */ function setPlaneSource(runtime, source) { runtime.planeSource = source; if (!runtime.plane) return; runtime.plane.source = source; parts.drawSets.writePlane(runtime.plane); } /** * Clear the active monitor-plane label source and ownership marker. */ function clearProjectionOverlay() { layerState._cctvOverlayHost.clearSource(CCTV_PROJECTION_OVERLAY_SOURCE_ID); layerState._cctvOverlayHost.setVisible( CCTV_PROJECTION_OVERLAY_SOURCE_ID, false, ); layerState._projectionOverlayOwnerId = null; } /** * Shows/hides the monitor plane and its associated shared-host label. * @param {Object} runtime - Projection runtime. * @param {boolean} visible */ function setPlaneVisible(runtime, visible) { if (!runtime) return; if (runtime.plane && runtime.plane.show !== !!visible) { runtime.plane.show = !!visible; parts.drawSets.writePlane(runtime.plane); } if (visible && runtime.overlayEntry && runtime.cameraId) { if (layerState._projectionOverlayOwnerId !== runtime.cameraId) { layerState._cctvOverlayHost.setEntries( CCTV_PROJECTION_OVERLAY_SOURCE_ID, [runtime.overlayEntry], CCTV_PROJECTION_OVERLAY_SOURCE_OPTIONS, ); layerState._cctvOverlayHost.setVisible( CCTV_PROJECTION_OVERLAY_SOURCE_ID, true, ); layerState._projectionOverlayOwnerId = runtime.cameraId; } } else if (layerState._projectionOverlayOwnerId === runtime.cameraId) { clearProjectionOverlay(); } } /** A plain white plane image, for a plane with no media (tests). */ function plainPlaneSource() { return { image: WHITE_IMAGE }; } /** Create the monitor plane plus its cached host-label presentation. */ function createProjectionPlane(record, runtime, geometry, positions) { runtime.labelPosition ||= { x: 0, y: 0, z: 0 }; copyPosition(positions.label, runtime.labelPosition); runtime.cameraId = String(record.camera.id); runtime.overlayEntry = createCctvProjectionOverlayEntry({ cameraId: runtime.cameraId, name: record.camera.name, position: () => runtime.labelPosition, }); const plane = { id: `cctv-${record.camera.id}-plane`, cameraId: record.camera.id, source: runtime.planeSource || plainPlaneSource(), alpha: PLANE_ALPHA, outline: { color: PLANE_OUTLINE_COLOR, widthPx: 1 }, show: false, }; placePlane(plane, record.camera, geometry, positions); runtime.plane = plane; parts.drawSets.writePlane(plane); return plane; } /** * Creates the projection runtime for a camera record: an offscreen canvas, * the monitor plane plus associated host label, and either an * or