feat(pyrowave): Apple Metal 4:4:4 + HDR decode, EDR present — self-configured in-band

Browse Source

Phases 4+5 of design/pyrowave-444-hdr.md. The Metal decoder needs NO new ABI:
every frame's sequence header carries chroma (444) and, since the Phase-3
stamps, the PQ/BT.2020 bits — so the decoder self-configures per session.

Decoder: WaveletLayout grows the 4:4:4 block space (chroma runs the full
pyramid like luma — no level-0 skip, no early half-res emit; the Metal
kernels were already chroma-agnostic, only the dispatch structure changes);
the parser accepts chroma_resolution=444, reads the PQ transfer bit, and
lifts the even-dims rule for 444; the plane ring allocates full-res chroma
and r16Unorm for PQ streams; CSC rows switch to depth-10 MSB-packed.

Presenter: planar HDR passthrough reuses pf_frag_planar on an rgba16Float
drawable (itur_2100_PQ + EDR metadata interpret the samples — same split as
pf_frag/pf_frag_hdr), plus a new pf_frag_planar_tm PQ->SDR tone-map (shared
pqToSdr tail refactored out of pf_frag_hdr_tv) for tvOS-without-headroom AND
macOS WINDOWED sessions, whose IOSurface present path (the DCP-panic
mitigation) is BGRA8-only. SessionModel stops stripping the HDR/10-bit/444
caps on the PyroWave opt-in.

New golden: au-dense444 + upstream's own 4:4:4 reference planes (regenerated
via the extended pyrowave_dump_golden); Metal decode matches at 64-67 dB
(420 fixtures re-verify 77-88 dB). Full Apple suite 157 tests green on a
real M-series GPU. Docs updated: the 8-bit-SDR-only wording is gone, the
Windows host is no longer 'on the roadmap', bpp scaling documented.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

...

This commit is contained in:

Enrico Bühler

2026-07-18 13:21:23 +02:00

parent 188edde2b3

commit 3ff1973d7f

9 changed files with 167 additions and 57 deletions

Show all changes Ignore whitespace when comparing lines Ignore changes in amount of whitespace Ignore changes in whitespace at EOL

Download Patch File Download Diff File Expand all files Collapse all files

clients/apple/Tests/PunktfunkKitTests/PyroWaveFixtures/au-dense444.bin

BIN

Binary file not shown.

clients/apple/Tests/PunktfunkKitTests/PyroWaveFixtures/ref-dense444-cb.bin

+1

File diff suppressed because one or more lines are too long

clients/apple/Tests/PunktfunkKitTests/PyroWaveFixtures/ref-dense444-cr.bin

+1

File diff suppressed because one or more lines are too long

clients/apple/Tests/PunktfunkKitTests/PyroWaveFixtures/ref-dense444-y.bin

+1

File diff suppressed because one or more lines are too long