ffprobe 文档

目录

1 概要

ffprobe [选项]输入网址

2 说明

ffprobe 从多媒体流中收集信息并以人类和机器可读的方式打印它。

例如，它可用于检查多媒体流使用的容器的格式以及其中包含的每个媒体流的格式和类型。

如果在输入中指定了 url，ffprobe 将尝试打开并探测 url 内容。如果无法打开 url 或将其识别为多媒体文件，则返回肯定的退出代码。

如果没有输出被指定为输出哦ffprobe 将写入标准输出。

ffprobe 既可以作为独立应用程序使用，也可以与文本过滤器结合使用，文本过滤器可以执行更复杂的处理，例如统计处理或绘图。

选项用于列出 ffprobe 支持的一些格式，或用于指定要显示的信息，以及设置 ffprobe 如何显示它。

ffprobe 输出被设计为可以通过文本过滤器轻松解析，并且由所选编写器定义的表单的一个或多个部分组成，该编写器由输出格式选项。

节可以包含其他嵌套节，并通过名称（可以由其他节共享）和唯一名称来标识。查看输出部分。

存储在容器或流中的元数据标签在相应的“FORMAT”、“STREAM”或“PROGRAM_STREAM”部分中被识别和打印。

3个选项

如果没有另外指定，所有数字选项都接受表示数字的字符串作为输入，该字符串后可能跟有 SI 单位前缀之一，例如：“K”、“M”或“G”。

如果将“i”附加到 SI 单位前缀，则完整的前缀将被解释为二进制倍数的单位前缀，它基于 1024 的幂而不是 1000 的幂。将“B”附加到 SI 单位前缀将乘以值除以 8。这允许使用例如：“KB”、“MiB”、“G”和“B”作为数字后缀。

不带参数的选项是布尔选项，并将相应的值设置为true。可以通过在选项名称前加上“no”前缀将它们设置为 false。例如，使用“-nofoo”会将名称为“foo”的布尔选项设置为 false。

3.1 Stream specifiers

某些选项适用于每个流，例如比特率或编解码器。流说明符用于精确指定给定选项所属的流。

流说明符是一个字符串，通常附加到选项名称并用冒号分隔。例如-codec:a:1 ac3包含 a:1流说明符，它与第二个音频流匹配。因此，它将为第二个音频流选择 ac3 编解码器。

流说明符可以匹配多个流，以便该选项应用于所有流。例如，流说明符-b:a 128k匹配所有音频流。

空流说明符匹配所有流。例如，-codec copy 或者-codec: copy将复制所有流而不重新编码。

流说明符的可能形式是：

stream_index

将流与该索引进行匹配。例如-threads:1 4，将第二个流的线程计数设置为 4。如果使用 stream_index作为附加流说明符（见下文），则它从匹配的流中选择流编号stream_index 。流编号基于 libavformat 检测到的流顺序，除非还指定了节目 ID。在这种情况下，它基于程序中流的顺序。

stream_type[:additional_stream_specifier]

Stream_type是以下之一：'v' 或 'V' 表示视频，'a' 表示音频，'s' 表示字幕，'d' 表示数据，'t' 表示附件。“v”匹配所有视频流，“V”仅匹配不附加图片、视频缩略图或封面艺术的视频流。如果使用 additional_stream_specifier ，则它匹配既具有此类型又匹配additional_stream_specifier的流。否则，它匹配指定类型的所有流。

p:program_id[:additional_stream_specifier]

匹配程序中 ID 为program_id的流。如果 使用additional_stream_specifier，则它匹配既属于程序一部分又匹配additional_stream_specifier的流。

#stream_id or i:stream_id

通过流 ID（例如 MPEG-TS 容器中的 PID）来匹配流。

m:key[:value]

将流与具有指定值的元数据标签键相匹配。如果 未给出值，则将包含给定标记的流与任何值进行匹配。

u

将流与可用配置相匹配，必须定义编解码器，并且必须提供视频尺寸或音频采样率等基本信息。

请注意，在 中ffmpeg，按元数据匹配仅适用于输入文件。

3.2 Generic options

这些选项在 ff* 工具之间共享。

-L

显示许可证。

-h, -?, -help, --help [arg]

显示帮助。可以指定可选参数来打印有关特定项目的帮助。如果未指定参数，则仅显示基本（非高级）工具选项。

arg的可能值为：

long

除了基本工具选项之外，还打印高级工具选项。

full

打印完整的选项列表，包括编码器、解码器、解复用器、复用器、过滤器等的共享和私有选项。

decoder=decoder_name

打印有关名为解码器名称的解码器的详细信息。使用 -解码器获取所有解码器列表的选项。

encoder=encoder_name

打印有关名为encoder_name的编码器的详细信息。使用 -编码器获取所有编码器列表的选项。

demuxer=demuxer_name

打印有关名为demuxer_name的解复用器的详细信息。使用 -格式获取所有解复用器和复用器列表的选项。

muxer=muxer_name

打印有关名为muxer_name的复用器的详细信息。使用 -格式获取所有复用器和解复用器列表的选项。

filter=filter_name

打印有关名为filter_name的过滤器的详细信息。使用 -过滤器获取所有过滤器列表的选项。

bsf=bitstream_filter_name

打印有关名为bitstream_filter_name的比特流过滤器的详细信息。使用-bsfs获取所有比特流过滤器列表的选项。

protocol=protocol_name

打印有关名为protocol_name的协议的详细信息。使用- 协议获取所有协议列表的选项。

-version

显示版本。

-buildconf

显示构建配置，每行一个选项。

-formats

显示可用格式（包括设备）。

-demuxers

显示可用的多路分配器。

-muxers

显示可用的复用器。

-devices

显示可用设备。

-codecs

显示 libavcodec 已知的所有编解码器。

请注意，本文档中使用术语“编解码器”作为更正确的媒体比特流格式的快捷方式。

-decoders

显示可用的解码器。

-encoders

显示所有可用的编码器。

-bsfs

显示可用的比特流过滤器。

-protocols

显示可用的协议。

-filters

显示可用的 libavfilter 过滤器。

-pix_fmts

显示可用的像素格式。

-sample_fmts

显示可用的示例格式。

-layouts

显示频道名称和标准频道布局。

-dispositions

显示流配置。

-colors

显示识别的颜色名称。

-sources device[,opt1=val1[,opt2=val2]...]

显示输入设备的自动检测源。某些设备可能提供无法自动检测的与系统相关的源名称。不能假定返回的列表始终是完整的。

ffmpeg -sources pulse,server=192.168.0.4

-sinks device[,opt1=val1[,opt2=val2]...]

显示输出设备自动检测到的接收器。某些设备可能提供无法自动检测的与系统相关的接收器名称。不能假定返回的列表始终是完整的。

ffmpeg -sinks pulse,server=192.168.0.4

-loglevel [flags+]loglevel | -v [flags+]loglevel

设置库使用的日志记录级别和标志。

可选的标志前缀可以包含以下值：

‘repeat’

指示重复的日志输出不应压缩到第一行，并且“Last message returned n times”行将被省略。

‘level’

指示日志输出应向[level]每个消息行添加前缀。这可以用作日志着色的替代方法，例如将日志转储到文件时。

标志也可以单独使用，通过添加 '+'/'-' 前缀来设置/重置单个标志，而不影响其他标志或更改loglevel。当设置flags和loglevel时，最后一个flags值和loglevel之前之间需要有一个“+”分隔符。

loglevel是包含以下值之一的字符串或数字：

‘quiet, -8’

不显示任何内容；安静。

‘panic, 0’

仅显示可能导致进程崩溃的致命错误，例如断言失败。目前这还没有用于任何用途。

‘fatal, 8’

只显示致命错误。这些都是错误，之后该过程绝对无法继续。

‘error, 16’

显示所有错误，包括可以恢复的错误。

‘warning, 24’

显示所有警告和错误。将显示与可能不正确或意外事件相关的任何消息。

‘info, 32’

在处理过程中显示信息性消息。这是对警告和错误的补充。这是默认值。

‘verbose, 40’

与 相同info，但更详细。

‘debug, 48’

显示一切，包括调试信息。

‘trace, 56’

例如，要启用重复日志输出，请添加level前缀，并将 loglevel设置为verbose：

ffmpeg -loglevel repeat+level+verbose -i input output

另一个启用重复日志输出而不影响level前缀标志或日志级别当前状态的示例：

ffmpeg [...] -loglevel +repeat

默认情况下，程序记录到 stderr。如果终端支持着色，则使用颜色来标记错误和警告。可以通过设置环境变量禁用日志着色 AV_LOG_FORCE_NOCOLOR，也可以强制设置环境变量AV_LOG_FORCE_COLOR。

-report

将完整的命令行和日志输出转储到当前目录中指定的文件中 。该文件对于错误报告很有用。这也暗示着。 program-YYYYMMDD-HHMMSS.log-loglevel debug

将环境变量设置FFREPORT为任意值都具有相同的效果。如果值是“:”分隔的 key=value 序列，这些选项将影响报告；如果选项值包含特殊字符或选项分隔符“:”，则必须对其进行转义（请参阅 ffmpeg-utils 手册中的“引用和转义”部分）。

可以识别以下选项：

file

设置报告使用的文件名；%p扩展为程序名称、%t扩展为时间戳、%%扩展为纯文本%

level

使用数值设置日志详细级别（请参阅-loglevel）。

例如，要将报告输出到名为ffreport.log 使用日志级别32（日志级别的别名info）：

FFREPORT=file=ffreport.log:level=32 ffmpeg -i input output

解析环境变量的错误不是致命的，并且不会出现在报告中。

-hide_banner

禁止打印横幅。

所有 FFmpeg 工具通常都会显示版权声明、构建选项和库版本。该选项可用于禁止打印该信息。

-cpuflags flags (global)

允许设置和清除 cpu 标志。该选项用于测试。除非您知道自己在做什么，否则不要使用它。

ffmpeg -cpuflags -sse+mmx ...
ffmpeg -cpuflags mmx ...
ffmpeg -cpuflags 0 ...

此选项可能的标志是：

‘x86’

‘mmx’

‘mmxext’

‘sse’

‘sse2’

‘sse2slow’

‘sse3’

‘sse3slow’

‘ssse3’

‘atom’

‘sse4.1’

‘sse4.2’

‘avx’

‘avx2’

‘xop’

‘fma3’

‘fma4’

‘3dnow’

‘3dnowext’

‘bmi1’

‘bmi2’

‘cmov’

‘ARM’

‘armv5te’

‘armv6’

‘armv6t2’

‘vfp’

‘vfpv3’

‘neon’

‘setend’

‘AArch64’

‘armv8’

‘vfp’

‘neon’

‘PowerPC’

‘altivec’

‘Specific Processors’

‘pentium2’

‘pentium3’

‘pentium4’

‘k6’

‘k62’

‘athlon’

‘athlonxp’

‘k8’

-cpucount count (global)

覆盖 CPU 计数检测。该选项用于测试。除非您知道自己在做什么，否则不要使用它。

ffmpeg -cpucount 2

-max_alloc bytes

设置 ffmpeg 的 malloc 函数系列在堆上分配块的最大大小限制。使用此选项时请格外小心。如果您不了解这样做的全部后果，请不要使用。默认值为 INT_MAX。

3.3 AVOptions

这些选项由 libavformat、libavdevice 和 libavcodec 库直接提供。要查看可用 AVOptions 的列表，请使用 -帮助选项。它们分为两类：

generic

可以为任何容器、编解码器或设备设置这些选项。容器/设备的 AVFormatContext 选项和编解码器的 AVCodecContext 选项下列出了通用选项。

private

这些选项特定于给定的容器、设备或编解码器。私有选项列在其相应的容器/设备/编解码器下。

例如，要将 ID3v2.3 标头而不是默认的 ID3v2.4 写入 MP3 文件，请使用id3v2_版本MP3 混合器的私有选项：

ffmpeg -i input.flac -id3v2_version 3 out.mp3

所有编解码器 AVOption 都是针对每个流的，因此应将流说明符附加到它们：

ffmpeg -i multichannel.mxf -map 0:v:0 -map 0:a:0 -map 0:a:0 -c:a:0 ac3 -b:a:0 640k -ac:a:1 2 -c:a:1 aac -b:2 128k out.mp4

在上面的示例中，多通道音频流被映射两次以输出。第一个实例使用编解码器 ac3 和比特率 640k 进行编码。第二个实例被缩混为 2 个通道并使用编解码器 aac 进行编码。使用输出流的绝对索引为其指定 128k 的比特率。

注：-无选项语法不能用于布尔 AVOptions，请使用-选项0/-选项1。

注意：通过在选项名称前添加 v/a/s 来指定每个流 AVOptions 的旧的未记录方法现已过时，并将很快被删除。

3.4 Main options

-f format

强制使用格式。

-unit

显示显示值的单位。

-prefix

对显示值使用 SI 前缀。除非使用“-byte_binary_prefix”选项，否则所有前缀都是十进制的。

-byte_binary_prefix

强制对字节值使用二进制前缀。

-sexagesimal

使用六十进制格式 HH:MM:SS.MICROSECONDS 作为时间值。

-pretty

美化显示值的格式，对应选项“-unit -prefix -byte_binary_prefix -sexagesimal”。

-output_format, -of, -print_format writer_name[=writer_options]

设置输出打印格式。

writer_name指定 writer 的名称， writer_options指定要传递给 writer 的选项。

例如，要以 JSON 格式打印输出，请指定：

-output_format json

有关可用输出打印格式的更多详细信息，请参阅下面的“写入器”部分。

-sections

打印节结构和节信息，然后退出。输出并不意味着由机器解析。

-select_streams stream_specifier

仅选择由stream_specifier指定的流。该选项仅影响与流相关的选项（例如show_streams、show_packets等）。

例如，要仅显示音频流，您可以使用以下命令：

ffprobe -show_streams -select_streams a INPUT

仅显示属于索引为 1 的视频流的视频数据包：

ffprobe -show_packets -select_streams v:1 INPUT

-show_data

以十六进制和 ASCII 转储形式显示有效负载数据。加上 -显示数据包，它将转储数据包的数据。加上 -显示流，它将转储编解码器额外数据。

转储被打印为“数据”字段。它可能包含换行符。

-show_data_hash algorithm

显示有效负载数据的哈希值，对于带有以下内容的数据包-显示数据包对于编解码器额外数据-显示流。

-show_error

显示有关尝试探测输入时发现的错误的信息。

错误信息打印在名称为“ERROR”的部分中。

-show_format

显示有关输入多媒体流的容器格式的信息。

所有容器格式信息都打印在名为“FORMAT”的部分中。

-show_format_entry name

喜欢-显示格式，但只打印容器格式信息的指定条目，而不是全部。可以多次给出此选项，然后将显示所有指定的条目。

此选项已弃用，请show_entries改用。

-show_entries section_entries

设置要显示的条目列表。

条目根据以下语法指定。section_entries包含由 分隔的节条目列表:。每个节条目均由节名称（或唯一名称）组成，后面可以选择跟随该节本地的条目列表，以 分隔,。

如果指定了节名称但后跟 no =，则所有条目以及所有包含的节都将打印到输出。否则，仅打印本地节条目列表中指定的条目。特别是，如果=指定但本地条目列表为空，则不会显示该部分的任何条目。

请注意，输出中不遵循本地节条目的指定顺序，并且将保留通常的显示顺序。

正式语法由以下给出：

LOCAL_SECTION_ENTRIES ::= SECTION_ENTRY_NAME[,LOCAL_SECTION_ENTRIES]
SECTION_ENTRY         ::= SECTION_NAME[=[LOCAL_SECTION_ENTRIES]]
SECTION_ENTRIES       ::= SECTION_ENTRY[:SECTION_ENTRIES]

例如，要仅显示每个流的索引和类型，以及数据包的 PTS 时间、持续时间和流索引，您可以指定参数：

packet=pts_time,duration_time,stream_index : stream=index,codec_type

要显示“格式”部分中的所有条目，但仅显示“流”部分中的编解码器类型，请指定参数：

format : stream=codec_type

要显示流和格式部分中的所有标签：

stream_tags : format_tags

仅显示title流部分中的标签（如果可用）：

stream_tags=title

-show_packets

显示有关输入多媒体流中包含的每个数据包的信息。

每个数据包的信息都打印在名为“PACKET”的专用部分中。

-show_frames

显示有关输入多媒体流中包含的每个帧和字幕的信息。

每个单帧的信息都打印在名为“FRAME”或“SUBTITLE”的专用部分中。

-show_log loglevel

根据loglevel中设置的值显示来自解码器的有关每个帧的日志信息（请参阅-loglevel）。该选项需要-show_frames.

每条日志消息的信息都打印在名为“LOG”的专用部分中。

-show_streams

显示有关输入多媒体流中包含的每个媒体流的信息。

每个媒体流信息都打印在名为“STREAM”的专用部分中。

-show_programs

显示有关输入多媒体流中包含的节目及其流的信息。

每个媒体流信息都打印在名为“PROGRAM_STREAM”的专用部分中。

-show_chapters

显示有关以格式存储的章节的信息。

每一章都打印在名为“CHAPTER”的专用部分中。

-count_frames

计算每个流的帧数并在相应的流部分中报告。

-count_packets

计算每个流的数据包数量并在相应的流部分中报告。

-read_intervals read_intervals

只读指定的间隔。read_intervals必须是由“,”分隔的间隔规范序列。 ffprobe将寻找间隔起点，并从那里继续阅读。

每个间隔由两个可选部分指定，并用“%”分隔。

第一部分指定间隔开始位置。它被解释为绝对位置，或者如果前面有“+”字符，则被解释为距当前位置的相对偏移量。如果未指定第一部分，则在读取此间隔时不会执行任何查找。

第二部分指定间隔结束位置。它被解释为绝对位置，或者如果前面有“+”字符，则被解释为距当前位置的相对偏移量。如果偏移量指定以“#”开头，则它被解释为从间隔开始读取的数据包数量（不包括刷新数据包）。如果没有指定第二部分，程序将读取直到输入结束。

请注意，查找并不准确，因此实际的区间起点可能与指定位置不同。此外，当指定间隔持续时间时，将通过将持续时间添加到通过查找文件找到的间隔起始点（而不是指定的起始值）来计算绝对结束时间。

正式语法由以下给出：

INTERVAL  ::= [START|+START_OFFSET][%[END|+END_OFFSET]]
INTERVALS ::= INTERVAL[,INTERVALS]

下面是一些例子。

• 查找到时间 10，读取数据包，直到找到查找点后 20 秒，然后查找到位置01:30（1 分 30 秒）并读取数据包，直到位置01:45。

  10%+20,01:30%01:45
  

• 定位后仅读取 42 个数据包01:23：

  01:23%+#42
  

• 只读取从开始起的前 20 秒：

  %+20
  

• 从头开始读取到位置02:30：

  %02:30
  

-show_private_data, -private

显示私有数据，即取决于特定显示元素的格式的数据。默认情况下启用此选项，但您可能需要针对特定​​用途禁用它，例如在创建符合 XSD 的 XML 输出时。

-show_program_version

显示与程序版本相关的信息。

版本信息打印在名为“PROGRAM_VERSION”的部分中。

-show_library_versions

显示与库版本相关的信息。

每个库的版本信息都打印在名为“LIBRARY_VERSION”的部分中。

-show_versions

显示与程序和库版本相关的信息。这相当于同时设置-显示程序版本和 -显示库版本选项。

-show_pixel_formats

显示有关 FFmpeg 支持的所有像素格式的信息。

每种格式的像素格式信息都打印在名为“PIXEL_FORMAT”的部分中。

-show_optional_fields value

一些作家即。JSON 和 XML，省略打印具有无效或不适用值的字段，而其他编写器总是打印它们。此选项使人们能够控制这种行为。有效值为always/ 1、never/0和auto/ -1。默认为自动。

-bitexact

强制 bitexact 输出，对于生成不依赖于特定构建的输出很有用。

-i input_url

读取input_url。

-o output_url

将输出写入output_url。如果未指定，则输出将发送到 stdout。

4 位作家

writer 定义了 所采用的输出格式ffprobe，并将用于打印输出的所有部分。

作者可以接受一个或多个参数，这些参数指定要采用的选项。这些选项被指定为键=值对的列表 ，用“:”分隔。

所有作者都支持以下选项：

string_validation, sv

设置字符串验证模式。

接受以下值。

‘fail’

如果在输入中发现无效字符串 (UTF-8) 序列或代码点，写入器将立即失败。这对于验证输入元数据特别有用。

‘ignore’

任何验证错误都将被忽略。这可能会导致输出损坏，尤其是使用 json 或 xml 编写器时。

‘replace’

作者将用指定的字符串替换无效的 UTF-8 序列或代码点字符串验证替换。

默认值为 '代替'。

string_validation_replacement, svr

设置替换字符串以防万一字符串验证被设定为 '代替'。

如果未指定该选项，编写器将假定为空字符串，即将从输入字符串中删除无效序列。

以下是对当前可用作家的描述。

4.1 default

默认格式。

打印表格中的每个部分：

[SECTION]
key1=val1
...
keyN=valN
[/SECTION]

元数据标记在相应的 FORMAT、STREAM 或 PROGRAM_STREAM 部分中打印为一行，并以字符串“TAG:”作为前缀。

下面是接受的选项的描述。

nokey, nk

如果设置为 1，则指定不打印每个字段的键。默认值为 0。

noprint_wrappers, nw

如果设置为 1，则指定不打印节页眉和页脚。默认值为 0。

4.2 compact, csv

紧凑和 CSV 格式。

writercsv相当于compact，但支持不同的默认值。

每个部分都打印在一行上。如果未指定选项，则输出的形式为：

section|key1=val1| ... |keyN=valN

元数据标签打印在相应的“格式”或“流”部分中。元数据标签键（如果打印）以字符串“tag:”作为前缀。

接受的选项的描述如下。

item_sep, s

指定用于分隔输出行中的字段的字符。它必须是单个可打印字符，即“|” 默认情况下（“，”为csv作者）。

nokey, nk

如果设置为 1，则指定不打印每个字段的键。它的默认值为 0（对于csv编写器为 1）。

escape, e

设置要使用的转义模式，默认为“c”（csv 编写器为“csv”）。

它可以采用以下值之一：

c

执行类似 C 的转义。包含换行符的字符串 ('\n'), 回车('\r'), 一个选项卡 ('\t'), 换页符 ('\F')、转义字符('\') 或项目分隔符SEP使用类似 C 的转义方式进行转义，以便将换行符转换为序列 '\n', 回车至 '\r','\' 到 '\\' 并且分隔符SEP转换为 '\九月'。

csv

执行类似 CSV 的转义，如 RFC4180 中所述。包含换行符的字符串 ('\n'), 回车符 ('\r'), 双引号 ('”') 或SEP用双引号括起来。

none

不执行任何转义操作。

print_section, p

如果值为 ，则在每行的开头打印节名称 1，并将值设置为 来禁用它0。默认值为 1。

4.3 flat

平面格式。

自由格式输出，其中每行包含显式 key=value，例如“streams.stream.3.tags.foo=bar”。输出是 shell 转义的，因此只要分隔符是字母数字字符或下划线（请参阅sep_char选项），它就可以直接嵌入 sh 脚本中。

接受的选项的描述如下。

sep_char, s

分隔符用于分隔打印字段键中的章节、节名称、ID 和潜在标签。

默认值为 '。'。

hierarchical, h

指定节名称规范是否应该分层。如果设置为 1，并且当前章节中有多个小节，则小节名称将以章节名称作为前缀。值为 0 将禁用此行为。

默认值为 1。

4.4 ini

INI 格式输出。

以基于 INI 的格式打印输出。

采用以下约定：

• 所有键和值都是 UTF-8
• '。' 是子组分隔符
• 新队， '\t','\F','\b' 并且以下字符被转义
• '\' 是转义字符
• '#' 是评论指示符
• '=' 是键/值分隔符
• '：' 不被使用，但通常被解析为键/值分隔符

该作者接受选项作为键=值对的列表，用'分隔：'。

接受的选项的描述如下。

hierarchical, h

指定节名称规范是否应该分层。如果设置为 1，并且当前章节中有多个小节，则小节名称将以章节名称作为前缀。值为 0 将禁用此行为。

默认值为 1。

4.5 json

基于 JSON 的格式。

每个部分都使用 JSON 表示法打印。

接受的选项的描述如下。

compact, c

如果设置为 1 启用紧凑输出，即每个部分将打印在一行上。默认值为 0。

有关 JSON 的更多信息，请参阅http://www.json.org/。

4.6 xml

基于 XML 的格式。

XML 输出在 XML 模式描述文件中进行描述 ffprobe.xsd安装在 FFmpeg 数据目录中。

可以在 URL http://www.ffmpeg.org/schema/ffprobe.xsd检索架构的更新版本，该 URL 重定向到提交到 FFmpeg 开发源代码树中的最新架构。

请注意，发出的输出将符合 ffprobe.xsd仅当没有特殊的全局输出选项时才架构（单元,字首,字节二进制前缀, 六十进制等）被指定。

接受的选项的描述如下。

fully_qualified, q

如果设置为 1，则指定输出是否应完全限定。默认值为 0。这是生成可通过 XSD 文件验证的 XML 文件所必需的。

xsd_strict, x

如果设置为 1，则执行更多检查以确保输出符合 XSD 标准。默认值为 0。此选项自动设置完全合格至 1。

有关 XML 格式的更多信息，请参阅 https://www.w3.org/XML/。

5 时间码

ffprobe支持时间码提取：

• MPEG1/2 时间码是从 GOP 中提取的，可在视频流详细信息中找到 (-显示流，参见时间码）。
• MOV 时间码是从 tmcd 轨道中提取的，因此可在 tmcd 流元数据中使用（-显示流，请参阅标签：时间码）。
• DV、GXF 和 AVI 时间码以格式元数据提供（-显示格式，请参阅标签：时间码）。

6 语法

本节记录 FFmpeg 库和工具使用的语法和格式。

6.1 Quoting and escaping

除非明确指定，FFmpeg 采用以下引用和转义机制。应用以下规则：

• ''' 和 '\' 是特殊字符（分别用于引用和转义）。除了它们之外，可能还有其他特殊字符，具体取决于使用转义和引用的特定语法。
• 特殊字符通过在其前面添加 ' 进行转义\'。
• ' 之间包含的所有字符”' 按字面意思包含在已解析的字符串中。引号字符 ''' 本身不能被引用，因此您可能需要关闭引用并转义它。
• 除非转义或引用，否则前导和尾随空格将从解析的字符串中删除。

请注意，在使用命令行或脚本时，您可能需要添加第二级转义，这取决于所采用的 shell 语言的语法。

函数av_get_token定义在 libavutil/avstring.h可用于根据上面定义的规则解析引用或转义的标记。

工具工具/ffescapeFFmpeg 源代码树中的内容可用于自动引用或转义脚本中的字符串。

6.1.1 示例

• Crime d'Amour转义包含特殊字符的字符串'：

  Crime d\'Amour
  

• 上面的字符串包含引号，因此'在引用它时需要转义：

  'Crime d'\''Amour'
  

• 使用引号包含前导或尾随空格：

  '  this string starts and ends with whitespaces  '
  

• 转义和引用可以混合在一起：

  ' The string '\'string\'' is a string '
  

• 包含文字 '\' 您可以使用转义或引用：

  'c:\foo' can be written as c:\\foo
  

6.2 Date

可接受的语法是：

[(YYYY-MM-DD|YYYYMMDD)[T|t| ]]((HH:MM:SS[.m...]]])|(HHMMSS[.m...]]]))[Z]
now

如果该值为“now”，则需要当前时间。

除非附加 Z，否则时间为本地时间，在这种情况下，它被解释为 UTC。如果未指定年月日部分，则采用当前年月日。

6.3 Time duration

有两种可接受的语法来表示持续时间。

[-][HH:]MM:SS[.m...]

HH表示小时数，MM表示分钟数，最多 2 位数字，SS表示秒数，最多 2 位数字。末尾的 m 表示 SS的十进制值。

或者

[-]S+[.m...][s|ms|us]

S表示秒数，带有可选的小数部分 m。可选的文字后缀 's','多发性硬化症' 或者 '我们' 表示将该值分别解释为秒、毫秒或微秒。

在这两个表达式中，可选的 '-' 表示负持续时间。

6.3.1 示例

以下示例均为有效持续时间：

‘55’

55秒

‘0.2’

0.2秒

‘200ms’

200毫秒，即0.2秒

‘200000us’

200000微秒，即0.2秒

‘12:03:45’

12小时03分45秒

‘23.189’

23.189秒

6.4 Video size

指定源视频的大小，它可以是width x height形式的字符串 ，或者是大小缩写的名称。

可以识别以下缩写：

‘ntsc’

720x480

‘pal’

720x576

‘qntsc’

352x240

‘qpal’

352x288

‘sntsc’

640x480

‘spal’

768x576

‘film’

352x240

‘ntsc-film’

352x240

‘sqcif’

128x96

‘qcif’

176x144

‘cif’

352x288

‘4cif’

704x576

‘16cif’

1408x1152

‘qqvga’

160x120

‘qvga’

320x240

‘vga’

640x480

‘svga’

800x600

‘xga’

1024x768

‘uxga’

1600x1200

‘qxga’

2048x1536

‘sxga’

1280x1024

‘qsxga’

2560x2048

‘hsxga’

5120x4096

‘wvga’

852x480

‘wxga’

1366x768

‘wsxga’

1600x1024

‘wuxga’

1920x1200

‘woxga’

2560x1600

‘wqsxga’

3200x2048

‘wquxga’

3840x2400

‘whsxga’

6400x4096

‘whuxga’

7680x4800

‘cga’

320x200

‘ega’

640x350

‘hd480’

852x480

‘hd720’

1280x720

‘hd1080’

1920x1080

‘2k’

2048x1080

‘2kflat’

1998x1080

‘2kscope’

2048x858

‘4k’

4096x2160

‘4kflat’

3996x2160

‘4kscope’

4096x1716

‘nhd’

640x360

‘hqvga’

240x160

‘wqvga’

400x240

‘fwqvga’

432x240

‘hvga’

480x320

‘qhd’

960x540

‘2kdci’

2048x1080

‘4kdci’

4096x2160

‘uhd2160’

3840x2160

‘uhd4320’

7680x4320

6.5 Video rate

指定视频的帧速率，表示为每秒生成的帧数。它必须是格式为 frame_rate_num / frame_rate_den的字符串、整数、浮点数或有效的视频帧速率缩写。

可以识别以下缩写：

‘ntsc’

30000/1001

‘pal’

25/1

‘qntsc’

30000/1001

‘qpal’

25/1

‘sntsc’

30000/1001

‘spal’

25/1

‘film’

24/1

‘ntsc-film’

24000/1001

6.6 Ratio

比率可以表示为表达式，或采用 分子:分母 的形式。

请注意，具有无限 (1/0) 或负值的比率被视为有效，因此如果要排除这些值，则应检查返回的值。

未定义的值可以使用“0:0”字符串来表示。

6.7 Color

它可以是如下定义的颜色名称（不区分大小写的匹配）或序列 [0x|#]RRGGBB[AA]，可能后跟 @ 和表示 alpha 分量的字符串。

alpha分量可以是由“0x”后跟一个十六进制数或0.0到1.0之间的十进制数组成的字符串，表示不透明度值（'0x00' 或者 '0.0' 表示完全透明，'0xff' 或者 '1.0' 完全不透明）。如果未指定 alpha 分量，则 '0xff' 假设。

字符串 '随机的' 将产生随机颜色。

可以识别以下颜色名称：

‘AliceBlue’

0xF0F8FF

‘AntiqueWhite’

0xFAEBD7

‘Aqua’

0x00FFFF

‘Aquamarine’

0x7FFFD4

‘Azure’

0xF0FFFF

‘Beige’

0xF5F5DC

‘Bisque’

0xFFE4C4

‘Black’

0x000000

‘BlanchedAlmond’

0xFFEBCD

‘Blue’

0x0000FF

‘BlueViolet’

0x8A2BE2

‘Brown’

0xA52A2A

‘BurlyWood’

0xDEB887

‘CadetBlue’

0x5F9EA0

‘Chartreuse’

0x7FFF00

‘Chocolate’

0xD2691E

‘Coral’

0xFF7F50

‘CornflowerBlue’

0x6495ED

‘Cornsilk’

0xFFF8DC

‘Crimson’

0xDC143C

‘Cyan’

0x00FFFF

‘DarkBlue’

0x00008B

‘DarkCyan’

0x008B8B

‘DarkGoldenRod’

0xB8860B

‘DarkGray’

0xA9A9A9

‘DarkGreen’

0x006400

‘DarkKhaki’

0xBDB76B

‘DarkMagenta’

0x8B008B

‘DarkOliveGreen’

0x556B2F

‘Darkorange’

0xFF8C00

‘DarkOrchid’

0x9932CC

‘DarkRed’

0x8B0000

‘DarkSalmon’

0xE9967A

‘DarkSeaGreen’

0x8FBC8F

‘DarkSlateBlue’

0x483D8B

‘DarkSlateGray’

0x2F4F4F

‘DarkTurquoise’

0x00CED1

‘DarkViolet’

0x9400D3

‘DeepPink’

0xFF1493

‘DeepSkyBlue’

0x00BFFF

‘DimGray’

0x696969

‘DodgerBlue’

0x1E90FF

‘FireBrick’

0xB22222

‘FloralWhite’

0xFFFAF0

‘ForestGreen’

0x228B22

‘Fuchsia’

0xFF00FF

‘Gainsboro’

0xDCDCCDC

‘GhostWhite’

0xF8F8FF

‘Gold’

0xFFD700

‘GoldenRod’

0xDAA520

‘Gray’

0x808080

‘Green’

0x008000

‘GreenYellow’

0xADFF2F

‘HoneyDew’

0xF0FFF0

‘HotPink’

0xFF69B4

‘IndianRed’

0xCD5C5C

‘Indigo’

0x4B0082

‘Ivory’

0xFFFFF0

‘Khaki’

0xF0E68C

‘Lavender’

0xE6E6FA

‘LavenderBlush’

0xFFF0F5

‘LawnGreen’

0x7CFC00

‘LemonChiffon’

0xFFFACD

‘LightBlue’

0xADD8E6

‘LightCoral’

0xF08080

‘LightCyan’

0xE0FFFF

‘LightGoldenRodYellow’

0xFAFAD2

‘LightGreen’

0x90EE90

‘LightGrey’

0xD3D3D3

‘LightPink’

0xFFB6C1

‘LightSalmon’

0xFFA07A

‘LightSeaGreen’

0x20B2AA

‘LightSkyBlue’

0x87CEFA

‘LightSlateGray’

0x778899

‘LightSteelBlue’

0xB0C4DE

‘LightYellow’

0xFFFFE0

‘Lime’

0x00FF00

‘LimeGreen’

0x32CD32

‘Linen’

0xFAF0E6

‘Magenta’

0xFF00FF

‘Maroon’

0x800000

‘MediumAquaMarine’

0x66CDAA

‘MediumBlue’

0x0000CD

‘MediumOrchid’

0xBA55D3

‘MediumPurple’

0x9370D8

‘MediumSeaGreen’

0x3CB371

‘MediumSlateBlue’

0x7B68EE

‘MediumSpringGreen’

0x00FA9A

‘MediumTurquoise’

0x48D1CC

‘MediumVioletRed’

0xC71585

‘MidnightBlue’

0x191970

‘MintCream’

0xF5FFFA

‘MistyRose’

0xFFE4E1

‘Moccasin’

0xFFE4B5

‘NavajoWhite’

0xFFDEAD

‘Navy’

0x000080

‘OldLace’

0xFDF5E6

‘Olive’

0x808000

‘OliveDrab’

0x6B8E23

‘Orange’

0xFFA500

‘OrangeRed’

0xFF4500

‘Orchid’

0xDA70D6

‘PaleGoldenRod’

0xEEE8AA

‘PaleGreen’

0x98FB98

‘PaleTurquoise’

0xAFEEEE

‘PaleVioletRed’

0xD87093

‘PapayaWhip’

0xFFEFD5

‘PeachPuff’

0xFFDAB9

‘Peru’

0xCD853F

‘Pink’

0xFFC0CB

‘Plum’

0xDDA0DD

‘PowderBlue’

0xB0E0E6

‘Purple’

0x800080

‘Red’

0xFF0000

‘RosyBrown’

0xBC8F8F

‘RoyalBlue’

0x4169E1

‘SaddleBrown’

0x8B4513

‘Salmon’

0xFA8072

‘SandyBrown’

0xF4A460

‘SeaGreen’

0x2E8B57

‘SeaShell’

0xFFF5EE

‘Sienna’

0xA0522D

‘Silver’

0xC0C0C0

‘SkyBlue’

0x87CEEB

‘SlateBlue’

0x6A5ACD

‘SlateGray’

0x708090

‘Snow’

0xFFFAFA

‘SpringGreen’

0x00FF7F

‘SteelBlue’

0x4682B4

‘Tan’

0xD2B48C

‘Teal’

0x008080

‘Thistle’

0xD8BFD8

‘Tomato’

0xFF6347

‘Turquoise’

0x40E0D0

‘Violet’

0xEE82EE

‘Wheat’

0xF5DEB3

‘White’

0xFFFFFF

‘WhiteSmoke’

0xF5F5F5

‘Yellow’

0xFFFF00

‘YellowGreen’

0x9ACD32

6.8 Channel Layout

通道布局指定多通道音频流中通道的空间布置。为了指定通道布局，FFmpeg 使用特殊语法。

各个频道由 ID 标识，如下表所示：

‘FL’

左前

‘FR’

右前方

‘FC’

前中心

‘LFE’

低频

‘BL’

左后侧

‘BR’

右后

‘FLC’

前偏左

‘FRC’

前偏右

‘BC’

后中心

‘SL’

左侧

‘SR’

右侧

‘TC’

顶部中心

‘TFL’

左前上方

‘TFC’

顶部前中心

‘TFR’

右前上方

‘TBL’

左上后侧

‘TBC’

上后中心

‘TBR’

右上后侧

‘DL’

向左缩混

‘DR’

右缩混

‘WL’

左宽

‘WR’

右宽

‘SDL’

环绕直接左

‘SDR’

直接右环绕

‘LFE2’

低频2

标准通道布局组合可以使用以下标识符来指定：

‘mono’

FC

‘stereo’

FL+FR

‘2.1’

FL+FR+LFE

‘3.0’

FL+FR+FC

‘3.0(back)’

FL+FR+BC

‘4.0’

FL+FR+FC+BC

‘quad’

FL+FR+BL+BR

‘quad(side)’

FL+FR+SL+SR

‘3.1’

FL+FR+FC+LFE

‘5.0’

FL+FR+FC+BL+BR

‘5.0(side)’

FL+FR+FC+SL+SR

‘4.1’

FL+FR+FC+LFE+BC

‘5.1’

FL+FR+FC+LFE+BL+BR

‘5.1(side)’

FL+FR+FC+LFE+SL+SR

‘6.0’

FL+FR+FC+BC+SL+SR

‘6.0(front)’

FL+FR+FLC+FRC+SL+SR

‘3.1.2’

FL+FR+FC+LFE+TFL+TFR

‘hexagonal’

FL+FR+FC+BL+BR+BC

‘6.1’

FL+FR+FC+LFE+BC+SL+SR

‘6.1’

FL+FR+FC+LFE+BL+BR+BC

‘6.1(front)’

FL+FR+LFE+FLC+FRC+SL+SR

‘7.0’

FL+FR+FC+BL+BR+SL+SR

‘7.0(front)’

FL+FR+FC+FLC+FRC+SL+SR

‘7.1’

FL+FR+FC+LFE+BL+BR+SL+SR

‘7.1(wide)’

FL+FR+FC+LFE+BL+BR+FLC+FRC

‘7.1(wide-side)’

FL+FR+FC+LFE+FLC+FRC+SL+SR

‘5.1.2’

FL+FR+FC+LFE+BL+BR+TFL+TFR

‘octagonal’

FL+FR+FC+BL+BR+BC+SL+SR

‘cube’

FL+FR+BL+BR+TFL+TFR+TBL+TBR

‘5.1.4’

FL+FR+FC+LFE+BL+BR+TFL+TFR+TBL+TBR

‘7.1.2’

FL+FR+FC+LFE+BL+BR+SL+SR+TFL+TFR

‘7.1.4’

FL+FR+FC+LFE+BL+BR+SL+SR+TFL+TFR+TBL+TBR

‘7.2.3’

FL+FR+FC+LFE+BL+BR+SL+SR+TFL+TFR+TBC+LFE2

‘9.1.4’

FL+FR+FC+LFE+BL+BR+FLC+FRC+SL+SR+TFL+TFR+TBL+TBR

‘hexadecagonal’

FL+FR+FC+BL+BR+BC+SL+SR+WL+WR+TBL+TBR+TBC+TFC+TFL+TFR

‘downmix’

DL+DR

‘22.2’

FL+FR+FC+LFE+BL+BR+FLC+FRC+BC+SL+SR+TC+TFL+TFC+TFR+TBL+TBC+TBR+LFE2+TSL+TSR+BFC+BFL+BFR

自定义通道布局可以指定为一系列术语，用“+”分隔。每个术语可以是：

• 单个频道的名称（例如'FL','FR','FC','低频效果”等），每个选项都可以在“@”之后包含自定义名称（例如“FL@左','FR@右','FC@中心','LFE@低频'， ETC。）

标准通道布局可以通过以下方式指定：

• 单个频道的名称（例如'FL','FR','FC','低频效果'， ETC。）
• 标准通道布局的名称（例如“单核细胞增多症','立体声','4.0','四边形','5.0'， ETC。）
• 多个通道，以十进制表示，后跟“c”，生成该通道数的默认通道布局（请参阅函数 av_channel_layout_default）。请注意，并非所有通道数都有默认布局。
• 多个通道（十进制），后跟“C”，产生具有指定通道数的未知通道布局。请注意，并非所有通道布局规范字符串都支持未知通道布局。
• 通道布局掩码，以“0x”开头的十六进制（请参阅 AV_CH_*中的宏libavutil/channel_layout.h。

在 libavutil 版本 53 之前，用于指定通道数量的尾随字符“c”是可选的，但现在是必需的，而通道布局掩码也可以指定为十进制数（当且仅当后面不跟有“c”或“C”）。

av_channel_layout_from_string另请参阅中定义的 函数libavutil/channel_layout.h。

7 表达评估

当评估算术表达式时，FFmpeg 使用内部公式评估器，通过libavutil/eval.h 界面。

表达式可以包含一元、二元运算符、常量和函数。

两个表达式expr1和expr2可以组合形成另一个表达式“ expr1 ; expr2 ”。 expr1和expr2依次计算，新表达式的计算结果为expr2的值。

可以使用以下二元运算符：+, -, *, /, ^。

可以使用以下一元运算符：+, -.

可以使用以下功能：

abs(x)

计算x的绝对值。

acos(x)

计算x的反余弦。

asin(x)

计算x的反正弦。

atan(x)

计算x的反正切。

atan2(x, y)

计算y / x的反正切主值。

between(x, min, max)

如果x大于或等于min且小于或等于max，则返回 1，否则返回 0。

bitand(x, y)

bitor(x, y)

对x和y进行按位和/或运算。

在执行按位运算之前， x和y的计算结果将转换为整数。

请注意，转换为整数和转换回浮点数都可能会丢失精度。请注意大数字（通常为 2^53 及更大）的意外结果。

ceil(expr)

将表达式expr的值向上舍入为最接近的整数。例如，“ceil(1.5)”为“2.0”。

clip(x, min, max)

返回介于min和max之间的x值。

cos(x)

计算x的余弦。

cosh(x)

计算x的双曲余弦。

eq(x, y)

如果x和y相等， 则返回 1 ，否则返回 0。

exp(x)

计算x的指数（以e欧拉数为底）。

floor(expr)

将表达式expr的值向下舍入到最接近的整数。例如，“下限(-1.5)”为“-2.0”。

gauss(x)

计算x的高斯函数，对应于 exp(-x*x/2) / sqrt(2*PI)。

gcd(x, y)

返回x和y的最大公约数。如果x和 y都为 0 或者其中一个或两个都小于零，则行为未定义。

gt(x, y)

如果x大于y ，则返回 1 ，否则返回 0。

gte(x, y)

如果x大于或等于y ，则返回 1 ，否则返回 0。

hypot(x, y)

该函数与C语言中的同名函数类似；它返回“sqrt( x * x + y * y )”，即边长为x和y的直角三角形的斜边长度，或者点 ( x , y ) 距原点的距离。

if(x, y)

计算x，如果结果非零，则返回y的计算结果，否则返回 0。

if(x, y, z)

计算x，如果结果非零，则返回y的计算结果，否则返回z的计算结果。

ifnot(x, y)

计算x，如果结果为零，则返回y的计算结果，否则返回 0。

ifnot(x, y, z)

计算x，如果结果为零，则返回y的计算结果，否则返回z的计算结果。

isinf(x)

如果x为 +/-INFINITY，则返回 1.0，否则返回 0.0。

isnan(x)

如果x为 NAN，则返回 1.0 ，否则返回 0.0。

ld(var)

使用数字var加载内部变量的值 ，该值之前使用 st( var , expr ) 存储。该函数返回加载的值。

lerp(x, y, z)

返回x和y之间按z量进行的线性插值。

log(x)

计算x的自然对数。

lt(x, y)

如果x小于y ，则返回 1 ，否则返回 0。

lte(x, y)

如果x小于或等于y ，则返回 1 ，否则返回 0。

max(x, y)

返回x和y之间的最大值。

min(x, y)

返回x和y之间的最小值。

mod(x, y)

计算x除以y的余数。

not(expr)

如果expr为零， 则返回 1.0 ，否则返回 0.0。

pow(x, y)

计算x提升y的幂，相当于“( x )^( y )”。

print(t)

print(t, l)

使用 loglevel l打印表达式t的值。如果 未指定l，则使用默认日志级别。返回打印的表达式的值。

打印 t 和日志级别 l

random(x)

返回 0.0 到 1.0 之间的伪随机值。x是用于保存种子/状态的内部变量的索引。

root(expr, max)

查找一个输入值，其参数ld(0)的expr表示的函数在区间 0.. max中为 0 。

expr中的表达式必须表示连续函数，否则结果是未定义的。

ld(0)用于表示函数输入值，这意味着给定的表达式将使用表达式可以访问的各种输入值进行多次计算 ld(0)。当表达式计算结果为 0 时，将返回相应的输入值。

round(expr)

将表达式expr的值舍入为最接近的整数。例如，“round(1.5)”是“2.0”。

sgn(x)

计算x的符号。

sin(x)

计算x的正弦。

sinh(x)

计算x的双曲正弦。

sqrt(expr)

计算expr的平方根。这相当于“( expr )^.5”。

squish(x)

计算表达式1/(1 + exp(4*x))。

st(var, expr)

将表达式expr的值存储在内部变量中。var指定存储值的变量号，范围是 0 到 9。函数返回内部变量中存储的值。请注意，变量当前不在表达式之间共享。

tan(x)

计算x的正切。

tanh(x)

计算x的双曲正切。

taylor(expr, x)

taylor(expr, x, id)

给定一个表示函数在 0 处的阶导数的 表达式，计算x处的泰勒级数。ld(id)

当级数不收敛时，结果是不确定的。

ld(id)用于表示expr中的导数阶，这意味着给定的表达式将使用表达式可以访问的各种输入值进行多次计算 ld(id)。如果未指定 id ，则假定为 0。

请注意，当您在 y 处求导数而不是 0 时， taylor(expr, x-y)可以使用。

time(0)

返回当前（挂钟）时间（以秒为单位）。

trunc(expr)

将表达式expr的值朝零舍入到最接近的整数。例如，“trunc(-1​​.5)”为“-1.0”。

while(cond, expr)

当表达式cond非零时计算表达式expr ，并返回最后一次expr计算的值，如果cond始终为 false，则返回 NAN。

以下常量可用：

PI

单位圆盘面积，约为 3.14

E

exp(1)（欧拉数），大约 2.718

PHI

黄金比例 (1+sqrt(5))/2，约为 1.618

假设如果表达式具有非零值，则该表达式被视为“真”，请注意：

*工作原理类似于 AND

+工作原理类似于或

例如构造：

if (A AND B) then C

相当于：

if(A*B, C)

在 C 代码中，您可以扩展一元和二元函数的列表，并定义可识别的常量，以便它们可用于您的表达式。

评估器还可以识别国际系统单位前缀。如果在前缀后面附加“i”，则使用二进制前缀，它基于 1024 的幂而不是 1000 的幂。“B”后缀将值乘以 8，并且可以附加在单位前缀之后或单独使用。这允许使用“KB”、“MiB”、“G”和“B”作为数字后缀。

可用的国际系统前缀列表如下，并指示相应的 10 和 2 的幂。

y

10^-24 / 2^-80

z

10^-21 / 2^-70

a

10^-18 / 2^-60

f

10^-15 / 2^-50

p

10^-12 / 2^-40

n

10^-9 / 2^-30

u

10^-6 / 2^-20

m

10^-3 / 2^-10

c

10^-2

d

10^-1

h

10^2

k

10^3 / 2^10

K

10^3 / 2^10

M

10^6 / 2^20

G

10^9 / 2^30

T

10^12 / 2^40

P

10^15 / 2^50

E

10^18 / 2^60

Z

10^21 / 2^70

Y

10^24 / 2^80

8 种编解码器选项

libavcodec 提供了一些通用的全局选项，可以在所有编码器和解码器上进行设置。此外，每个编解码器可以支持所谓的私有选项，其特定于给定编解码器。

有时，全局选项可能只影响特定类型的编解码器，并且可能是无意义的或被另一种编解码器忽略，因此您需要了解指定选项的含义。此外，有些选项仅用于解码或编码。

可以通过在 FFmpeg 工具中 指定 -选项 值AVCodecContext来设置选项，或者通过在选项中显式设置值或使用libavutil/opt.h用于编程使用的 API。

支持的选项列表如下：

b integer (encoding,audio,video)

设置比特率（以位/秒为单位）。默认值为 200K。

ab integer (encoding,audio)

设置音频比特率（以位/秒为单位）。默认值为 128K。

bt integer (encoding,video)

设置视频比特率容差（以位/秒为单位）。在 1-pass 模式下，比特率容差指定码率控制愿意偏离目标平均比特率值的程度。这与最小/最大比特率无关。过度降低耐受性会对质量产生不利影响。

flags flags (decoding/encoding,audio,video,subtitles)

设置通用标志。

可能的值：

‘mv4’

按宏块使用四个运动矢量 (mpeg4)。

‘qpel’

使用 1/4 像素运动补偿。

‘loop’

使用环路滤波器。

‘qscale’

使用固定的 qscale。

‘pass1’

在第一遍模式下使用内部 2pass 速率控制。

‘pass2’

在第二遍模式下使用内部 2pass 速率控制。

‘gray’

仅解码/编码灰度。

‘psnr’

在编码期间设置 error[?] 变量。

‘truncated’

输入比特流可能会被随机截断。

‘drop_changed’

不要输出参数与流中第一个解码帧不同的帧。丢帧时会返回错误 AVERROR_INPUT_CHANGED。

‘ildct’

使用隔行 DCT。

‘low_delay’

强制低延迟。

‘global_header’

将全局标题放置在额外数据中，而不是每个关键帧中。

‘bitexact’

仅写入与平台、构建和时间无关的数据。（（I）DCT 除外）。这可确保文件和数据校验和在平台之间可重复且匹配。它的主要用途是回归测试。

‘aic’

应用H263高级帧内编码/mpeg4 ac预测。

‘ilme’

应用隔行运动估计。

‘cgop’

使用封闭的 gop。

‘output_corrupt’

甚至输出可能损坏的帧。

time_base rational number

设置编解码器时基。

它是表示帧时间戳的基本时间单位（以秒为单位）。对于固定 fps 内容，时基应为1 / frame_rate1，时间戳增量应相同为 1。

g integer (encoding,video)

设置图片组 (GOP) 大小。默认值为 12。

ar integer (decoding/encoding,audio)

设置音频采样率（以 Hz 为单位）。

ac integer (decoding/encoding,audio)

设置音频通道数。

cutoff integer (encoding,audio)

设置截止带宽。（仅受选定编码器支持，请参阅其各自的文档部分。）

frame_size integer (encoding,audio)

设置音频帧大小。

除最后一个帧外，每个提交的帧都必须包含每个通道的frame_size 个样本。当编解码器设置了 CODEC_CAP_VARIABLE_FRAME_SIZE 时，可能为 0，在这种情况下，帧大小不受限制。它由一些解码器设置以指示恒定的帧大小。

frame_number integer

设置帧数。

delay integer

qcomp float (encoding,video)

设置视频量化器比例压缩 (VBR)。它用作速率控制方程中的常数。默认 rc_eq 的推荐范围：0.0-1.0。

qblur float (encoding,video)

设置视频量化器比例模糊 (VBR)。

qmin integer (encoding,video)

设置最小视频量化比例 (VBR)。必须包含在 -1 到 69 之间，默认值为 2。

qmax integer (encoding,video)

设置最大视频量化器比例 (VBR)。必须包含在 -1 到 1024 之间，默认值为 31。

qdiff integer (encoding,video)

设置量化器比例 (VBR) 之间的最大差异。

bf integer (encoding,video)

设置非 B 帧之间的 B 帧的最大数量。

必须是 -1 到 16 之间的整数。0 表示禁用 B 帧。如果使用值-1，它将根据编码器选择自动值。

默认值为 0。

b_qfactor float (encoding,video)

设置 P 帧和 B 帧之间的 qp 因子。

codec_tag integer

bug flags (decoding,video)

解决方法无法自动检测编码器错误。

可能的值：

‘autodetect’

‘xvid_ilace’

Xvid 交错错误（如果 fourcc==XVIX 则自动检测）

‘ump4’

（如果 fourcc==UMP4 则自动检测）

‘no_padding’

填充错误（自动检测）

‘amv’

‘qpel_chroma’

‘std_qpel’

旧标准 qpel（根据 fourcc/版本自动检测）

‘qpel_chroma2’

‘direct_blocksize’

direct-qpel-blocksize 错误（每个 fourcc/版本自动检测）

‘edge’

边缘填充错误（每个 fourcc/版本自动检测）

‘hpel_chroma’

‘dc_clip’

‘ms’

解决微软损坏的解码器中的各种错误。

‘trunc’

截断帧

strict integer (decoding/encoding,audio,video)

指定如何严格遵守标准。

可能的值：

‘very’

严格遵守较旧的更严格版本的规范或参考软件

‘strict’

严格遵守规范中的所有内容，无论后果如何

‘normal’

‘unofficial’

允许非官方扩展

‘experimental’

允许非标准化的实验性事物、实验性（未完成/正在进行中/未经过充分测试）解码器和编码器。注意：实验性解码器可能会带来安全风险，请勿使用它来解码不受信任的输入。

b_qoffset float (encoding,video)

设置 P 帧和 B 帧之间的 QP 偏移。

err_detect flags (decoding,audio,video)

设置错误检测标志。

可能的值：

‘crccheck’

验证嵌入的 CRC

‘bitstream’

检测比特流规范偏差

‘buffer’

检测不正确的比特流长度

‘explode’

检测到小错误时中止解码

‘ignore_err’

忽略解码错误，并继续解码。如果您想分析视频的内容并因此希望无论如何都可以解码所有内容，这非常有用。如果出现错误，此选项将不会产生令人赏心悦目的视频。

‘careful’

考虑那些违反规范并且在野外未被视为错误的事情

‘compliant’

将所有不符合规范的情况视为错误

‘aggressive’

考虑一个理智的编码器不应该做的事情作为错误

has_b_frames integer

block_align integer

rc_override_count integer

maxrate integer (encoding,audio,video)

设置最大比特率容差（以位/秒为单位）。需要设置 bufsize。

minrate integer (encoding,audio,video)

设置最小比特率容限（以位/秒为单位）。在设置 CBR 编码时最有用。否则就没什么用了。

bufsize integer (encoding,audio,video)

设置速率控制缓冲区大小（以位为单位）。

i_qfactor float (encoding,video)

设置 P 帧和 I 帧之间的 QP 因子。

i_qoffset float (encoding,video)

设置 P 帧和 I 帧之间的 QP 偏移。

dct integer (encoding,video)

设置DCT算法。

可能的值：

‘auto’

自动选择一个好的（默认）

‘fastint’

快速整数

‘int’

精确整数

‘mmx’

‘altivec’

‘faan’

浮点 AAN DCT

lumi_mask float (encoding,video)

明亮区域的压缩强度比中等区域的压缩强度要大。

tcplx_mask float (encoding,video)

设置时间复杂度掩码。

scplx_mask float (encoding,video)

设置空间复杂性掩蔽。

p_mask float (encoding,video)

设置帧间屏蔽。

dark_mask float (encoding,video)

比中等区域更强烈地压缩黑暗区域。

idct integer (decoding/encoding,video)

选择 IDCT 实施。

可能的值：

‘auto’

‘int’

‘simple’

‘simplemmx’

‘simpleauto’

自动选择与简单IDCT兼容的IDCT

‘arm’

‘altivec’

‘sh4’

‘simplearm’

‘simplearmv5te’

‘simplearmv6’

‘simpleneon’

‘xvid’

‘faani’

浮点 AAN IDCT

slice_count integer

ec flags (decoding,video)

设置错误隐藏策略。

可能的值：

‘guess_mvs’

迭代运动矢量 (MV) 搜索（慢速）

‘deblock’

对损坏的 MB 使用强解块滤波器

‘favor_inter’

倾向于从前一帧而不是当前帧进行预测

bits_per_coded_sample integer

aspect rational number (encoding,video)

设置样本纵横比。

sar rational number (encoding,video)

设置样本纵横比。方面的别名。

debug flags (decoding/encoding,audio,video,subtitles)

打印具体的调试信息。

可能的值：

‘pict’

图片信息

‘rc’

速率控制

‘bitstream’

‘mb_type’

宏块 (MB) 类型

‘qp’

每块量化参数 (QP)

‘dct_coeff’

‘green_metadata’

显示即将到来的帧、GoP 或给定持续时间的复杂性元数据。

‘skip’

‘startcode’

‘er’

错误识别

‘mmco’

内存管理控制操作（H.264）

‘bugs’

‘buffers’

图片缓冲区分配

‘thread_ops’

线程操作

‘nomc’

跳跃运动补偿

cmp integer (encoding,video)

设置完整的像素比较功能。

可能的值：

‘sad’

绝对差值之和，快速（默认）

‘sse’

误差平方和

‘satd’

绝对 Hadamard 变换差值之和

‘dct’

DCT 变换绝对差值之和

‘psnr’

量化误差平方和（避免，低质量）

‘bit’

块所需的位数

‘rd’

率失真最佳，慢

‘zero’

0

‘vsad’

绝对垂直差之和

‘vsse’

垂直差平方和

‘nsse’

噪声保留平方差和

‘w53’

5/3 小波，仅在雪中使用

‘w97’

9/7 小波，仅在雪中使用

‘dctmax’

‘chroma’

subcmp integer (encoding,video)

设置子像素比较功能。

可能的值：

‘sad’

绝对差值之和，快速（默认）

‘sse’

误差平方和

‘satd’

绝对 Hadamard 变换差值之和

‘dct’

DCT 变换绝对差值之和

‘psnr’

量化误差平方和（避免，低质量）

‘bit’

块所需的位数

‘rd’

率失真最佳，慢

‘zero’

0

‘vsad’

绝对垂直差之和

‘vsse’

垂直差平方和

‘nsse’

噪声保留平方差和

‘w53’

5/3 小波，仅在雪中使用

‘w97’

9/7 小波，仅在雪中使用

‘dctmax’

‘chroma’

mbcmp integer (encoding,video)

设置宏块比较功能。

可能的值：

‘sad’

绝对差值之和，快速（默认）

‘sse’

误差平方和

‘satd’

绝对 Hadamard 变换差值之和

‘dct’

DCT 变换绝对差值之和

‘psnr’

量化误差平方和（避免，低质量）

‘bit’

块所需的位数

‘rd’

率失真最佳，慢

‘zero’

0

‘vsad’

绝对垂直差之和

‘vsse’

垂直差平方和

‘nsse’

噪声保留平方差和

‘w53’

5/3 小波，仅在雪中使用

‘w97’

9/7 小波，仅在雪中使用

‘dctmax’

‘chroma’

ildctcmp integer (encoding,video)

设置隔行DCT比较功能。

可能的值：

‘sad’

绝对差值之和，快速（默认）

‘sse’

误差平方和

‘satd’

绝对 Hadamard 变换差值之和

‘dct’

DCT 变换绝对差值之和

‘psnr’

量化误差平方和（避免，低质量）

‘bit’

块所需的位数

‘rd’

率失真最佳，慢

‘zero’

0

‘vsad’

绝对垂直差之和

‘vsse’

垂直差平方和

‘nsse’

噪声保留平方差和

‘w53’

5/3 小波，仅在雪中使用

‘w97’

9/7 小波，仅在雪中使用

‘dctmax’

‘chroma’

dia_size integer (encoding,video)

设置运动估计的菱形类型和大小。

‘(1024, INT_MAX)’

全运动估计（最慢）

‘(768, 1024]’

嗯运动估计

‘(512, 768]’

六角运动估计

‘(256, 512]’

l2s 菱形运动估计

‘[2,256]’

var 菱形运动估计

‘(-1, 2)’

小菱形运动估计

‘-1’

有趣的钻石运动估计

‘(INT_MIN, -1)’

sab钻石运动估计

last_pred integer (encoding,video)

设置前一帧的运动预测变量的数量。

precmp integer (encoding,video)

设置预运动估计比较功能。

可能的值：

‘sad’

绝对差值之和，快速（默认）

‘sse’

误差平方和

‘satd’

绝对 Hadamard 变换差值之和

‘dct’

DCT 变换绝对差值之和

‘psnr’

量化误差平方和（避免，低质量）

‘bit’

块所需的位数

‘rd’

率失真最佳，慢

‘zero’

0

‘vsad’

绝对垂直差之和

‘vsse’

垂直差平方和

‘nsse’

噪声保留平方差和

‘w53’

5/3 小波，仅在雪中使用

‘w97’

9/7 小波，仅在雪中使用

‘dctmax’

‘chroma’

pre_dia_size integer (encoding,video)

设置运动估计预通道的菱形类型和大小。

subq integer (encoding,video)

设置亚像素运动估计质量。

me_range integer (encoding,video)

设置限制运动矢量范围（DivX 播放器为 1023）。

global_quality integer (encoding,audio,video)

slice_flags integer

mbd integer (encoding,video)

设置宏块决策算法（高质量模式）。

可能的值：

‘simple’

使用 mbcmp（默认）

‘bits’

使用最少的位

‘rd’

使用最佳率失真

rc_init_occupancy integer (encoding,video)

设置解码开始前应加载到 rc 缓冲区的位数。

flags2 flags (decoding/encoding,audio,video,subtitles)

可能的值：

‘fast’

允许不符合规范的加速技巧。

‘noout’

跳过比特流编码。

‘ignorecrop’

忽略来自 sps 的裁剪信息。

‘local_header’

将全局标题放置在每个关键帧上，而不是放在额外数据中。

‘chunks’

帧数据可能被分成多个块。

‘showall’

显示第一个关键帧之前的所有帧。

‘export_mvs’

将运动矢量导出到帧侧数据（请参阅 参考资料AV_FRAME_DATA_MOTION_VECTORS）以了解支持它的编解码器。也可以看看文档/示例/export_mvs.c。

‘skip_manual’

不要跳过样本并将跳过信息导出为帧侧数据。

‘ass_ro_flush_noop’

不要在刷新时重置 ASS ReadOrder 字段。

‘icc_profiles’

从比色标签生成/解析嵌入的 ICC 配置文件。

export_side_data flags (decoding/encoding,audio,video,subtitles)

可能的值：

‘mvs’

将运动矢量导出到帧侧数据（请参阅 参考资料AV_FRAME_DATA_MOTION_VECTORS）以了解支持它的编解码器。也可以看看文档/示例/export_mvs.c。

‘prft’

将编码器生产者参考时间导出到数据包侧数据中（请参阅AV_PKT_DATA_PRFT参考资料）以了解支持它的编解码器。

‘venc_params’

通过帧端数据导出视频编码参数（请参阅 参考资料AV_FRAME_DATA_VIDEO_ENC_PARAMS）以了解支持它的编解码器。目前有 H.264 和 VP9。

‘film_grain’

通过帧侧数据导出胶片颗粒参数（请参阅AV_FRAME_DATA_FILM_GRAIN_PARAMS）。目前支持 AV1 解码器。

threads integer (decoding/encoding,video)

设置要使用的线程数，以防所选编解码器实现支持多线程。

可能的值：

‘auto, 0’

自动选择要设置的线程数

默认值为 '汽车'。

dc integer (encoding,video)

设置intra_dc_ precision。

nssew integer (encoding,video)

设置 nsse 权重。

skip_top integer (decoding,video)

设置顶部跳过的宏块行数。

skip_bottom integer (decoding,video)

设置底部跳过的宏块行数。

profile integer (encoding,audio,video)

设置编码器编解码器配置文件。默认值为 '未知'。编码器特定配置文件记录在相关编码器文档中。

level integer (encoding,audio,video)

设置编码器电平。此级别取决于特定的编解码器，并且可能对应于配置文件级别。它默认设置为 '未知'。

可能的值：

‘unknown’

lowres integer (decoding,audio,video)

以 1= 1/2、2=1/4、3=1/8 分辨率进行解码。

mblmin integer (encoding,video)

设置最小宏块拉格朗日因子 (VBR)。

mblmax integer (encoding,video)

设置最大宏块拉格朗日因子 (VBR)。

skip_loop_filter integer (decoding,video)

skip_idct integer (decoding,video)

skip_frame integer (decoding,video)

根据选项值选择的帧类型进行解码器丢弃处理。

跳过循环过滤器跳过帧循环过滤，跳过IDCT 跳帧 IDCT/反量化，跳帧跳过解码。

可能的值：

‘none’

不丢弃任何框架。

‘default’

丢弃无用的帧，例如 0 大小的帧。

‘noref’

丢弃所有非参考帧。

‘bidir’

丢弃所有双向帧。

‘nokey’

丢弃除关键帧之外的所有帧。

‘nointra’

丢弃除 I 帧之外的所有帧。

‘all’

丢弃所有帧。

默认值为 '默认'。

bidir_refine integer (encoding,video)

细化双向宏块中使用的两个运动矢量。

keyint_min integer (encoding,video)

设置 IDR 帧之间的最小间隔。

refs integer (encoding,video)

设置参考帧以考虑运动补偿。

trellis integer (encoding,audio,video)

设置率失真最佳量化。

mv0_threshold integer (encoding,video)

compression_level integer (encoding,audio,video)

bits_per_raw_sample integer

channel_layout integer (decoding/encoding,audio)

可能的值：

request_channel_layout integer (decoding,audio)

可能的值：

rc_max_vbv_use float (encoding,video)

rc_min_vbv_use float (encoding,video)

color_primaries integer (decoding/encoding,video)

可能的值：

‘bt709’

BT.709

‘bt470m’

BT.470M

‘bt470bg’

BT.470 BG

‘smpte170m’

SMPTE 170M

‘smpte240m’

SMPTE 240M

‘film’

电影

‘bt2020’

BT.2020

‘smpte428’

‘smpte428_1’

SMPTE ST 428-1

‘smpte431’

SMPTE 431-2

‘smpte432’

SMPTE 432-1

‘jedec-p22’

JEDEC P22

color_trc integer (decoding/encoding,video)

可能的值：

‘bt709’

BT.709

‘gamma22’

BT.470M

‘gamma28’

BT.470 BG

‘smpte170m’

SMPTE 170M

‘smpte240m’

SMPTE 240M

‘linear’

线性

‘log’

‘log100’

日志

‘log_sqrt’

‘log316’

对数平方根

‘iec61966_2_4’

‘iec61966-2-4’

IEC 61966-2-4

‘bt1361’

‘bt1361e’

BT.1361

‘iec61966_2_1’

‘iec61966-2-1’

IEC 61966-2-1

‘bt2020_10’

‘bt2020_10bit’

BT.2020 - 10 位

‘bt2020_12’

‘bt2020_12bit’

BT.2020 - 12 位

‘smpte2084’

SMPTE ST 2084

‘smpte428’

‘smpte428_1’

SMPTE ST 428-1

‘arib-std-b67’

ARIB STD-B67

colorspace integer (decoding/encoding,video)

可能的值：

‘rgb’

RGB

‘bt709’

BT.709

‘fcc’

美国联邦通信委员会

‘bt470bg’

BT.470 BG

‘smpte170m’

SMPTE 170M

‘smpte240m’

SMPTE 240M

‘ycocg’

YCOCG

‘bt2020nc’

‘bt2020_ncl’

BT.2020 NCL

‘bt2020c’

‘bt2020_cl’

BT.2020 CL

‘smpte2085’

SMPTE 2085

‘chroma-derived-nc’

色度衍生的 NCL

‘chroma-derived-c’

色度衍生 CL

‘ictcp’

心电图

color_range integer (decoding/encoding,video)

如果用作输入参数，它会向解码器提示输入的 color_range。可能的值：

‘tv’

‘mpeg’

‘limited’

MPEG (219*2^(n-8))

‘pc’

‘jpeg’

‘full’

JPEG (2^n-1)

chroma_sample_location integer (decoding/encoding,video)

可能的值：

‘left’

‘center’

‘topleft’

‘top’

‘bottomleft’

‘bottom’

log_level_offset integer

设置日志级别偏移量。

slices integer (encoding,video)

并行编码中使用的切片数量。

thread_type flags (decoding/encoding,video)

选择要使用的多线程方法。

用于 '框架' 将增加每个线程一帧的解码延迟，因此无法提供未来帧的客户端不应使用它。

可能的值：

‘slice’

一次解码一帧的多个部分。

仅当使用切片对视频进行编码时，使用切片的多线程才有效。

‘frame’

一次解码多于一帧。

默认值为 '切片+帧'。

audio_service_type integer (encoding,audio)

设置音频服务类型。

可能的值：

‘ma’

主要音频服务

‘ef’

效果

‘vi’

视障人士

‘hi’

听力障碍

‘di’

对话

‘co’

评论

‘em’

紧急情况

‘vo’

画外音

‘ka’

卡拉OK

request_sample_fmt sample_fmt (decoding,audio)

设置音频解码器应该首选的样本格式。默认值为 none。

pkt_timebase rational number

sub_charenc encoding (decoding,subtitles)

设置输入字幕的字符编码。

field_order field_order (video)

设置/覆盖视频的场序。可能的值：

‘progressive’

渐进式视频

‘tt’

隔行扫描视频，顶场编码并首先显示

‘bb’

隔行扫描视频，底场编码并先显示

‘tb’

隔行视频，顶部编码优先，底部优先显示

‘bt’

隔行扫描视频，底部编码优先，顶部优先显示

skip_alpha bool (decoding,video)

设置为 1 以禁用处理 Alpha（透明度）。这就像'灰色的' 中的标志旗帜跳过色度信息而不是 alpha 的选项。默认值为 0。

codec_whitelist list (input)

“，”分隔允许的解码器列表。默认情况下，所有内容都是允许的。

dump_separator string (input)

分隔符用于分隔命令行上打印的有关流参数的字段。例如，要使用换行符和缩进分隔字段：

ffprobe -dump_separator "
                          "  -i ~/videos/matrixbench_mpeg2.mpg

max_pixels integer (decoding/encoding,video)

每个图像的最大像素数。该值可用于避免由于大图像导致的内存不足故障。

apply_cropping bool (decoding,video)

如果裁剪参数是左侧和顶部参数所需对齐的倍数，则启用裁剪。如果不符合对齐方式，将进行部分裁剪以保持对齐。默认值为 1（启用）。注意：所需的对齐取决于是否AV_CODEC_FLAG_UNALIGNED设置和CPU。AV_CODEC_FLAG_UNALIGNED无法从命令行更改。此外，硬件解码器不会应用左/上裁剪。

9 个解码器

解码器是 FFmpeg 中的配置元素，允许解码多媒体流。

当您配置 FFmpeg 构建时，默认情况下会启用所有支持的本机解码器。需要外部库的解码器必须通过相应的选项手动启用--enable-lib。您可以使用配置选项列出所有可用的解码器--list-decoders。

您可以使用配置选项禁用所有解码器 ，并使用选项/ --disable-decoders选择性地启用/禁用单个解码器。 --enable-decoder=DECODER--disable-decoder=DECODER

ff* 工具的选项-decoders将显示启用的解码器列表。

10 个视频解码器

下面是一些当前可用的视频解码器的描述。

10.1 av1

AOMedia 视频 1 (AV1) 解码器。

10.1.1 选项

operating_point

选择可扩展 AV1 比特流的操作点 (0 - 31)。默认值为 0。

10.2 rawvideo

原始视频解码器。

该解码器对原始视频流进行解码。

10.2.1 选项

top top_field_first

指定输入视频的假定字段类型。

-1

视频被假定为渐进式（默认）

0

假设底场优先

1

假设顶场优先

10.3 libdav1d

dav1d AV1 解码器。

libdav1d 允许 libavcodec 解码 AOMedia Video 1 (AV1) 编解码器。需要在配置过程中存在 libdav1d 标头和库。您需要使用 显式配置构建--enable-libdav1d。

10.3.1 选项

libdav1d 包装器支持以下选项。

framethreads

设置解码期间要使用的帧线程数量。默认值为 0（自动检测）。libdav1d >= 1.0 已弃用此选项，并将在将来删除。请改用该选项max_frame_delay和全局选项threads。

tilethreads

设置解码期间要使用的图块线程数量。默认值为 0（自动检测）。libdav1d >= 1.0 已弃用此选项，并将在将来删除。请改用全局选项threads。

max_frame_delay

设置解码器可以在内部缓冲的最大帧数。默认值为 0（自动检测）。

filmgrain

如果比特流中存在解码视频，则将胶片颗粒应用于解码视频。默认为库的内部默认值。此选项已弃用，并将在将来删除。export_side_data请参阅导出胶片颗粒参数而不是应用它的 全局选项 。

oppoint

选择可扩展 AV1 比特流的操作点 (0 - 31)。默认为库的内部默认值。

alllayers

输出可扩展 AV1 比特流的所有空间层。默认值为 false。

10.4 libdavs2

AVS2-P2/IEEE1857.4 视频解码器包装器。

该解码器允许 libavcodec 使用 davs2 库解码 AVS2 流。

10.5 libuavs3d

AVS3-P2/IEEE1857.10视频解码器。

libuavs3d 允许 libavcodec 解码 AVS3 流。需要在配置过程中存在 libuavs3d 标头和库。您需要使用 显式配置构建--enable-libuavs3d。

10.5.1 选项

libuavs3d 包装器支持以下选项。

frame_threads

设置解码期间要使用的帧线程数量。默认值为 0（自动检测）。

10.6 QSV Decoders

英特尔 QuickSync 视频解码器系列（VC1、MPEG-2、H.264、HEVC、JPEG/MJPEG、VP8、VP9、AV1）。

10.6.1 常用选项

所有 qsv 解码器都支持以下选项。

async_depth

内部并行化深度，值越高，延迟越高。

gpu_copy

视频和系统内存之间的 GPU 加速复制

‘default’

‘on’

‘off’

10.6.2 HEVC 选项

hevc_qsv 的额外选项。

load_plugin

用于在内部会话中加载的用户插件

‘none’

‘hevc_sw’

‘hevc_hw’

load_plugins

:-要在内部会话中加载的十六进制插件 UID 的单独列表

10.7 v210

未压缩的 4:2:2 10 位解码器。

10.7.1 选项

custom_stride

设置 v210 数据的行大小（以字节为单位）。默认值为 0（自动检测）。您可以对无步幅 v210 使用特殊的 -1 值，如 BOXX 文件中所示。

11 个音频解码器

下面是一些当前可用的音频解码器的描述。

11.1 ac3

AC-3 音频解码器。

该解码器实现了 ATSC A/52:2010 和 ETSI TS 102 366 的一部分，以及未记录的 RealAudio 3（又名 dnet）。

11.1.1 AC-3 解码器选项

-drc_scale value

动态范围比例因子。应用于 AC-3 流的动态范围值的系数。该因子以指数方式应用。默认值为 1。有 3 个值得注意的比例因子范围：

drc_scale == 0

刚果民主共和国禁用。产生全频音频。

0 < drc_scale <= 1

已启用 DRC。应用流 DRC 值的一小部分。音频再现介于全范围和全压缩之间。

drc_scale > 1

已启用 DRC。不对称地应用 drc_scale。响亮的声音被完全压缩。柔和的声音得到增强。

11.2 flac

FLAC 音频解码器。

该解码器旨在实现 Xiph 的完整 FLAC 规范。

11.2.1 FLAC 解码器选项

-use_buggy_lpc

lavc FLAC 编码器用于生成具有高 lpc 值（如默认值）的有问题的流。此选项使得可以通过使用 lavc 旧的有缺陷的 lpc 逻辑进行解码来正确解码此类流。

11.3 ffwavesynth

内波合成器。

该解码器根据预定义的序列生成波形图案。它的使用纯粹是内部的，它接受的数据格式没有公开记录。

11.4 libcelt

libcelt 解码器包装器。

libcelt 允许 libavcodec 解码 Xiph CELT 超低延迟音频编解码器。需要在配置过程中存在 libcelt 标头和库。您需要使用 显式配置构建--enable-libcelt。

11.5 libgsm

libgsm 解码器包装器。

libgsm 允许 libavcodec 解码 GSM 全速率音频编解码器。需要在配置过程中存在 libgsm 标头和库。您需要使用 显式配置构建--enable-libgsm。

该解码器支持普通 GSM 和 Microsoft 变体。

11.6 libilbc

libilbc 解码器包装器。

libilbc 允许 libavcodec 解码互联网低比特率编解码器 (iLBC) 音频编解码器。需要在配置过程中存在 libilbc 标头和库。您需要使用 显式配置构建 --enable-libilbc。

11.6.1 选项

libilbc 包装器支持以下选项。

enhance

设置为 1 时启用解码音频的增强。默认值为 0（禁用）。

11.7 libopencore-amrnb

libopencore-amrnb 解码器包装器。

libopencore-amrnb 允许 libavcodec 解码自适应多速率窄带音频编解码器。使用它需要在配置过程中存在 libopencore-amrnb 标头和库。您需要使用 显式配置构建--enable-libopencore-amrnb。

存在 AMR-NB 的 FFmpeg 本机解码器，因此用户无需此库即可解码 AMR-NB。

11.8 libopencore-amrwb

libopencore-amrwb 解码器包装器。

libopencore-amrwb 允许 libavcodec 解码自适应多速率宽带音频编解码器。使用它需要在配置过程中存在 libopencore-amrwb 标头和库。您需要使用 显式配置构建--enable-libopencore-amrwb。

存在 AMR-WB 的 FFmpeg 本机解码器，因此用户无需此库即可解码 AMR-WB。

11.9 libopus

libopus 解码器包装器。

libopus 允许 libavcodec 解码 Opus 交互式音频编解码器。需要在配置过程中存在 libopus 标头和库。您需要使用 显式配置构建 --enable-libopus。

Opus 存在 FFmpeg 本机解码器，因此用户无需此库即可解码 Opus。

12个字幕解码器

12.1 libaribb24

ARIB STD-B24 字幕解码器。

实施 ARIB STD-B24 标准的配置文件 A 和 C。

12.1.1 libaribb24 解码器选项

-aribb24-base-path path

设置 libaribb24 库的基本路径。这用于读取配置文件（用于自定义 unicode 转换），以及将非文本符号转储为该位置下的图像。

默认情况下取消设置。

-aribb24-skip-ruby-text boolean

告诉解码器包装器跳过包含半高 ruby​​ 文本的文本块。

默认启用。

12.2 libaribcaption

另一个使用外部libaribcaption 库的 ARIB STD-B24 字幕解码器。

实现日本 ARIB STD-B24 标准、巴西 ABNT NBR 15606-1 和菲律宾版本 ISDB-T 的配置文件 A 和 C。

需要在配置过程中存在 libaribcaption 标头和库 ( https://github.com/xqq/libaribcaption )。您需要使用 显式配置构建--enable-libaribcaption。如果同时启用libaribb24和libaribcaption ，则libaribcaption 解码器优先。

12.2.1 libaribcaption 解码器选项

-sub_type subtitle_type

指定解码字幕的格式。

‘bitmap’

图形图像。

‘ass’

ASS 格式的文本。

‘text’

基于简单文本的输出，无需格式化。

默认为ass ，与libaribb24解码器相同。一些现有的播放器（例如mpv）希望 ARIB 字幕采用 ASS 格式。

-caption_encoding encoding_scheme

指定输入字幕文本的编码方案。

‘auto’

自动检测文本编码（默认）。

‘jis’

ARIB STD B24 中定义的 8 位字符 JIS 编码。这种编码在日本用于 ISDB 字幕。

‘utf8’

ARIB STD B24 中定义的 UTF-8 编码。此编码在菲律宾用于 ISDB-T 字幕。

‘latin’

ABNT NBR 15606-1 中定义的拉丁字符编码。此编码在南美洲用于 SBTVD / ISDB-Tb 字幕。

-font font_name[,font_name2,...]

指定用于位图 或ass类型字幕渲染的字体系列名称的逗号分隔列表。屁股类型字幕仅使用第一个字体名称。

如果未指定，则使用内部定义的默认字体系列。

-ass_single_rect boolean

ARIB STD-B24 规定某些字幕可以一次显示在不同的位置（多矩形字幕）。由于某些播放器（例如，旧的mpv）无法处理单个 AVSubtitle 中的多个 ASS 矩形，或者具有相同开始时间戳的不确定持续时间的多个 ASS 矩形，因此此选项可以更改行为，以便所有文本都显示在单个 AVSubtitle 中ASS 矩形。

默认为false。

如果您的播放器无法正确处理具有多个 ASS 矩形的 AVSubtitles，请将此选项设置为true或定义ASS_SINGLE_RECT=1以更改编译时的默认行为。

-force_outline_text boolean

指定是否始终为所有字符呈现轮廓文本，而不管字符样式的指示如何。

默认为false。

-outline_width number (0.0 - 3.0)

指定轮廓文本的宽度，以点（相对）为单位。

默认值为1.5。

-ignore_background boolean

指定是否忽略背景颜色渲染。

默认为false。

-ignore_ruby boolean

指定是否忽略类拼音（注音假名）字符的渲染。

默认为false。

-replace_drcs boolean

指定是否将替换的 DRCS 字符呈现为 Unicode 字符。

默认值为true。

-replace_msz_ascii boolean

指定是否用半角字母数字替换 MSZ（中号；半角）全角字母数字。

默认值为true。

-replace_msz_japanese boolean

指定是否将某些 MSZ（中号；半角）全角日语特殊字符替换为半角字符。

默认值为true。

-replace_msz_glyph boolean

指定是否用半角字形替换 MSZ（中号；半角）字符（如果字体支持）。此选项适用于具有 Adob​​e-Japan1 兼容字体的 FreeType 或 DirectWrite 渲染器。例如，IBM Plex Sans JP、Morisawa BIZ UDGothic、Morisawa BIZ UDMincho、Yu Gothic、Yu Mincho 和 Meiryo。

默认值为true。

-canvas_size image_size

指定渲染字幕的画布的分辨率；通常，这应该是输入视频的帧大小。-subtitle_type这仅在设置为bitmap时适用。

libaribcaption 解码器假定位图渲染的输入帧大小如下：

1. PROFILE_A：1440 x 1080，SAR (PAR) 4:3
2. PROFILE_C：320 x 180，SAR (PAR) 1:1

如果输入视频的实际帧大小与上述假设不匹配，则渲染的字幕可能会失真。为了使字幕不失真，请添加-canvas_size选项来指定实际输入视频大小。

请注意，-canvas_size对于不同尺寸但相同宽高比的视频，不需要该选项。-canvas_size在这种情况下，如果未指定选项，字幕将拉伸或缩小到实际视频大小。如果-canvas_size选项指定了不同的大小，则标题将根据计算的 SAR 拉伸或收缩为指定的大小。

12.2.2 libaribcaption解码器使用示例

通过工具显示带有ARIB字幕的MPEG-TS文件ffplay：

ffplay -sub_type bitmap MPEG.TS

通过工具显示输入帧大小为1920x1080的MPEG-TS文件ffplay：

ffplay -sub_type bitmap -canvas_size 1920x1080 MPEG.TS

在转码视频中嵌入 ARIB 字幕：

ffmpeg -sub_type bitmap -i src.m2t -filter_complex "[0:v][0:s]overlay" -vcodec h264 dest.mp4

12.3 dvbsub

12.3.1 选项

compute_clut

-2

如果流中没有匹配的 CLUT，则计算一次 clut。

-1

如果流中没有匹配的 CLUT，则计算 clut。

0

从不计算 CLUT

1

始终计算 CLUT 并覆盖流中提供的 CLUT。

dvb_substream

选择 dvb 子流，如果默认值为 -1，则选择所有子流。

12.4 dvdsub

该编解码器对 DVD 中使用的位图字幕进行解码；在 VobSub 文件对和某些 Matroska 文件中也可以找到相同的字幕。

12.4.1 选项

palette

指定位图使用的全局调色板。当存储在VobSub中时，调色板通常在索引文件中指定；在 Matroska 中，调色板以与 VobSub 中相同的格式存储在编解码器额外数据中。在 DVD 中，调色板存储在 IFO 文件中，因此在从转储的 VOB 文件中读取时不可用。

该选项的格式是一个字符串，包含 16 个 24 位十六进制数字（不带 0x 前缀），以逗号分隔，例如0d00ee, ee450d, 101010, eaeaea, 0ce60b, ec14ed, ebff0b, 0d617a, 7b7b7b, d1d1d1, 7b2a0e, 0d950c, 0f007b, cf0dec, cfa80c, 7c127b。

ifo_palette

指定从中获取全局调色板的 IFO 文件。（实验性）

forced_subs_only

仅解码标记为强制的字幕条目。有些影片在同一曲目中具有强制字幕和非强制字幕。将此标志设置为1 只会保留强制字幕。默认值为0。

12.5 libzvbi-teletext

Libzvbi 允许 libavcodec 解码 DVB 图文电视页面和 DVB 图文电视字幕。需要在配置过程中存在 libzvbi 标头和库。您需要使用 显式配置构建 --enable-libzvbi。

12.5.1 选项

txt_page

要解码的图文电视页码列表。与指定列表不匹配的页面将被删除。您可以使用特殊*字符串来匹配所有页面，或subtitle匹配所有字幕页面。默认值为*。

txt_default_region

设置用于解码的默认字符集，值介于 0 和 87 之间（请参阅 ETS 300 706，第 15 节，表 32）。默认值为 -1，不会覆盖 libzvbi 默认值。对于某些无法发出正确字符集信号的旧版 1.0 传输，需要此选项。

txt_chop_top

丢弃顶部图文电视行。默认值为 1。

txt_format

指定解码字幕的格式。

bitmap

默认格式，您应该将其用于图文电视页面，因为某些图形和颜色无法用简单文本甚至 ASS 来表达。

text

基于简单文本的输出，无需格式化。

ass

格式化的 ASS 输出、字幕页面和图文电视页面以不同的样式返回，字幕页面被精简为文本，但努力保持文本对齐和格式。

txt_left

生成位图的 X 偏移量，默认为 0。

txt_top

生成位图的 Y 偏移量，默认为 0。

txt_chop_spaces

删除前导和尾随空格并从生成的文本中删除空行。此选项对于基于图文电视的字幕很有用，其中行的开头或结尾处可能存在空格，或者由于双倍大小的图文电视字符，字幕行之间可能存在空行。默认值为 1。

txt_duration

设置解码的图文电视页面或字幕的显示持续时间（以毫秒为单位）。默认值为-1，表示无穷大或直到下一个字幕事件到来。

txt_transparent

强制生成的图文电视位图的背景透明。默认值为 0，表示背景不透明。

txt_opacity

设置图文电视背景的不透明度 (0-255)。如果 txt_透明未设置，它仅影响开始框和结束框之间的字符，通常是字幕。默认值为 0，如果 txt_透明已设置，否则为 255。

13 个比特流过滤器

当您配置 FFmpeg 构建时，默认情况下会启用所有支持的比特流过滤器。您可以使用配置选项列出所有可用的选项--list-bsfs。

您可以使用configure 选项禁用所有比特流过滤器 --disable-bsfs，并使用该选项有选择地启用任何比特流过滤器--enable-bsf=BSF，或者您可以使用该选项禁用特定的比特流过滤器--disable-bsf=BSF。

ff* 工具的选项-bsfs将显示构建中包含的所有受支持的比特流过滤器的列表。

ff* 工具对每个流应用一个 -bsf 选项，采用逗号分隔的过滤器列表，其参数遵循过滤器名称后的“=”。

ffmpeg -i INPUT -c:v copy -bsf:v filter1[=opt1=str1:opt2=str2][,filter2] OUTPUT

以下是当前可用的比特流过滤器及其参数（如果有）的描述。

13.1 aac_adtstoasc

将 MPEG-2/4 AAC ADTS 转换为 MPEG-4 音频特定配置比特流。

此过滤器从 MPEG-2/4 ADTS 标头创建 MPEG-4 AudioSpecificConfig 并删除 ADTS 标头。

例如，将 AAC 流从原始 ADTS AAC 或 MPEG-TS 容器复制到 MP4A-LATM、FLV 文件或 MOV/MP4 文件以及相关格式（例如 3GP 或 M4A）时，需要此过滤器。请注意，它会自动插入 MP4A-LATM 和 MOV/MP4 及相关格式。

13.2 av1_metadata

修改嵌入 AV1 流中的元数据。

td

在流的所有时间单元中插入或删除时间定界符 OBU。

‘insert’

在每个尚未有 TU 的开头插入 TD。

‘remove’

从每个有 TU 的开头删除 TD。

color_primaries

transfer_characteristics

matrix_coefficients

设置流中的颜色描述字段（请参阅 AV1 第 6.4.2 节）。

color_range

设置流中的颜色范围（请参阅 AV1 第 6.4.2 节；请注意，不能为使用 BT.709 原色、sRGB 传输特性和单位 (RGB) 矩阵系数的流设置此项）。

‘tv’

范围有限。

‘pc’

全系列。

chroma_sample_position

设置流中的色度样本位置（请参阅 AV1 第 6.4.2 节）。只能为 4:2:0 流设置此项。

‘vertical’

左侧位置（与 MPEG-2 和 H.264 中的默认位置匹配）。

‘colocated’

左上角位置。

tick_rate

在序列标头的计时信息中 设置刻度率 ( time_scale / num_units_in_display_tick )。

num_ticks_per_picture

设置每张图片中的刻度数，以指示流具有固定的帧速率。忽略如果滴答率也没有设置。

delete_padding

删除填充 OBU。

13.3 chomp

删除数据包末尾的零填充。

13.4 dca_core

从 DCA/DTS 流中提取核心，丢弃 DTS-HD 等扩展。

13.5 dump_extra

将额外数据添加到已过滤数据包的开头，除非所述数据包已经完全以要添加的额外数据开始。

freq

附加参数指定应过滤哪些数据包。它接受以下值：

‘k’

‘keyframe’

将额外数据添加到所有关键数据包中

‘e’

‘all’

向所有数据包添加额外数据

如果未指定，则假定 'k'。

例如，以下ffmpeg命令在编码器生成的 H.264 数据包中强制使用全局标头（从而禁用各个数据包标头）libx264，但通过将存储在 extradata 中的标头添加到关键数据包来纠正它们：

ffmpeg -i INPUT -map 0 -flags:v +global_header -c:v libx264 -bsf:v dump_extra out.ts

13.6 dv_error_marker

DV 中标记为损坏的块将替换为指定颜色的块。

color

替换损坏块的颜色

sta

16 位掩码，指定 16 个可能的错误状态值中的哪一个将被彩色块替换。0xFFFE 是默认值，它替换所有非 0 错误状态值。

‘ok’

没有错误，没有隐瞒

‘err’

错误，无隐瞒

‘res’

预订的

‘notok’

错误或隐瞒

‘notres’

不保留

‘Aa, Ba, Ca, Ab, Bb, Cb, A, B, C, a, b, erri, erru’

具体错误状态码

请参阅第 44-46 页或 http://web.archive.org/web/20060927044735/http://www.smpte.org/smpte_store/standards/pdf/s314m.pdf的第 5.5 节

13.7 eac3_core

从 E-AC-3 流中提取核心，丢弃额外的通道。

13.8 extract_extradata

提取带内额外数据。

某些编解码器允许长期标头（例如 MPEG-2 序列标头或 H.264/HEVC (VPS/)SPS/PPS）“带内”传输（即作为包含编码的比特流的一部分）。帧）或“带外”（例如在容器级别）。后一种形式在 FFmpeg 术语中称为“额外数据”。

该比特流过滤器检测带内标头并使它们可用作额外数据。

remove

启用此选项后，长期标头将在提取后从比特流中删除。

13.9 filter_units

从流中删除类型属于或不属于给定集合的单元。

pass_types

删除所有其他内容时要通过的单位类型或单位类型范围的列表。这被指定为以“|”分隔的单位类型值列表或带有“-”的值范围。

remove_types

相同通行证类型，除了给定集合中的单位被删除并且所有其他单位都通过。

此转换不会改变额外数据，但请注意，如果流包含内联参数集，则删除它们后输出可能无法使用。

例如，要从 H.264 流中删除所有非 VCL NAL 单元：

ffmpeg -i INPUT -c:v copy -bsf:v 'filter_units=pass_types=1-5' OUTPUT

要从 H.265 流中删除所有 AUD、SEI 和填充符：

ffmpeg -i INPUT -c:v copy -bsf:v 'filter_units=remove_types=35|38-40' OUTPUT

13.10 hapqa_extract

提取 HAPQA 文件的 Rgb 或 Alpha 部分，无需重新压缩，以创建 HAPQ 或 HAPAlphaOnly 文件。

texture

指定要保留的纹理。

color

alpha

将 HAPQA 转换为 HAPQ

ffmpeg -i hapqa_inputfile.mov -c copy -bsf:v hapqa_extract=texture=color -tag:v HapY -metadata:s:v:0 encoder="HAPQ" hapq_file.mov

将 HAPQA 转换为 HAPAlphaOnly

ffmpeg -i hapqa_inputfile.mov -c copy -bsf:v hapqa_extract=texture=alpha -tag:v HapA -metadata:s:v:0 encoder="HAPAlpha Only" hapalphaonly_file.mov

13.11 h264_metadata

修改 H.264 流中嵌入的元数据。

aud

在流的所有访问单元中插入或删除 AUD NAL 单元。

‘pass’

‘insert’

‘remove’

默认为通过。

sample_aspect_ratio

在 VUI 参数中设置流的样本宽高比。参见 H.264 表 E-1。

overscan_appropriate_flag

设置流是否适合使用过扫描显示（参见 H.264 第 E.2.1 节）。

video_format

video_full_range_flag

设置流中的视频格式（请参阅 H.264 第 E.2.1 节和表 E-2）。

colour_primaries

transfer_characteristics

matrix_coefficients

设置流中的颜色描述（请参阅 H.264 第 E.2.1 节和表 E-3、E-4 和 E-5）。

chroma_sample_loc_type

设置流中的色度样本位置（请参阅 H.264 第 E.2.1 节和图 E-1）。

tick_rate

在 VUI 参数中设置刻度率 (time_scale / num_units_in_tick)。这是流中可表示的最小时间单位，并且在许多情况下表示流的场速率（帧速率的两倍）。

fixed_frame_rate_flag

设置流是否具有固定帧速率 - 通常这表示帧速率恰好是节拍速率的一半，但确切含义取决于隔行扫描和图像结构（请参阅 H.264 第 E.2.1 节和表 E-6）。

zero_new_constraint_set_flags

SPS中的constraint_set4_flag和constraint_set5_flag为零。这些位在 H.264 规范的早期版本中保留，因此某些硬件解码器要求这些位为零。将其归零的结果仍然是有效的比特流。

crop_left

crop_right

crop_top

crop_bottom

在 SPS 中设置帧裁剪偏移。如果流已被裁剪，这些值将替换当前值。

这些字段以像素为单位设置。请注意，如果对色度进行二次采样或对流进行隔行扫描，则某些大小可能无法表示（请参阅 H.264 第 7.4.2.1.1 节）。

sei_user_data

插入字符串作为 SEI 未注册用户数据。参数必须采用UUID+string形式，其中 UUID 是可能用连字符分隔的十六进制数字，并且字符串可以是任何内容。

例如， '086f3693-b7b3-4f2c-9653-21492feee5b8+你好' 将插入与给定 UUID 关联的字符串“hello”。

delete_filler

删除填充 NAL 单元和填充 SEI 消息。

display_orientation

插入、提取或删除显示方向 SEI 消息。有关语法和语义，请参阅 H.264 第 D.1.27 和 D.2.27 节。

‘pass’

‘insert’

‘remove’

‘extract’

默认为通过。

rotate插入模式与和选项结合使用flip。任何预先存在的显示方向消息都将在插入或删除模式下删除。提取模式将显示矩阵作为辅助数据附加到数据包中。

rotate

设置显示方向 SEI 的旋转（逆时针角度，以度为单位）。范围为 -360 至 +360。默认为 NaN。

flip

设置显示方向 SEI 翻转。

‘horizontal’

‘vertical’

默认值未设置。

level

在 SPS 中设置级别。请参阅 H.264 第 A.3 节和表 A-1 至 A-5。

参数必须是级别的名称（例如，'4.2'），一个 level_idc 值（例如，'42'), 或特殊名称 '汽车' 指示过滤器应尝试从输入流属性中猜测级别。