30 lines
1.2 KiB
Markdown
30 lines
1.2 KiB
Markdown
# 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.
|