Publish Chimera GFX source

2026-09-03 02:53:36 +02:00
commit fee37cd9b5
824 changed files with 100072 additions and 0 deletions
@@ -0,0 +1,29 @@
+# ADR-0006: Phase-1 VideoOut experiment stays behind SDL2
+
+- Status: accepted
+- Date: 2026-07-17
+
+## Context
+
+The public SDK v0.41 exports VideoOut stubs but supplies no official VideoOut
+headers. The pinned PS5 SDL2 fork contains a working framebuffer route, but its
+backend declares opaque layouts with fields named `junk`. Those declarations
+are public source evidence of the upstream implementation, not a sufficiently
+proven ABI for duplication in `chimera-gfx`.
+
+## Decision
+
+The first presentation candidate calls only public SDL2 APIs. A reviewed
+Zlib-licensed build overlay removes SDL's unrelated keyboard/IME initialization
+from this candidate. Project code does not copy a VideoOut prototype or data
+layout. The target is disabled by default, requires the PS5 toolchain and an
+explicit SDL build path, and embeds the same `NONE` firmware gate as the probe.
+
+The candidate does not link SDL2main because that wrapper hides the splash
+screen before application-level firmware validation.
+
+## Consequences
+
+The upstream SDL backend remains the owner of VideoOut, direct memory, tiling,
+flip, and cleanup. Its unbounded flip wait is a known hardware-test blocker;
+successful offline compilation is not runtime approval or ABI proof.