mirror of
https://github.com/bilawalsidhu/gods-eye-view.git
synced 2026-11-17 16:52:20 +00:00
Upstream's layers and changes are carried onto the ports, with no Cesium outside src/render and no reach into the viewer: - Shipwrecks draw as one icon set, clicked through the input dispatcher. - News draws through draw sets, the camera port and the input dispatcher; its beacons pulse each frame through the frame port. - The scene occlusion probe moves into src/render/cesium and reaches detection through a new application hook, createOcclusionProbe; its private Cesium reads go through internals.js. - Flight and military trails, the stale and SIGNAL LOST cue, coasting and following the world clock run on the draw and frame ports. GPU icons follow the scene clock while the world clock is followed, and fade when stale. A report that holds is not planned again every tick. - Vessels are keyed by their record id. The stub boot now enables military, shipwrecks and news as well.
206 lines
6.8 KiB
JavaScript
206 lines
6.8 KiB
JavaScript
import {
|
|
accentForVesselType,
|
|
displayVesselType,
|
|
normalizeVesselType,
|
|
} from '../../data/vesselLabels.js';
|
|
import { formatNumber, t } from '../../i18n/index.js';
|
|
import { roundHeadingDegrees } from '../../data/headingDegrees.js';
|
|
|
|
export function createCards({
|
|
vesselState,
|
|
services,
|
|
parts: components,
|
|
layer,
|
|
options,
|
|
}) {
|
|
function updateSelectedVesselHud(record) {
|
|
// Pinned vessels missing from recent refreshes get a stale marker
|
|
const stale = (record.missedRefreshes || 0) > 0;
|
|
services.readouts?.presentSelectedVessel({
|
|
text: [
|
|
t('AIS: {name}', { name: trimHudValue(record.name, 32) }),
|
|
t('{type} SPD: {speed} HDG: {heading}', {
|
|
type: trimHudValue(record.type || t('VESSEL'), 24),
|
|
speed: formatSpeed(record.speed),
|
|
heading: formatHeading(record.heading ?? record.course),
|
|
}),
|
|
`MMSI: ${record.mmsi || '--'} ${formatPositionTime(record)}${stale ? ` · ${t('STALE')}` : ''}`,
|
|
].join('\n'),
|
|
});
|
|
}
|
|
|
|
function resetSelectedVesselHud() {
|
|
services.readouts?.presentSelectedVessel(null);
|
|
}
|
|
|
|
function trimHudValue(value, maxLength) {
|
|
const text = String(value || '--').trim() || '--';
|
|
return text.length > maxLength
|
|
? `${text.slice(0, maxLength - 3)}...`
|
|
: text;
|
|
}
|
|
|
|
/**
|
|
* Card model for an ambient (decluttered-in) vessel — name title plus one
|
|
* compact type/speed/heading detail line, anchored at the record's current
|
|
* rendered position (height-datum caveat: no datum work here). Pure —
|
|
* exported for unit tests.
|
|
* @param {Object} record - Vessel record.
|
|
* @returns {Object} vesselLabels entry.
|
|
*/
|
|
|
|
function buildVesselCard(record) {
|
|
const parts = [];
|
|
const type = vesselTypeShort(record);
|
|
if (type) parts.push(type);
|
|
if (record.speed !== null && record.speed !== undefined)
|
|
parts.push(formatSpeed(record.speed));
|
|
const direction = record.heading ?? record.course;
|
|
if (Number.isFinite(direction))
|
|
parts.push(`${roundHeadingDegrees(direction)}°`);
|
|
return {
|
|
id: vesselOverlayEntryId(record),
|
|
actionable: Boolean(record?.id),
|
|
position: components.rendering.iconPosition(record),
|
|
gapPx: 10,
|
|
accent: accentForVesselType(record.type),
|
|
title: trimHudValue(displayVesselName(record), 26),
|
|
details: parts.length ? [parts.join(' · ')] : [],
|
|
selected: false,
|
|
priority: components.rendering.labelPriority(record, null),
|
|
};
|
|
}
|
|
|
|
/**
|
|
* Card model for the click-selected vessel — the full-detail card, drawn last
|
|
* (on top) and never distance-faded by the overlay. Pinned-but-vanished
|
|
* vessels carry a STALE marker (mirrors the HUD readout). Pure — exported
|
|
* for unit tests.
|
|
* @param {Object} record - Selected vessel record.
|
|
* @returns {Object} vesselLabels entry.
|
|
*/
|
|
|
|
function buildSelectedVesselCard(record) {
|
|
const direction = record.heading ?? record.course;
|
|
const details = [
|
|
[
|
|
vesselTypeShort(record) || t('VESSEL'),
|
|
formatSpeed(record.speed),
|
|
Number.isFinite(direction)
|
|
? `${roundHeadingDegrees(direction)}°`
|
|
: '--°',
|
|
].join(' · '),
|
|
];
|
|
const destination = String(record.destination || '').trim();
|
|
if (destination) details.push(`→ ${trimHudValue(destination, 24)}`);
|
|
const stale = (record.missedRefreshes || 0) > 0;
|
|
details.push(
|
|
`MMSI ${record.mmsi || '--'} · ${formatPositionTime(record)}${stale ? ` · ${t('STALE')}` : ''}`,
|
|
);
|
|
return {
|
|
id: vesselOverlayEntryId(record),
|
|
actionable: Boolean(record?.id),
|
|
position: components.rendering.iconPosition(record),
|
|
gapPx: 12,
|
|
accent: accentForVesselType(record.type),
|
|
title: trimHudValue(displayVesselName(record), 32),
|
|
details,
|
|
selected: true,
|
|
priority: 100000,
|
|
};
|
|
}
|
|
|
|
/** Stable overlay identity for keyed and source-retained unkeyed rows. */
|
|
|
|
function vesselOverlayEntryId(record) {
|
|
const id = String(record?.id || '').trim();
|
|
if (id) return `vessel:${id}`;
|
|
const name = String(record?.name || 'VESSEL').trim() || 'VESSEL';
|
|
const lat = Number.isFinite(record?.lat) ? record.lat.toFixed(5) : 'x';
|
|
const lon = Number.isFinite(record?.lon) ? record.lon.toFixed(5) : 'x';
|
|
return `vessel:unkeyed:${name}:${lat}:${lon}`;
|
|
}
|
|
|
|
/**
|
|
* Uppercased AIS type for the card (empty string when unknown). Free feed
|
|
* text is bounded to the card width; a translated type token is a short
|
|
* catalog word and shows whole, never cut mid-word ("AUXILIAR DE PUERTO").
|
|
*/
|
|
|
|
function vesselTypeShort(record) {
|
|
const feedType = normalizeVesselType(record.type);
|
|
const shown = displayVesselType(record.type);
|
|
return shown === feedType
|
|
? feedType.toUpperCase().slice(0, 14)
|
|
: shown.toUpperCase();
|
|
}
|
|
|
|
/**
|
|
* True when `screen` is at least `minSepPx` away from every accepted screen
|
|
* position (greedy card-declutter accept test, mirroring the FIRMS pass).
|
|
* Exported for unit tests.
|
|
* @param {Array<{x: number, y: number}>} accepted - Accepted card positions.
|
|
* @param {{x: number, y: number}} screen - Candidate window coordinates.
|
|
* @param {number} minSepPx - Minimum separation in pixels.
|
|
* @returns {boolean}
|
|
*/
|
|
|
|
function cardScreenSeparated(accepted, screen, minSepPx) {
|
|
const minSq = minSepPx * minSepPx;
|
|
for (let i = 0; i < accepted.length; i += 1) {
|
|
const dx = screen.x - accepted[i].x;
|
|
const dy = screen.y - accepted[i].y;
|
|
if (dx * dx + dy * dy < minSq) return false;
|
|
}
|
|
return true;
|
|
}
|
|
|
|
function displayVesselName(record) {
|
|
const name = String(record.name || '').trim();
|
|
// A source may name a vessel by its id when it has no name.
|
|
if (name && name !== 'VESSEL' && name !== record.mmsi && name !== record.id)
|
|
return name;
|
|
return record.mmsi ? `MMSI ${record.mmsi}` : t('VESSEL');
|
|
}
|
|
|
|
function formatSpeed(speed) {
|
|
return t('{speed}KT', {
|
|
speed:
|
|
speed === null
|
|
? '--'
|
|
: formatNumber(speed, {
|
|
minimumFractionDigits: 1,
|
|
maximumFractionDigits: 1,
|
|
useGrouping: false,
|
|
}),
|
|
});
|
|
}
|
|
|
|
function formatHeading(heading) {
|
|
return t('{heading}DEG', {
|
|
heading: roundHeadingDegrees(heading) ?? '--',
|
|
});
|
|
}
|
|
|
|
function formatPositionTime(record) {
|
|
if (!record.lastPositionUtc) return t('POS: LIVE');
|
|
const date = new Date(record.lastPositionUtc);
|
|
if (Number.isNaN(date.getTime())) return t('POS: LIVE');
|
|
return t('POS: {time}Z', { time: date.toISOString().slice(11, 19) });
|
|
}
|
|
return {
|
|
updateSelectedVesselHud,
|
|
resetSelectedVesselHud,
|
|
trimHudValue,
|
|
buildVesselCard,
|
|
buildSelectedVesselCard,
|
|
vesselOverlayEntryId,
|
|
vesselTypeShort,
|
|
cardScreenSeparated,
|
|
displayVesselName,
|
|
formatSpeed,
|
|
formatHeading,
|
|
formatPositionTime,
|
|
};
|
|
}
|