39 lines
2.3 KiB
Markdown
39 lines
2.3 KiB
Markdown
# 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.
|