Files
gods-eye-view/src/data/aircraftIcons.js
T
German Khokhlov b14bf7e013 feat(flights): render on Navara
Task 10b. src/layers/aircraft/render/navara.js implements the aircraft
renderer contract on the engine contract alone (no three, no Cesium):
- Fleet glyphs: banks of engine.movers sprite sets (one per distance scale
  and depth mode the handles ask for; flights: one, 'always', Cesium's
  NearFarScalar), growing by doubling, from a glyph atlas of every
  aircraftIcon() kind at the fleet (64 px) and tracked (192 px) rasters
  (data/aircraftIcons: AIRCRAFT_ICON_KINDS, aircraftIconCells,
  aircraftIconAtlasLayout, drawAircraftIconAtlas). Sprite handles keep the
  Billboard field vocabulary as setters; a frame's writes commit once at
  the end of the frame listener that made them (a microtask outside one).
- Models: banks of model mover sets per glTF and look; handles report
  ready from MoverSet.ready() and computedScale from minimumPixelSize kept
  on the CPU (radiusM in the spec, the class's nativeRadiusM); poses are
  Cesium's HPR frame (modelMatrix) turned by Navara's glTF axes
  (Z_UP_TO_X_UP: its loader is already Z-up; chosen side by side with
  Cesium among six candidates).
- Tracked glyph: a sprite whose position/colour/rotation callbacks are read
  every frame in preRender; follow = engine.camera.follow with the tracked
  readout's card as its label (gevFollowHandle); current() maps the follow
  back to the tracked handle, also while follow() raises followChanged.
- Trail and live head: engine.lines (alpha 0.85, depth-fail 0.4, geodesic)
  in the gev-trail pick namespace.
- View: camera/scene adapters over engine.camera.pose() (registered with
  the engine so shared helpers project through it), frustum and horizon
  tests, frame number, engine frame events.
flights/render/navara.js registers it for 'navara' from the Navara mode's
import(); the Navara catalog now offers Live Flights.

Also: tracking a contact that is selected but no longer followed follows it
again (a camera command ends a Navara follow; on Cesium a search flight
releases trackedEntity): trackById/select re-follows instead of only
re-publishing. Behaviour change on Cesium only in that case.

Tests: the renderer on the fake engine (contract, atlas, banks, per-frame
commits, growth, tracked callbacks, follow label, model pose, trails) and
the flights logic over it (fleet, click-select, follow, re-follow after a
camera command, release, no set left behind).
2026-10-17 02:15:04 +04:00

341 lines
16 KiB
JavaScript
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
// src/data/aircraftIcons.js
/**
* Nose-up white aircraft silhouettes, one per classifyAircraft() kind, as SVG
* data URIs for Cesium billboards.
*
* FIDELITY NOTE (2026-07-02): redrawn at a 96×96 viewBox (glyph centered at
* 48,48) instead of the old 32×32. The billboards themselves are still added at
* width/height 20 (24 tracked) in flights.js / militaryFlights.js, so Cesium
* DOWN-samples this larger, higher-precision source to the same on-screen
* footprint — crisp anti-aliased edges instead of an upscaled 32px bitmap. The
* on-screen size is unchanged and CLASS_SCALE_2D is untouched (no scale
* compensation needed: the billboard's explicit width/height, not the SVG's,
* sets the pixel size — the intrinsic SVG size only controls raster fidelity).
*
* All glyphs are nose-up (nose toward -Y at rotation 0; the screen-projected
* rotation pipeline in iconOrientation.js spins the whole glyph). Fill is white
* with a subtle dark hairline stroke so the tint pipeline (billboard.color =
* white / cyan-tracked / amber-military, plus .withAlpha fades) keeps working —
* no per-glyph hardcoded colors that would fight the tint.
*
* MIXED-SET UPDATE (2026-08-15, owner Hangar picks): airliner/widebody/
* turboprop/helicopter use the "refined" recognition-chart redraw;
* quadjet/glider use the "bold" chart-symbol redraw; light/fastjet keep the
* original drawings. Raster fidelity doubled (192px source, same 96 coords).
*
* Silhouette language follows skylight's type-aware glyphs (MIT,
* https://github.com/cpaczek/skylight): slender fuselages, swept wings for
* jets, long high-aspect wings for the glider, straight wings + prop discs for
* props, a rotor disc + tail boom + tail-rotor for the helicopter, and a delta
* for the fast jet. Each class has a DISTINCT planform so it reads at ~20px by
* shape, not just by footprint size.
*/
const VIEW = 96;
const C = VIEW / 2; // 48 — glyph centre
// Hairline dark edge (scaled for the 96 box: ~1.5u ≈ the old 0.5u at 32).
const STROKE =
'stroke="rgba(0,0,0,0.32)" stroke-width="1.4" stroke-linejoin="round"';
// Heavier edge for the chart-symbol ("bold") glyphs adopted 2026-08-15.
const STROKE_BOLD =
'stroke="rgba(0,0,0,0.38)" stroke-width="2" stroke-linejoin="round"';
// Softer white for translucent detail (prop discs, rotor disc) — still white so
// the tint multiplies cleanly; only the alpha differs.
const DISC = 'fill="white" fill-opacity="0.5"';
// Each body is drawn in a centred coordinate frame (origin 0,0 = glyph centre),
// nose toward -Y. Numbers are in the 96-unit space (half-extent up to ~45).
const BODIES = {
// ── Airliner: slender swept-wing narrow-body, two underwing engine pods,
// swept tailplane. The canonical jet; everything else reads against it.
airliner: `
<path d="M0,-42 C 3.8,-40 4.6,-34 4.6,-26 L 4.6,-14
L 32,4 L 34,6 L 34,10 L 31.4,9.2 L 4.6,2.4
L 4.2,20
L 14,28 L 14,32 L 0,28.6 L -14,32 L -14,28 L -4.2,20
L -4.6,2.4 L -31.4,9.2 L -34,10 L -34,6 L -32,4 L -4.6,-14
L -4.6,-26 C -4.6,-34 -3.8,-40 0,-42 Z" fill="white" ${STROKE}/>
<path d="M-15.5,-1.5 l3,7.6 4,-1.4 -1.5,-8.4 Z" fill="white"/>
<path d="M15.5,-1.5 l-3,7.6 -4,-1.4 1.5,-8.4 Z" fill="white"/>
<path d="M-1.6,33.5 L 1.6,33.5 L 1.6,40 L -1.6,40 Z" fill="white"/>`,
// ── Widebody: same swept jet but noticeably BIGGER span + fatter fuselage,
// twin engines set further out. Reads as a heavier airliner.
widebody: `
<path d="M0,-45 C 5.6,-43 6.8,-36 6.8,-27 L 6.8,-12
L 38,9 L 41.5,12.4 L 41.5,16.6 L 37.6,15 L 6.8,6
L 6.3,21
L 17,30 L 17,34.6 L 0,30.4 L -17,34.6 L -17,30 L -6.3,21
L -6.8,6 L -37.6,15 L -41.5,16.6 L -41.5,12.4 L -38,9 L -6.8,-12
L -6.8,-27 C -6.8,-36 -5.6,-43 0,-45 Z" fill="white" ${STROKE}/>
<path d="M-19,2 l3.6,9 4.8,-1.7 -1.8,-10 Z" fill="white"/>
<path d="M19,2 l-3.6,9 -4.8,-1.7 1.8,-10 Z" fill="white"/>
<path d="M-2,35.5 L 2,35.5 L 2,42.5 L -2,42.5 Z" fill="white"/>`,
// ── Quadjet: the widest swept jet, with FOUR bold underwing engine pods (two
// per wing) that hang well below the trailing edge — the wing reads as a
// 4-lumped bar even when the individual pods blur together at ~20px.
quadjet: `
<path d="M0,-45 C 7,-42 9,-34 9,-25 L 9,-11
L 46,12 L 46,21 L 9,11.5
L 8.4,21 L 20,31 L 20,37.5 L 0,32 L -20,37.5 L -20,31 L -8.4,21
L -9,11.5 L -46,21 L -46,12 L -9,-11
L -9,-25 C -9,-34 -7,-42 0,-45 Z" fill="white" ${STROKE_BOLD}/>
<rect x="-31" y="9" width="7" height="12" rx="2" fill="white"/>
<rect x="-17" y="4.5" width="7" height="12" rx="2" fill="white"/>
<rect x="10" y="4.5" width="7" height="12" rx="2" fill="white"/>
<rect x="24" y="9" width="7" height="12" rx="2" fill="white"/>`,
// ── Turboprop: bold STRAIGHT (unswept) wings — thicker chord than a jet — two
// fat nacelles that jut ahead of the leading edge, each capped by a solid
// prop disc. Reads as "straight wing with two lumps + discs" at ~20px.
turboprop: `
<path d="M0,-40 C 3.4,-38.5 4.2,-33 4.2,-26 L 4.2,-18
L 36,-15.5 L 36,-7.5 L 4.2,-8
L 3.8,22
L 13,27.5 L 13,31.5 L 0,28.6 L -13,31.5 L -13,27.5 L -3.8,22
L -4.2,-8 L -36,-7.5 L -36,-15.5 L -4.2,-18
L -4.2,-26 C -4.2,-33 -3.4,-38.5 0,-40 Z" fill="white" ${STROKE}/>
<circle cx="-17.5" cy="-16.5" r="7.5" fill="white" fill-opacity="0.5"/>
<circle cx="17.5" cy="-16.5" r="7.5" fill="white" fill-opacity="0.5"/>
<path d="M-19.5,-19 h4 v5 h-4 Z" fill="white"/>
<path d="M15.5,-19 h4 v5 h-4 Z" fill="white"/>
<path d="M-1.7,31.5 L 1.7,31.5 L 1.7,38.5 L -1.7,38.5 Z" fill="white"/>`,
// ── Light GA: small and CHUNKY — short, DEEP-chord straight wings and a fat
// stubby fuselage make it read as a solid little block (not a thin cross),
// with a bold nose prop disc. The short deep wing is the anti-glider cue.
light: `
<path d="M0,-27
C 4,-25 5.2,-20 5.2,-13
L 5.2,-9
L 27,-9 L 27,6 L 5.2,6
L 5.2,16
L 11.5,23 L 11.5,27 L 0,23.5 L -11.5,27 L -11.5,23 L -5.2,16
L -5.2,6
L -27,6 L -27,-9 L -5.2,-9
L -5.2,-13
C -5.2,-20 -4,-25 0,-27 Z" fill="white" ${STROKE}/>
<ellipse cx="0" cy="-29" rx="12" ry="3.8" ${DISC}/>`,
// ── Glider: VERY long, high-aspect TAPERED wings (fat root → thin tips) on a
// slim fuselage with a T-tail. The extreme span is the whole identity — it
// reads as "the wide skinny one" against light's short stubby wings.
glider: `
<path d="M0,-35 C 2.4,-33 3,-29 3,-25 L 3,-14
L 45,-10.5 L 45,-3.5 L 2.9,-6
L 2.2,32 L -2.2,32 L -2.9,-6
L -45,-3.5 L -45,-10.5 L -3,-14
L -3,-25 C -3,-29 -2.4,-33 0,-35 Z" fill="white" ${STROKE_BOLD}/>
<rect x="-10.5" y="32.5" width="21" height="5" rx="1.5" fill="white" ${STROKE_BOLD}/>`,
// ── Helicopter: a SOLID translucent main-rotor disc (survives downscale as an
// obvious circle, unlike a thin ring) with a bold two-blade cross, a
// teardrop cabin, a tail boom, and a tail rotor. Unmistakable "disc on top"
// silhouette that never reads as a fixed-wing.
helicopter: `
<circle cx="0" cy="-6" r="31" fill="white" fill-opacity="0.22"/>
<g transform="rotate(45 0 -6)">
<rect x="-30.5" y="-8.2" width="61" height="4.4" rx="2.2" fill="white" fill-opacity="0.9"/>
<rect x="-30.5" y="-8.2" width="61" height="4.4" rx="2.2" fill="white" fill-opacity="0.9" transform="rotate(90 0 -6)"/>
</g>
<path d="M0,-22 C 8,-20 10.5,-13 10.5,-6 C 10.5,2 7.5,7 0,8.5
C -7.5,7 -10.5,2 -10.5,-6 C -10.5,-13 -8,-20 0,-22 Z" fill="white" ${STROKE}/>
<path d="M-2.6,8 L 2.6,8 L 1.8,32 L -1.8,32 Z" fill="white" ${STROKE}/>
<path d="M-8,27 L 8,27 L 8,30.6 L -8,30.6 Z" fill="white"/>
<circle cx="5.6" cy="35" r="6" fill="white" fill-opacity="0.6"/>
<circle cx="5.6" cy="35" r="2.1" fill="white"/>`,
// ── Fast jet: sharp delta/cropped-delta with a pointed nose, LERX root
// blend, and twin tail fins. Aggressive, all-wing.
fastjet: `
<path d="M0,-43
L 3.5,-30
C 4,-24 4.6,-16 5,-8
L 27,20 L 27,26 L 6,16
L 8,30 L 8,34 L 3,31
L 3,38 L 6.5,42 L 6.5,44 L 0,41.5
L -6.5,44 L -6.5,42 L -3,38
L -3,31 L -8,34 L -8,30 L -6,16
L -27,26 L -27,20 L -5,-8
C -4.6,-16 -4,-24 -3.5,-30 Z" fill="white" ${STROKE}/>`,
// 2026-08-15 Hangar additions: two NEW classes shipped with the real-model
// fleet (CLASS_MODEL_REAL). Same contract as the set above: 96×96 nose-up,
// white fill, hairline stroke, tint-safe.
// Business jet — slender fuselage, modest swept wing, aft engines, T-tail.
bizjet: `
<path d="M0,-42
L 2.6,-36 L 3.4,-26 L 3.4,-8
L 27,8 L 27,13 L 3.6,6
L 3.6,16
L 8,18 L 8,26 L 3.8,25
L 3.2,30 L 15,34 L 15,38 L 2.4,36
L 0,40
L -2.4,36 L -15,38 L -15,34 L -3.2,30
L -3.8,25 L -8,26 L -8,18 L -3.6,16
L -3.6,6 L -27,13 L -27,8 L -3.4,-8
L -3.4,-26 L -2.6,-36 Z" fill="white" ${STROKE}/>`,
// ── TR-3B (hidden 9th kind, Easter egg — NOT a classifyAircraft() output).
// The canonical black-triangle silhouette: a dark isosceles delta with a
// light at each corner and a dimmer one at the centre. Reached only by
// explicit user conversion (see tr3bRegistry.js), never by classification.
//
// DELIBERATE BREAK from the white-fill contract above: this glyph is a
// SHADOW, so it carries its own near-black fill. The billboard tint still
// multiplies (white fleet / cyan tracked / amber military), which darkens
// rather than lightens — the triangle stays a silhouette in every layer,
// and the corner lights pick the tint up as their hue.
tr3b: `
<path d="M0,-38 L 40,30 L -40,30 Z"
fill="#0d1014" stroke="rgba(158,184,210,0.34)" stroke-width="1.6"
stroke-linejoin="round"/>
<circle cx="0" cy="-24" r="8.5" fill="#c9dcf0" fill-opacity="0.13"/>
<circle cx="-28" cy="21" r="8.5" fill="#c9dcf0" fill-opacity="0.13"/>
<circle cx="28" cy="21" r="8.5" fill="#c9dcf0" fill-opacity="0.13"/>
<circle cx="0" cy="-24" r="4.6" fill="#dceaf8" fill-opacity="0.52"/>
<circle cx="-28" cy="21" r="4.6" fill="#dceaf8" fill-opacity="0.52"/>
<circle cx="28" cy="21" r="4.6" fill="#dceaf8" fill-opacity="0.52"/>
<circle cx="0" cy="6" r="3.4" fill="#dceaf8" fill-opacity="0.26"/>`,
// ── TR-3B, thermal-reactive variant. Same cold airframe, but the three
// corner emitters + the centre one render HOT: near-white cores inside a
// baked radial glow, so the FLIR/NVG luminance mapping (and any bloom)
// lights them up while the hull stays cold. Selected by the layers
// whenever their `irBoost` style param is on (surveillance/thermal/nvg).
tr3bHot: `
<defs>
<radialGradient id="tr3bGlow">
<stop offset="0%" stop-color="#ffffff" stop-opacity="0.92"/>
<stop offset="32%" stop-color="#f2f9ff" stop-opacity="0.44"/>
<stop offset="100%" stop-color="#dcefff" stop-opacity="0"/>
</radialGradient>
</defs>
<path d="M0,-38 L 40,30 L -40,30 Z"
fill="#0b0e12" stroke="rgba(126,148,172,0.3)" stroke-width="1.6"
stroke-linejoin="round"/>
<circle cx="0" cy="-24" r="15" fill="url(#tr3bGlow)"/>
<circle cx="-28" cy="21" r="15" fill="url(#tr3bGlow)"/>
<circle cx="28" cy="21" r="15" fill="url(#tr3bGlow)"/>
<circle cx="0" cy="6" r="10" fill="url(#tr3bGlow)"/>
<circle cx="0" cy="-24" r="5.2" fill="#ffffff"/>
<circle cx="-28" cy="21" r="5.2" fill="#ffffff"/>
<circle cx="28" cy="21" r="5.2" fill="#ffffff"/>
<circle cx="0" cy="6" r="3.6" fill="#ffffff" fill-opacity="0.82"/>`,
// Large UAV (Reaper-class) — bulbous sensor nose, very long slender
// straight wings, slim tail boom, canted V-tail.
uav: `
<path d="M0,-40
C 3.6,-40 4.6,-35 4.4,-30
L 2.4,-12
L 43,-7 L 43,-2.5 L 2.3,0
L 2.1,24
L 13,32 L 13,36 L 1.6,30
L 0,38
L -1.6,30 L -13,36 L -13,32 L -2.1,24
L -2.3,0 L -43,-2.5 L -43,-7 L -2.4,-12
L -4.4,-30 C -4.6,-35 -3.6,-40 0,-40 Z" fill="white" ${STROKE}/>`,
};
const _iconCache = new Map();
const _b64 = (s) =>
typeof btoa === 'function'
? btoa(s)
: Buffer.from(s, 'utf8').toString('base64');
/** Fleet raster: billboards render at ~40–58 DEVICE px (width 20–24 CSS ×
* Retina × class scale). Cesium's billboard atlas has no mipmaps, so a big
* texture gets GPU-minified into mush (192 px ÷ 40 = 4.8× — the owner's
* "soft" glyphs; the pre-2026-08-15 96 px raster aliased instead). Rastering
* NEAR the display size lets the browser's SVG AA do the work: crisp AND
* smooth. 64 covers the 40–58 px fleet band with ≤1.6× minification. */
const FLEET_RASTER_PX = 64;
/** Tracked raster: the tracked billboard is the one SUSTAINED large 2D glyph
* (close-zoom fleet flybys hand off to 3D models). Keep the 192 px texture so
* it stays crisp at its biggest on-screen sizes. */
const TRACKED_RASTER_PX = 192;
/** Data URI for a class silhouette (lazily built, cached per kind+size).
* Default size serves the fleet; pass `aircraftIcon(kind, TRACKED_ICON_PX)`
* (re-exported below) for the tracked billboard. */
export const TRACKED_ICON_PX = TRACKED_RASTER_PX;
/** The fleet raster size (aircraftIcon's default). */
export const FLEET_ICON_PX = FLEET_RASTER_PX;
/** Every silhouette kind aircraftIcon draws (an engine's sprite atlas). */
export const AIRCRAFT_ICON_KINDS = Object.freeze(Object.keys(BODIES));
export function aircraftIcon(kind, px = FLEET_RASTER_PX) {
const k = BODIES[kind] ? kind : 'airliner';
const key = `${k}@${px}`;
let uri = _iconCache.get(key);
if (!uri) {
const svg = `<svg xmlns="http://www.w3.org/2000/svg" width="${px}" height="${px}" viewBox="0 0 ${VIEW} ${VIEW}"><g transform="translate(${C},${C})">${BODIES[k]}</g></svg>`;
uri = 'data:image/svg+xml;base64,' + _b64(svg);
_iconCache.set(key, uri);
}
return uri;
}
// ---------------------------------------------------------------------------
// The glyph atlas (engines that draw sprites from one texture: Navara)
// ---------------------------------------------------------------------------
const ATLAS_PAD = 2;
const atlasCellKey = (kind, px) => `${kind}@${px}`;
/** Every aircraftIcon() data URI → its atlas cell key (`${kind}@${px}`). */
export function aircraftIconCells() {
const cells = new Map();
for (const kind of AIRCRAFT_ICON_KINDS)
for (const px of [FLEET_RASTER_PX, TRACKED_RASTER_PX])
cells.set(aircraftIcon(kind, px), atlasCellKey(kind, px));
return cells;
}
/**
* The atlas layout (pure): the tracked raster in row 0, the fleet raster in
* row 1, one column per kind, ATLAS_PAD px around each cell; cells are
* [u0, v0, u1, v1] in 0..1.
*/
export function aircraftIconAtlasLayout(kinds = AIRCRAFT_ICON_KINDS) {
const big = TRACKED_RASTER_PX + 2 * ATLAS_PAD;
const small = FLEET_RASTER_PX + 2 * ATLAS_PAD;
const width = kinds.length * big;
const height = big + small;
const rects = new Map();
const cells = {};
kinds.forEach((kind, column) => {
for (const [px, row] of [
[TRACKED_RASTER_PX, 0],
[FLEET_RASTER_PX, big],
]) {
const x = column * big + ATLAS_PAD;
const y = row + ATLAS_PAD;
const key = atlasCellKey(kind, px);
rects.set(key, { x, y, size: px });
cells[key] = [x / width, y / height, (x + px) / width, (y + px) / height];
}
});
return { width, height, rects, cells };
}
/** Draws the atlas (browser): a canvas and its cells, once the SVGs decode. */
export async function drawAircraftIconAtlas() {
const layout = aircraftIconAtlasLayout();
const canvas = document.createElement('canvas');
canvas.width = layout.width;
canvas.height = layout.height;
const context = canvas.getContext('2d');
await Promise.all(
[...aircraftIconCells()].map(async ([uri, key]) => {
const image = new Image();
image.src = uri;
await image.decode();
const { x, y, size } = layout.rects.get(key);
context.drawImage(image, x, y, size, size);
}),
);
return { canvas, cells: layout.cells };
}