v0.3.0: display abstraction, map-browser menu, SAGE terrain tiling/blends

- ra3.client::display: shared interactive loops; SDL and Vulkan backends
  implement only the primitives (init/present/poll_event/window_size/
  key_down/present_terrain). ra3.display picks the backend.
- Menu: maps by localized name (gamestrings.csf), red/gold theme, hover
  highlight, mouse + keyboard, wheel scroll, fullscreen and FPS/vsync
  options, loading progress bar.
- Terrain: continuous tile sampling via a texture array (REPEAT, uv =
  cell/(2*cellSize)) removes per-cell grid seams; SAGE blend ramp for
  material transitions; FPS label + top-right minimap overlays.
- Skip the skirmish sim for map views; reuse the Vulkan texture; no idle
  terrain redraw.
This commit is contained in:
EnderTheCoder
2026-09-20 02:20:39 +08:00
parent 702b4e29aa
commit b6d619254d
66 changed files with 37661 additions and 406 deletions
+27 -16
View File
@@ -18,25 +18,36 @@ that each one produces something that builds and runs.
`import std;` in every module; added an isolated Windows cross-build
(llvm-mingw + SDL3 MinGW) producing `openra3.exe` + `SDL3.dll`, alongside
the Linux build. Both images are separate to keep the toolchains apart.
- [x] **v0.3.2 — real terrain.** `ra3.terrain` parses the map's `HeightMapData`
and `BlendTileData` and rasterises the actual terrain from the install's
`Terrain.big` tile textures (top-down, elevation-shaded), replacing the
`<map>_art.tga` overview as what `render` draws.
- [x] **v0.3.0 — real balance + skirmish + Vulkan.** `ra3.data` pins the retail
numbers (damage types, `ArmorTemplate` percentages, weapons, units,
structures, ore economy) audited from EA's open RA3 XML; `ra3.skirmish` is
rebuilt on them (armour resolution, weapon target masks, pay-as-you-go
build queue, power, tech prerequisites, refinery ore cycle, team-wipe
victory); and `ra3.vulkan` replaces the presentation stack with Vulkan
(SDL3 surface, embedded SPIR-V), with a null fallback where no loader
exists.
## Next
- [ ] **v0.1.1 — correct world calibration.** Parse the map heightmap
dimensions (and `MPPositionList` starts) so the unit overlay lines up with
the map art instead of using an assumed world size.
- [ ] **v0.2.0 — data & file formats.** Parse compiled gameplay assets
(`GameObject`, `WeaponTemplate`, `ArmorTemplate`, `LocomotorTemplate`) so
units use the real balance numbers instead of OpenRA3's stand-ins.
- [ ] **v0.3.0 — deterministic simulation.** Real update modules, locomotor
movement, weapons/damage/armour resolution, build queues and the tech
tree, pathfinding and shroud.
- [ ] **v0.4.0 — AI.** Skirmish AI: build states, team composition, attack
waves (the reference tree's `AI*` modules).
- [ ] **v0.5.0 — full renderer.** Terrain heightmap rendering, W3D models and a
D3D9/Vulkan/OpenGL client backend implementing `ra3::client::display`,
plus full input.
- [ ] **v0.6.0 — content.** Load real maps, units, powers and strings; play a
skirmish end-to-end with a UI.
- [ ] **v0.3.1 — tactical map view.** The Vulkan/SDL viewer reproduces the
retail tactical view (`TheTacticalView`, `ra3_1.12.game` `0x00cdb7b4`):
opens centred on the player's start, wheel zoom, edge scroll and clamped
pan. A hand-rolled HUD was tried and removed — the real in-game interface
is `.apt` art that must be recovered first, so it is not on the near
roadmap.
- [ ] **v0.4.0 — real update modules.** Locomotor movement, projectiles and
warheads, build placement, shroud, and pathfinding, driven by the
`GameObject` module set recovered from the binary.
- [ ] **v0.5.0 — data-driven content.** Deserialise the compiled assets
(`global.bin`/`static.*.bin` + `.manifest`) so `ra3.data` reads the
install instead of pinned constants; real maps, models and strings.
- [ ] **v0.6.0 — full renderer.** Perspective terrain (the heightmap is decoded
but drawn top-down today), W3D models and the full in-game client on
Vulkan, plus input.
## Cross-cutting tracks