Files
Neutron/docs/reference-testing.md
T

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