ffprobe 文档

目录

1 概要

ffprobe [选项] 输入_url

2 描述

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

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

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

如果没有使用 o 指定输出，ffprobe 将写入标准输出。

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

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

ffprobe 输出被设计为易于被文本过滤器解析，并且由一个或多个由选定的编写器定义的格式部分组成，该编写器由 输出_格式 选项指定。

节可以包含其他嵌套节，并由名称（可能与其他节共享）和唯一名称标识。请参阅 sections 的输出。

存储在容器或流中的元数据标签将被识别并打印在相应的“FORMAT”、“STREAM”、“STREAM_GROUP_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。

接受参数的选项支持一种特殊的语法，其中命令行上给定的参数被解释为从中加载实际参数值的文件路径。要使用此功能，请在选项名称之前（在起始破折号之后）立即添加正斜杠“/”。例如

ffmpeg -i INPUT -/filter:v filter.script OUTPUT

将从名为 filter.script 的文件中加载滤镜图描述。

3.1 流指定符

某些选项是按流应用的，例如比特率或编解码器。流指定符用于精确指定给定选项属于哪个或哪些流。

流指定符是一个字符串，通常附加到选项名称，并用冒号分隔。例如，-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[:附加_流_指定符]

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

g:组_指定符[:附加_流_指定符]

匹配属于具有指定符 组_指定符 的组的流。如果使用 附加_流_指定符，则它匹配既是组的一部分又匹配 附加_流_指定符 的流。组_指定符 可以是以下之一

group_index

匹配具有此组索引的流。

#group_id 或 i:group_id

匹配具有此组 ID 的流。

p:程序_id[:附加_流_指定符]

匹配属于 ID 为 程序_id 的程序的流。如果使用 附加_流_指定符，则它匹配既是程序的一部分又匹配 附加_流_指定符 的流。

#流_id 或 i:流_id

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

m:键[:值]

匹配具有指定值的元数据标签 键 的流。如果未给出 值，则匹配包含具有任何值的给定标签的流。键 或 值 中的冒号字符“:”需要使用反斜杠转义。

disp:处置[:附加_流_指定符]

匹配具有给定处置的流。处置 是一个或多个使用“+”连接的处置（如 -dispositions 选项打印的）的列表。

u

匹配具有可用配置的流，必须定义编解码器，并且必须存在诸如视频尺寸或音频采样率之类的基本信息。

请注意，在 ffmpeg 中，按元数据匹配仅对输入文件正常工作。

3.2 通用选项

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

-L

显示许可证。

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

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

arg 的可能值为

long

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

full

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

decoder=解码器_名称

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

encoder=编码器_名称

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

demuxer=解复用器_名称

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

muxer=复用器_名称

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

filter=过滤器_名称

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

bsf=比特流_过滤器_名称

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

protocol=协议_名称

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

-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

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

可选的 flags 前缀可以包含以下值

‘repeat’

指示不应将重复的日志输出压缩到第一行，并且将省略“最后一条消息重复 n 次”行。

‘level’

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

也可以单独使用标志，方法是添加 “+”/“-” 前缀来设置/重置单个标志，而不会影响其他 flags 或更改 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 前缀标志或 loglevel 状态的情况下启用重复的日志输出

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）。

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

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

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

-hide_banner

禁止打印横幅。

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

-cpuflags flags（全局）

允许设置和清除 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（全局）

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

ffmpeg -cpucount 2

-max_alloc bytes

设置 ffmpeg 的 malloc 函数族在堆上分配块的最大大小限制。使用此选项时请极其谨慎。如果您不完全理解这样做可能造成的后果，请不要使用。默认值为 INT_MAX。

3.3 AVOptions

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

通用 (generic)

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

私有 (private)

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

例如，要将 ID3v2.3 标头而不是默认的 ID3v2.4 写入 MP3 文件，请使用 MP3 混流器的 id3v2_version 私有选项。

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

所有编解码器 AVOptions 都是按流设置的，因此应将流指定符附加到它们。

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 的比特率。

注意：-nooption 语法不能用于布尔 AVOptions，请使用 -option 0/-option 1。

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

3.4 主要选项

-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_options 指定要传递给写入器的选项。

例如，要以 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_packets 结合使用，将转储数据包的数据。与 -show_streams 结合使用，将转储编解码器附加数据。

转储以 "data" 字段的形式打印。它可能包含换行符。

-show_data_hash algorithm

显示有效负载数据的哈希值，对于使用 -show_packets 的数据包，以及使用 -show_streams 的编解码器附加数据。

-show_error

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

错误信息将打印在名为 "ERROR" 的节中。

-show_format

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

所有容器格式信息都打印在名为 "FORMAT" 的节中。

-show_format_entry name

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

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

-show_entries section_entries

设置要显示的条目列表。

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

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

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

形式语法由以下内容给出

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”节中的编解码器类型，请指定参数

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_stream_groups

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

每个媒体流信息都打印在名为 "STREAM_GROUP_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
  

• 在查找位置 01:23 后仅读取 42 个数据包

  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_program_version 和 -show_library_versions 选项。

-show_pixel_formats

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

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

-show_optional_fields value

一些写入器（例如 JSON 和 XML）会省略打印具有无效或不适用值的字段，而其他写入器始终会打印它们。此选项使您可以控制此行为。有效值为 always/1、never/0 和 auto/-1。默认值为 auto。

-analyze_frames

分析帧和/或它们的辅助数据，直到提供的读取间隔，提供可能在流级别有用的附加信息。必须与 -show_streams 选项配对使用，否则将不起作用。

当前，启用此选项时提供的附加字段是 closed_captions 和 film_grain 字段。

例如，分析前 20 秒并填充这些字段

ffprobe -show_streams -analyze_frames -read_intervals "%+20" INPUT

-bitexact

强制位精确输出，有助于生成不依赖于特定构建的输出。

-i input_url

读取 input_url。

-o output_url

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

4 写入器

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

写入器可以接受一个或多个参数，这些参数指定要采用的选项。这些选项指定为以“:”分隔的 key=value 对列表。

所有写入器都支持以下选项

string_validation，sv

设置字符串验证模式。

接受以下值。

‘fail’

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

‘ignore’

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

‘replace’

写入器将用 string_validation_replacement 指定的字符串替换无效的 UTF-8 序列或代码点。

默认值为 ‘replace’。

string_validation_replacement，svr

设置在 string_validation 设置为 ‘replace’ 时使用的替换字符串。

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

下面是当前可用的写入器的说明。

4.1 默认

默认格式。

以以下形式打印每个部分

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

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

下面是接受选项的说明。

nokey，nk

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

noprint_wrappers，nw

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

4.2 紧凑, csv

紧凑和 CSV 格式。

csv 写入器等效于 compact，但支持不同的默认值。

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

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

元数据标记打印在相应的“format”或“stream”部分中。如果打印了元数据标记键，则以字符串“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 转换为 ‘\SEP’。

csv

按照 RFC4180 中的描述执行类似 CSV 的转义。包含换行符（‘\n’）、回车符（‘\r’）、双引号（‘"’）或 SEP 的字符串用双引号括起来。

none

不执行转义。

print_section，p

如果值为 1，则在每行开头打印节名称；如果值设置为 0，则禁用此功能。默认值为 1。

4.3 扁平

平面格式。

自由格式输出，其中每行包含一个显式的键=值，例如 "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’ 和以下字符会被转义
• ‘\’ 是转义字符
• ‘#’ 是注释指示符
• ‘=’ 是键/值分隔符
• ‘:’ 不使用，但通常被解析为键/值分隔符

此编写器接受选项，选项形式为 key=value 对列表，并以 ‘:’ 分隔。

下面是接受选项的说明。

hierarchical, h

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

默认值为 1。

4.5 json

基于 JSON 的格式。

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

下面是接受选项的说明。

compact, c

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

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

4.6 xml

基于 XML 的格式。

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

该模式的更新版本可以从 URL http://www.ffmpeg.org/schema/ffprobe.xsd 获取，该 URL 会重定向到 FFmpeg 开发源代码树中提交的最新模式。

请注意，只有在没有指定特殊的全局输出选项（unit、prefix、byte_binary_prefix、sexagesimal 等）时，发出的输出才符合 ffprobe.xsd 模式。

下面是接受选项的说明。

fully_qualified, q

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

xsd_strict, x

如果设置为 1，则执行更多检查以确保输出符合 XSD。默认值为 0。此选项会自动将 fully_qualified 设置为 1。

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

5 时间码

ffprobe 支持时间码提取

• MPEG1/2 时间码从 GOP 中提取，并在视频流详细信息中可用（-show_streams，请参阅 timecode）。
• MOV 时间码从 tmcd 轨道提取，因此在 tmcd 流元数据中可用（-show_streams，请参阅 TAG:timecode）。
• DV、GXF 和 AVI 时间码在格式元数据中可用（-show_format，请参阅 TAG:timecode）。

6 语法

本节介绍了 FFmpeg 库和工具使用的语法和格式。

6.1 引号和转义

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

• ‘'’ 和 ‘\’ 是特殊字符（分别用于引号和转义）。此外，根据使用转义和引号的特定语法，可能还存在其他特殊字符。
• 特殊字符通过在其前面添加 ‘\’ 来转义。
• 所有用 ‘''’ 引起来的字符都按字面形式包含在解析后的字符串中。引号字符 ‘'’ 本身不能被引用，因此你可能需要关闭引号并转义它。
• 除非转义或引用，否则从解析的字符串中删除前导和尾随空格。

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

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

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

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 日期

接受的语法是

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

如果值为 “now”，则表示当前时间。

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

6.3 时间持续

有两种接受的语法用于表示持续时间。

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

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

或者

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

S 表示秒数，带有可选的小数部分 m。可选的字面后缀 ‘s’、‘ms’ 或 ‘us’ 表示将值分别解释为秒、毫秒或微秒。

在两种表达式中，可选的 ‘-’ 表示负持续时间。

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 视频尺寸

指定源视频的大小，它可以是 宽度x高度 形式的字符串，也可以是大小缩写的名称。

识别以下缩写

‘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 视频速率

指定视频的帧率，表示为每秒生成的帧数。它必须是 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 比率

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

请注意，无限值（1/0）或负值的比率被认为是有效的，因此如果您想排除这些值，则应检查返回值。

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

6.7 颜色

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

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

字符串 ‘random’ 将生成一个随机颜色。

以下颜色名称是被识别的

‘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’

0xDCDCDC

‘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 声道布局

通道布局指定多通道音频流中通道的空间布置。 要指定通道布局，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

‘9.1.6’

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

‘hexadecagonal’

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

‘binaural’

BIL+BIR

‘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’，‘LFE’等），每个名称可以选择在 “@” 之后包含自定义名称（例如， ‘FL@Left’，‘FR@Right’， ‘FC@Center’， ‘LFE@Low_Frequency’ 等）。

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

• 单个声道的名称（例如， ‘FL’，‘FR’，‘FC’， ‘LFE’ 等）。
• 标准声道布局的名称（例如，‘mono’，‘stereo’，‘4.0’，‘quad’，‘5.0’ 等）。
• 声道的数量，以十进制表示，后跟“c”，生成该声道数量的默认声道布局（请参阅函数 av_channel_layout_default）。请注意，并非所有声道计数都有默认布局。
• 声道的数量，以十进制表示，后跟“C”，生成具有指定数量声道的未知声道布局。请注意，并非所有声道布局规范字符串都支持未知声道布局。
• 声道布局掩码，以 “0x” 开头的十六进制表示（请参阅 libavutil/channel_layout.h 中的 AV_CH_* 宏）。

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

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

7 表达式求值

在计算算术表达式时，FFmpeg 使用内部公式计算器，该计算器通过 libavutil/eval.h 接口实现。

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

可以将两个表达式 expr1 和 expr2 组合形成另一个表达式 "expr1;expr2"。expr1 和 expr2 将依次求值，新表达式的值为 expr2 的值。

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

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

一些内部变量可用于存储和加载中间结果。可以使用 ld 和 st 函数访问它们，索引参数从 0 到 9 不等，用于指定要访问的内部变量。

以下函数可用：

abs(x)

计算 x 的绝对值。

acos(x)

计算 x 的反余弦值。

asin(x)

计算 x 的反正弦值。

atan(x)

计算 x 的反正切值。

atan2(y, x)

计算 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)

返回 x 的值，该值被限制在 min 和 max 之间。

cos(x)

计算 x 的余弦值。

cosh(x)

计算 x 的双曲余弦值。

eq(x, y)

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

exp(x)

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

floor(expr)

将表达式 expr 的值向下舍入到最接近的整数。例如，“floor(-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(idx)

加载索引为 idx 的内部变量的值，该值先前已使用 st(idx, 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)

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

random(idx)

返回介于 0.0 和 1.0 之间的伪随机值。idx 是用于保存种子/状态的内部变量的索引，该种子/状态可以使用 st(idx) 预先存储。

要初始化种子，您需要将种子值作为 64 位无符号整数存储在索引为 idx 的内部变量中。

例如，要在索引为 0 的内部变量中存储种子值 42 并打印一些随机值

st(0,42); print(random(0)); print(random(0)); print(random(0))

randomi(idx, min, max)

返回介于 min 和 max 之间的伪随机值。idx 是内部变量的索引，该内部变量将用于保存种子/状态，该种子/状态可以使用 st(idx) 预先存储。

要初始化种子，您需要将种子值作为 64 位无符号整数存储在索引为 idx 的内部变量中。

root(expr, max)

在 0..max 区间内，查找使以 ld(0) 为参数的 expr 所代表的函数值为 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(idx, expr)

将表达式 expr 的值存储在内部变量中。idx 指定要存储值的变量的索引，其取值范围为 0 到 9。该函数返回存储在内部变量中的值。

可以使用 ld(var) 检索存储的值。

注意：变量当前不在表达式之间共享。

tan(x)

计算 x 的正切值。

tanh(x)

计算 x 的双曲正切值。

taylor(expr, x)

taylor(expr, x, idx)

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

当级数不收敛时，结果未定义。

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

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

time(0)

返回当前（实际）时间（以秒为单位）。

trunc(expr)

将表达式 expr 的值向零方向舍入到最接近的整数。例如，“trunc(-1.5)”为“-1.0”。

while(cond, expr)

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

以下常量可用

PI

单位圆盘的面积，约为 3.14

E

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

PHI

黄金分割率 (1+sqrt(5))/2，约为 1.618

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

* 的作用类似于 AND

+ 的作用类似于 OR

例如，以下构造

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 工具中指定 -option value 或通过在 AVCodecContext 选项中显式设置值，或者使用 libavutil/opt.h API 进行编程方式来设置选项。

以下是支持的选项列表

b 整数 (编码,音频,视频)

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

ab 整数 (编码,音频)

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

bt 整数 (编码,视频)

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

flags 标志 (解码/编码,音频,视频,字幕)

设置通用标志。

可能的值

‘mv4’

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

‘qpel’

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

‘loop’

使用环路滤波器。

‘qscale’

使用固定 qscale。

‘pass1’

在第一次编码模式下使用内部 2 次编码率控制。

‘pass2’

在第二次编码模式下使用内部 2 次编码率控制。

‘gray’

仅解码/编码灰度。

‘psnr’

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

‘truncated’

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

‘drop_changed’

不输出其参数与流中第一个解码帧不同的帧。当帧被丢弃时，返回错误 AVERROR_INPUT_CHANGED。

‘ildct’

使用隔行 DCT。

‘low_delay’

强制低延迟。

‘global_header’

将全局头放在 extradata 中，而不是每个关键帧中。

‘bitexact’

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

‘aic’

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

‘ilme’

应用隔行运动估计。

‘cgop’

使用封闭 GOP。

‘output_corrupt’

输出甚至可能已损坏的帧。

time_base 有理数

设置编解码器时间基准。

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

g 整数 (编码,视频)

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

ar 整数 (解码/编码,音频)

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

ac 整数 (解码/编码,音频)

设置音频通道数。

cutoff 整数 (编码,音频)

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

frame_size 整数 (编码,音频)

设置音频帧大小。

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

frame_number 整数

设置帧号。

delay 整数

qcomp 浮点数 (编码,视频)

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

qblur 浮点数 (编码,视频)

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

qmin 整数 (编码,视频)

设置最小视频量化器比例 (VBR)。必须介于 -1 和 69 之间，默认值为 2。

qmax 整数 (编码,视频)

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

qdiff 整数 (编码,视频)

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

bf 整数 (编码,视频)

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

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

默认值为 0。

b_qfactor 浮点数 (编码,视频)

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

codec_tag 整数

bug 标志 (解码,视频)

解决未自动检测到的编码器错误。

可能的值

‘autodetect’

‘xvid_ilace’

Xvid 隔行扫描错误（如果 fourcc==XVIX 则自动检测）

‘ump4’

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

‘no_padding’

填充错误（自动检测）

‘amv’

‘qpel_chroma’

‘std_qpel’

旧标准 qpel（每个 fourcc/版本自动检测）

‘qpel_chroma2’

‘direct_blocksize’

直接-qpel-块大小错误（每个 fourcc/版本自动检测）

‘edge’

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

‘hpel_chroma’

‘dc_clip’

‘ms’

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

‘trunc’

截断帧

strict 整数 (解码/编码,音频,视频)

指定严格遵守标准的程度。

可能的值

‘very’

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

‘strict’

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

‘normal’

‘unofficial’

允许非官方扩展

‘experimental’

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

b_qoffset 浮点数 (编码,视频)

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

err_detect 标志 (解码,音频,视频)

设置错误检测标志。

可能的值

‘crccheck’

验证嵌入的 CRC

‘bitstream’

检测比特流规范偏差

‘buffer’

检测不正确的比特流长度

‘explode’

在检测到小错误时中止解码

‘ignore_err’

忽略解码错误，并继续解码。如果您想分析视频的内容，并因此希望解码所有内容，无论如何，这很有用。如果出现错误，此选项不会产生令人愉悦的观看视频。

‘careful’

将违反规范且在野外未见的内容视为错误

‘compliant’

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

‘aggressive’

将健全的编码器不应该做的事情视为错误

has_b_frames 整数

block_align 整数

rc_override_count 整数

maxrate 整数 (编码,音频,视频)

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

minrate 整数 (编码,音频,视频)

设置最小比特率容差（单位为 比特/秒）。在设置 CBR 编码时最有用。否则，用处不大。

bufsize 整数 (编码,音频,视频)

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

i_qfactor 浮点数 (编码,视频)

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

i_qoffset 浮点数 (编码,视频)

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

dct 整数 (编码,视频)

设置 DCT 算法。

可能的值

‘auto’

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

‘fastint’

快速整数

‘int’

精确整数

‘mmx’

‘altivec’

‘faan’

浮点 AAN DCT

lumi_mask 浮点数 (编码,视频)

压缩比中等区域更亮的区域。

tcplx_mask float (编码,视频)

设置时间复杂度掩蔽。

scplx_mask float (编码,视频)

设置空间复杂度掩蔽。

p_mask float (编码,视频)

设置帧间掩蔽。

dark_mask float (编码,视频)

对黑暗区域的压缩比中等区域更强。

idct integer (解码/编码,视频)

选择 IDCT 实现。

可能的值

‘auto’

‘int’

‘simple’

‘simplemmx’

‘simpleauto’

自动选择与 simple 版本兼容的 IDCT

‘arm’

‘altivec’

‘sh4’

‘simplearm’

‘simplearmv5te’

‘simplearmv6’

‘simpleneon’

‘xvid’

‘faani’

浮点 AAN IDCT

slice_count integer

ec flags (解码,视频)

设置错误隐藏策略。

可能的值

‘guess_mvs’

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

‘deblock’

对损坏的宏块使用强去块滤波器

‘favor_inter’

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

bits_per_coded_sample integer

aspect 有理数 (编码,视频)

设置样本宽高比。

sar 有理数 (编码,视频)

设置样本宽高比。是 aspect 的别名。

debug flags (解码/编码,音频,视频,字幕)

打印特定的调试信息。

可能的值

‘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 (编码,视频)

设置全像素运动估计比较函数。

可能的值

‘sad’

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

‘sse’

平方误差之和

‘satd’

绝对哈达玛变换差之和

‘dct’

绝对 DCT 变换差之和

‘psnr’

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

‘bit’

块所需的比特数

‘rd’

率失真最优，慢

‘zero’

0

‘vsad’

绝对垂直差之和

‘vsse’

平方垂直差之和

‘nsse’

噪声保留平方差之和

‘w53’

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

‘w97’

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

‘dctmax’

‘chroma’

subcmp integer (编码,视频)

设置子像素运动估计比较函数。

可能的值

‘sad’

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

‘sse’

平方误差之和

‘satd’

绝对哈达玛变换差之和

‘dct’

绝对 DCT 变换差之和

‘psnr’

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

‘bit’

块所需的比特数

‘rd’

率失真最优，慢

‘zero’

0

‘vsad’

绝对垂直差之和

‘vsse’

平方垂直差之和

‘nsse’

噪声保留平方差之和

‘w53’

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

‘w97’

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

‘dctmax’

‘chroma’

mbcmp integer (编码,视频)

设置宏块比较函数。

可能的值

‘sad’

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

‘sse’

平方误差之和

‘satd’

绝对哈达玛变换差之和

‘dct’

绝对 DCT 变换差之和

‘psnr’

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

‘bit’

块所需的比特数

‘rd’

率失真最优，慢

‘zero’

0

‘vsad’

绝对垂直差之和

‘vsse’

平方垂直差之和

‘nsse’

噪声保留平方差之和

‘w53’

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

‘w97’

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

‘dctmax’

‘chroma’

ildctcmp integer (编码,视频)

设置隔行 DCT 比较函数。

可能的值

‘sad’

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

‘sse’

平方误差之和

‘satd’

绝对哈达玛变换差之和

‘dct’

绝对 DCT 变换差之和

‘psnr’

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

‘bit’

块所需的比特数

‘rd’

率失真最优，慢

‘zero’

0

‘vsad’

绝对垂直差之和

‘vsse’

平方垂直差之和

‘nsse’

噪声保留平方差之和

‘w53’

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

‘w97’

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

‘dctmax’

‘chroma’

dia_size integer (编码,视频)

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

‘(1024, INT_MAX)’

全运动估计（最慢）

‘(768, 1024]’

umh 运动估计

‘(512, 768]’

十六进制运动估计

‘(256, 512]’

l2s 菱形运动估计

‘[2,256]’

可变菱形运动估计

‘(-1, 2)’

小菱形运动估计

‘-1’

有趣菱形运动估计

‘(INT_MIN, -1)’

sab 菱形运动估计

last_pred integer (编码,视频)

设置来自前一帧的运动预测器的数量。

precmp integer (编码,视频)

设置预运动估计比较函数。

可能的值

‘sad’

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

‘sse’

平方误差之和

‘satd’

绝对哈达玛变换差之和

‘dct’

绝对 DCT 变换差之和

‘psnr’

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

‘bit’

块所需的比特数

‘rd’

率失真最优，慢

‘zero’

0

‘vsad’

绝对垂直差之和

‘vsse’

平方垂直差之和

‘nsse’

噪声保留平方差之和

‘w53’

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

‘w97’

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

‘dctmax’

‘chroma’

pre_dia_size integer (编码,视频)

设置用于运动估计预先传递的菱形类型和大小。

subq integer (编码,视频)

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

me_range integer (编码,视频)

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

global_quality integer (编码,音频,视频)

slice_flags integer

mbd integer (编码,视频)

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

可能的值

‘simple’

使用 mbcmp (默认)

‘bits’

使用最少比特

‘rd’

使用最佳率失真

rc_init_occupancy integer (编码,视频)

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

flags2 flags (解码/编码,音频,视频,字幕)

可能的值

‘fast’

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

‘noout’

跳过比特流编码。

‘ignorecrop’

忽略来自 sps 的裁剪信息。

‘local_header’

将全局头放在每个关键帧处而不是在 extradata 中。

‘chunks’

帧数据可能会拆分成多个块。

‘showall’

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

‘export_mvs’

将运动矢量导出到帧边数据（请参阅 AV_FRAME_DATA_MOTION_VECTORS）以供支持的编解码器使用。另请参阅 doc/examples/export_mvs.c。

‘skip_manual’

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

‘ass_ro_flush_noop’

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

‘icc_profiles’

从/向色度标签生成/解析嵌入式 ICC 配置文件。

export_side_data flags (解码/编码,音频,视频,字幕)

可能的值

‘mvs’

将运动矢量导出到帧边数据（请参阅 AV_FRAME_DATA_MOTION_VECTORS）以供支持的编解码器使用。另请参阅 doc/examples/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 解码器支持。

‘enhancements’

通过帧边数据导出图像增强元数据，例如 LCEVC（请参阅 AV_FRAME_DATA_LCEVC）。

threads integer (解码/编码,视频)

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

可能的值

‘auto, 0’

自动选择要设置的线程数

默认值为 ‘auto’。

dc integer (编码,视频)

设置 intra_dc_precision。

nssew integer (编码,视频)

设置 nsse 权重。

skip_top integer (解码,视频)

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

skip_bottom integer (解码,视频)

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

profile integer (编码,音频,视频)

设置编码器编解码器配置文件。默认值为“unknown”。编码器特定的配置文件在相关的编码器文档中记录。

level 整数 (编码，音频，视频)

设置编码器级别。此级别取决于特定的编解码器，可能与配置文件级别相对应。默认设置为“unknown”。

可能的值

“unknown”

lowres 整数 (解码，音频，视频)

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

mblmin 整数 (编码，视频)

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

mblmax 整数 (编码，视频)

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

skip_loop_filter 整数 (解码，视频)

skip_idct 整数 (解码，视频)

skip_frame 整数 (解码，视频)

根据选项值选择的帧类型，使解码器放弃处理。

skip_loop_filter 跳过帧循环滤波，skip_idct 跳过帧 IDCT/反量化，skip_frame 跳过解码。

可能的值

“none”

不丢弃任何帧。

“default”

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

“noref”

丢弃所有非参考帧。

“bidir”

丢弃所有双向帧。

“nokey”

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

“nointra”

丢弃除 I 帧外的所有帧。

“all”

丢弃所有帧。

默认值为“default”。

bidir_refine 整数 (编码，视频)

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

keyint_min 整数 (编码，视频)

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

refs 整数 (编码，视频)

设置运动补偿时要考虑的参考帧。

trellis 整数 (编码，音频，视频)

设置速率失真最优量化。

mv0_threshold 整数 (编码，视频)

compression_level 整数 (编码，音频，视频)

bits_per_raw_sample 整数

channel_layout 整数 (解码/编码，音频)

有关所需的语法，请参见 (ffmpeg-utils)ffmpeg-utils(1) 手册中的通道布局部分。

rc_max_vbv_use 浮点数 (编码，视频)

rc_min_vbv_use 浮点数 (编码，视频)

color_primaries 整数 (解码/编码，视频)

可能的值

“bt709”

BT.709

“bt470m”

BT.470 M

“bt470bg”

BT.470 BG

“smpte170m”

SMPTE 170 M

“smpte240m”

SMPTE 240 M

‘film’

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 整数 (解码/编码，视频)

可能的值

“bt709”

BT.709

“gamma22”

BT.470 M

“gamma28”

BT.470 BG

“smpte170m”

SMPTE 170 M

“smpte240m”

SMPTE 240 M

“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 整数 (解码/编码，视频)

可能的值

“rgb”

RGB

“bt709”

BT.709

“fcc”

FCC

“bt470bg”

BT.470 BG

“smpte170m”

SMPTE 170 M

“smpte240m”

SMPTE 240 M

“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”

ICtCp

color_range 整数 (解码/编码，视频)

如果用作输入参数，则作为解码器的提示，表明输入具有的 color_range。可能的值

“tv”

“mpeg”

“limited”

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

“pc”

“jpeg”

“full”

JPEG (2^n-1)

chroma_sample_location 整数 (解码/编码，视频)

可能的值

“left”

“center”

“topleft”

“top”

“bottomleft”

“bottom”

log_level_offset 整数

设置日志级别偏移。

slices 整数 (编码，视频)

切片数量，用于并行编码。

thread_type 标志 (解码/编码，视频)

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

使用“frame”会使每个线程的解码延迟增加一帧，因此无法提供未来帧的客户端不应使用它。

可能的值

“slice”

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

仅当视频使用切片编码时，使用切片的多线程才起作用。

“frame”

一次解码多个帧。

默认值为“slice+frame”。

audio_service_type 整数 (编码，音频)

设置音频服务类型。

可能的值

“ma”

主音频服务

“ef”

效果

“vi”

视觉障碍

“hi”

听觉障碍

“di”

对话

“co”

评论

“em”

紧急情况

“vo”

旁白

“ka”

卡拉OK

request_sample_fmt sample_fmt (解码，音频)

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

pkt_timebase 有理数

sub_charenc 编码 (解码，字幕)

设置输入字幕字符编码。

field_order 场序 (视频)

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

“progressive”

逐行视频

“tt”

隔行视频，顶部场先编码和显示

“bb”

隔行视频，底部场先编码和显示

“tb”

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

“bt”

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

skip_alpha 布尔值 (解码，视频)

设置为 1 可禁用处理 alpha（透明度）。这类似于 flags 选项中的“gray”标志，后者会跳过色度信息而不是 alpha。默认为 0。

codec_whitelist 列表 (输入)

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

dump_separator 字符串 (输入)

用于分隔命令行中关于流参数的字段的分隔符。例如，使用换行符和缩进分隔字段

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

max_pixels 整数 (解码/编码，视频)

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

apply_cropping 布尔值 (解码，视频)

如果裁剪参数是左边和顶部参数所需对齐的倍数，则启用裁剪。如果未满足对齐要求，裁剪将部分应用以保持对齐。默认值为 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 Video 1 (AV1) 解码器。

10.1.1 选项

operating_point

选择可伸缩 AV1 比特流的操作点（0 - 31）。默认值为 0。

10.2 hevc

HEVC（又名 ITU-T H.265 或 ISO/IEC 23008-2）解码器。

该解码器支持最多包含两个视图的 MV-HEVC 多视图流。要输出的视图通过向解码器提供视图 ID 列表来选择（view_ids 选项）。此选项可以在解码器初始化之前静态设置，也可以从 get_format() 回调设置 - 当视图计数或 ID 在解码期间动态更改时很有用。

默认情况下仅解码基本层。

请注意，如果您正在使用 ffmpeg CLI 工具，您应该使用其手册中记录的视图说明符，而不是此处记录的选项。

10.2.1 选项

view_ids (MV-HEVC)

指定应输出的视图 ID 列表。此选项也可以设置为单个 '-1'，这将导致解码和输出 VPS 中定义的所有视图。

view_ids_available (MV-HEVC)

调用者可以读取此选项，以检索活动 VPS 中可用的视图 ID 数组。对于单层视频，该数组为空。

从 get_format() 回调读取时，此选项的值保证准确。它也可以在其他时间设置（例如，打开解码器后），但该值仅供参考，可能不正确（例如，当流包含多个不同的 VPS NALU 时）。

view_pos_available (MV-HEVC)

调用者可以读取此选项，以检索活动 VPS 中可用的视图位置（左、右或未指定）数组，作为 AVStereo3DView 值。当数组可用时，其元素应用于 view_ids_available 的相应元素，即 view_pos_available[i] 包含 ID 为 view_ids_available[i] 的视图的位置。

与 view_ids_available 相同的有效性限制适用于此选项。

10.3 rawvideo

原始视频解码器。

此解码器解码 rawvideo 流。

10.3.1 选项

top top_field_first

指定输入视频的假定场类型。

-1

假设视频是逐行的（默认）

0

假设为底场优先

1

假设为顶场优先

10.4 libdav1d

dav1d AV1 解码器。

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

10.4.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.5 libdavs2

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

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

10.6 libuavs3d

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

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

10.6.1 选项

libuavs3d 包装器支持以下选项。

frame_threads

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

10.7 libxevd

超快基本视频解码器 (XEVD) MPEG-5 EVC 解码器包装器。

此解码器需要在配置期间存在 libxevd 标头和库。您需要使用 --enable-libxevd 显式配置构建。

xevd 项目网站位于 https://github.com/mpeg5/xevd。

10.7.1 选项

libxevd 包装器支持以下选项。xevd 等效选项或值在括号中列出，以便于迁移。

要获取更准确和更全面的 libxevd 选项文档，请调用命令 xevd_app --help 或查阅 libxevd 文档。

threads (threads)

强制使用特定数量的线程

10.8 QSV 解码器

Intel QuickSync Video 解码器系列（VC1、MPEG-2、H.264、HEVC、JPEG/MJPEG、VP8、VP9、AV1、VVC）。

10.8.1 通用选项

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

async_depth

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

gpu_copy

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

“default”

‘on’

‘off’

10.8.2 HEVC 选项

hevc_qsv 的额外选项。

load_plugin

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

“none”

‘hevc_sw’

‘hevc_hw’

load_plugins

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

10.9 v210

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

10.9.1 选项

custom_stride

设置 v210 数据行的字节大小。默认值为 0（自动检测）。您可以对 BOXX 文件中看到的无跨距 v210 使用特殊值 -1。

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

DRC 已禁用。产生全范围音频。

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 显式配置构建。

存在一个 FFmpeg 原生 AMR-NB 解码器，因此用户可以在没有此库的情况下解码 AMR-NB。

11.8 libopencore-amrwb

libopencore-amrwb 解码器封装器。

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

存在一个 FFmpeg 原生 AMR-WB 解码器，因此用户可以在没有此库的情况下解码 AMR-WB。

11.9 libopus

libopus 解码器封装器。

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

存在一个 FFmpeg 原生 Opus 解码器，因此用户可以在没有此库的情况下解码 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 标准的配置文件 A 和 C、巴西 ABNT NBR 15606-1 和菲律宾版本的 ISDB-T。

在配置期间需要存在 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,...]

指定用于 bitmap 或 ass 类型字幕渲染的以逗号分隔的字体系列名称列表。只有第一个字体名称用于 ass 类型字幕。

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

-ass_single_rect boolean

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

指定是否忽略对 ruby 式（振假名）字符的渲染。

默认值为 false。

-replace_drcs boolean

指定是否将替换的 DRCS 字符渲染为 Unicode 字符。

默认值为 true。

-replace_msz_ascii boolean

指定是否将 MSZ（中等大小；半宽）全宽字母数字替换为半宽字母数字。

默认值为 true。

-replace_msz_japanese boolean

指定是否将一些 MSZ（中等大小；半宽）全宽日文特殊字符替换为半宽字符。

默认值为 true。

-replace_msz_glyph boolean

指定如果字体支持，是否将 MSZ（中等大小；半宽）字符替换为半宽字形。此选项在具有符合 Adobe-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 解码器使用示例

使用 ffplay 工具显示带有 ARIB 字幕的 MPEG-TS 文件

ffplay -sub_type bitmap MPEG.TS

使用 ffplay 工具显示输入帧大小为 1920x1080 的 MPEG-TS 文件

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_transparent，它只会影响开始框和结束框之间的字符，通常是字幕。如果设置了 txt_transparent，则默认值为 0，否则为 255。

13 比特流过滤器

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

您可以使用配置选项 --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