diff --git a/docs/source/video_encoding_parameters.mdx b/docs/source/video_encoding_parameters.mdx index eb0d1f7f4..337ff5e46 100644 --- a/docs/source/video_encoding_parameters.mdx +++ b/docs/source/video_encoding_parameters.mdx @@ -232,75 +232,10 @@ After the first episode of a video stream is encoded, the encoder configuration Two sources contribute to the `info` block: -
-
-
- Stream-derived -
-
-
- Read back from the encoded MP4 with PyAV. -
-
- - video.height - - - video.width - - - video.codec - - - video.pix_fmt - - - video.fps - - - video.channels - - - is_depth_map - - - audio.* - -
-
-
-
-
- Encoder-derived -
-
-
- Taken from RGBEncoderConfig /{" "} - DepthEncoderConfig. -
-
- - video.g - - - video.crf - - - video.preset - - - video.fast_decode - - - video.video_backend - - - video.extra_options - -
-
-
-
+| Source | Where it comes from | Fields | +| ------------------- | ----------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------- | +| **Stream-derived** | Read back from the encoded MP4 with PyAV. | `video.height`, `video.width`, `video.codec`, `video.pix_fmt`, `video.fps`, `video.channels`, `is_depth_map`, `audio.*` | +| **Encoder-derived** | Taken from `RGBEncoderConfig` / `DepthEncoderConfig`. | `video.g`, `video.crf`, `video.preset`, `video.fast_decode`, `video.video_backend`, `video.extra_options` | > [!IMPORTANT] > This block is populated **once**, from the **first** episode. It assumes every @@ -314,35 +249,7 @@ Two sources contribute to the `info` block: When aggregating datasets with `merge_datasets`, video files are concatenated as-is (no re-encoding), and encoder fields in `info.json` are merged per-key: -
-
- - Must match - - - Stream-derived fields — video.codec,{" "} - video.pix_fmt,{" "} - video.height,{" "} - video.width,{" "} - video.fps — must match across - sources, otherwise FFmpeg's concat demuxer fails. - -
-
- - Merged loosely - - - Encoder-tuning fields — video.g,{" "} - video.crf,{" "} - video.preset,{" "} - video.fast_decode,{" "} - video.extra_options. If every source - agrees, the value is kept; if not, it's set to{" "} - null (or{" "} - {} for{" "} - video.extra_options) and a warning is - logged. - -
-
+| Merge rule | Fields | Behaviour | +| ------------------ | ---------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------- | +| **Must match** | `video.codec`, `video.pix_fmt`, `video.height`, `video.width`, `video.fps` | Stream-derived fields must match across sources, otherwise FFmpeg's concat demuxer fails. | +| **Merged loosely** | `video.g`, `video.crf`, `video.preset`, `video.fast_decode`, `video.extra_options` | Encoder-tuning fields. If every source agrees, the value is kept; if not, it's set to `null` (or `{}` for `video.extra_options`) and a warning is logged. |