# MRPS v4 Adaptive Mono/Stereo — Documented Player Package

This package contains the real-device encoder, reference decoder, and a complete player-facing format contract.

Start here:

1. `MRPS_v4_SPEC.md` — normative field-by-field definition and reconstruction algorithm.
2. `mrps-v4-metadata.schema.json` — machine-readable metadata validation and descriptions.
3. `mrps-v4-depth-payload.ksy` — binary native-depth payload layout.
4. `MRPS_v4_CONFORMANCE_CHECKLIST.md` — player acceptance tests.
5. `example_mono_metadata.json` and `example_stereo_metadata.json` — representative records.

The visible atlas is useful as a fallback, but calibrated playback must prefer the embedded native depth chunks and per-view `sensorGeometry` matrices. Capture geometry is measured in metres relative to the capture viewer/camera and is attached to the current playback viewer pose. Capture IPD/baseline is never used as a scale multiplier.
