feat(globe): dynamic lines on both engines

engine.lines.createLine({ id, widthPx, color, depthFailAlpha, dash
({ lengthPx, gapPx } | 'tactical'), arc ('none'|'geodesic'), modelMatrix,
pickId }) → a Line: setPositions (Cartesian3[] or a flat Float64Array),
setColor, setModelMatrix, show, destroy; lines.list() for QA. Options,
flat positions, geodesic densification (great circles of the geodetic
normals, height interpolated, one step per degree) and the registry are
engine-neutral (src/globe/lines.js); the fake engine keeps every line.

- Cesium: a Primitive of a PolylineGeometry (synchronous, rebuilt when
  the positions change) with a PolylineMaterialAppearance in an
  engine-owned collection; depthFailAlpha is depthFailAppearance with the
  alpha scaled; pixel dashes are PolylineDash (16-bit pattern); the
  tactical dash is the launches' selected-orbit shader under its own type
  (launches keep theirs until Task 15a moves them onto engine.lines).
- Navara: a public MeshDesc (transparent pass, unlit) holding a ribbon
  of one quad per segment, widened to CSS pixels in the vertex shader;
  a second copy drawn with GreaterDepth and the alpha scaled is the
  depth-fail part; dashes are cut in the fragment shader (pixels along
  the screen direction, or the tactical pattern over the fraction along
  the line); positions relative to the first point, the model matrix on
  the group. Geodesic arcs are densified on the CPU. Not pickable yet.
- The contract suite draws a three-point line on both engines: magenta
  along both segments, nothing off it, 1° east once turned by its model
  matrix, gone when hidden; a line 30 km under the ground shows only its
  depth-fail copy, dimmer than the line.

Main chunk 2,867,499 bytes (+7,197, +0.25 %: the Cesium lines).
This commit is contained in:
German Khokhlov committed 2026-10-16 17:24:36 +04:00
1 parent 0109097440
commit 86aa0bc9ba
16 files changed
+1380 -2

No files matched your search

+33
View File
@@ -296,6 +296,37 @@
* @property {(options: MoverSetOptions) => MoverSet} createSet
* @property {() => { id: string, kind: string, count: number, capacity: number }[]} list
*
* @typedef {object} LineOptions
* A dynamic polyline (src/globe/lines.js checks and defaults these).
* @property {string} id Unique among the engine's live lines.
* @property {number} widthPx Width in CSS pixels.
* @property {number[]} color rgba in 0..1.
* @property {number} [depthFailAlpha] 0..1: where the scene hides the line, a
* copy drawn with its alpha scaled by this (Cesium's depthFailAppearance);
* 0 (the default) draws nothing there.
* @property {{ lengthPx: number, gapPx: number } | 'tactical'} [dash]
* Dashes in pixels along the screen direction (Cesium's PolylineDash), or
* the launches' selected-orbit pattern over the whole line.
* @property {'none'|'geodesic'} [arc] 'geodesic' follows great circles
* between points (Cesium's ArcType.GEODESIC); 'none' (default) draws
* straight segments.
* @property {Matrix4} [modelMatrix] Applied to the positions (an orbit ring
* turned by GMST).
* @property {any} [pickId] What a Cesium pick of the line returns (Navara
* lines are not pickable yet).
*
* @typedef {object} Line
* @property {(positions: Cartesian3[] | Float64Array) => void} setPositions
* @property {(color: number[]) => void} setColor
* @property {(matrix: Matrix4) => void} setModelMatrix
* @property {(visible: boolean) => void} show
* @property {() => void} destroy
* Every call requests a render; nothing animates on its own.
*
* @typedef {object} GlobeLines
* @property {(options: LineOptions) => Line} createLine
* @property {() => { id: string, points: number, shown: boolean }[]} list
*
* @typedef {object} GlobeEngine
* @property {'cesium'|'navara'} kind
* @property {{ container: object, canvas: object, size: () => { width: number, height: number } }} host
@@ -317,6 +348,7 @@
* @property {GlobeMaps} maps
* @property {GlobeClock} clock
* @property {GlobeMovers} movers
* @property {GlobeLines} lines
* @property {() => void} destroy
* @property {() => boolean} isDestroyed True once destroy() has run.
*/
@@ -497,6 +529,7 @@ const SHAPE = {
credits: { addStatic: isFunction },
clock: { now: isFunction, frameTime: isFunction, ticked: isEngineEvent },
movers: { createSet: isFunction, list: isFunction },
lines: { createLine: isFunction, list: isFunction },
maps: {
setBaseImagery: isFunction,
setTerrain: isFunction,