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:
@@ -0,0 +1,23 @@
|
||||
# Offscreen render harness for tools/capture.sh: a private X server (Xvfb) and Mesa's
|
||||
# software rasterizers, so Godot can render the real client without any host display,
|
||||
# GPU or audio device. Built as image tidewall-capture.
|
||||
FROM debian:13
|
||||
|
||||
RUN apt-get update \
|
||||
&& DEBIAN_FRONTEND=noninteractive apt-get install -y --no-install-recommends \
|
||||
xvfb xauth \
|
||||
libgl1 libgl1-mesa-dri libglx-mesa0 libegl1 libgles2 \
|
||||
mesa-vulkan-drivers libvulkan1 \
|
||||
libx11-6 libxcursor1 libxinerama1 libxrandr2 libxi6 libxext6 libxrender1 \
|
||||
libxkbcommon0 libxkbcommon-x11-0 \
|
||||
libfontconfig1 libdbus-1-3 libasound2t64 libpulse0 libudev1 \
|
||||
&& rm -rf /var/lib/apt/lists/*
|
||||
|
||||
# Never touch a real GPU, even if a device were passed in by mistake.
|
||||
ENV LIBGL_ALWAYS_SOFTWARE=1 \
|
||||
GALLIUM_DRIVER=llvmpipe \
|
||||
VK_ICD_FILENAMES=/usr/share/vulkan/icd.d/lvp_icd.json \
|
||||
HOME=/tmp/home
|
||||
|
||||
COPY entrypoint.sh /usr/local/bin/tidewall-capture
|
||||
ENTRYPOINT ["/usr/local/bin/tidewall-capture"]
|
||||
Reference in New Issue
Block a user