Pixel types guide · ← Live plane and native-code examples
What the updated explorer exposes
Reviewed 10 November 2026 against merged source. These are implementation and design observations, not a release-completion claim.
The native view duplicates more than its explanation suggested
PlaneRole::CbCr and CrCb already exist. CodePlane::component reads interleaved components with individually supplied encodings. The RGB10 + alpha1 witness uses this existing component reader.
The speculative NativeCodeSlice adapter and its dependent conversion APIs have been removed at the owner’s direction. No production caller justified them. The explorer now shows the existing component-view path, without a replacement public adapter.
Signed/wide SampleEncoding descriptions, native pixel identity carriage and exact ST2086 metadata remain. Signed/wide component reading and unaligned access are not implied by those capabilities; extensions need concrete consumers.
HLG presentation was stale
The converter now supports explicit display rendering. The live panel accepts display peak, black, effective gamma and SDR white; missing conditions still refuse. The JavaScript swatch uses only the HLG OETF, so it is no longer presented as a byte oracle for display rendering. ICC synthesis remains unavailable.
Completed contracts and remaining work
The build stamp on the explorer identifies the compiled source. Statuses below are a dated review; issue links show current tracking. Downstream qualification remains separate.
| Issue | Remaining review boundary |
|---|
| 83 — Native samples | Closed: generic native storage, code descriptions and exact metadata satisfy the core scope. IMIJ adapter integration remains consumer work. |
| 69 — Identity allocations | Borrowed OutputPlan identity rows are allocation-free in packed/padded controls; owned finalization intentionally copies. Typed U8/U16/F32 extraction reuse is qualified. |
| 132 — HLG | Closed: explicit rendering conditions and both backend refusals are qualified. Consumer work and HLG ICC synthesis remain separate. |
| 133 — API documentation | Closed: API/documentation task completed. This guide and the copied explorer snippets now have executable Rust checks. |
| 134 — ICC/CICP authority | Closed: both output boundaries enforce authority. Grayscale reduction preserves unusable ICCs; companion CICP cannot repair them. Synthesis preconditions are explicit. |
| 135 — P3 exports | Current default/no-db bytes pass fresh native and independent color controls. Old release refs remain gated pending reconciliation. |
| 136 — Gain-map transcodes | Consumer reconstruction and end-to-end HDR pixels, not merely metadata carriage. |
| 137 — JXL luminance | Consumer qualification of content peak, intensity_target and diffuse white. |
| 138 — AVIF matrix resolution | Consumer migration to shared resolution, with a decoded fixture witness. |
| 139 — Authoritative CICP refusal | Unsupported authoritative signaling must not fall through to contradictory ICC. |
| 140 — Coded matrix/range | Consumer range/matrix and metadata preservation; extracting raw codes does not establish this. |
| 141 — PNG/EXIF provenance | Reader fixtures and provenance qualification remain open. |
| 142 — Apple gain maps | Independent reconstruction measurements and explicit acceptance remain open. |
| 143 — Downstream compilation | Compile actual consumers against one candidate revision, including newly changed descriptor errors and worker cloning. |
| 154 — Current precision requirements | Remaining consumer integration: select encoder precision from current evidence and explicit requirements. Original depth alone is not preservation evidence. Historical approximate ICC qualification remains lower priority. |
Full source-backed review · Repository improvements and qualification