Files
Neutron/docs/reference-testing.md
T

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/.