89 lines
5.6 KiB
Markdown
89 lines
5.6 KiB
Markdown
# Native infrastructure and package scope
|
|
|
|
Presentation now survives level loads: one SDL window/device with scene-resource
|
|
replacement. Uniform widescreen UI and input mapping are documented in
|
|
presentation-and-ui.md. The optional scripts/test-window-transitions.sh uses
|
|
installed Xvfb/Xfwm/D-Bus for isolated Linux fullscreen checks; these are not game
|
|
dependencies. --width/--height choose initial window/offscreen dimensions.
|
|
|
|
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.
|
|
- Controllable lab with separate60Hz simulation, source-triangle capsule collision,
|
|
original no-gadget walking/jump formulas, chase camera and original motion clips.
|
|
|
|
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. Initial Windows rendering
|
|
is user-reported; broader native functionality remains unverified. Wine reference
|
|
testing is a separate investigation path.
|
|
- Preliminary Windows-package Wine64 check: standalone .NET10 executable rendered
|
|
two frames, exit0, with byte-identical PPM to Linux on the same software driver.
|
|
Validation was disabled for this Wine test; SDL window/input/audio and native
|
|
Windows drivers remain untested. See reference-testing.md for exact scope.
|
|
- Corrected Windows preview also passes a six-frame Wine64 window/input/animation
|
|
selection/resize smoke (validation disabled). Native Windows retest is pending.
|
|
- Movement checkpoint packages rebuilt: Linux GTX1070 window and Windows Wine64
|
|
window each pass240 steps, SDL arrows/Shift, jump/landing and resize800x600.
|
|
Movement statistics match (travel1250.12, maxrise137.62, grounded final).
|
|
Linux Khronos validation is enabled with zero errors; Wine validation is disabled.
|
|
|
|
## Scope limits
|
|
|
|
The default now runs the lab story and recovered interactions, source props/patrol,
|
|
objectives/practice modal and jet pack tutorial. --skip-intro restores control;
|
|
--inspect retains the scene/clip inspector. Collision response, visual pivot,
|
|
60Hz cadence, global phase order and animation/render-state fidelity remain
|
|
provisional. Full combat/AI/progression/menus/runtime saves are incomplete.
|
|
|
|
Packages include all33 available prepared scene pairs, original ASE/png/gam/omt
|
|
copies, alpha.omt, entity speech/canvases, actor clips, original UI,251 preserved
|
|
effect RIFF resources, .NET runtime, native SDL3 and SPIR-V. Legacy EXE/DLLs, tool
|
|
caches and original save slots are not runtime dependencies. Level3B/E GAMs are
|
|
supplied; registered geometry archives are absent but gameplay use is unverified,
|
|
so this is not an established missing-content blocker. No substitutes are used.
|
|
|
|
SceneAudio connects music/speech, pickup/button/door effects and owner loop stops.
|
|
Original positioning/volume/channel policy, jetpack callbacks and MPEG-in-RIFF
|
|
bird1/id162 decoding are unfinished. Linux dummy streams establish consumption,
|
|
not speaker output or historical fidelity. Native Windows story/input/audio and
|
|
original comparison remain unverified. See compatibility.md and progress.md for
|
|
current tests; these packages are investigation checkpoints, not a finished release.
|