56 lines
2 KiB
Markdown
56 lines
2 KiB
Markdown
# Epiphany Aquarium Engine
|
|
|
|
C# engine-core seed for the next Epiphany Aquarium line.
|
|
|
|
This repo starts after the web and Rust prototypes taught the expensive lesson:
|
|
the Aquarium wants an owned renderer, owned state model, and owned interaction
|
|
grammar. Stride can stay on the shelf as reference material, but the runtime is
|
|
Aquarium-owned: window, renderer, state, and interaction grammar all belong
|
|
here.
|
|
|
|
## Intent
|
|
|
|
- C# host with renderer architecture kept legible in Rider.
|
|
- Vortice/D3D11 first, with the native boundary kept explicit.
|
|
- Grid-centered camera and world-space interaction invariants as first-class
|
|
engine contracts.
|
|
- Diegetic UI surfaces driven by Aquarium objects instead of admin chrome.
|
|
- CultNet for Epiphany communication.
|
|
- CultCache for settings, persistent client state, and reload recovery.
|
|
- Procedural audio and visual state treated as coupled signals.
|
|
|
|
## Borrowed Lessons
|
|
|
|
- The web client proved the interaction grammar: objects first, panels only as
|
|
local unfold surfaces.
|
|
- The Bevy prototype proved the renderer direction: raymarched bodies,
|
|
Grid-space fields, HDR, bloom, and camera/Grid invariants.
|
|
- The Rust synth work proved the audio module deserves its own small, sharp API.
|
|
|
|
## First Build Target
|
|
|
|
Create the smallest C# executable that opens a window, owns the camera/Grid
|
|
invariant, and renders one sun plus orbiting planets with diegetic labels.
|
|
Everything else earns its way back in.
|
|
|
|
## Run
|
|
|
|
Aquarium currently expects the sibling `CultMath` repo at `E:\Projects\CultMath`
|
|
or the equivalent `..\..\..\CultMath` path from the engine project.
|
|
|
|
```powershell
|
|
dotnet build Aquarium.Engine.slnx
|
|
dotnet run --project src\Aquarium.Engine\Aquarium.Engine.csproj
|
|
```
|
|
|
|
Headless smoke:
|
|
|
|
```powershell
|
|
dotnet run --project src\Aquarium.Engine\Aquarium.Engine.csproj -- --headless
|
|
```
|
|
|
|
The first cut opens a Win32 window directly and owns a D3D11 swapchain through
|
|
Vortice. No Stride runtime, no asset protocol, no borrowed game loop wearing a
|
|
fake mustache. See `docs/vortice-spine.md`.
|
|
|
|
Current camera controls are documented in `docs/input.md`.
|