Render original lab and Jimmy with native Vulkan and SDL3 on .NET 10
This commit is contained in:
1 parent
3df20ac19a
commit
008c0e16da
41 files changed
+2125
-68
No files matched your search
@@ -0,0 +1,61 @@
|
||||
# Native infrastructure and package scope
|
||||
|
||||
Verified environment: Ubuntu 24.04 x86-64; project-local .NET SDK 10.0.402,
|
||||
Silk.NET 2.23.0, SDL 3.4.2 built from official source (Linux) and official x64
|
||||
SDL3.dll (Windows). GLSL compiled to Vulkan 1.3 SPIR-V and checked by spirv-val.
|
||||
Khronos validation layers are installed locally. No root installation is required.
|
||||
|
||||
`scripts/env.sh` selects local SDK, NuGet cache, native tools and validation layer;
|
||||
it also disables .NET CLI telemetry. `bootstrap.sh` reproduces dependency setup
|
||||
on the tested Ubuntu host using official pinned SDK/SDL archives and apt packages.
|
||||
Downloaded archive SHA-256 values are checked before extraction. Tool/dependency
|
||||
downloads are permitted by the specification; no project material is uploaded.
|
||||
|
||||
## Implemented
|
||||
|
||||
- C# .NET 10 shared executable and local-only solution/build scripts.
|
||||
- Vulkan 1.3 instance/device/graphics queue, descriptors, buffers, texture uploads,
|
||||
sampler, indexed graphics pipeline, depth attachment, offscreen target/readback.
|
||||
- SDL3 Vulkan surface, swapchain/presentation, resize/recreation, synchronization,
|
||||
cleanup, keyboard, focus handling and fullscreen toggle.
|
||||
- SDL3 WAV streams with conversion, optional looping and lifecycle cleanup.
|
||||
- Original OMT-derived world geometry/materials/textures; original ASE model and
|
||||
retained-base vertex morph animation samples; original GAM entities/camera.
|
||||
- Self-contained Linux/Windows publishing with matching native SDL3 libraries.
|
||||
|
||||
The renderer completes submissions synchronously. This deliberately simple early
|
||||
implementation is maintainable but does not target final performance. It currently
|
||||
has a texture-times-color pipeline, nearest mip level/linear sampling, alpha
|
||||
discard and depth. Original per-material culling/blending, lighting, fog and
|
||||
animation state/render sorting are incomplete. See rendering.md for evidence.
|
||||
|
||||
## Verified checks
|
||||
|
||||
- `scripts/test.sh`: Python extraction/GAM tests, C# data/morph/arithmetic tests,
|
||||
all 128 PNG and 254 ASE base meshes, actual original lab and player rendering.
|
||||
- Offscreen Mesa llvmpipe: lab 2,869 source triangles / 33 recovered textures;
|
||||
combined Jimmy preview 3,683 triangles / 34 textures; zero Vulkan validation
|
||||
errors. Readback is saved locally, visually reviewed and compared before/after
|
||||
material/texture fixes. This is not original-game visual equivalence proof.
|
||||
- SDL3 window on NVIDIA GeForce GTX 1070 under Xvfb: six frames, injected keyboard
|
||||
received, resize 960x720 -> 800x600, zero validation errors. Tested with scoped
|
||||
escalation because the restricted tool sandbox blocks display-socket access.
|
||||
- Recovered 11,025 Hz mono WAV: dummy-device SDL3 stream consumed 10,752 bytes
|
||||
in 500 ms. Physical speaker output, positional mixing and original timing are
|
||||
unverified.
|
||||
- Linux/Windows self-contained cross-publishing succeeds. Native Windows execution
|
||||
remains unverified; Wine reference testing is a separate investigation path.
|
||||
|
||||
## Scope limits
|
||||
|
||||
This is an investigation/runtime foundation, not complete reconstructed gameplay.
|
||||
Original collisions, task/trigger execution, introductory cutscene, inventory,
|
||||
combat, enemies, progression, save/load, original mouse/control behavior and
|
||||
remaining scenes are incomplete. Player rendering at the original startpoint is
|
||||
an animated preview; its interpolation loop/speed are not a recovered state machine.
|
||||
|
||||
Packages include local copies of asset directories (ASE/png/gam/omt), original
|
||||
font PNGs/NewGame/readme, lab/Jimmy scene resources, recovered music, .NET runtime,
|
||||
SDL3, SPIR-V and these limitations. Legacy EXEs/DLLs, old user save slots, tool
|
||||
caches and analysis databases are not runtime dependencies. Vulkan drivers remain
|
||||
platform prerequisites. No claim of native Windows runtime validation is made.
|
||||
Reference in new issue
Block a user