GUI Proof Capture

Use tests/workspace_smoke/proof_capture.py from the repository root. The GUI application may run inside Docker, but the capture runs on the host X11 display.

When a user asks for a screenshot or recording as proof, start with this host-side X11 capture path after launching the relevant GUI. Do not start with Isaac Replicator, offscreen rendering, or other internal renderer export paths unless the user explicitly asks for a rendered scene artifact, headless render, or no GUI/display is available. For Isaac proof, a visible Isaac Sim window plus CLI/version logs is usually the fastest sufficient evidence.

For Isaac Sim screenshot proof, use tests/workspace_smoke/isaac_gui_proof_scene.py as the container-side scene launcher. Wait for ISAAC_GUI_SCENE_READY in its log before capturing; a black viewport usually means Isaac was still loading or settling the scene.

Screenshot:

python3 tests/workspace_smoke/proof_capture.py screenshot \
  --display "${DISPLAY:-:0}" \
  --x11-size 1280x720 \
  --output tests/workspace_smoke/artifacts/<name>.png

Short recording:

python3 tests/workspace_smoke/proof_capture.py record \
  --display "${DISPLAY:-:0}" \
  --x11-size 1280x720 \
  --seconds 10 \
  --framerate 15 \
  --output tests/workspace_smoke/artifacts/<name>.mp4

The helper wakes the display with xset and captures with ffmpeg -f x11grab. Python callers can pass window_id to capture a specific application window. This requires xdotool and rejects hidden windows or a change of foreground window during recording. Go2 rough-terrain proof uses this guarded capture. For automated workspace demos, prefer tests/workspace_smoke/doc_demo_smoke.py; it already calls this helper and writes screenshot artifacts beside logs.