Render original lab and Jimmy with native Vulkan and SDL3 on .NET 10

This commit is contained in:
UnixNight committed 2026-10-23 17:36:04 -04:00
1 parent 3df20ac19a
commit 008c0e16da
41 files changed
+2125 -68

No files matched your search

+38
View File
@@ -0,0 +1,38 @@
# Original reference testing
Originals are never executed in place. `tools/recon/reference_capture.py` copies
Original to ignored `artifacts/reference/game`, then launches official Wine 11.0
in bubblewrap with all namespaces unshared, no network, a minimal read-only host
filesystem, and writable generated work/prefix only. Original paths and home are
not mounted. Xvfb runs inside the namespace; ImageMagick captures its root window.
Return key injection is optional. The new port has no Wine dependency.
Local WineHQ Ubuntu noble stable amd64/i386 packages were downloaded separately,
verified against official index SHA-256 and extracted under `.tools/wine`. The
wrapper also needs `.tools/native/usr/bin/Xvfb`, bubblewrap, xkbcomp, ImageMagick,
32-bit Wine runtime libraries and an appropriate Wine graphics backend. Mesa
software-driver dependencies are kept project-local. Network namespace creation
needs scoped tool escalation in this environment; no host installation is used.
Reproduce (Linux host with those tools):
```sh
python3 tools/recon/reference_capture.py --seconds 24 --enter --debug
```
The supplied NeutronNoCD.exe was launched in the isolated copy and created its
1024x768 'Jimmy Neutron' window. Initial captures were uniform white. Debug logs
show Wine DirectDraw/Direct3D initialization failing to find a suitable GL pixel
format, then failing to allocate a 3D-capable surface (0x8876086a). These captures
are **not usable gameplay references**. Original timing, startup, cutscene,
lighting, camera, collision and audio have therefore not yet been compared.
The wrapper records screenshots, Wine/Xvfb logs, window tree and isolated process
list, all locally under artifacts/reference. An alternate Wine Vulkan backend is
also tested with `--wine-renderer vulkan --output artifacts/reference-vulkan`.
It created a Vulkan device/window but logged unsupported fixed-function states
and a requested swapchain image count1 outside the driver's supported3..16 range.
Those frames are also unusable. Failures must not be treated as original behavior.
No native Windows installation/VM or Windows 98 image was available in the initial
environment/tool inventory. A local reference machine remains necessary if Wine
cannot render correctly. Native Windows port execution remains separately untested.