F7: Offscreen render capture harness
tools/capture.sh <scene-or-scenario> <out.png> renders the real client in a throwaway tidewall-capture-* Docker container (debian:13, Xvfb, Mesa software rendering), with no network, no host display, GPU or audio, and removes the container afterwards. The tidewall-capture image rebuilds only when its recipe changes. Forward+ through Lavapipe is the default, matching the game; CAPTURE_RENDERER=compatibility uses OpenGL through llvmpipe. The script fails if Godot silently falls back to another renderer, and fails on a blank frame, judged by ImageStats (luminance variance and colour count). make capture-test renders the shore test scene with both renderers and proves an empty scene is rejected. ImageStats has unit tests in make check. CLAUDE.md now requires a capture for visual issues, and requires that it be opened and looked at. Closes #7 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
Executable
+25
@@ -0,0 +1,25 @@
|
||||
#!/usr/bin/env bash
|
||||
# Runs inside the tidewall-capture container. Starts a private Xvfb, then runs the
|
||||
# repo's pinned Godot against it. Arguments go to Godot after the repo's own flags.
|
||||
set -euo pipefail
|
||||
|
||||
mkdir -p "$HOME"
|
||||
export DISPLAY=:77
|
||||
Xvfb "$DISPLAY" -screen 0 "${CAPTURE_SCREEN:-1280x720x24}" -nolisten tcp -noreset \
|
||||
>/tmp/xvfb.log 2>&1 &
|
||||
xvfb_pid=$!
|
||||
trap 'kill "$xvfb_pid" 2>/dev/null || true' EXIT
|
||||
|
||||
for _ in $(seq 1 50); do
|
||||
[[ -e /tmp/.X11-unix/X77 ]] && break
|
||||
sleep 0.1
|
||||
done
|
||||
if [[ ! -e /tmp/.X11-unix/X77 ]]; then
|
||||
echo "tidewall-capture: Xvfb did not start" >&2
|
||||
cat /tmp/xvfb.log >&2
|
||||
exit 3
|
||||
fi
|
||||
|
||||
# This container's X server is private, so a window here is allowed.
|
||||
export TIDEWALL_GODOT_DISPLAY=1
|
||||
/repo/tools/godot.sh --display-driver x11 --audio-driver Dummy "$@"
|
||||
Reference in New Issue
Block a user