diff options
Diffstat (limited to 'DOCS/edl-mpv.rst')
| -rw-r--r-- | DOCS/edl-mpv.rst | 54 |
1 files changed, 54 insertions, 0 deletions
diff --git a/DOCS/edl-mpv.rst b/DOCS/edl-mpv.rst index ec60d09ccc..0e4d2b410e 100644 --- a/DOCS/edl-mpv.rst +++ b/DOCS/edl-mpv.rst @@ -214,6 +214,16 @@ It provides following parameters change track metadata: ``byterate`` Number of bytes per second this stream uses. (Purely informational.) +``index`` + The numeric index of the track this should map to (default: -1). This is + the 0-based index of the virtual stream as seen by the player, enumerating + all audio/video/subtitle streams. If nothing matches, this is silently + discarded. The special index -1 (the default) has two meanings: if there + was a previous meta data entry (either ``!track_meta`` or ``!delay_open`` + element since the last ``!new_stream``), then this element manipulates + the previous meta data entry. If there was no previous entry, a new meta + data entry that matches all streams is created. + Example:: # mpv EDL v0 @@ -229,6 +239,26 @@ title. The subtitle stream will use ``ducks`` as title. The ``track_meta`` header is not part of the core EDL format. It may be changed or removed at any time, depending on mpv's internal requirements. +Global metadata +=============== + +The special ``global_tags`` header can set metadata fields (aka tags) of the EDL +file. This metadata is supposed to be informational, much like for example ID3 +tags in audio files. Due to lack of separation of different kinds of metadata it +is unspecified what names are allowed, how they are interpreted, and whether +some of them affect playback functionally. (Much of this is unfortunately +inherited from FFmpeg. Another consequence of this is that FFmpeg "normalized" +tags are recognized, or stuff like replaygain tags.) + +Example:: + + !global_tags,title=bla,something_arbitrary=even_more_arbitrary + +Any parameter names are allowed. Repeated use of this adds to the tag list. If +``!new_stream`` is used, the location doesn't matter. + +May possibly be ignored in some cases, such as delayed media opening. + Delayed media opening ===================== @@ -244,6 +274,12 @@ Using multiple segments requires you to specify all offsets and durations (also it was never tested whether it works at all). Interaction with ``mp4_dash`` may be strange. +You can describe multiple sub-tracks by using multiple ``delay_open`` headers +before the same source URL. (If there are multiple sub-tracks of the same media +type, then the mapping to the real stream is probably rather arbitrary.) If the +source contains tracks not described, a warning is logged when the delayed +opening happens, and the track is hidden. + This has the following parameters: ``media_type`` @@ -261,9 +297,27 @@ This has the following parameters: Above also applies for similar fields such as ``w``. These fields are mostly to help with user track pre-selection. +``flags`` + A ``+`` separated list of boolean flags. Currently defined flags: + + ``default`` + Set the default track flag. + + ``forced`` + Set the forced track flag. + + Other values are ignored after triggering a warning. + ``w``, ``h`` For video codecs: expected video size. See ``codec`` for details. +``fps`` + For video codecs: expected video framerate, as integer. (The rate is usually + only crudely reported, and it makes no sense to expect exact values.) + +``samplerate`` + For audio codecs: expected sample rate, as integer. + The ``delay_open`` header is not part of the core EDL format. It may be changed or removed at any time, depending on mpv's internal requirements. |