feat(primitives_gallery): añadir --capture <dir> mode (offscreen render + glReadPixels)

Modo de captura que renderiza cada demo de la gallery en una ventana GLFW
invisible (GLFW_VISIBLE=GLFW_FALSE) y guarda PNG por demo via stb_image_write.

- capture.{h,cpp}: API gallery::run_capture(cfg, items) — warmup_frames,
  glReadPixels(GL_RGBA), flip vertical, stbi_write_png.
- main.cpp: parsea --capture <dir> antes de fn::run_app y delega a capture.cpp.
- vendor: stb_image_write.h v1.16 (mismo commit que stb_image.h).

Funciona en WSL con LIBGL_ALWAYS_SOFTWARE=1 (Mesa/llvmpipe). Si el entorno
no tiene contexto GL, el binario sale con rc!=0 sin generar PNGs.

Issue 0048.

cpp/apps/primitives_gallery/capture.h

@@ -0,0 +1,34 @@
+#pragma once
+// Capture mode: renderiza cada demo de la gallery en una ventana GLFW
+// invisible y guarda un PNG en `output_dir/<demo_id>.png` via stb_image_write.
+//
+// Diseñado para CI / golden-image diffing: ver `cpp/scripts/update_goldens.sh`
+// y `cpp/tests/test_visual.cpp`.
+//
+// Importante:
+// - Requiere un contexto OpenGL real. En entornos sin GPU (containers minimos)
+//   funciona con `LIBGL_ALWAYS_SOFTWARE=1` (Mesa/llvmpipe) o swiftshader.
+// - Si el entorno (WSL sin GL) no puede crear un contexto GL valido, el
+//   binario sale con codigo != 0 sin generar PNGs.
+
+#include <string>
+#include <vector>
+
+namespace gallery {
+
+struct CaptureItem {
+    std::string id;
+    void (*fn)();
+};
+
+struct CaptureConfig {
+    std::string output_dir;
+    int         warmup_frames = 3;
+    int         capture_w     = 800;
+    int         capture_h     = 600;
+};
+
+// Devuelve true si todo el set se capturo OK.
+bool run_capture(const CaptureConfig& cfg, const std::vector<CaptureItem>& items);
+
+} // namespace gallery