Vendor libra3assets (C++26 modules: BIG4, RefPack, BinaryAsset, CSF, CkMp map)
under third_party/ and add the ra3_assets target. ra3.fs, ra3.map and ra3.terrain
become thin adapters over it:
- ra3.fs delegates RefPack and the BIG4 index/payload reads (index-only, payloads
read on demand).
- ra3.map decodes ObjectsList and CSF via map_document/csf_table; starts come from
player_starts(), replacing the off-by-one whole-buffer scan.
- ra3.terrain takes the CkMp container and HeightMapData from map_document, with
BlendTileData (not modelled by the library) parsed from the chunk payload.
Adds an opt-in real-asset check (OPENRA3_TEST_ASSETS) plus the library's own unit
suite as ra3assets_unit.
- ra3.map: capture the object RoadType; ra3.models pairs the map's
Start/End road objects and drapes a flat textured ribbon along each
segment (tessellated to the relief).
- Ground decals (roads/sidewalks) get a per-vertex screen-space depth
offset (scene::vertex.bias) applied in the object shader and the
software rasteriser, so they no longer z-fight or clip into the
terrain at top-down angles.
- Tactical view aligned with retail (SAGE LookAtTranslator): middle-drag
orbits yaw/pitch, a middle click resets angle/pitch/zoom, arrow keys
pan, wheel zooms within the retail zoom range; WASD pan removed and
left-drag no longer rotates.
- ui_event gains middle/right/released buttons; Vulkan + SDL map them.
- docs: roads, depth bias and camera controls.
Read the buildings and props a map places from its compiled art (the
uncompressed worldbuilder stream + embedded DDS textures):
- ra3.models: BAB asset-stream parser (lazy slices), W3DMesh + D3DHierarchy
decode, DDS (DXT1/3/5 + uncompressed) decode, per-mesh bone remap and
bind-pose single-joint skinning, flattened to one world-space triangle soup.
- ra3.map: parse the ObjectsList chunk into (type, x, y, z, angle).
- ra3.terrain: render3d rasterises the scene over the raymarched terrain with
a z-buffer; gpu_terrain carries the scene for the GPU backends.
- ra3.vulkan: second pipeline + depth attachment, terrain.frag writes
gl_FragDepth, and a small depth bias keeps ground decals from z-fighting.
- objects.fx shaders (compiled to SPIR-V), embedded like scene/terrain.
Only opaque parts are drawn: FX-light billboards (DefaultW3D.fx / BasicW3D.fx)
and damage-fill shells (BuildingsGenericDamageFill.fx) are skipped, since the
latter paint the wrecked interior (e.g. orange CBBuilding_Wood) over the shell.
Ground-decal meshes with no diffuse role and the Road templates themselves are
still not drawn.
- ra3.webgl: a Web peer of Vulkan/Direct3D (SDL3 canvas + GLES3/WebGL2), with
2D blit and the GPU terrain raymarch; GLSL ES shaders; null fallback off
Emscripten. backend::webgl + default_backend() (webgl under Emscripten).
- Emscripten toolchain + Dockerfile.wasm + scripts/build-wasm.sh; import std,
global -fexceptions, and Asyncify so the blocking frame loop yields to the
browser (display::sleep_frame calls emscripten_sleep).
- apps/web/shell.html + apps/web/serve.py (Range-capable dev server).
- Assets: browsers forbid synchronous on-demand reads on the main thread (and
FS.createLazyFile / the WasmFS fetch backend are worker-only; SDL3's Emscripten
backend is main-thread DOM only, so the engine cannot run in a worker). The
wasm build therefore preloads a compact per-map set via OPENRA3_WEB_ASSETS.
- New openra3 textures --map ID lists the loose terrain TGAs a map resolves to
(terrain::resolve_texture_files, shared with load_textures_from_dir).
- Fixes: webgl heightmap used GL_R16 = 0x8229 (that is R8) -> upload rejected,
terrain flattened to water; now 0x822A. Logger uses a stdout console sink on
the web (stderr maps to console.error); a GL error check logs bad uploads.
- CI: wasm image + build jobs.
EnderTheCoder