Gives hb-gpu a non-interactive output path:
hb-gpu --demo -o /tmp/frame.ppm
hb-gpu --demo -o - | display # stdout piping
When --output-file is set, the GL backend passes
GLFW_VISIBLE=false so no window pops up. After the normal init
and one render pass, we glReadPixels the default framebuffer,
flip row order, and write a PPM (P6) to the selected sink.
No event loop, process exits after writing.
Supported format: ppm (only). Other formats are rejected by the
shared output_options_t machinery. Metal and D3D11 backends
currently still open a window; headless support there is a
straightforward follow-up.
This unlocks CI golden-image tests for shader changes and
reproducible benchmark timing without swapchain-present jitter.
Assisted-by: Claude <noreply@anthropic.com>