mirror of
https://github.com/bilawalsidhu/gods-eye-view.git
synced 2026-11-16 08:12:24 +00:00
feat(cockpit): ride the selected vessel from its bridge
With no aircraft tracked, Cockpit can ride the selected AIS vessel. Entry needs only Live AIS Vessels and a selected vessel; C, double-click and the entry buttons (reading BRIDGE with a ship icon) enter it, while voice stays aircraft-only. The eye sits on the AIS position at a representative bridge height for the vessel's type family, looks along true heading and moves along course over ground. The last fix is dead-reckoned for up to 180 s between the layer's refreshes, and on rivers and lakes the waterline is read from the rendered surface around the ship rather than the geoid. The bridge HUD shows speed and course over ground, a straight heading tape, window mullions, the AIS destination as a reported voyage and a heading-up radar of nearby ships (3 to 24 NM). The arrow keys look around, Home or 0 looks ahead again. The vessel layer hides the ridden ship's sprite and card, ignores scene clicks while held, and returns the camera to the vessel's map view on exit.
This commit is contained in:
1 parent
52187c91d1
commit
72112ecb45
58 files changed
+5313
-137
No files matched your search
@@ -0,0 +1,140 @@
|
||||
// src/cockpitRadar.test.mjs — the bridge radar's range steps, rings and
|
||||
// heading-up contact projection.
|
||||
import test from 'node:test';
|
||||
import assert from 'node:assert/strict';
|
||||
import {
|
||||
DEFAULT_RADAR_RANGE_NM,
|
||||
METRES_PER_NM,
|
||||
RADAR_MAX_CONTACTS,
|
||||
RADAR_RANGES_NM,
|
||||
nextRadarRange,
|
||||
projectRadarContacts,
|
||||
radarPicture,
|
||||
radarRangeM,
|
||||
radarRingsNm,
|
||||
} from './cockpitRadar.js';
|
||||
|
||||
const OWN = Object.freeze({ latitude: 54.5, longitude: 10.2, headingDeg: 0 });
|
||||
/** One nautical mile of latitude, in degrees. */
|
||||
const NM_LAT = 1 / 60;
|
||||
/** One nautical mile of longitude at 54.5°N, in degrees. */
|
||||
const NM_LON = 1 / (60 * Math.cos((54.5 * Math.PI) / 180));
|
||||
|
||||
function contact(id, northNm, eastNm, extra = {}) {
|
||||
return {
|
||||
id,
|
||||
name: id,
|
||||
latitude: OWN.latitude + northNm * NM_LAT,
|
||||
longitude: OWN.longitude + eastNm * NM_LON,
|
||||
course: null,
|
||||
color: '#fff',
|
||||
stale: false,
|
||||
...extra,
|
||||
};
|
||||
}
|
||||
|
||||
test('the range steps 3, 6, 12, 24 NM, opens on 3 and wraps', () => {
|
||||
assert.deepEqual(RADAR_RANGES_NM, [3, 6, 12, 24]);
|
||||
assert.equal(DEFAULT_RADAR_RANGE_NM, 3);
|
||||
assert.equal(nextRadarRange(3), 6);
|
||||
assert.equal(nextRadarRange(6), 12);
|
||||
assert.equal(nextRadarRange(12), 24);
|
||||
assert.equal(nextRadarRange(24), 3);
|
||||
assert.equal(nextRadarRange(7), 6, 'an unknown range steps from the default');
|
||||
assert.equal(radarRangeM(6), 6 * METRES_PER_NM);
|
||||
});
|
||||
|
||||
test('range rings sit at each quarter of the range', () => {
|
||||
assert.deepEqual(radarRingsNm(6), [1.5, 3, 4.5, 6]);
|
||||
assert.deepEqual(radarRingsNm(24), [6, 12, 18, 24]);
|
||||
});
|
||||
|
||||
test('a contact dead ahead is straight up the scope', () => {
|
||||
const [ahead] = projectRadarContacts(OWN, [contact('A', 3, 0)], {
|
||||
rangeNm: 6,
|
||||
});
|
||||
assert.ok(Math.abs(ahead.x) < 0.01, `x ${ahead.x}`);
|
||||
assert.ok(Math.abs(ahead.y - 0.5) < 0.01, `y ${ahead.y}`);
|
||||
assert.ok(Math.abs(ahead.distanceNm - 3) < 0.02);
|
||||
assert.ok(Math.abs(ahead.relativeBearingDeg) < 0.5);
|
||||
});
|
||||
|
||||
test('heading-up turns the picture with the bow', () => {
|
||||
// Heading east: a contact to the north is on the port beam, one to the
|
||||
// south on the starboard beam, one to the east dead ahead.
|
||||
const own = { ...OWN, headingDeg: 90 };
|
||||
const byId = Object.fromEntries(
|
||||
projectRadarContacts(own, [
|
||||
contact('N', 2, 0),
|
||||
contact('S', -2, 0),
|
||||
contact('E', 0, 2),
|
||||
]).map((entry) => [entry.id, entry]),
|
||||
);
|
||||
assert.ok(byId.N.x < -0.3 && Math.abs(byId.N.y) < 0.02, 'north is to port');
|
||||
assert.ok(
|
||||
byId.S.x > 0.3 && Math.abs(byId.S.y) < 0.02,
|
||||
'south is to starboard',
|
||||
);
|
||||
assert.ok(Math.abs(byId.E.x) < 0.02 && byId.E.y > 0.3, 'east is ahead');
|
||||
assert.ok(Math.abs(byId.S.relativeBearingDeg - 90) < 1);
|
||||
assert.ok(Math.abs(byId.N.relativeBearingDeg + 90) < 1);
|
||||
});
|
||||
|
||||
test('a contact to starboard is right of the centre', () => {
|
||||
const [starboard] = projectRadarContacts(OWN, [contact('B', 0, 1.5)]);
|
||||
assert.ok(starboard.x > 0.2, `x ${starboard.x}`);
|
||||
assert.ok(Math.abs(starboard.y) < 0.01);
|
||||
});
|
||||
|
||||
test('course is drawn relative to the bow and stays null when unknown', () => {
|
||||
const own = { ...OWN, headingDeg: 90 };
|
||||
const [crossing, drifting] = projectRadarContacts(own, [
|
||||
contact('A', 1, 0, { course: 180 }),
|
||||
contact('B', 2, 0, { course: null }),
|
||||
]);
|
||||
assert.equal(crossing.relativeCourseDeg, 90);
|
||||
assert.equal(drifting.relativeCourseDeg, null);
|
||||
});
|
||||
|
||||
test('contacts beyond the range are left out', () => {
|
||||
const contacts = projectRadarContacts(
|
||||
OWN,
|
||||
[contact('in', 5.9, 0), contact('out', 6.2, 0), contact('far', 0, 30)],
|
||||
{ rangeNm: 6 },
|
||||
);
|
||||
assert.deepEqual(
|
||||
contacts.map((entry) => entry.id),
|
||||
['in'],
|
||||
);
|
||||
assert.ok(contacts.every((entry) => Math.hypot(entry.x, entry.y) <= 1));
|
||||
});
|
||||
|
||||
test('contacts come nearest first, capped', () => {
|
||||
const many = Array.from({ length: RADAR_MAX_CONTACTS + 15 }, (_, index) =>
|
||||
contact(`V${index}`, 0, 5.5 - index * 0.07),
|
||||
);
|
||||
const contacts = projectRadarContacts(OWN, many, { rangeNm: 6 });
|
||||
assert.equal(contacts.length, RADAR_MAX_CONTACTS);
|
||||
for (let index = 1; index < contacts.length; index += 1)
|
||||
assert.ok(contacts[index - 1].distanceNm <= contacts[index].distanceNm);
|
||||
assert.equal(
|
||||
projectRadarContacts(OWN, many, { rangeNm: 6, maxCount: 3 }).length,
|
||||
3,
|
||||
'a smaller cap is honoured',
|
||||
);
|
||||
});
|
||||
|
||||
test('a picture carries the range, rings, heading and own course over ground', () => {
|
||||
const picture = radarPicture(
|
||||
{ ...OWN, headingDeg: 350, courseDeg: 10 },
|
||||
[contact('A', 1, 0)],
|
||||
12,
|
||||
);
|
||||
assert.equal(picture.rangeNm, 12);
|
||||
assert.deepEqual(picture.ringsNm, [3, 6, 9, 12]);
|
||||
assert.equal(picture.headingDeg, 350);
|
||||
assert.equal(picture.ownRelativeCourseDeg, 20);
|
||||
assert.equal(picture.contacts.length, 1);
|
||||
assert.ok(picture.contacts[0].x > 0, 'north is to starboard of 350°');
|
||||
assert.equal(radarPicture(OWN, [], 6).ownRelativeCourseDeg, null);
|
||||
});
|
||||
Reference in new issue
Block a user