mirror of
https://github.com/bilawalsidhu/gods-eye-view.git
synced 2026-11-20 18:22:25 +00:00
Merge branch 'main' into codex/fix-annotation-height-culling
This commit is contained in:
388 files changed
+32116
-1778
No files matched your search
@@ -0,0 +1,138 @@
|
||||
# GEV cameras in Blender
|
||||
|
||||
Export the cameras of one saved Director scene as a camera-only USD stage
|
||||
(`.usda`, plain text) and open it with Blender's built-in importer. The export
|
||||
needs no API key, network, browser or Blender add-on and contains no imagery or
|
||||
geometry, so use independently licensed assets for your set.
|
||||
|
||||
## Export a saved scene
|
||||
|
||||
Save a Director project as JSON, then run from the repository root:
|
||||
|
||||
```sh
|
||||
mkdir -p output
|
||||
node tools/export-blender-camera.mjs --input scene.json --output output/cameras.usda --scene my-scene-id --origin 39.7,-105,1600 --fps 30000/1001 --width 1920 --height 1080 --horizontal-fov-deg 70
|
||||
```
|
||||
|
||||
Paths are relative to the current directory; `output/` is ignored by git.
|
||||
Omit `--scene` only when the document contains exactly one scene. `--output`
|
||||
is required and must be a new file ending in `.usda`; the tool refuses to
|
||||
overwrite it. No environment files are read.
|
||||
|
||||
`--origin` is latitude, longitude and **WGS84 ellipsoid height in meters**.
|
||||
Positions and sampled paths must remain within 100 km of that origin. Heights
|
||||
are never implicitly converted from mean sea level or above ground level.
|
||||
Positions must be complete; legacy documents without saved IDs or positions
|
||||
need to be saved again in GEV before export.
|
||||
|
||||
Projection and fps are required because Director documents do not record a
|
||||
viewport lens, aspect ratio or video frame rate. `--horizontal-fov-deg` is the
|
||||
horizontal perspective FOV in degrees, even for portrait output. If deriving it
|
||||
from a Cesium `PerspectiveFrustum`, use
|
||||
`2 * atan(tan(fovy / 2) * aspectRatio) * 180 / π` (`fovy` is in radians).
|
||||
Do not assume `frustum.fov` is horizontal: it is the wider-dimension FOV.
|
||||
The optional `--sensor-width-mm` defaults to 36; focal length is
|
||||
`sensorWidthMm / (2 * tan(horizontalFovRadians / 2))`.
|
||||
|
||||
The exporter supports integer fps or an integer ratio such as `30000/1001`,
|
||||
with an effective rate from 1 to 240. Image dimensions are integers from 4 to
|
||||
16384, pixels are square, horizontal FOV is 1 to 179 degrees and sensor width
|
||||
is 1 to 100 mm. A lens shorter than Blender's 1 mm minimum is rejected.
|
||||
Input must be a regular file within the existing 5 MiB scene-document limit;
|
||||
output is limited to 100,000 frames and 64 MiB. Every shot needs at least one
|
||||
sampled frame.
|
||||
|
||||
## Timing and camera semantics
|
||||
|
||||
Timing is the Director's **runtime** seek timing. The exporter loads the
|
||||
document as Director does, so ordinary shots fly for at least 0.2 s, and takes
|
||||
each shot's length and hold from `shotRuntimeTiming` in
|
||||
`src/scenes/shotPresentation.js` with the default scene packs. Registered hold
|
||||
overrides, minimum holds and evidence-sequence durations therefore move later
|
||||
shots as they do when seeking in the app. Live playback can run longer when it
|
||||
waits for a layer's media. Saved shots are never rewritten; each camera
|
||||
records both the authored and the runtime hold.
|
||||
|
||||
Each frame's camera is the Director's `sceneSeekState` pose at that time.
|
||||
Named anchors and explicit `move.from` endpoints resolve through the existing
|
||||
camera owner, and explicit linear/cubic moves use its sampler. Ordinary shots
|
||||
interpolate cubically, by the shortest angle, from the previous shot's camera;
|
||||
a shot that opens the scene starts at its own camera. A cut can be authored as
|
||||
an explicit move with identical start/end poses.
|
||||
|
||||
The bridge does not reproduce Cesium's implicit live `flyTo` trajectory,
|
||||
provider readiness, layer-owned camera motion, lens changes, visual effects,
|
||||
media or geometry. Export authored camera moves when repeatable playback
|
||||
framing is required. This feature does not depend on GEV video export.
|
||||
|
||||
Frame 1 samples time zero. Frame `n` samples `(n - 1) * denominator / numerator`
|
||||
seconds. The final sample precedes the exclusive scene end; frame count is the
|
||||
ceiling of duration times fps, with rounding noise at integer boundaries removed.
|
||||
Shot ranges are half open: `frameStart <= frame < frameEndExclusive`. A shot
|
||||
boundary switches at the first sampled time at or after the boundary.
|
||||
|
||||
## What the USD stage contains
|
||||
|
||||
- Stage metadata `upAxis = "Z"` and `metersPerUnit = 1`. Scene X/Y/Z are
|
||||
east/north/up in meters around `--origin`, in the geodetic ENU frame (axes
|
||||
from the WGS84 ellipsoid normal at the origin's latitude and longitude), so
|
||||
Blender applies no axis or unit conversion.
|
||||
- USD time codes equal frame numbers: `startTimeCode = 1`, `endTimeCode` is the
|
||||
last frame, and `timeCodesPerSecond`/`framesPerSecond` hold the effective
|
||||
rate. The exact fps ratio is kept as text.
|
||||
- A root `GEV` transform at identity, with one perspective `Camera` per shot
|
||||
named `Shot_001_<id>`, `Shot_002_<id>` and so on. Each camera has an
|
||||
`xformOp:transform` matrix time sample on every frame of its own shot range,
|
||||
and holds its first or last pose outside that range. Camera local X points
|
||||
right, local Y up and local -Z forward, which is both the USD and the Blender
|
||||
camera convention.
|
||||
- Lens attributes in USD's units: `focalLength`, `horizontalAperture` and
|
||||
`verticalAperture` are in **tenths of a scene unit**, so with
|
||||
`metersPerUnit = 1` one unit of these attributes is 100 mm. A 25 mm lens on
|
||||
a 36 mm sensor is written as `focalLength = 0.25` and
|
||||
`horizontalAperture = 0.36`. The vertical aperture is the sensor width times
|
||||
`height / width`, so it matches the output aspect.
|
||||
- Clipping range 0.01 m to 200 km; adjust it for your set if needed.
|
||||
- Source scene and shot IDs, titles, pack identifiers, authored and runtime
|
||||
timing, frame ranges, origin, fps ratio, image size and data-pack
|
||||
attribution text, as `userProperties:` attributes. No referenced assets are
|
||||
fetched.
|
||||
|
||||
## Import into Blender
|
||||
|
||||
1. In Blender, choose **File > Import > Universal Scene Description**, select
|
||||
the `.usda` file and keep **Set Frame Range** enabled.
|
||||
2. Set **Output Properties > Format** to the exported `--width`, `--height` and
|
||||
frame rate, with **Aspect X:Y** at 1:1. USD carries the time codes but not
|
||||
render resolution, and Blender does not take its scene frame rate from the
|
||||
file.
|
||||
3. Pick a shot camera as the active camera, or bind cameras to timeline markers
|
||||
at each shot's `gevFrameStart` (shown under **Object Data Properties >
|
||||
Custom Properties**).
|
||||
|
||||
How Blender maps the lens: its USD importer multiplies `focalLength` and the
|
||||
apertures by `100 * metersPerUnit` to get millimeters. With this exporter's
|
||||
`metersPerUnit = 1` that is ×100, so the imported **Focal Length** and
|
||||
**Sensor Width** equal the `lensMm` and `--sensor-width-mm` values. Blender
|
||||
chooses horizontal sensor fit when the horizontal aperture is at least as large
|
||||
as the vertical one and vertical fit otherwise, so portrait exports import with
|
||||
vertical fit and the same field of view. This mapping is in Blender's
|
||||
`usd_reader_camera.cc`.
|
||||
|
||||
Blender imports animated USD transforms as a **Transform Cache** constraint
|
||||
that keeps the absolute path of the imported `.usda`. Put the file in its
|
||||
permanent place before importing, or update the path in the constraint after
|
||||
moving it. For a self-contained file, select the cameras and use **Object >
|
||||
Animation > Bake Action…** with **Visual Keying** and **Clear Constraints**.
|
||||
Blender stores object transforms in single precision: up to about 4 mm of
|
||||
rounding at 100 km, less closer to the origin.
|
||||
|
||||
## Checks
|
||||
|
||||
```sh
|
||||
node --test src/tooling/blender*.test.mjs
|
||||
```
|
||||
|
||||
The tests compare the export with an independent Cesium camera and the
|
||||
Director's runtime timing, and parse the stage with OpenUSD's `usdcat` when it
|
||||
is installed.
|
||||
+367
-35
@@ -10,6 +10,20 @@ or an older position from another feed) and one reported slower than 2 m/s
|
||||
give no course and keep the last; an aircraft with no course at all faces
|
||||
north.
|
||||
|
||||
A selected vessel, aircraft or military aircraft can be found again from its
|
||||
Context card. While it is off screen, behind the globe or out of its layer's
|
||||
feed (the clock jumped to a time the feed lacks it, or the view moved away
|
||||
from it), the card's header shows Find it (`store.locate()`,
|
||||
`src/ui/stores/entityCard.js`). One still in its feed is flown to (an
|
||||
aircraft followed). One out of its feed is looked up at the layer's time on
|
||||
its own track (`locate` on the vessels, flights and military layers, through
|
||||
`locateOnTrack` in `src/data/locate.js`): the newest point at or before the
|
||||
world clock's time while the layer follows the clock, else the newest. The card
|
||||
moves to it and says how old that reading is, and the camera flies there. Once
|
||||
the feed has it again, its layer selects it again (an aircraft is followed).
|
||||
With no point at or before the time, the card says there is no reading then and
|
||||
the camera stays. A followed item is never counted as off screen.
|
||||
|
||||
While anything moves (a layer in motion, the camera, a followed contact), the
|
||||
globe draws at the display's own refresh rate; there is no fixed 60 FPS cap.
|
||||
The render governor (`src/renderGovernor.js`) caps a parked scene at
|
||||
@@ -93,6 +107,16 @@ settling. Oblique views below 300 km are left alone.
|
||||
`QA_BASE_URL=http://localhost:4173 node scripts/qa-zoom-out-guard.mjs` exercises
|
||||
the real browser controller at desktop and phone widths with keyless fixtures.
|
||||
|
||||
Below 150 km Cesium sizes a wheel or pinch zoom step from the depth it picks at
|
||||
the canvas centre. Icons drawn over depth (aircraft, vessels and most markers:
|
||||
`disableDepthTest: Infinity`) sit on the near plane and write a depth of
|
||||
exactly 0 there (`src/render/cesium/iconSetPrimitive.js`), which that pick
|
||||
reads as nothing drawn, so it keeps the ground under the icon. Any depth past
|
||||
the near plane would be taken for a surface a near plane's distance from the
|
||||
camera, and the zoom would stop while an icon is under the centre.
|
||||
`QA_BASE_URL=http://localhost:5173 node scripts/qa-zoom-under-icon.mjs` checks
|
||||
this against a dev server (`npm run dev`).
|
||||
|
||||
Cesium's free look (Shift+drag, which turns the camera in place) works only
|
||||
below 1,000 km. Above that height a few drags could turn the whole planet out of
|
||||
frame and leave only stars, so Shift+drag does nothing there. Cesium also turns
|
||||
@@ -1200,9 +1224,11 @@ every width, right to left it takes the bottom right at every width, and
|
||||
`src/ui/creditLineHeight.js` keeps its height in `--credit-line-height`: the
|
||||
coordinates (and, right to left, the Tactical readout) stay 6px above it
|
||||
however many lines it wraps onto, and the dock and World Timeline rise when
|
||||
it is taller than their usual clearance. Narrower than 1120px the dock leaves
|
||||
no room between the corners, so the coordinates and the readout sit above
|
||||
the dock, and above the World Timeline while it shows. Outside that layout
|
||||
it is taller than their usual clearance. The World Timeline takes the dock's
|
||||
floor and the dock (with the Omnibar's field) sits above it, rising by the
|
||||
bar's height while it shows, as the plain dock does. Narrower than 1120px the
|
||||
dock leaves no room between the corners, so the coordinates and the readout
|
||||
sit above the dock. Outside that layout
|
||||
Cesium's credit box wraps from 1200px, as before; the phone shell, clean
|
||||
view, recording and scene playback lay the line out themselves.
|
||||
The left rail treats the centered World Timeline and voice control as
|
||||
@@ -1560,6 +1586,10 @@ seek and keeps the last settled position. Undeclared operator layers remain
|
||||
untouched, and the shot is not rebuilt.
|
||||
See [camera directions](DIRECTOR-CAMERA.md).
|
||||
|
||||
An opt-in offline [Blender camera bridge](BLENDER-CAMERAS.md) exports a saved
|
||||
Director scene as a camera-only USD stage (`.usda`) with Director seek
|
||||
interpolation and runtime shot timing; format, units and limits are in that guide.
|
||||
|
||||
Realtime voice composes separate connection, response/tool, Radio handoff, input
|
||||
and audio-meter, cost, viewport-context and diagnostic owners. The existing
|
||||
controller exports and session/backend contracts remain available. Tool protocol,
|
||||
@@ -1938,6 +1968,16 @@ The row count explicitly says **nearby**: loaded records can be outside the
|
||||
screen. Cyan camera badges use Manjunath's camera artwork; selection switches to a
|
||||
larger coral badge with corner brackets and an animated tactical card. Numeric
|
||||
mapped bearings draw illustrative 90 m direction wedges (not measured coverage).
|
||||
A camera whose OSM `model` tag names known hardware (Motorola Solutions Vigilant,
|
||||
Genetec AutoVu, Axis, Verkada, Bosch MIC; 408 of the 1,567 tagged cameras
|
||||
in October 2026) gets a `SPEC` line on its card from vendored datasheet records
|
||||
(`src/layers/alpr/modelSpecs.js`, matched with the CCTV layer's
|
||||
`createModelSpecLookup`). A `manufacturer` naming another maker rejects the
|
||||
match, and the raw tag text is never shown.
|
||||
Unversioned `AutoVu SharpV` and `AutoVu SharpX` tags show no specs; G1/G2
|
||||
tags show the G2 (1280x960) record and G3 tags the G3 record. The default
|
||||
hourly extract has no `model` field yet; an Overpass-backed source or a custom
|
||||
adapter record's optional `model` fills it.
|
||||
The shared overlay paints gradients for at most 64 nearby cameras, promoting the
|
||||
selected camera; farther cameras keep native Cesium badges without wedges.
|
||||
Native ground-clamped wedges (a ground polyline plus a classification polygon per
|
||||
@@ -1998,16 +2038,54 @@ and follows redirects only on the camera's origin. Catalog image URLs, and
|
||||
redirects on those hosts, are pinned by parsed URL to the agency's image
|
||||
directory. Every `/api/cctv` route refuses cross-site browser requests but
|
||||
accepts forwarding headers, so cameras work behind a reverse proxy; a forwarded
|
||||
request skips the key-bearing Street View fallback and gets the placeholder.
|
||||
request skips the key-bearing Street View fallback and gets the placeholder. The
|
||||
fallback answers only for cameras the server lists, at their catalog position,
|
||||
so position calibration never reaches it. Heading, field of view (clamped to
|
||||
20–120°) and pitch (clamped to −40–20°) come from the request, else from the
|
||||
catalog pose. A bundled seed camera, shown when the server catalog is empty,
|
||||
gets the placeholder. The fallback counts in its own per-IP Google window (see
|
||||
the cost-bearing proxies below).
|
||||
|
||||
The CCTV layer draws only the cameras on or near the screen. Zoomed out, it
|
||||
keeps one camera per ground cell sized to the view, preferring a healthy feed,
|
||||
and the cells are anchored to the ground so a pan keeps the same cameras. The
|
||||
active camera always shows. Ground placement and coverage geometry load only
|
||||
for the cameras in view, with at most two attempts per camera and view regime.
|
||||
The view pass reruns while the camera moves, paced by its own cost. The camera
|
||||
picker lists the cameras in view, active camera first, and closes with the
|
||||
count of cameras outside the view.
|
||||
The CCTV layer draws only the cameras on or near the screen. Zoomed out, a
|
||||
ground cell with two or more cameras shows one marker at their mean position. A
|
||||
green camera pictogram sits under its top edge and the count just below its
|
||||
middle. The marker grows with the count and paints on the world overlay at
|
||||
callout resolution. The count covers the whole cell up to the horizon, including
|
||||
its off-screen cameras. Overlapping markers merge and add their counts. A lone
|
||||
camera whose icon would touch a marker joins the nearest one, unless the HUD
|
||||
hides the merged marker. In that case the lone camera keeps its icon and the
|
||||
count stays where it was before the merge. If the marker there would still cover
|
||||
the icon, the camera stays in its count when the label fits. The active camera
|
||||
keeps its own icon beside any marker that would cover it and stays out of the
|
||||
count. A click on a marker zooms in on its group, at least halving the distance
|
||||
each time. If halving would leave the group wider or taller than the frame, the
|
||||
view zooms in on the nearest of the group's ground cells with two or more
|
||||
cameras. The cockpit or a tracked object holds the view in place. Ambient cards
|
||||
and coverage attach only to
|
||||
cameras drawn as icons. On a globe map a marker stands on the drawn terrain. A
|
||||
camera the height batch never answered for takes the drawn terrain as its ground
|
||||
once it is near the screen. It reads that height again from much closer, once
|
||||
the terrain in view has loaded, or when the terrain source changes. A later
|
||||
Re:Earth answer replaces it. A fallback preserves it. Close up every camera
|
||||
shows. Cameras on one mount draw side by side and their records keep the mount.
|
||||
Ground placement has at most two attempts per camera and view regime. The view
|
||||
pass reruns while the camera moves, paced by its own cost, and when the terrain
|
||||
in view finishes loading. The camera picker lists the active camera first, then
|
||||
one camera per visible cell, preferring healthy feeds. It ends with the count of
|
||||
catalog cameras missing from the list.
|
||||
|
||||
Turning CCTV on opens on the camera nearest the view. Until someone picks a
|
||||
camera, each settled move, such as a shared view's flight landing, moves it to
|
||||
the camera then nearest the view. Automatic selection ends at the first pick:
|
||||
NEAREST, PREV or NEXT, FOCUS, a camera chosen in the picker, a click on a
|
||||
camera, a click on empty ground that deselects, an auto-hop step, or a call to
|
||||
`selectCamera`, `focusNearest`, `focusNearestToPoint` or
|
||||
`setParams({ selectedCameraId })`, which voice and scenes use. Picking the
|
||||
camera that is already active counts. The picker shows the automatic camera
|
||||
as its own option, and a native list sends no change for the option it
|
||||
already shows, so the list cannot pick that camera: FOCUS does, and so does
|
||||
NEAREST when that camera is the nearest. Closing the list without a choice
|
||||
keeps automatic selection.
|
||||
|
||||
Traffic owns its rendered-surface observer only while enabled, removes it on disable/destroy, and rebuilds no cached heights on frames where the surface identity is unchanged. Its dots and heat-lines are two renderer draw sets, it animates on the frame port's preRender, and it follows the camera through the camera port at its own 5% threshold rather than the shared `percentageChanged` ledger. The surface identity is the globe port's `surfaceVersion()` and tile readiness its `isSettled('surface')`, so the layer no longer reaches Cesium. Heat-lines are always asked for draped: where the Cesium renderer cannot drape (no depth textures) its draw port draws them (and every other draped line) over the surface, in their colour where the surface hides them and hidden past the horizon, recolouring a line in place when only its colour changes, rather than the layer dropping them.
|
||||
|
||||
@@ -2046,6 +2124,213 @@ tracked satellite's dot a set of its own drawn where the follow camera framed
|
||||
it, and the orbit rings a line set dimmed behind the globe and turned with the
|
||||
Earth each second. A caller handing it a Cesium viewer, with no
|
||||
renderer bound, loads the `./render/cesium/unbound` export once first.
|
||||
|
||||
The ISS (NORAD 25544, by number, not name) is drawn as NASA's 3D model within
|
||||
1,500 km of the camera and as its dot beyond; the two split the distance range,
|
||||
so exactly one draws (the tracked dot too). The model is at its real 109 m span
|
||||
with a 72 px floor, flies the station's usual attitude (modules along the
|
||||
velocity, the same side to the Earth) from its own per-frame SGP4 sample, sits
|
||||
on the follow camera's sample while tracked, loads only once the ISS is shown,
|
||||
and hides with the dot's own rules. A click on it tracks the ISS.
|
||||
The station has several catalog entries that are one body: the ISS itself
|
||||
(listed as ISS (ZARYA)), ISS (NAUKA) and whatever vehicle is docked, each with
|
||||
a dot of its own, so a click on the station's dot can land on any of them.
|
||||
`issTrackedOnStation` (`policy.js`) treats a tracked entry as the station when
|
||||
it is the ISS or the ISS shares its position (`_dockedCompanions`). For such
|
||||
an entry the model sits on the tracked entry's own per-frame sample, as it
|
||||
does for the ISS (drawn from a later sample it stood a frame of orbital
|
||||
motion, over 100 m, off the camera's centre); its tracked dot and orbit ring
|
||||
leave the near range to the model, its card keeps clear of the model, and the
|
||||
command panel and the live video show as they do for the ISS. Such an entry
|
||||
draws no orbit ring of its own (its elements would put a second line beside
|
||||
the ISS's through the same station): when tracking judges it docked (both
|
||||
orbits at one instant within 5 km) the ISS's ring shows for it, even with the
|
||||
Stations class hidden.
|
||||
In the Cockpit, a station entry is ridden from the station itself instead of
|
||||
the straight-down picture: the camera sits at a point on the model
|
||||
(`issMounts.js`), with the model drawn, and looks out, away from the station.
|
||||
There are six views, the same whichever entry was selected: from Nauka (the
|
||||
one it opens on; its lower end, out ahead to port), from Zarya (its port
|
||||
side, out across the track), from Poisk (its top, out behind to starboard),
|
||||
from the Cupola (just below it, out aft past the Russian segment), from Kibo
|
||||
(outside the two windows on its port end, out over the Exposed Facility;
|
||||
the port solar arrays turn through it as they follow the Sun, as they do past
|
||||
the real windows)
|
||||
and, while a vehicle is docked, from that vehicle (behind Zvezda's aft port,
|
||||
out behind the station; the catalog does not say which port a vehicle is
|
||||
on). The Cupola and Kibo have no catalog entries: their views ride the ISS's
|
||||
and show cards of their own (`ISS_MOUNT_CARDS`: the Cupola as ESA's
|
||||
observation module with 7 windows, launched 8 Feb 2010 on STS-130, on
|
||||
Tranquility's Earth-facing port; Kibo as JAXA's laboratory module with 2
|
||||
windows, launched 31 May 2008 on STS-124, on Harmony's port side) in place of
|
||||
the entry's NORAD number, owner and TLE; altitude, velocity and the
|
||||
sub-satellite point stay the station's.
|
||||
Each looks 20° to 30° below level, which keeps the Earth's limb in the frame.
|
||||
The points were chosen by casting rays across the view against the model at
|
||||
rest: over a meter clear of every surface, at most a tenth of the frame
|
||||
meeting the station and none of it nearer than 12 m. The satellites layer's
|
||||
`getCockpitMount(key)` gives the eye point, the view frame, the view shown,
|
||||
the catalog entry it belongs to (ISS (NAUKA), the ISS itself for Zarya,
|
||||
POISK, the docked vehicle) and the views on offer, worked out from the same
|
||||
sample the model is then placed on, so the camera stays on the model. The
|
||||
Cockpit rides the view's own entry (`switchOrbitalSatellite`, as riding
|
||||
another satellite from Live Signals), so the readout, the TLE and the signals
|
||||
describe the module the view is from; a view whose entry is missing or cannot
|
||||
be tracked keeps the entry ridden, and is not retried until the view changes.
|
||||
Leaving the Cockpit from a station view selects Nauka (when the catalog has
|
||||
it) and puts the follow camera on it, whichever view it ended on; leaving
|
||||
any other satellite's view refocuses that satellite as before. `cockpitOrbitalView.js` puts the
|
||||
camera there, turns the arrow-key look about the view's own frame, keeps the
|
||||
chosen view for the session (also while the model is away) and publishes its
|
||||
name (`mount`) and the number on offer (`mountViews`). The HUD shows STATION
|
||||
VIEW with the view's name between two arrows that step back and forth
|
||||
through them, wrapping round,
|
||||
and leaves out the nadir reticle, north pointer, swath and sensor strip. A
|
||||
ground focus (a click on a mapped installation, or its Live Signals row)
|
||||
works from a station view as from the nadir picture: it aims from the
|
||||
view's camera point and turns about the view's own frame, with the same
|
||||
±45° reach, so the sites listed and focusable are those within reach of
|
||||
where the view looks; their rows still give the angle from straight down.
|
||||
Switching views ends a focus.
|
||||
Until the model has loaded, or with the model not shown, the entry keeps the
|
||||
nadir picture, and the TRACK ACQUIRED line follows the change. Zoom, the
|
||||
place line and the identity readouts are unchanged.
|
||||
While the station is selected on the map, Context gains a LIVE section
|
||||
(`src/ui/liveControls.js`, `LivePanel.vue`, the `gev-live` store): the live
|
||||
streams attached to the selected object. The list is fixed
|
||||
(`src/data/liveStreams.js`: NASA's exterior cameras, and its live video with
|
||||
space-to-ground audio, both on YouTube) and each stream names the subject
|
||||
keys it belongs to; a layer names its selected subject's keys with
|
||||
`getLiveSubjectKeys` (the satellites layer answers `station:iss` for the ISS,
|
||||
Nauka and a docked vehicle, and `station:tiangong` for Tiangong's entries,
|
||||
which no stream is listed for yet), and the keys are read again every 2 s while
|
||||
something is selected, since a docked entry is judged so only once both
|
||||
orbits have been compared. The section shows the subject, the stream's name
|
||||
with two arrows when there are several, a screen and a status line. It
|
||||
starts collapsed, and nothing loads on selection: the screen is a poster
|
||||
with Play, under the line "Video plays from YouTube, which sees your IP
|
||||
address." Play is the one thing that loads the player:
|
||||
`youtubeLivePlayer.js` builds YouTube's player (the IFrame API from
|
||||
`www.youtube.com`, the video on `www.youtube-nocookie.com`), muted, and reads
|
||||
its state back. Collapsing the section, collapsing or closing Context, or the
|
||||
section leaving the page removes the player, so nothing plays unseen. ON AIR
|
||||
with a blinking red dot while it plays; LOADING with an amber dot while it
|
||||
starts; an offline card ("Stream is offline", with Try again) when
|
||||
the player reports the video ended, errored or did not start within 25 s,
|
||||
which is how an off-air broadcast shows, or when YouTube's player API does not
|
||||
load (Try again loads it afresh); "This stream cannot play here" when the
|
||||
owner refuses embedding. Stepping to another
|
||||
stream hands a playing one over; a selection that moves to an object
|
||||
without that stream, clearing it or turning the layer off removes the
|
||||
player, while another entry of the same station (a module, a docked vehicle,
|
||||
the Cockpit stepping between views) keeps it. In the Cockpit the rail is hidden, so the
|
||||
briefing card gains a fourth page, LIVE (SIG / NEWS / LOCAL / LIVE,
|
||||
`CockpitLivePage.vue`), with the same subject line, arrows, screen, states
|
||||
and credit, and the same poster with Play under the IP line; it is offered
|
||||
only while the ridden subject has a stream, and with none the briefing keeps
|
||||
its three pages. There is one player: entering or leaving the Cockpit
|
||||
removes it (an embedded player cannot change parents without reloading, and
|
||||
the view it was in is hidden), and so does leaving the LIVE page; the view
|
||||
now shown offers Play again. Previous, Next and the tabs reach the LIVE page;
|
||||
the automatic 9-second cycle never turns to it and waits while it is shown.
|
||||
The credit links the owner and the stream's own page.
|
||||
The model is NASA/JSC IGOAL's current-configuration station, reduced to 3 MB
|
||||
with its joints kept as nodes (`public/models/README.md`), fetched only once
|
||||
the camera nears its range, and drawn as an item of a `models` set of the
|
||||
renderer's draw port, its joints posed through the item's `nodes`.
|
||||
`issArticulation.js` turns them every frame, by default from computation: the two alpha joints and eight beta joints face
|
||||
the arrays to the Sun (feathered along the flight direction in the Earth's
|
||||
shadow, taken as a cylinder), the two radiator joints keep the radiators
|
||||
edge-on to it, the two Ku-band dishes aim at the highest TDRS nominal slots
|
||||
(41°W, 171°W, 85°E) above the station's horizon plane, and Canadarm2, Dextre's
|
||||
arms and the Japanese arm sway a few degrees about NASA's filed pose, which is
|
||||
illustrative only (no public source gives their real pose; the European arm has
|
||||
no joints in the file). Joints turn at most 12°/s of wall time. Docked objects
|
||||
are found by comparing both orbits at one instant, since dots are moved at
|
||||
different moments. Selecting the station on the map also gives Context a
|
||||
STATION section (`stationPanel.js` presents it through the `gev-station`
|
||||
store; `StationPanel.vue` renders it; `issStation.js` describes the ISS, and
|
||||
another station plugs in with a description of its own): the station's badge
|
||||
and the selected entry's name, **Automatic** / **Manual**, a status line, and
|
||||
**Zoom to the ISS** (offered beyond 1 km while the viewer's follow camera is
|
||||
on the station's entity; it shortens the camera's offset from the station,
|
||||
a step per frame, to 260 m, and never moves along the view direction, which
|
||||
ran away when the camera was not looking at the station).
|
||||
Automatic (the default) leaves the joints to their rules and says where the
|
||||
angles come from: "Telemetry · updated 4 s ago" with a green dot while the
|
||||
relay's answer is fresh, "No signal since 12:04 · computed values" when the
|
||||
feed lost the station, "Telemetry unavailable · last update 3 min ago ·
|
||||
computed values" when the relay cannot be reached, "Telemetry not enabled on
|
||||
this server · computed values" when it is switched off, and a lit/shadow
|
||||
line. Manual pauses telemetry ("Manual · telemetry paused") and offers the
|
||||
controls: replace the Sun with a chosen position or a 40 s orbit, fold the
|
||||
arrays and radiators as a labelled demonstration, aim the dishes and pose
|
||||
Canadarm2 by joint. Automatic, a new selection, the Cockpit (the rail is
|
||||
hidden there, and the section with it) or turning the layer off hand every
|
||||
joint back. `issCommand.js` keeps the rules these share (the zoom's range and
|
||||
step, the fast orbit, the status wording).
|
||||
With `ISS_TELEMETRY_ENABLED=1` (off by default: the feed publishes no terms)
|
||||
`server/providers/space/issTelemetry.js` relays NASA's public ISSLive telemetry
|
||||
at `/api/iss-telemetry`. It speaks Lightstreamer's text protocol over `ws`,
|
||||
holds one connection for the whole server, opens it on the first request,
|
||||
closes it after two minutes without one, retries on a 5 s to 5 min ladder and
|
||||
recycles a socket that is silent for 30 s. The body is
|
||||
`{ configured, status, generatedAt, items }`: `status` is `live` only while the
|
||||
station clock ticked with signal in the last 20 s, and each item is
|
||||
`[value, epoch ms it was true at]`. On a socket loss the relay discards that
|
||||
connection's joint samples and station-clock credit, so fresh signal after
|
||||
reconnection cannot present old angles as live telemetry. Unset, the route answers
|
||||
`{ configured: false }` without contacting the feed, and the browser asks once.
|
||||
`issTelemetry.js` in the satellites layer polls it every 5 s while the model is
|
||||
drawn and, in Automatic, replaces the computed targets with the feed's: each
|
||||
alpha joint its own angle (port `+`, starboard `-`), each beta joint
|
||||
`±angle + 90°`, each radiator joint its angle, and the first dish the direction
|
||||
its elevation and cross-elevation give (the second holds still: the feed
|
||||
reports one dish and not which). The mapping was fitted on a recording of the
|
||||
feed: the dish direction stayed within 0.3° of a TDRS satellite across a
|
||||
hand-over, and the arrays sat 5° to 9° off the Sun; the radiator joints did not
|
||||
move in the recording, so their sign is not fitted. With no relay, no signal,
|
||||
an answer older than 20 s, Manual, or a Sun chosen by hand, the joints keep the
|
||||
computed rules, and the STATION section's status line and note say which
|
||||
holds. The arms still sway for illustration.
|
||||
Tiangong is the second station, drawn the same way: `stationModel.js` is the
|
||||
station-independent model part (load on approach, placement from its own SGP4
|
||||
sample or the tracked entry's, dot and companion hand-over, ring hidden up
|
||||
close, card anchor and clearance), driven by a spec; `issModel.js` gives the
|
||||
ISS's and `tiangongModel.js` Tiangong's (`CSS (TIANHE)`, NORAD 48274, with
|
||||
`CSS (WENTIAN)`, `CSS (MENGTIAN)` and the Shenzhou and Tianzhou ships as its
|
||||
docked entries). `policy.js` lists both stations (`STATIONS`) and
|
||||
`stationModels.js` says which station a tracked entry belongs to, so the card,
|
||||
the detection marks, the LIVE keys, the Cockpit's mounts and the STATION
|
||||
section work per station rather than for the ISS alone (tracking records
|
||||
`_trackedDockedToStation`; the ISS's ring keeps its own rules). The model
|
||||
(`public/models/tiangong.glb`, 382 KB, 26 k triangles) is the project's own,
|
||||
built from primitives with procedural textures, in meters and in the ISS
|
||||
file's frame, so it takes the ISS's flight-axes mapping: the station is
|
||||
assumed to fly with Tianhe along the velocity, the node forward, the labs
|
||||
across the orbit and nadir to the Earth. `tiangongJoints.js` carries the
|
||||
file's 37 joint and dock nodes (pivot, axis, kind) and
|
||||
`tiangongArticulation.js` drives them, all computed, since China publishes no
|
||||
telemetry: Tianhe's and the ships' one-axis wings turn about their booms to
|
||||
face the Sun, the lab wings turn about the lab's axis then their own (the
|
||||
SARJ/BGA pair), in the Earth's shadow every wing turns flat to the Earth
|
||||
(edge into the flight direction), the high-gain antenna aims at the highest
|
||||
Tianlian II nominal slot (79.9°E, 171.04°E, 10.5°E) above the horizon plane,
|
||||
and the two arms sway a few degrees on one side of their folded pose (so they
|
||||
lift off the hull), at the ISS's 12°/s cap. The STATION section for Tiangong
|
||||
(`tiangongStation.js`) says "No public telemetry · computed values", offers
|
||||
the Sun positions and the fast orbit, every wing on a slider of its own
|
||||
(Tianhe's two; the labs' four, alpha and beta each: a wing set by hand holds
|
||||
its angle, reached at the joint rate, while the rest keep following the Sun,
|
||||
and "Follow the Sun" frees them), and the Tianhe and Wentian arms by joint;
|
||||
**Zoom to Tiangong** uses the ISS's zoom range. In the Cockpit, Tiangong is
|
||||
ridden from views on its model (`tiangongMounts.js`), as the ISS is: from
|
||||
Tianhe (the one it opens on; its port side, out across the track), from the
|
||||
outer end of Wentian and of Mengtian (out past their wings, which turn through
|
||||
the view as they follow the Sun) and from the docked vehicle (standing in on
|
||||
the aft port, looking behind the station); each rides its own catalog entry,
|
||||
so no cards are needed, and leaving selects Tianhe. The visiting ships are
|
||||
always drawn; they are not yet toggled by what the catalog shows docked.
|
||||
The mission factory separates paths, replay, camera, panel, overlays and placement.
|
||||
Its markers, lines, live rings and pad zone are renderer draw sets, and it
|
||||
follows a mission through the camera port, so a caller handing it a Cesium
|
||||
@@ -2126,7 +2411,10 @@ trail, a route. A layer under another layer's card or label
|
||||
(`isUnderOtherCard`) does nothing: it neither acts on its item there nor
|
||||
treats the click as empty space, so a tracked aircraft stays tracked and a
|
||||
selection stays selected. Context (`src/ui/entityContextBridge.js`) names
|
||||
nothing under a card. With no card on top, the scene rules are unchanged.
|
||||
nothing under a card. A layer can claim a target it paints outside the overlay's
|
||||
entries (`registerClickClaim`) where no card or label is on top. A CCTV count
|
||||
claims each click that zooms to it, so a tracked aircraft stays tracked.
|
||||
With no card or claim on top, the scene rules are unchanged.
|
||||
World-overlay hit rectangles are what is painted on screen until the next
|
||||
paint: an overlay change (a click subscriber publishing its selection card)
|
||||
no longer clears them mid-click, and a paint that draws nothing clears them
|
||||
@@ -2766,9 +3054,16 @@ frame the arrows tilt, so the site stays at the centre as the satellite
|
||||
moves. The turn onto it (and between sites) eases what is left of the swing
|
||||
with the arrows' easing on a slower clock (250 ms time constant, about
|
||||
0.75 s to 95%), then holds the site exactly, and cuts under
|
||||
`prefers-reduced-motion`. A single click on a site's marker focuses it too:
|
||||
the pick is resolved through the layer's own pick ids (`findByPick`: a named
|
||||
marker's `{ installationId }` or a site entity). A click anywhere else
|
||||
`prefers-reduced-motion`. A single click on a site's marker, or on the label
|
||||
box the overlay paints for it, focuses it too: the click is resolved through
|
||||
the layer's own lookup (`findAt`: `scene.pick` for a named marker's
|
||||
`{ installationId }` or a site entity, else the box the overlay painted for
|
||||
the label; from orbit the dot is 7 px, so the label is what a click lands
|
||||
on). The map's own click selection reads the label the same way, through a
|
||||
click claim (`registerClickClaim`) rather than as an interactive card: the
|
||||
label takes a click only where nothing another layer draws is under it, so
|
||||
an aircraft or vessel drawn under a base's label stays selectable, and
|
||||
another layer's card painted over the label keeps its click. A click anywhere else
|
||||
(a site beyond the reach included), the
|
||||
focused site's row, NADIR, Home or `0` ends the focus and the view eases
|
||||
back to nadir on the same clock; an arrow ends it (or the ease back) and
|
||||
@@ -3530,6 +3825,9 @@ unaffected. `GEV_RATELIMIT_OPENAI_PER_MIN` and `GEV_RATELIMIT_GOOGLE_PER_MIN` ov
|
||||
those; exactly `0` disables the limiter, while a value that cannot be read as a
|
||||
number falls back to the default rather than to unlimited. Over-limit requests
|
||||
receive a sanitized `429` with `Retry-After: 5` and never reach the provider.
|
||||
The CCTV Street View fallback counts in a separate window with the Google cap.
|
||||
An IPv6 /64 counts as one client. Over the cap, a frame gets the placeholder
|
||||
image instead of a `429`.
|
||||
Typed chat (`/api/openai/chat`, `/api/gemini/chat`) counts in its own window,
|
||||
set by `GEV_RATELIMIT_OPENAI_CHAT_PER_MIN` and `GEV_RATELIMIT_GEMINI_CHAT_PER_MIN`.
|
||||
Left unset, each takes its provider's resolved cap — `GEV_RATELIMIT_OPENAI_PER_MIN`
|
||||
@@ -5113,9 +5411,20 @@ down | auth-failed` (plus the unchanged `missing-key`/`unsupported`) with
|
||||
> stacking. Narrow mobile Cockpit
|
||||
> viewports suppress the legacy layer stack, peripheral HUD, and secondary
|
||||
> Context/briefing panes so the flight instruments and primary controls remain
|
||||
> unobstructed. Outside Cockpit, Radio starts collapsed while off and lives
|
||||
> only in its section inside Context; the detailed panel's normal accordion
|
||||
> control owns its disclosure and its Enable/Disable action owns power.
|
||||
> unobstructed. In the phone layout (720 px wide and below) the flight and
|
||||
> bridge views put the collapsed Display and Radio launchers in one row
|
||||
> centred on the Reset/Exit axis, above the reticle and clear of the
|
||||
> destination cue: below the roll arc in portrait, over the arc's lower tick
|
||||
> ends in landscape. On short landscape screens the row stays
|
||||
> on screen and tappable below the vision controls but may cover the top of
|
||||
> the speed and altitude readouts. Windows under 240 px tall, and those under
|
||||
> 390 px wide and 450 px tall, keep the row above Reset/Exit at the right.
|
||||
> Satellite and provider views keep the row
|
||||
> above Reset/Exit at the right, where their own layouts expect it. The
|
||||
> first-visit Stories announcement waits, unread, until Cockpit closes.
|
||||
> Outside Cockpit, Radio starts collapsed while off and lives only in its
|
||||
> section inside Context; the detailed panel's normal accordion control
|
||||
> owns its disclosure and its Enable/Disable action owns power.
|
||||
> Radio volume in the full and Cockpit surfaces, plus Space Mission
|
||||
> replay speed, use Display / Sharpen's muted 3px rail, circular cyan thumb,
|
||||
> glow, and mono value treatment. Their larger transparent hit areas, keyboard
|
||||
@@ -6313,7 +6622,17 @@ caption has no place name (KartaView's is where the drive began) and links to
|
||||
the full-size photo through the image proxy, since kartaview.org's photo
|
||||
pages fail for signed-out visitors. The viewer itself is `photoViewer.js`,
|
||||
shared with Panoramax: each provider hands it a `PhotoSources` table (first
|
||||
and sharper flat and panorama URLs, and the caption fields).
|
||||
and sharper flat and panorama URLs, and the caption fields). It builds no
|
||||
element: it presents the viewer through the layer's
|
||||
`subscribePhotoViewer()`, which the application shell publishes to the
|
||||
`gev-street-level-photo` store, and `StreetLevelPhotoViewer` draws it in the
|
||||
viewer host and hands back the canvas the panorama is drawn on (a fresh one
|
||||
after a lost context). Each mount and each canvas has a key of its own, so
|
||||
a viewer never draws on another one's elements, and of two viewers
|
||||
mounting at once only the later one is drawn (`photoViewers.js`): the
|
||||
earlier one's mount closes. A view may draw at once or later; what it
|
||||
reads (`mountKey`, `actions.supersede()`) is `ViewerAdapter.subscribeView`
|
||||
in `registry.js`. Without a subscribed view these photos cannot open.
|
||||
|
||||
Panoramax (`providers/panoramax/`) is keyless and browser-side: the
|
||||
meta-catalogue `api.panoramax.xyz` (CORS open) federates every instance, and
|
||||
@@ -7525,7 +7844,7 @@ silently demoting every later lookup for the session.
|
||||
ground clamp now lifts the cap _center_ only so the wireframe stays a true pyramid welded to
|
||||
the plane (was a flattened fan / the ~47.5 m divergence — RESOLVED), re-selecting the active
|
||||
camera is a no-op (killed a click-flash), and texture swaps gate on canvas content (killed a
|
||||
periodic white flash). Camera icons are cyan for stills, violet for cameras with a video feed, and amber for the active camera. Coverage is now **metro-wide: 250 cameras** (`CCTV_AUSTIN_MAX_SOURCES`
|
||||
periodic white flash). Camera icons are green for stills, violet for cameras with a video feed, and amber for the active camera. Coverage is now **metro-wide: 250 cameras** (`CCTV_AUSTIN_MAX_SOURCES`
|
||||
default 36 → 250, hard bound 300), filtered to `camera_status === TURNED_ON` (~815 live of
|
||||
1,003 rows). City packs (2026-07-04): Caltrans (districts 4/7/11/3 — SF, LA, San Diego,
|
||||
Sacramento; cap 300) and TfL London JamCams (cap 250) join Austin (cap 250) as keyless default
|
||||
@@ -7534,7 +7853,7 @@ silently demoting every later lookup for the session.
|
||||
requires a developer key, so the pack needs `ONTARIO_511_API_KEY` and is skipped without one
|
||||
(#1228). All sources are RAW PRIOR
|
||||
poses, and the layer is stills-first.
|
||||
sources. Fintraffic Finland road weather cameras (2026-09-13; cap 300, `CCTV_FINTRAFFIC_MAX_SOURCES`,
|
||||
Fintraffic Finland road weather cameras (2026-09-13; cap 300, `CCTV_FINTRAFFIC_MAX_SOURCES`,
|
||||
kill switch `CCTV_FINTRAFFIC_ENABLED=0`) are the fourth pack: one keyless GeoJSON station list
|
||||
covering the whole country, where one _preset_ (a station's fixed view) is one camera — 806
|
||||
GATHERING stations carry 2,256 in-collection presets, prioritized to 300 against seven anchors
|
||||
@@ -7549,11 +7868,17 @@ silently demoting every later lookup for the session.
|
||||
empty keeps the old catalog and is retried after another 15 minutes, not on the next
|
||||
request. Estonia's Tarktee DATEX feeds, which answer in 2 to 16.6 s, get 30 s
|
||||
(`TARKTEE_FETCH_TIMEOUT_MS`) where other packs get 15 s.
|
||||
Both Tarktee XML catalogs refuse redirects and have a 4 MiB per-document
|
||||
limit, enforced against declared length and streamed bytes. A rejected fetch,
|
||||
unsuccessful response, or body-read failure releases both available response
|
||||
bodies; read failures also cancel an active sibling reader. Cameras sharing
|
||||
an image number are deduplicated before the Tarktee pack cap is applied.
|
||||
Ontario catalog requests refuse redirects and log only the error class and
|
||||
system code for transport/JSON failures, never the request URL or key.
|
||||
Both Tarktee XML catalogs share that 30 s deadline, refuse redirects and
|
||||
have a 4 MiB per-document limit, enforced against declared length and
|
||||
streamed bytes. A failed request, unsuccessful response or body read aborts
|
||||
the other feed at once and releases every response body, including one that
|
||||
arrives after the failure. The Lithuania pack reads its two catalogs
|
||||
through the same helper (`readCatalogsTogether`,
|
||||
`server/providers/cctv/catalogPair.js`) with its 15 s deadline. An Ontario
|
||||
error response has its body released. Cameras sharing an image number are
|
||||
deduplicated before the Tarktee pack cap is applied.
|
||||
- **CCTV v3 UX — viewshed + calibration gizmo** (built 2026-07-05 and field
|
||||
validated 2026-07-21): the COVERAGE toggle is a
|
||||
tri-state cycle `OFF → ON → VIEWSHED`; viewshed mode renders each visible camera's frustum
|
||||
@@ -8341,7 +8666,8 @@ Providers normalize coordinates, canonical name, label, place types and optional
|
||||
bounds. Camera framing, nearby landmark recovery and footprint selection remain
|
||||
in their consumers, including the Capitol identity/containment safeguards.
|
||||
Radio keeps localized country names in labels rather than station filters.
|
||||
Nearby/text-search endpoints retain their existing behavior.
|
||||
Nearby/text-search cache and error rules are listed under Proxy/Security
|
||||
Baseline below.
|
||||
|
||||
**Google geocoding is a server route, not a browser call** (#363). Forward and
|
||||
reverse lookups go to `/api/google/geocode` and `/api/google/reverse-geocode`,
|
||||
@@ -8571,7 +8897,7 @@ pins and share links already supply complete boxes.
|
||||
- Vessels, Transit and Rail draw fleet models under the same DISPLAY rail `3D` toggle, at the same altitude ceiling, caps and 3 km add/keep radii as the aircraft, at true size (`FLEET_MODEL_POLICY`, `src/layers/flights/policy.js`; `createFleetModelLayer`, `src/data/fleetModelInstances.js`). A vessel's model follows its AIS ship type and is drawn at its reported length and beam (AIS static dimensions A+B and C+D, now carried on vessel rows as `length` and `beam`), standing at the sea surface, heading by true heading then course. An aid to navigation is not a hull: a vessel record whose type names a buoy, beacon, mark, RACON or light, or whose MMSI is an aid-to-navigation station's (`99MIDxxxx`), is `isAidToNavigation` (`src/data/vesselTypes.js`) and is drawn as the set's `buoys` model of the IALA mark its type names (`aidToNavigationModel`, `src/data/fleetModels.js`: cardinal N/E/S/W, port or starboard hand, preferred channel by its side, safe water, isolated danger, special mark; a beacon, light, light vessel, RACON or reference point with no mark of its own is the special mark), else a red can (`DEFAULT_AID_MODEL`), at its built size and facing north whatever heading it reports. A type is an aid's when it is one of the 32 kinds an aid report names or uses a word for one (buoy, beacon, cardinal, safe water, RACON, lighthouse and so on); a vessel that works on aids (`Buoy Tender`, `Buoy Layer`) is not one. Its icon is the buoy sprite, tinted bone white (`AID_TO_NAVIGATION_STYLE`, `src/data/vesselLabels.js`), upright and never turned, and its card, selected card and HUD readout (`src/layers/vessels/cards.js`) show its kind alone, whole, in that colour: no speed or heading, since a fixed mark has neither. AISStream subscribes to `AidsToNavigationReport` (message 21) by default, and the server names each report's aid type code (0 to 31) as its kind (`aidToNavigationTypeName`: `20` is `Cardinal Mark N`) rather than reading it as a ship type, and its name runs on into the report's `NameExtension`. A virtual aid (the report's `VirtualAtoN` flag: a mark broadcast where nothing physical stands) carries `virtual: true` on its row, and on its vessel source record (the live-source contract's `virtual`, `src/sources/live/contract.js`, false unless a source says true; any source may set it). It keeps its buoy sprite but never gets a model (`vesselModelSpec` returns null for it, and the vessel layer gathers no model item for it), and its card and readout add `VIRTUAL` after its kind. `aisStreamRows` (`server/providers/vessels/ais-store.js`) puts every vessel ahead of every aid, so a capped request (the layer asks for 12,000 rows) never gives up a ship for a buoy. The `vessels_in_area` tool (and the brief built on it) counts ships only: it leaves aids out of its rows, counts, breakdowns and speed stats. A transit vehicle's model follows its route's GTFS `route_type` when its record carries one and that type is a kind of the vehicle's mode (`types.json` `transit.route_types`: 200 a coach, 101 a high-speed set, 106 a regional DMU, 710 a double-decker), else its layer mode (`transit.modes`: bus, trolleybus, tram, cable car, subway, monorail, rail, funicular, gondola or ferry; a vehicle of `unknown` mode keeps its icon); a fleet hint that overrules the route (a bus on a tram route) leaves the type unused. A monorail and a gondola are raised by their `transit.elevation` lifts. A train's model follows its rail category and mode (rail, metro or tram). The bundled GTFS-Realtime proxy carries no route type, so its vehicles draw their mode's model; a source that adds `routeType` reaches the finer ones. Both stand on the road or rail top they are drawn on, without the 1.5 m `GROUND_FLOOR_LIFT_M` their icons carry, and are painted in their mode or category colour where the model's `_TINT` attribute marks it. A vessel model is clipped at its waterline (one clipping plane per model, at the model origin's horizontal plane), so its hull below the water never shows through a plain globe, which Cesium does not depth-test models against. Under the NVG/FLIR styles (the Flights `irBoost` parameter) these models render unlit flat white, as aircraft models do. Each vehicle's icon stays the visual until its model is loaded, ready and placed; a model is picked as its icon is, and a vehicle drawn as its model keeps its selection card and its place in the detection overlay.
|
||||
- **Aircraft models skip Cesium's dynamic environment map (2026-10-24).** Flights, Military Flights and Local ADS-B pass `environmentMapOptions: AIRCRAFT_ENVIRONMENT_MAP_OPTIONS` (`{ enabled: false }`, `src/data/aircraftModelLighting.js`) to every drawn model. Otherwise each `Model` renders the sky around it and reads it back from the GPU (`readPixels`) when it is first placed, and again whenever it moves more than 1 km, the scene's atmosphere settings change, or (under sunlight dynamic lighting) an hour of scene time passes (`DynamicEnvironmentMapManager`, Cesium 1.138). The models are lit from Cesium's default spherical harmonics instead, with no specular environment map, so the sky's model-lighting cube map no longer reaches aircraft. `src/data/aircraftModelLighting.test.mjs` pins the option at every drawn model call; every model is built from the fleet set loaded up front, so there is no separate preload.
|
||||
- The DISPLAY-rail `3D` toggle is the user-facing activation path for both aircraft layers. Their small approved GLBs build their render resources without Cesium's frame-spread job queue, preventing continuous Photorealistic 3D Tiles streaming from starving model readiness; model caps, tracking, camera, and fallback billboards are unchanged.
|
||||
- **The `3D` toggle DEFAULTS ON in `proximity` on a first run.** Proximity is itself the budget — models appear only within 3 km of the camera and only for the nearest `MODEL_MAX` — so the default costs nothing at globe scale, and `all` remains a deliberate opt-in. A fresh boot runs NO layer-state restoration (`LayerStateCoordinator.start()` returns early with neither a share payload nor stored state), so four independent initializers decide what a first-run operator sees and must agree: `booleanOption('models3d', 'e', true)` in `src/data/layerState.js`, `_models3dEnabled = true` in BOTH flight layers, `this._models3dEnabled = true` in `src/ui/aircraftDisplay.js`, and the `active` / `visible` classes on `#models3d-toggle` / `#models3d-mode-row` in `index.html`. All four are pinned together in `src/data/layerState.test.mjs`. Explicit state still wins: because the codec omits default-valued options, `models3d: false` is now what travels in a link (`lo=…f.e.0`) and restores OFF at both aircraft layers. **Consequence for returning users:** a stored `gev:layer-state:v2` blob is a FULL options snapshot, so a session that wrote one before this change carries `models3d:false` and keeps 3D off until the operator flips it (or clears the key) — the durable snapshot is treated as the recipient's own state, by design.
|
||||
- **The `3D` toggle DEFAULTS ON in `proximity` on a first run.** Proximity is itself the budget — models appear only within 3 km of the camera and only for the nearest `MODEL_MAX` — so the default costs nothing at globe scale, and `all` remains a deliberate opt-in. A fresh boot runs NO layer-state restoration (`LayerStateCoordinator.start()` returns early with neither a share payload nor stored state), so four independent initializers decide what a first-run operator sees and must agree: `booleanOption('models3d', 'e', true)` in `src/data/layerState.js`, `_models3dEnabled = true` in BOTH flight layers, `this._models3dEnabled = true` in `src/ui/aircraftDisplay.js`, and the `active` / `visible` classes on `#models3d-toggle` / `#models3d-mode-row` in `index.html`. All four are pinned together in `src/data/layerState.test.mjs`. Explicit state still wins: because the codec omits default-valued options, `models3d: false` is now what travels in a link (`lo=…f.e.0`) and restores OFF at both aircraft layers. Start-up never reads a stored `gev:layer-state:v2` blob back: a bare URL starts from these defaults and a link from its hash (`src/ui/shareRestoration.js`, `allowLocalState: false`), so clearing the address always resets the view.
|
||||
- Civilian and military 2D aircraft use the established distance scale: `3×` near
|
||||
the camera and a `0.5×` floor from 8,000 km outward. A standard 20 px ambient
|
||||
icon therefore remains about 10 px at globe altitude while retaining the
|
||||
@@ -8661,6 +8987,7 @@ apply to `public/` assets or built-preview serving.
|
||||
- `AISSTREAM_API_KEY` is server-side only; the browser reads the same-origin `/api/vessels` cache.
|
||||
- `/api/google/nearby-places` keeps the Google key out of Places requests issued for voice scene context.
|
||||
- `/api/google/text-search` keeps the Google key server-side for view-biased Places recovery used by annotation resolution.
|
||||
- The Places and geocode routes cache only an answer (`private, max-age=300`). For geocode, that means an HTTP success with `OK` or `ZERO_RESULTS`, because Google sends `REQUEST_DENIED` and `OVER_QUERY_LIMIT` as HTTP 200. Every other reply, including an unreadable Places 200 (now a 502), is `no-store`.
|
||||
- `/api/overpass` is bounded by body/response caps, per-client/global rate limits, concurrency limits, operator-configured upstreams, in-flight dedupe, cache bounds, and static validation that every selector is spatially bounded.
|
||||
- `/api/military-installations` uses an independent limiter with the same 90-per-client/300-global one-minute bounds, so viewport installation refreshes never consume `/api/overpass` annotation capacity.
|
||||
- `/api/route` proxies bounded OSRM route requests for annotation routes, with profile allowlisting, distance caps, response caps, caching, and sanitized "no route found" errors; routing outages return 502.
|
||||
@@ -8761,7 +9088,7 @@ apply to `public/` assets or built-preview serving.
|
||||
The ship bridge and the orbital view have their own own-layer gates
|
||||
(`bridgeEntryAllowed`, `orbitEntryAllowed`; see
|
||||
[Ship bridge view](#ship-bridge-view) and [Orbital view](#orbital-view)).
|
||||
- **Aircraft cockpit view:** selecting a commercial or military aircraft reveals a `COCKPIT` action once that aircraft's own layer is on; Contacts is not required. The action shows in Contacts (`#cockpit-entry`) and under the Intel HUD's bottom-right readout (`#cockpit-entry-readout`, with the HUD on, in its Tactical layout), so entry needs no Contacts panel. Turning off the ridden aircraft's layer ends the view (the layer clears its tracking). When an air feed the surrounding picture uses is off, the Cockpit says so instead of blocking: Live Signals leads with `MILITARY FEED OFF · PARTIAL PICTURE` or `FLIGHTS FEED OFF · PARTIAL PICTURE`, and the Contact card shows that line in place of its inputs status, so a partial picture is never presented as complete. `control_cockpit` refuses entry with `entryBlockedReason` `contacts-starting` (a Context change in flight), `subject-layer-off` (the aircraft's layer, or with none tracked any aircraft layer, is off) or `no-tracked-aircraft`. Cockpit mode temporarily releases Cesium's orbit-follow transform and drives a first-person camera from the tracked aircraft's existing smoothed display position and course. Its concave helmet-visor HUD shows callsign, UTC time, coordinates, curved roll/pitch guides, and a seven-division heading tape. Ambient commercial and military AIR contacts use a Cockpit near/far band selected by the shared Display 3D mode: Proximity admits at 150 km and retains to 185 km; All admits at 400 km and retains to 450 km. The shared 3D toggle now applies in Cockpit: Off keeps in-range contacts as rotating 2D aircraft silhouettes, while On lets a ready admitted glTF take over without a drawing gap. The Cockpit model cap remains 60 and can only lower the map budget; in-range contacts that are capped or still loading remain 2D silhouettes instead of degrading to out-of-range dots. Contacts outside the selected band use small rotation-free cyan-white pips for civilian aircraft and amber pips for military. The pilot's own airframe is not drawn in first person, and exiting clears the Cockpit band and restores normal map silhouettes/models. The normal left accordion remains available for Layers and Authoring and keeps the same 26vh HUD-aligned anchor used in map mode, independent of whether the bottom-left Contact card is expanded or collapsed; the right-rail CCTV and Context chooser are hidden to avoid duplicating or overlapping the cockpit presentation. When the intelligence HUD is enabled, its classification, scene summary, collection/orbit metadata, coordinates, and imaging-status text remain visible as reduced peripheral cockpit telemetry; the optical center and flight instruments stay clear, and turning the HUD off still hides it. Ground speed, exact heading, and rendered altitude form one compact lower-center instrument cluster, keeping the horizon and peripheral view open. A second live altitude tape hugs the inside-right visor rim: its rail and nine moving ticks are derived from the same responsive keyhole radius, remain 20 px inside the circular edge even on wide displays, fade deeply at both vertical ends, and move continuously behind a fixed current-altitude pointer; its interval tightens automatically near the surface and it is suppressed on narrow screens. Cockpit mode also has a weather-backed transparent volumetric-cloud pass derived from the supplied FBM/domain-warped R&D shader. It renders at no more than 520×320, uses 24 ray steps/three FBM octaves at 12 FPS, is clipped to the visor, fails clear when Open-Meteo is unavailable, and stops its animation completely on cockpit exit. It does not restore the prior CPU weather canvases, precipitation, scene fog, or any map-mode effect. When Contacts is active for the tracked aircraft, the compact `CONTACT` rail adds the 250 km subject window, four cohort counts, nearest observed/mapped example with relative bearing and distance, freshness, explicit uncertainty, and Previous and Next controls plus its own collapse control. The mirrored right rail is a three-page **cockpit briefing carousel**: source-backed live signals, location-matched regional headlines, and physical-region/current-weather context from bundled Natural Earth polygons and Open-Meteo. It is manual-first: Previous, Next, and direct page controls are always available, and the visible `CYCLE OFF` / `CYCLE ON` control starts or stops the nine-second page cycle. The cycle pauses on hover or keyboard focus and stops while collapsed, hidden, or outside cockpit mode; live signal data continues refreshing either way. Regional News holds its list to the last 24 hours (`newsWindowHours` in the brief; the client drops anything older or undated even if a server sends it) and shows four distinct states: fresh results with no banner and a `{SOURCE} · LAST 24 H` footer; earlier results kept after a failed refresh under `CACHED · REFRESH FAILED` with the cached age in the footer; `NO NEWS IN THE LAST 24 H` when a source answered with nothing Line truncated
|
||||
- **Aircraft cockpit view:** selecting a commercial or military aircraft reveals a `COCKPIT` action once that aircraft's own layer is on; Contacts is not required. The action shows in Contacts (`#cockpit-entry`) and under the Intel HUD's bottom-right readout (`#cockpit-entry-readout`, with the HUD on, in its Tactical layout), so entry needs no Contacts panel. Turning off the ridden aircraft's layer ends the view (the layer clears its tracking). When an air feed the surrounding picture uses is off, the Cockpit says so instead of blocking: Live Signals leads with `MILITARY FEED OFF · PARTIAL PICTURE` or `FLIGHTS FEED OFF · PARTIAL PICTURE`, and the Contact card shows that line in place of its inputs status, so a partial picture is never presented as complete. `control_cockpit` refuses entry with `entryBlockedReason` `contacts-starting` (a Context change in flight), `subject-layer-off` (the aircraft's layer, or with none tracked any aircraft layer, is off) or `no-tracked-aircraft`. Cockpit mode temporarily releases Cesium's orbit-follow transform and drives a first-person camera from the tracked aircraft's existing smoothed display position and course. Its concave helmet-visor HUD shows callsign, UTC time, coordinates, curved roll/pitch guides, and a seven-division heading tape. Ambient commercial and military AIR contacts use a Cockpit near/far band selected by the shared Display 3D mode: Proximity admits at 150 km and retains to 185 km; All admits at 400 km and retains to 450 km. The shared 3D toggle now applies in Cockpit: Off keeps in-range contacts as rotating 2D aircraft silhouettes, while On lets a ready admitted glTF take over without a drawing gap. The Cockpit model cap remains 60 and can only lower the map budget; in-range contacts that are capped or still loading remain 2D silhouettes instead of degrading to out-of-range dots. Contacts outside the selected band use small rotation-free cyan-white pips for civilian aircraft and amber pips for military. The pilot's own airframe is not drawn in first person, and exiting clears the Cockpit band and restores normal map silhouettes/models. The normal left accordion remains available for Layers and Authoring and keeps the same 26vh HUD-aligned anchor used in map mode, independent of whether the bottom-left Contact card is expanded or collapsed; the right-rail CCTV and Context chooser are hidden to avoid duplicating or overlapping the cockpit presentation. When the intelligence HUD is enabled, its classification, scene summary, collection/orbit metadata, coordinates, and imaging-status text remain visible as reduced peripheral cockpit telemetry; the optical center and flight instruments stay clear, and turning the HUD off still hides it. Ground speed, exact heading, and rendered altitude form one compact lower-center instrument cluster, keeping the horizon and peripheral view open. A second live altitude tape hugs the inside-right visor rim: its rail and nine moving ticks are derived from the same responsive keyhole radius, remain 20 px inside the circular edge even on wide displays, fade deeply at both vertical ends, and move continuously behind a fixed current-altitude pointer; its interval tightens automatically near the surface and it is suppressed on narrow screens. Cockpit mode also has a weather-backed transparent volumetric-cloud pass derived from the supplied FBM/domain-warped R&D shader. It renders at no more than 520×320, uses 24 ray steps/three FBM octaves at 12 FPS, is clipped to the visor, fails clear when Open-Meteo is unavailable, and stops its animation completely on cockpit exit. It does not restore the prior CPU weather canvases, precipitation, scene fog, or any map-mode effect. When Contacts is active for the tracked aircraft, the compact `CONTACT` rail adds the 250 km subject window, four cohort counts, nearest observed/mapped example with relative bearing and distance, freshness, explicit uncertainty, and Previous and Next controls plus its own collapse control. The mirrored right rail is a **cockpit briefing carousel** of three pages: source-backed live signals, location-matched regional headlines, and physical-region/current-weather context from bundled Natural Earth polygons and Open-Meteo; a fourth page, LIVE, is offered while the ridden subject has a live stream (the ISS; see the LIVE section) and shows the same muted player. It is manual-first: Previous, Next, and direct page controls are always available, and the visible `CYCLE OFF` / `CYCLE ON` control starts or stops the nine-second page cycle. The cycle pauses on hover or keyboard focus, never turns to the LIVE page and waits while it is shown, and stops while collapsed, hidden, or outside cockpit mode; live signal data continues refreshing either way. Regional News holds its list to the last 24 hours (`newsWindowHours` in the brief; the client drops anything older or undated even if a server sends it) and shows four distinct states: fresh results with no banner and a `{SOLine truncated
|
||||
- **Cockpit left-panel clearance:** the Cockpit Contact card and peripheral HUD participate in the adaptive left accordion's live obstacle measurements, including live viewport-height changes. Expanding Layers or Authoring keeps the active panel in the available upper-left corridor with internal scrolling; it does not cover the Contact card, lower Cockpit controls, or Cesium credit line. Outside Cockpit the hidden card does not alter the normal corridor.
|
||||
- **Cockpit Context scope:** the 250 km radius applies to the air/sea proximity cohorts. Installation counts come only from the currently loaded viewport and are labeled `CURRENT VIEWPORT ONLY` in the cockpit as well as the normal Context panel; neither surface presents them as a complete 250 km installation survey.
|
||||
- **Cockpit camera anchor:** first-person mode does not write feed-boundary corrections directly into the camera. A cockpit-only inertial anchor advances from the selected aircraft's displayed course and speed, then converges toward the authoritative delayed track with correction capped below forward motion. The displayed kinematics are derived from the same consecutive fix segment as the rendered position, with raw feed speed/course used only as fallback; a transient zero/missing feed speed therefore cannot freeze a visibly moving aircraft after layer enable or a map/cockpit handoff. Rendered altitude continues to come from that interpolated track position. Late ADS-B fixes and short render stalls can remove drift without accelerating or reversing the view. Camera placement runs before scene update/culling at a bounded 20 Hz so a moving cockpit does not force Photoreal 3D Tiles to retraverse on every display frame; textual instruments update at 10 Hz and context/layout work at 4 Hz. Every far Cockpit contact pip shares one stable Cesium texture-atlas entry and skips unused screen-projected course calculations, while only in-range 2D aircraft silhouettes pay the screen-projected rotation cost; ambient glTF collections are hidden/retained rather than synchronously destroyed at cockpit entry, and context rails lay out only on explicit content/state changes and viewport resize. The deliberate 15/30-second layer interpolation delays and per-Cesium-frame position caches remain unchanged.
|
||||
@@ -8772,7 +9099,7 @@ apply to `public/` assets or built-preview serving.
|
||||
- **Cockpit weather status:** the earlier multi-canvas atmospheric compositor remains fail-closed and is not attached to the live viewer. Cockpit clouds are a separate transparent WebGL pass with a capped 520×320 framebuffer, 24 ray steps, three FBM octaves, and a 12 FPS ceiling. It defaults off and starts only when local storage explicitly contains the persisted `WX ON` opt-in (`'1'`). When opted in, observations refresh after five minutes or 25 km of aircraft movement, fail transparent when unavailable or clear, and stop on exit or disable. `WX OFF` governs atmospheric rendering only: the briefing still fetches source-backed Natural Earth region, headline, and Open-Meteo local-information data, aborting and replacing any in-flight request when the selected aircraft changes. No weather effect runs in map mode and no synthetic fallback is shown.
|
||||
- **Cockpit trail visibility:** entering cockpit hides the selected aircraft's trail body and head so they cannot cross the first-person view; exit restores them. This cockpit-only presentation change does not alter the normal map-mode invariant that aircraft trails render through terrain using their depth-fail material.
|
||||
- **Aircraft course slew:** civilian and military 3D models retain the 60°/s course limiter, but each rendered frame can consume at most 250 ms of accumulated slew time. A long tile/render stall therefore catches up over multiple visible frames instead of turning one delayed frame into a heading snap.
|
||||
- **Manual-first cockpit briefing:** the right-side Live Signals / Regional News / Local Info carousel does not advance automatically on page load. Previous, Next, and direct page controls remain available; the visible `CYCLE OFF` / `CYCLE ON` toggle explicitly starts or stops the nine-second page cycle, which still pauses on hover/focus and while collapsed, hidden, or outside cockpit mode. Live signal data continues refreshing in either state.
|
||||
- **Manual-first cockpit briefing:** the right-side Live Signals / Regional News / Local Info carousel (plus LIVE while the ridden subject has a stream) does not advance automatically on page load. Previous, Next, and direct page controls remain available; the visible `CYCLE OFF` / `CYCLE ON` toggle explicitly starts or stops the nine-second page cycle, which still pauses on hover/focus and while collapsed, hidden, or outside cockpit mode, and which never turns to the LIVE page. Live signal data continues refreshing in either state.
|
||||
- **Photoreal horizon blend:** Cesium's sky atmosphere remains enabled behind the hidden base globe, but its light intensity, saturation, and brightness are reduced from the library defaults so the distant Google Photorealistic 3D Tiles boundary blends into the sky instead of producing a bright cyan horizon seam.
|
||||
- **Cockpit direction and speed tapes:** plausible destination metadata now drives one translucent, isometric visor chevron labeled directly below with the estimated geographic bearing; the prior full geodesic dashed path is not rendered. A mirrored live ground-speed tape follows the inside-left keyhole rim using the same responsive curve, end fades, fixed pointer, and fractional tick motion as the altitude tape on the right. Speed values scroll upward as they increase while altitude values scroll downward. Its tick endpoints and current-speed pointer share the rail's inset-circle origin, so the markings stay attached to the visible curve rather than drifting inward with the text-label gutter.
|
||||
- Voice control UI (`#gev-voice-control`) shows status states OFF / CONNECTING / LISTENING / EXECUTING / ERROR.
|
||||
@@ -8814,13 +9141,18 @@ that era's default (`scf` → 35, `ko` → 5). Every link since carries both fie
|
||||
explicitly, because the generator always writes them, so no era whose default
|
||||
later changed depends on a fallback either way.
|
||||
|
||||
**They do NOT all persist the same way, and only one of them persists at all.**
|
||||
**None of them comes back from storage on a bare URL; only the hash carries them.**
|
||||
Worth stating plainly, because "a default you can override" and "a default that
|
||||
remembers" are different promises:
|
||||
|
||||
- **3D models** have durable storage — `gev:layer-state:v2` in local storage,
|
||||
written by `LayerStateCoordinator` on explicit intent. A session that stored a
|
||||
snapshot keeps whatever it stored, across tabs and restarts.
|
||||
- **3D models** are written to `gev:layer-state:v2` in local storage by
|
||||
`LayerStateCoordinator` on explicit intent, but start-up never reads it back:
|
||||
a link restores what its hash carries, and a bare URL starts with the default
|
||||
layers and options (`src/ui/shareRestoration.js` passes
|
||||
`allowLocalState: false`), so clearing the address always resets the view.
|
||||
A host may name the layers a bare URL starts with (`startLayers` on
|
||||
`createApplicationControls`, e.g. `['flights', 'satellites']`); they are
|
||||
restored passively, never written to storage, and a link's own layers win.
|
||||
- **Detection mode/density and scope feather have NO storage key at all.** Their
|
||||
only durable carrier is the URL hash (`dm`/`dd`, `scf`), written on a 500 ms
|
||||
debounce. A same-URL reload therefore keeps them only if that debounce already
|
||||
|
||||
@@ -107,6 +107,7 @@ Call it before views render. `onLocaleChange` listeners word their text again at
|
||||
- **Translate the label, not the value.** Layer ids, enums, share-link parameters, API fields, voice tool schemas and feed data (callsigns, vessel and place names) stay as they are; translate only the text shown for them.
|
||||
- **No `t()` at module top level.** Keep the English in `msg()` and call `t()` when rendering.
|
||||
- **Numbers and dates** go through `formatNumber`, `formatDate`, `formatRelativeTime` and `formatUtcDayMonth` from `src/i18n/index.js`, which follow the active language.
|
||||
Compact CCTV count badges painted on the map use Latin digits, a decimal point and a `K` suffix for thousands (`999`, `1.7K`, `12K`). Each badge keeps its width and reads the same across locales. Format these badges only with `formatCameraCount` in `src/data/cctvCellCounts.js`.
|
||||
- **Identical English means identical translation,** unless you give it a context: `t('CLEAR', { context: 'action' })` (a button) is its own catalog entry, `action|CLEAR`, while `t('CLEAR')` (the sky) stays separate. English output is the same.
|
||||
- **Text that should stay English** (a brand, a code, a unit symbol) is simply not wrapped.
|
||||
|
||||
|
||||
@@ -83,6 +83,6 @@ Consumers use the package exports, which do not import standalone application
|
||||
globals.
|
||||
|
||||
Dataset files and source/license notices remain under `src/data/local_data/`.
|
||||
Their input counts are 4,352 datacenter features and 704 dam features. A multipart
|
||||
Their input counts are 4,352 datacenter features and 706 dam features. A multipart
|
||||
geometry draws as several parts, each with its own stem; part and stem counts are
|
||||
different measurements from feature counts. This change does not refresh or relicense the datasets.
|
||||
different measurements from feature counts.
|
||||
@@ -343,6 +343,17 @@ correction turns them to, paints the mask in a custom shader per colour
|
||||
clipping plane through the model's origin. The checks `draw.models.bytes`
|
||||
and `draw.models.fleet` cover them.
|
||||
|
||||
An articulated model's joints are its item's `nodes`: transforms of the
|
||||
model's named glTF nodes, each a column-major 4×4 matrix in the node's
|
||||
parent frame that replaces the node's own (the ISS's solar arrays,
|
||||
radiators, dishes and arms). They change live; a node whose name leaves the
|
||||
map goes back to its authored pose, and names the model lacks are ignored.
|
||||
A renderer that poses nodes lists `modelNodes`; one without it draws the
|
||||
model as authored. The Cesium port lists it, and writes each node's matrix
|
||||
once the model is ready, and again only when its numbers change. The check
|
||||
`draw.models.nodes` moves the harness model's node off the screen's centre
|
||||
and back.
|
||||
|
||||
The Cesium port draws timed imagery (`imageryFrames`): a layer given a timed
|
||||
source hides its own imagery and draws each frame its clock shows as a Cesium
|
||||
imagery layer just above it (in `blend` mode the later frame over the earlier
|
||||
|
||||
+232
-41
@@ -37,9 +37,12 @@ one-panel rule too. Share links continue to record which panels are open.
|
||||
## Component kit
|
||||
|
||||
`src/ui/kit/` holds the generic components: `UiRail`, `UiTooltip`, `UiIcon`,
|
||||
`UiButton`, `UiCloseButton`, `UiPanel`, `UiSegmented`, `UiSlider`, `UiChip`,
|
||||
`UiSelect`, `UiSearchField`, `UiCheckbox`, `UiDialog`, `UiBadge` and `UiEmpty` so far, with more
|
||||
joining as the controls they serve are converted. One component
|
||||
`UiButton`, `UiCloseButton`, `UiPanel`, `UiPanelToggle` (a panel's collapse
|
||||
button, which `UiPanel` and `PanelCollapseButton` draw), `UiPanelEdge` (a
|
||||
panel header's edge switch), `UiSegmented`, `UiSlider`, `UiChip`,
|
||||
`UiSelect`, `UiSearchField`, `UiCheckbox`, `UiDialog`, `UiBadge` and
|
||||
`UiEmpty` so far, with more joining as the controls they serve are
|
||||
converted. One component
|
||||
serves every use of a control, with props for the differences (`UiPanel`'s
|
||||
`sideways`, `glow`, `scroll`), rather than a copy per panel. The components
|
||||
are styled by the existing stylesheet and custom properties, and they contain
|
||||
@@ -81,16 +84,44 @@ Home and End), since each of Core's groups keeps its own keyboard policy, and
|
||||
once and asks for a change only when it lands on another option. Every
|
||||
segmented group in Core is a `UiSegmented`; the old `segmentedControl.js`
|
||||
adapter is gone.
|
||||
No view hand-writes a control the kit has: every button in an SFC outside
|
||||
the kit is a `UiButton`, `UiCloseButton` or another kit control, every
|
||||
Material Symbols glyph a `UiIcon`, every checkbox a `UiCheckbox`, every
|
||||
select a `UiSelect`, and every range a `UiSlider` except the radio
|
||||
tuner's and the world timeline's, for the reasons given below. No module
|
||||
outside the kit, and no SFC's script, builds a button, select, field or
|
||||
Material glyph in script or writes one as markup in a string, apart from
|
||||
the globe panel's standalone page (`src/tools/globePanel.js`), plain HTML
|
||||
a host serves with no Vue or kit, whose Expand and Open buttons are
|
||||
written as markup (`src/ui/kit/viewControls.test.mjs` pins all of it).
|
||||
The native fields left are the text, number, password and file inputs
|
||||
and the two text areas (the chat's message box and the scene dialog's
|
||||
multiline field) the kit has no control for, and the search fields whose
|
||||
surfaces this document names. The scene dialog's single-line field takes
|
||||
its type from its caller, which passes text-like types only.
|
||||
`UiButton` adds `pressedClass`, Core's class on a pressed toggle (most use
|
||||
`active`); its pressed classes toggle through `classList`, so a class other
|
||||
code adds (a voice highlight) survives a press. Not every pressed toggle in
|
||||
the views is one yet: the context view and a few panel buttons still
|
||||
hand-write theirs, and
|
||||
Bhote Koshi's cinematic button and the tilt-map button have owners that
|
||||
write their state into the DOM. Core's
|
||||
pressable chips and pills (rail card chips, map sources, cities and places)
|
||||
are `UiButton`s too; `UiChip` is a non-interactive label chip, used by
|
||||
the voice card.
|
||||
code adds (a voice highlight) survives a press. Every pressed toggle (a
|
||||
control with `aria-pressed`) in the views is a `UiButton` with `pressed`
|
||||
except Explore's story cards, which keep their own `aria-pressed` since
|
||||
they are `role="button"` elements, not buttons
|
||||
(`src/ui/kit/viewControls.test.mjs` pins it). Where the
|
||||
converted buttons draw Material symbols (the tilt-map button, the Context
|
||||
header's search and expand, the imported files' row actions and the rail
|
||||
chips' icons), the glyphs are `UiIcon`s with `:size="null"`, so the site
|
||||
rules still size them. Core's pressable chips and pills (the rail cards'
|
||||
chips and action chips, Recent Imagery's day chips, SWAP and ZOOM IN, map
|
||||
sources, cities and places, the view context's place and layer chips and
|
||||
the key setup chip) are `UiButton`s too. `UiChip` is a non-interactive
|
||||
label chip, used by the voice card.
|
||||
header's search and expand, Draw, Import, the imported files' and drawn
|
||||
shapes' row actions and the rail chips' icons), the glyphs are `UiIcon`s
|
||||
with `:size="null"`, so the site rules still size them. Core's pressable
|
||||
chips and pills (the rail cards' chips and action chips, Recent Imagery's
|
||||
day chips, SWAP and ZOOM IN, map sources, cities and places, and the view
|
||||
context's place and layer chips) are `UiButton`s too; the key setup chip
|
||||
is still a plain button. `UiChip`
|
||||
is a non-interactive label chip, used by the voice card.
|
||||
The welcome card's buttons (SKIP, the three start tiles, BROWSE STORIES,
|
||||
BACK and the main NEXT / ENTER GOD MODE action) are ghost `UiButton`s:
|
||||
the start tiles are pressed toggles, and all but SKIP keep `aria-disabled`
|
||||
@@ -106,11 +137,30 @@ Story screen's Context button and the timeline's Expand map are pressed
|
||||
toggles, with no pressed class since their skins read `aria-pressed`;
|
||||
Explore's story cards are `role="button"` elements and keep their own
|
||||
`aria-pressed`. Their glyphs are inline SVG drawn for Stories, which no
|
||||
Material symbol the page loads draws the same, so they stay SVG; the two
|
||||
search fields keep their own markup, since `UiSearchField`'s Material
|
||||
magnifier would replace their SVG one, and their clear buttons, which draw
|
||||
an SVG cross, are ghost `UiButton`s rather than `UiCloseButton`s
|
||||
(`src/ui/kit/storiesControls.test.mjs` pins it).
|
||||
Material symbol the page loads draws the same, so they stay SVG; the three
|
||||
search fields (Explore's two and the Story context sheet's story search, a
|
||||
combobox) keep their own markup, since `UiSearchField`'s Material
|
||||
magnifier would replace their SVG one, and Explore's two clear buttons,
|
||||
which draw an SVG cross, are ghost `UiButton`s rather than
|
||||
`UiCloseButton`s (`src/ui/kit/storiesControls.test.mjs` pins it).
|
||||
Explore's sort is a `UiSelect`.
|
||||
Every button in the Cockpit HUD (`CockpitView` and its panels: the vision
|
||||
selector, Look ahead, the view switcher's Reset and Exit, the utility
|
||||
strip's launchers, collapse buttons, Radio transport and desktop rail, the
|
||||
briefing card's paging, Auto, collapse and page tabs, the Contact card's
|
||||
navigation, collapse and Weather, a signal row's target, the orbital
|
||||
view's TLE, Nadir, zoom and Sensor, and the bridge radar's range) is a
|
||||
ghost `UiButton` that keeps its id and classes, so the Cockpit
|
||||
controller's listeners and the cockpit stylesheets still find it. Radio's
|
||||
Enable (with `active`), Auto and Weather are pressed toggles; the
|
||||
disclosures keep `aria-expanded` and the page tabs `aria-current`. Its
|
||||
glyphs (the rim pointers, the reticle, the heading caret, the chevrons and
|
||||
panel glyphs, the contact and route arrows) are `UiIcon`s with
|
||||
`:size="null"`; the heading caret's rule reads
|
||||
`.cockpit-compass .cockpit-heading-caret`, so it still outranks the kit's
|
||||
`.ui-icon`, which loads after cockpit.css
|
||||
(`src/ui/kit/cockpitControls.test.mjs` pins it). The −, ◀ ▶ and + glyphs
|
||||
are text characters and stay text, and the Radio volume is a `UiSlider`.
|
||||
The Omnibar's mic (a pressed toggle with `active`) and its suggestion
|
||||
strip's chips (options, so `aria-current` rather than `pressed`) are
|
||||
ghost `UiButton`s, and its search, row and chip glyphs are `UiIcon`s with
|
||||
@@ -138,6 +188,23 @@ context view shows too). Their glyphs are `UiIcon`s with `:size="null"`,
|
||||
so entity-card.css and spot-conditions.css still size them
|
||||
(`src/ui/kit/entityCardControls.test.mjs` pins it). Ask GEV's chat bubble
|
||||
stays inline SVG, since no Material symbol the page loads draws it.
|
||||
The command dock's buttons (the six style buttons, the two tray toggles,
|
||||
Location's collapse and the search toggle, beside the pins and pills that
|
||||
already were) are ghost `UiButton`s. The style buttons are pressed toggles
|
||||
with `active` as their pressed class, so they now carry `aria-pressed`;
|
||||
Normal is the pressed one until a style is published. Their glyphs, the
|
||||
search 🔎 and the collapse + are text characters, not Material symbols, and
|
||||
stay plain text. The Context panel's buttons (its two tabs, Contacts, the
|
||||
cockpit entry and SEARCH NEARBY SITES, beside the header's search and
|
||||
expand and the TR-3B chip) are ghost `UiButton`s; the tabs and Contacts
|
||||
are `role="tab"` controls, chosen through `aria-selected` with their own
|
||||
`active` class rather than `pressed`. The view context it shows while
|
||||
nothing is picked (a worldwide tile that turns a layer on, an item's row,
|
||||
the place and layer chips and Ask GEV) is on the kit too, and the glyphs of
|
||||
all three are `UiIcon`s with `:size="null"`, so their site rules still size
|
||||
them; an item's motion glyph keeps `role="img"` and its name, with the
|
||||
kit's `aria-hidden` taken off (`src/ui/kit/commandDockControls.test.mjs`
|
||||
pins it). Ask GEV's chat bubble stays inline SVG.
|
||||
The Layer Finder's buttons (Search, Filter, the filter menu's Status and
|
||||
Category options and the bar's two clear chips) are ghost `UiButton`s.
|
||||
Search and the options are pressed toggles; the options' pressed class is
|
||||
@@ -147,13 +214,109 @@ while a query is typed. The Filter button opens a disclosure and carries
|
||||
a `UiIcon` with `:size="null"`, so `layer-finder.css` still sizes them
|
||||
(`src/ui/kit/layerFinderControls.test.mjs` pins it); the search field's
|
||||
magnifier is `UiSearchField`'s own span.
|
||||
The Space Missions panel's buttons (a mission's roster row, FOCUS,
|
||||
REPLAY ASCENT, the replay's pause, PREV, NEXT and SHOW ALL / DESELECT),
|
||||
the Contacts panel's (PREV, FOCUS, NEXT and a contact's row), the Radio
|
||||
panel's (Enable, PREV, PLAY, NEXT and STOP), the RTL-SDR card's (Connect,
|
||||
Locate, Change device, FM, ADS-B, Tune and the two seeks) and the key
|
||||
setup's (the POWER UP chip, a key's REMOVE, the voice auth toggle and
|
||||
SAVE KEYS) are ghost `UiButton`s. Radio's Enable and the card's Connect,
|
||||
FM and ADS-B are pressed toggles with `active`; PLAY and Locate keep
|
||||
their own `active` class without `aria-pressed`, since their words say
|
||||
what they will do or have done. The chip's bolt is a `UiIcon` with
|
||||
`:size="null"`, so provider-settings.css still sizes it
|
||||
(`src/ui/kit/missionsRadioControls.test.mjs` pins it). The card's FM
|
||||
frequency stays a native number field, which the kit has no control for,
|
||||
and the replay's pause, the roster's chevron and the compass arrows are
|
||||
text characters, not Material symbols.
|
||||
Utilities' Draw and Import are on the kit. Draw (a pressed toggle with
|
||||
`active`), Clear and Import are ghost `UiButton`s, their glyphs `UiIcon`s
|
||||
with `pp-icon` and `:size="null"`. Draw's five colour swatches, in the
|
||||
toolbar and in a drawn shape's row, are ghost `UiButton`s with
|
||||
`role="radio"`: they say they are chosen with `aria-checked` and their own
|
||||
`active` class, never `aria-pressed`. A drawn shape's row (its swatch,
|
||||
show/hide, the application's row actions and fly to, beside its remove
|
||||
`UiCloseButton`) is on the kit too, its glyphs `UiIcon`s with
|
||||
`:size="null"`, so `controls.css` still sizes them; show/hide says what it
|
||||
does in its name (Show …, Hide …) rather than being pressed. The Street
|
||||
Level panel's controls already were kit controls; its EXPAND ⤢ ⤡ and its
|
||||
errors' ⚠ are text characters and stay text
|
||||
(`src/ui/kit/drawControls.test.mjs` pins it).
|
||||
The AI chat panel's and the voice control's buttons are ghost
|
||||
`UiButton`s: the chat's Settings, quick prompts, attachment removes,
|
||||
Attach layer, Attach a file, Expand conversation, command suggestions,
|
||||
Expand chat, Add attachment and Send (a submit button that turns into
|
||||
Stop reply), and the voice control's Open AI chat, Back to chat, Back to
|
||||
voice, its Preview and Settings tabs and the error tray's DISMISS, beside
|
||||
the tier button, the mic and the dock and minimize buttons, which already
|
||||
were. The tier button and dock are pressed toggles; the mic is one only
|
||||
while its owner has a state for it; the tabs keep `role="tab"` and
|
||||
`aria-selected`. DISMISS is a text button, not a cross, so it is not a
|
||||
`UiCloseButton`. The Settings and tab glyphs are `UiIcon`s with
|
||||
`:size="null"`, so voice-cost.css and voice-card.css still size them
|
||||
(`src/ui/kit/chatVoiceControls.test.mjs` pins it). The chat bubble,
|
||||
globe, attach, send and stop, expand and Back glyphs stay inline SVG,
|
||||
since no Material symbol the page loads draws them the same, and the
|
||||
message box, file picker and inactivity minutes stay native fields, which
|
||||
the kit has none of. The voice modules build no controls in script.
|
||||
The small surfaces' buttons are ghost `UiButton`s: the locale picker's
|
||||
button, the phone tab bar's tabs, the globe actions' Clear, Share, Reset
|
||||
and north-up compass, the imagery divider's handle, the scene sharing
|
||||
dialog's buttons, the layer group index's ticks, the title logo, Exit
|
||||
clean view, the HUD's cockpit entry, a News card's face, a rail card's
|
||||
header, a layer row's toggle, the credits line's Data attribution and the
|
||||
camera calibration chips. None is a pressed toggle; the disclosures keep
|
||||
`aria-expanded`. Their Material glyphs (the tabs', the globe actions', the
|
||||
compass needle, the cockpit entry's and the celestial ring's sun and moon)
|
||||
are `UiIcon`s with `:size="null"`, so the site rules still size them. The
|
||||
locale picker's globe, caret and check and a News card's category icon stay
|
||||
inline SVG. The Omnibar guide draws the extra rings of a step with several
|
||||
targets in its template, as many as `view.subRings` says, rather than
|
||||
building them in script; the Omnibar's one other `material-symbols-outlined`
|
||||
is a stylesheet selector, and the layer disclosure only names a button in a
|
||||
comment (`src/ui/kit/smallSurfacesControls.test.mjs` pins it).
|
||||
The Street Level photo viewer of KartaView and Panoramax (the photo, the
|
||||
panorama canvas and the ‹ › buttons) is `StreetLevelPhotoViewer`, drawn
|
||||
from what the photo viewer presents rather than built in script. Its ‹ and
|
||||
› are ghost `UiButton`s, not pressed toggles, whose glyphs are text
|
||||
characters; the viewer builds no element, and the street-level layer it
|
||||
belongs to needs no Vue (`src/ui/kit/streetLevelPhotoControls.test.mjs`
|
||||
pins it). The notice the God's Eye View panel page shows when it loses its
|
||||
3D graphics (`#status`, in `src/app/globePanelRuntime.js`) stays built in
|
||||
script: that script is sent to the host as source text and runs in the
|
||||
host's panel page before the app loads, so it can import nothing.
|
||||
The Bhote Koshi reconstruction panel's buttons (previous and next beat,
|
||||
Play, Play scene, Cinematic, Full story, Open original, Lower gorge, the
|
||||
field reports and Open public map) are ghost `UiButton`s that keep their
|
||||
`data-action` hooks. Cinematic is a pressed toggle with no pressed class,
|
||||
since bhote-koshi.css reads its `aria-pressed`: the event layer presents
|
||||
its state as the record's `pressed`, which the panel passes to the
|
||||
button, instead of writing an `aria-pressed` attribute. The ‹ and ›
|
||||
arrows are text characters. The event's embedded media cards (each
|
||||
anchored witness clip's frame, leader line, title, status and original
|
||||
link, and the hidden YouTube preload) are drawn by
|
||||
`BhoteKoshiMediaCards`, which `src/data/bhoteKoshiEmbeddedMedia.js`
|
||||
renders into its overlay root with `h()` and `render()` on every change,
|
||||
words again on a locale change, and places after each frame; they hold
|
||||
no control, and the original link stays a link. The script still builds
|
||||
the provider SDKs' script and preconnect tags, the overlay root, and the
|
||||
Facebook player node: that node is warmed hidden before its card exists
|
||||
and carried, loaded, into the card's player, where the SDK replaces its
|
||||
contents, so a template could only rebuild it and reload the player; the
|
||||
X post is likewise built by its SDK inside the player
|
||||
(`src/ui/kit/bhoteKoshiControls.test.mjs` pins it).
|
||||
`UiSelect` renders the bare native select (Core's labels sit outside it or
|
||||
come as an `aria-label`) with `v-model`, `options` and `disabled`;
|
||||
options that carry their own attributes come through the slot, a caller's
|
||||
`@change` still reaches the select, and `hold` works as in `UiSlider`.
|
||||
Without `hold`, a select takes its model back after its own change renders,
|
||||
so a pick its owner refuses goes back; an owner that answers later (the SDR
|
||||
gain) takes `hold`. Every select in the views is a `UiSelect`.
|
||||
gain) takes `hold`. A layer row's range ends are repainted on a later frame
|
||||
and may come back reordered (a start picked after the end swaps them), so
|
||||
they take a plain `value` instead of a model: a pick stays until the owner
|
||||
publishes a different value, which shows at once, focused or not
|
||||
(`src/ui/layerPanel/rowRange.test.mjs`). Every select in the views is a
|
||||
`UiSelect` (`src/ui/kit/viewControls.test.mjs` pins it).
|
||||
`UiBadge` takes a `tone` and carries Core's `gev-status-badge`; its
|
||||
density variants and colours stay caller classes, and it renders the CCTV
|
||||
source and calibration badges and the rail card badges. `UiEmpty` takes
|
||||
@@ -165,13 +328,16 @@ empty rows stay a paragraph and table cells.
|
||||
no tip unless the site passes a `title`; attributes and classes pass through,
|
||||
so each site keeps its id, feature class and look. Every close, dismiss and
|
||||
clear button in the views that draws a cross is one
|
||||
(`src/ui/kit/closeButtons.test.mjs` pins it) except Story Explore's two
|
||||
search clears, whose SVG cross is neither of its glyphs; the Story context
|
||||
(`src/ui/kit/closeButtons.test.mjs` and `viewControls.test.mjs` pin it,
|
||||
for a bare × or one in a span) except Story Explore's two search clears,
|
||||
whose SVG cross is neither of its glyphs, and an imported file's
|
||||
Remove, one of the row's icon `UiButton`s (show or hide, fly to, remove)
|
||||
that draw the icon the file import names for each. The Story context
|
||||
sheet's Close is a text button, a plain `UiButton`. Street Level's and the
|
||||
space mission's keep `bare`, since their skins set their own padding and
|
||||
border, and so does the credits list's. The
|
||||
Quebec CCTV overlay's close is one too, and so is the Omnibar guide's,
|
||||
which keeps its feature class and tip.
|
||||
space mission's (its deselect and the replay's Cancel) keep `bare`, since
|
||||
their skins set their own padding and border, and so does the credits
|
||||
list's. The Quebec CCTV overlay's close is one too, and so is the Omnibar
|
||||
guide's, which keeps its feature class and tip.
|
||||
`UiSearchField` takes `v-model`, a required `label` (the input's
|
||||
accessible name), `placeholder` and `tag` (`div`, given `role="search"` by
|
||||
the site, or `label`); attributes and classes go to the frame, and
|
||||
@@ -215,7 +381,8 @@ classes, styles and listeners go to the dialog, and `element` is exposed.
|
||||
The Data Library and the scene sharing dialogs are `UiDialog`s
|
||||
(`src/ui/kit/dialogs.test.mjs` pins it); the panels drawn as
|
||||
`role="dialog"` (key setup, the welcome launcher, the CCTV popup, Story
|
||||
Explore's filter, the credits) and the render failure's `alertdialog` are
|
||||
Explore's filter, the credits, the Omnibar guide's callout) and the render
|
||||
failure's `alertdialog` are
|
||||
other controls. The two dialogs share no declarations, so it has no kit
|
||||
rules.
|
||||
`UiSlider` keeps the native range input rather than drawing a
|
||||
@@ -227,9 +394,12 @@ are, without Core's slider surface). A caller's own input, change and blur
|
||||
handlers still reach the input, and a null model leaves it as it is. It is
|
||||
a functional render-function component, so the portable `./ui/input` rows
|
||||
use it without a component compiler. Every range in the views is a
|
||||
`UiSlider` except the radio tuner's: its owner moves the handle back to the
|
||||
`UiSlider` except two. The radio tuner's owner moves the handle back to the
|
||||
selected station on a drag's first input without changing the slot, which
|
||||
a functional component would not render again.
|
||||
a functional component would not render again. The world timeline's
|
||||
scrubber is a bare range inside its own gesture track: its `step="any"`
|
||||
bounds follow the zoomed view, and a pinch puts the input back on the
|
||||
handle itself.
|
||||
|
||||
Controls share one skin, so every panel reads the same. Every scrolling
|
||||
surface carries the kit's `.ui-scroll`, which draws the thin
|
||||
@@ -240,11 +410,17 @@ page declares no dark `color-scheme`. Selects and number fields are
|
||||
and keeps native spinners dark; ranges are `.gev-quantitative-slider`, with
|
||||
a feature supplying only its accent.
|
||||
|
||||
`t()` is not reactive. Words a view passes to a kit component as a prop
|
||||
(`UiCloseButton`'s `label`) follow a locale change on the view's next
|
||||
render, but words in a kit component's slot do not: the compiled slot does
|
||||
not render the child again. A view whose words must follow the locale at
|
||||
once passes the locale itself as a prop or key, as the credits line does.
|
||||
`t()` is reactive only while the locale is bound to a ref (the app binds
|
||||
it to vue-i18n's). Words a view passes to a kit component as a prop
|
||||
(`UiCloseButton`'s `label`) follow the view's render at once. Words and
|
||||
props read in a kit component's slot follow a tick later, in the child's
|
||||
own update, and never when the locale is unbound; a slot that reads a
|
||||
`v-for` variable is already redrawn with its view. A view whose owner
|
||||
patches synchronously and reads the result at once (a News card, a rail
|
||||
card, the credits line, the Omnibar guide's buttons) gives such a slot
|
||||
under a named condition that is always true
|
||||
(`<template v-if="redrawWithView" #default>`): Vue redraws a conditional
|
||||
slot whenever its view is drawn.
|
||||
|
||||
## Phases
|
||||
|
||||
@@ -309,7 +485,20 @@ once passes the locale itself as a prop or key, as the credits line does.
|
||||
(done: `RecentImageryReadout` and its day cards, the same way),
|
||||
Street level (done: `StreetLevelPanel` renders the `gev-street-level`
|
||||
store that `StreetLevelControls` publishes to; the controls keep their
|
||||
listeners, EXPAND, focus and resizing), CCTV (done: `CctvPanel` renders
|
||||
listeners, EXPAND, focus and resizing; `StreetLevelPhotoViewer`, beside
|
||||
it in the layer panels, teleports into the viewer host the photo viewer
|
||||
KartaView and Panoramax mount there, which `createPhotoViewer()`
|
||||
presents through the layer's `subscribePhotoViewer()` and the
|
||||
application shell publishes to the `gev-street-level-photo` store, so
|
||||
the portable `./layers/street-level` entries need no Vue; the viewer
|
||||
keeps every decision, the photo loading, keys, drag and zoom, and draws
|
||||
its panorama on the canvas the view hands back, a fresh one after a lost
|
||||
WebGL context; each mount and canvas is keyed, so no viewer reuses
|
||||
another's elements, and of two viewers mounting at once only the later
|
||||
is drawn while the earlier one's mount closes; with no view
|
||||
subscribed, as when the layer runs without the application shell, a
|
||||
KartaView or Panoramax photo cannot mount),
|
||||
CCTV (done: `CctvPanel` renders
|
||||
the whole panel from the `gev-cctv` store, including the camera picker,
|
||||
the inline pose editor, the frame preview, source badge and typed
|
||||
summary; `CctvControls` keeps its listeners, the frame requests and the
|
||||
@@ -411,7 +600,8 @@ once passes the locale itself as a prop or key, as the credits line does.
|
||||
reconstruction panel (`BhoteKoshiPanel`, last in the context rail,
|
||||
renders what the event layer publishes to the `gev-bhote-koshi-panel`
|
||||
store: each control's text, hidden, disabled, value and attributes as
|
||||
the layer writes them, unchanged frames sending nothing; the rail takes
|
||||
the layer writes them, and the cinematic button's pressed state,
|
||||
unchanged frames sending nothing; the rail takes
|
||||
`bhote-event-active` while it shows), the full-globe celestial ring
|
||||
(`CelestialRing` teleports into the globe container what `CelestialRing`
|
||||
in `src/celestialRing.js` publishes to the `gev-celestial-ring` store and
|
||||
@@ -500,14 +690,15 @@ once passes the locale itself as a prop or key, as the credits line does.
|
||||
records surface by surface; [Building UI](../CONTRIBUTING.md#building-ui)
|
||||
now requires the pattern for new UI. The page-level markup tests read
|
||||
`renderApplicationHtml()`, the real views rendered on the server, and new
|
||||
tests mount components; two tests still read a `.vue` file's source
|
||||
(`panelStorageDocs`, `geoFileImport`). The views translate with `t()`
|
||||
while rendering, and vue-i18n holds the locale they read; the attribute
|
||||
translation pass is left for static page markup (the loading screen and a
|
||||
host's own markup). An explicit API for hosts to register panels and rail items is
|
||||
deferred until a host adds one: no host does today (the hosted
|
||||
application's account interface is its own markup), and the first such
|
||||
panel, the hosted timeline, will shape it.
|
||||
tests mount components. Many tests still read `.vue` sources: the kit's
|
||||
control scans in `src/ui/kit/` (`viewControls`, `closeButtons`,
|
||||
`checkboxes`, `dialogs` and the per-surface ones) and markup checks such
|
||||
as `contextTabKeyboard`, `geoFileImport` and `panelStorageDocs`. The
|
||||
views translate with `t()` while rendering, and vue-i18n holds the
|
||||
locale they read; the attribute translation pass is left for static page
|
||||
markup (the loading screen and a host's own markup). An explicit API for
|
||||
hosts to register panels and rail items is deferred until a host needs
|
||||
one.
|
||||
|
||||
## Verification
|
||||
|
||||
|
||||
Reference in new issue
Block a user