Files
gods-eye-view/src/data/local_data/sky/README.md
T
German Khokhlov 97c4dc76ce Move scene effects and imported geometry behind the globe contract
Move Cesium viewer, map, sky, projection, trail and sonar internals into
its engine. Drive styles, bloom, sharpening and contact sonar through
engine.render. Count camera-input suspensions across all three engines
and migrate the feature callers. Preserve Cesium's effects and input
behaviour; fix transit lens clicks on Cesium and make zero sharpening on
Navara disable sharpening, as it does on Cesium.

Parse imported files into plain records and draw them through movers,
lines, ground and imagery on both engines. Follow Cesium's KML style
precedence, preserve local KMZ images and frame the drawable records.
Open overlays use imagery when the engine has no native map-overlay API.
Run every imported-display case on fake and headless Cesium engines.

The shared import path retains these known differences from Cesium's old
DataSources: wall fills, extruded prisms and gx:LatLonQuad are undrawn;
raised polygon fills drape while outlines retain altitude; GroundOverlay
rotation, altitude and RGB tint are not applied; rhumb lines become great
circles. Ground heights use the loaded surface synchronously instead of
waiting for most-detailed sampling. Supported KMZ ground overlays now
draw on Navara too. Document the limits rather than claiming full parity.

Combine batches B and C because their disjoint path manifests cannot
place the shared boundary and format files in a later commit while
keeping B independently valid. This combined commit owns the shared
docs, package boundaries, format scope, locale catalogs and coupling
baseline. Remove five obsolete import strings from all eleven catalogs.
Make the load-time source scan include new files and skip deleted paths
so the same checks work before and after recording the moves.

Coupling: Navara renderer lines fall from 1695 to 1294, Cesium import
files from 25 to 9, viewer lines from 1177 to 1026, SDK loads from 4 to 3
and engine-name lines from 62 to 42. No count grows.

The full unit suite and the boundary, format and coupling checks pass.
Browser validation remains to be run.

Browser checks to run
GOOGLE_MAPS_API_KEY= CESIUM_ION_TOKEN= npm run dev -- --port 4291
node scripts/qa-contract-suite.mjs http://localhost:4291
node scripts/qa-navara-visual-styles.mjs http://localhost:4291
node scripts/qa-navara-bloom.mjs http://localhost:4291
node scripts/qa-navara-sonar.mjs http://localhost:4291
QA_BASE_URL=http://localhost:4291 node scripts/qa-visual-effects.mjs
QA_BASE_URL=http://localhost:4291 node scripts/qa-zoom-out-guard.mjs
node scripts/qa-sky-model-lighting.mjs --url http://localhost:4291
node scripts/qa-geo-import.mjs http://localhost:4291
node scripts/qa-geo-import-regressions.mjs http://localhost:4291
node scripts/qa-geo-import-large.mjs http://localhost:4291
node scripts/qa-navara-geo-import.mjs http://localhost:4291

Use the keyless server for every check. Photoreal-only cases remain
unverified; do not enable paid tiles to run them.
2026-11-07 12:45:21 +04:00

2.0 KiB
Raw Blame History

Sky background

Catalogue stars over a soft Milky Way, drawn by src/globe/cesium/starrySky.js in place of Cesium's blocky Tycho-2 sky box.

File Content Size
bright_stars.json 9,096 stars: J2000 RA/Dec, V magnitude, B−V 235 KB
milkyway_{px,nx,py,ny,pz,nz}.webp Milky Way glow, six 1024² cube faces, no stars 62 KB

Stars — Yale Bright Star Catalogue

Source: 5th Revised Edition (Hoffleit & Warren 1991), CDS catalogue V/50, file https://cdsarc.cds.unistra.fr/ftp/V/50/catalog.gz (sha256 3dc44b1e90be8fbe5bcc7656032560f51275f985c7e3f783c9028e1838ec7bed, fetched 2026-10-19).

License: public domain. CDS asks for an acknowledgement; the "Data attribution" popover carries it.

Build: node scripts/build-bright-stars.mjs [catalog.gz]. Drops the 14 records without a J2000 position; rounds RA/Dec to 0.001° and magnitudes to 0.01.

Milky Way — ESO/S. Brunier

Source: ESO image eso0932a, https://cdn.eso.org/images/original/eso0932a.tif (6000×3000 sRGB TIFF, sha256 10f209ab83e1fd89e7fa1ed70277ffc6ed19c43549f04ec637c6806d98aff035, fetched 2026-10-19).

License: CC BY 4.0. Credit: ESO/S. Brunier.

Changes made (CC BY 4.0 asks for them): resampled to 4096×2048; stars removed; two images of Jupiter painted over; blurred (0.4°, 2° in the faint glow); reprojected to ICRF cube faces; black level at the median sky; saved as WebP. Build: node scripts/build-milky-way.mjs <eso0932a.tif>.

The panorama's stars sit up to ~2° off; that is invisible in the blurred glow, and every sharp star comes from the catalogue.

NASA SVS "Deep Star Maps 2020" was not used: it derives from Gaia DR2, which ESA licenses CC BY-NC 3.0 IGO.

Frame

Both layers are in ICRF/J2000. The cube faces use the WebGL face layout, +X to the March equinox and +Z to the north celestial pole, uploaded without flipY.