Document stream specifier syntax change from 46cbe4ab5c

Fixes #11248.

(cherry picked from commit 9e68b26765)
Signed-off-by: Anton Khirnov <anton@khirnov.net>
This commit is contained in:
Anton Khirnov 2024-10-26 11:48:48 +02:00
parent 367b7b546f
commit 5120d30890
3 changed files with 12 additions and 2 deletions

View File

@ -27,6 +27,15 @@ version 7.1:
- LCEVC enhancement data exporting in H.26x and MP4/ISOBMFF - LCEVC enhancement data exporting in H.26x and MP4/ISOBMFF
- LCEVC filter - LCEVC filter
- MV-HEVC decoding - MV-HEVC decoding
- minor stream specifier syntax changes:
- when matching by metadata (:m:<key>:<val>), the colon character
in keys or values now has to be backslash-escaped
- in optional maps (-map ....?) with a metadata-matching stream specifier,
the value has to be separated from the question mark by a colon, i.e.
-map ....:m:<key>:<val>:? (otherwise it would be ambiguous whether the
question mark is a part of <val> or not)
- multiple stream types in a single specifier (e.g. :s:s:0) now cause an
error, as such a specifier makes no sense
version 7.0: version 7.0:

View File

@ -1799,7 +1799,7 @@ Set the size of the canvas used to render subtitles.
@section Advanced options @section Advanced options
@table @option @table @option
@item -map [-]@var{input_file_id}[:@var{stream_specifier}][:@var{view_specifier}][?] | @var{[linklabel]} (@emph{output}) @item -map [-]@var{input_file_id}[:@var{stream_specifier}][:@var{view_specifier}][:?] | @var{[linklabel]} (@emph{output})
Create one or more streams in the output file. This option has two forms for Create one or more streams in the output file. This option has two forms for
specifying the data source(s): the first selects one or more streams from some specifying the data source(s): the first selects one or more streams from some

View File

@ -78,7 +78,8 @@ Match the stream by stream id (e.g. PID in MPEG-TS container).
@item m:@var{key}[:@var{value}] @item m:@var{key}[:@var{value}]
Matches streams with the metadata tag @var{key} having the specified value. If Matches streams with the metadata tag @var{key} having the specified value. If
@var{value} is not given, matches streams that contain the given tag with any @var{value} is not given, matches streams that contain the given tag with any
value. value. The colon character ':' in @var{key} or @var{value} needs to be
backslash-escaped.
@item disp:@var{dispositions}[:@var{additional_stream_specifier}] @item disp:@var{dispositions}[:@var{additional_stream_specifier}]
Matches streams with the given disposition(s). @var{dispositions} is a list of Matches streams with the given disposition(s). @var{dispositions} is a list of
one or more dispositions (as printed by the @option{-dispositions} option) one or more dispositions (as printed by the @option{-dispositions} option)