1.2 KiB
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.