3.6 KiB
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):
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.
Preliminary Windows-port smoke under Wine64
python3 tools/recon/reference_capture.py --port-smoke --seconds 24 --debug
mounts only the self-contained Windows package in a fresh filesystem/network
namespace, with its own win64 prefix. The runtime, assets, shaders and scene data
all come from that package; the source, SDK and Original directory are not mounted.
The new port calls Vulkan directly and does not use Wine's legacy D3D backend.
The Windows x64 .NET10.0.13 executable decoded LV1B, loaded original lab/character resources and rendered two offscreen frames through lavapipe, exiting0. This test disabled Vulkan validation and does not establish Windows-driver validation, SDL window/audio/input functionality or native Windows compatibility.
At fixed morph time0.05, its PPM GPU readback is byte-identical to the native Linux
package readback (SHA-256 c30bcbc95d00ce104b146cc46c84e9a9d50849bf0b0bf33c027a402bb46e47c4).
Both use the same software Vulkan driver. This establishes consistency between
those two package executions, not fidelity to the original game.
An initial harness configuration disabled mscoree for the legacy game and thereby prevented Wine from loading the port's IL-only System.Runtime.dll. Port mode now uses Wine's built-in mscoree, correcting the test environment; no app workaround or Mono runtime is required. Logs/readback are in artifacts/windows-smoke/.