ffplay 文档

目录

1 概要

ffplay [选项] [输入网址]

2 说明

FFplay 是一个非常简单且便携式的媒体播放器，使用 FFmpeg 库和 SDL 库。它主要用作各种 FFmpeg API 的测试平台。

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

-x width

强制显示宽度。

-y height

强制显示高度。

-fs

以全屏模式启动。

-an

禁用音频。

-vn

禁用视频。

-sn

禁用字幕。

-ss pos

寻找pos。请注意，在大多数格式中不可能精确查找，因此ffplay将查找距离 pos最近的查找点。

pos必须是持续时间规范，请参阅ffmpeg-utils(1) 手册中的 (ffmpeg-utils)持续时间部分。

-t duration

音频/视频的 播放持续时间秒。

持续时间必须是持续时间规范，请参阅ffmpeg-utils(1) 手册中的 (ffmpeg-utils)持续时间部分。

-bytes

按字节查找。

-seek_interval

设置使用左/右键查找的自定义间隔（以秒为单位）。默认值为 10 秒。

-nodisp

禁用图形显示。

-noborder

无边框窗口。

-alwaysontop

窗口始终在顶部。适用于：SDL >= 2.0.5 的 X11、Windows SDL >= 2.0.6。

-volume

设置启动音量。0表示静音，100表示​​不降低或放大音量。负值被视为 0，大于 100 的值被视为 100。

-f fmt

强制格式化。

-window_title title

设置窗口标题（默认为输入文件名）。

-left title

设置窗口左侧的 x 位置（默认为居中窗口）。

-top title

设置窗口顶部的 y 位置（默认为居中窗口）。

-loop number

循环播放影片 <number> 次。0表示永远。

-showmode mode

设置要使用的显示模式。模式的可用值为：

‘0, video’

显示视频

‘1, waves’

显示音频波

‘2, rdft’

使用 RDFT（（逆）实数离散傅里叶变换）显示音频频段

默认值为“video”，如果视频不存在或无法播放，则自动选择“rdft”。

您可以通过按w键以交互方式循环显示可用的显示模式。

-vf filtergraph

创建filtergraph指定的filtergraph并用它来过滤视频流。

filtergraph是对应用于流的filtergraph 的描述，并且必须具有单个视频输入和单个视频输出。在过滤器图中，输入与 label 关联 in，输出与 label 关联out。有关 filtergraph 语法的更多信息，请参阅 ffmpeg-filters 手册。

您可以多次指定此参数，并通过按w键循环显示指定的过滤图和显示模式。

-af filtergraph

filtergraph是应用于输入音频的filtergraph 的描述。使用选项“-filters”显示所有可用的过滤器（包括源和接收器）。

-i input_url

读取input_url。

3.5 Advanced options

-stats

打印一些播放统计信息，特别是显示流持续时间、编解码器参数、流中的当前位置以及音频/视频同步漂移。默认显示，除非日志级别低于info。可以通过手动指定此选项来强制显示它。要禁用它，您需要指定-nostats.

-fast

不符合规范的优化。

-genpts

生成积分。

-sync type

将主时钟设置为音频 ( type=audio)、视频 ( type=video) 或外部 ( type=ext)。默认为音频。主时钟用于控制音视频同步。大多数媒体播放器使用音频作为主时钟，但在某些情况下（流媒体或高质量广播）有必要更改它。该选项主要用于调试目的。

-ast audio_stream_specifier

使用给定的流说明符选择所需的音频流。流说明符在流说明符一章中进行了描述。如果未指定此选项，则在已选择的视频流的节目中选择“最佳”音频流。

-vst video_stream_specifier

使用给定的流说明符选择所需的视频流。流说明符在流说明符一章中进行了描述。如果未指定此选项，则选择“最佳”视频流。

-sst subtitle_stream_specifier

使用给定的流说明符选择所需的字幕流。流说明符在流说明符一章中进行了描述。如果未指定该选项，则在已选择的视频或音频流的节目中选择“最佳”字幕流。

-autoexit

视频播放完毕后退出。

-exitonkeydown

按任意键退出。

-exitonmousedown

如果按下任何鼠标按钮则退出。

-codec:media_specifier codec_name

强制对media_specifier标识的流执行特定的解码器实现 ，该解码器可以采用值a（音频）、 v（视频）和s字幕。

-acodec codec_name

强制使用特定的音频解码器。

-vcodec codec_name

强制使用特定的视频解码器。

-scodec codec_name

强制使用特定的字幕解码器。

-autorotate

根据文件元数据自动旋转视频。默认启用，使用-不自动旋转禁用它。

-framedrop

如果视频不同步，则丢弃视频帧。如果主时钟未设置为视频，则默认启用。使用此选项可为所有主时钟源启用帧丢弃，使用-noframedrop禁用它。

-infbuf

不要限制输入缓冲区大小，尽快从输入中读取尽可能多的数据。默认情况下为实时流启用，如果不及时读取数据可能会丢失。使用此选项可为所有输入启用无限缓冲区，使用-noinfbuf禁用它。

-filter_threads nb_threads

定义使用多少个线程来处理过滤器管道。每个管道都会生成一个线程池，其中有这么多线程可用于并行处理。默认值为 0，这意味着线程计数将由可用 CPU 的数量决定。

-enable_vulkan

使用 vulkan 渲染器而不是 SDL 内置渲染器。取决于 libplacebo。

-vulkan_params

Vulkan 配置使用由“:”分隔的键=值对列表。

-hwaccel

使用硬件加速解码。启用此选项将自动启用 vulkan 渲染器。

3.6 While playing

q, ESC

辞职。

f

切换全屏。

p, SPC

暂停。

m

切换静音。

9, 0

/, *

分别减少和增加音量。

a

循环当前节目中的音频通道。

v

循环视频频道。

t

在当前节目中循环字幕频道。

c

循环程序。

w

循环视频过滤器或显示模式。

s

进入下一帧。

如果流尚未暂停，则暂停，跳到下一个视频帧，然后暂停。

left/right

向后/向前搜索 10 秒。

down/up

向后/向前搜索 1 分钟。

page down/page up

查找上一章/下一章。或者如果没有章节 向后/向前搜索 10 分钟。

right mouse click

查找文件中与宽度分数相对应的百分比。

left mouse double-click

切换全屏。

4 语法

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

4.1 Quoting and escaping

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

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

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

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

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

4.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
  

4.2 Date

可接受的语法是：

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

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

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

4.3 Time duration

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

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

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

或者

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

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

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

4.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秒

4.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

4.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

4.6 Ratio

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

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

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

4.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

4.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。

5 表达评估

当评估算术表达式时，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

6 种编解码器选项

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无法从命令行更改。此外，硬件解码器不会应用左/上裁剪。

7 个解码器

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

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

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

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

8 个视频解码器

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

8.1 av1

AOMedia 视频 1 (AV1) 解码器。

8.1.1 选项

operating_point

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

8.2 rawvideo

原始视频解码器。

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

8.2.1 选项

top top_field_first

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

-1

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

0

假设底场优先

1

假设顶场优先

8.3 libdav1d

dav1d AV1 解码器。

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

8.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。

8.4 libdavs2

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

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

8.5 libuavs3d

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

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

8.5.1 选项

libuavs3d 包装器支持以下选项。

frame_threads

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

8.6 QSV Decoders

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

8.6.1 常用选项

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

async_depth

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

gpu_copy

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

‘default’

‘on’

‘off’

8.6.2 HEVC 选项

hevc_qsv 的额外选项。

load_plugin

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

‘none’

‘hevc_sw’

‘hevc_hw’

load_plugins

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

8.7 v210

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

8.7.1 选项

custom_stride

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

9 个音频解码器

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

9.1 ac3

AC-3 音频解码器。

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

9.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。响亮的声音被完全压缩。柔和的声音得到增强。

9.2 flac

FLAC 音频解码器。

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

9.2.1 FLAC 解码器选项

-use_buggy_lpc

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

9.3 ffwavesynth

内波合成器。

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

9.4 libcelt

libcelt 解码器包装器。

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

9.5 libgsm

libgsm 解码器包装器。

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

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

9.6 libilbc

libilbc 解码器包装器。

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

9.6.1 选项

libilbc 包装器支持以下选项。

enhance

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

9.7 libopencore-amrnb

libopencore-amrnb 解码器包装器。

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

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

9.8 libopencore-amrwb

libopencore-amrwb 解码器包装器。

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

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

9.9 libopus

libopus 解码器包装器。

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

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

10个字幕解码器

10.1 libaribb24

ARIB STD-B24 字幕解码器。

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

10.1.1 libaribb24 解码器选项

-aribb24-base-path path

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

默认情况下取消设置。

-aribb24-skip-ruby-text boolean

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

默认启用。

10.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 解码器优先。

10.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 拉伸或收缩为指定的大小。

10.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

10.3 dvbsub

10.3.1 选项

compute_clut

-2

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

-1

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

0

从不计算 CLUT

1

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

dvb_substream

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

10.4 dvdsub

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

10.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。

10.5 libzvbi-teletext

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

10.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。

11 比特流过滤器

当您配置 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

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

11.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 及相关格式。

11.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。

11.3 chomp

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

11.4 dca_core

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

11.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

11.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 节

11.7 eac3_core

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

11.8 extract_extradata

提取带内额外数据。

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

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

remove

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

11.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

11.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

11.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'), 或特殊名称 '汽车' 指示过滤器应尝试从输入流属性中猜测级别。

11.12 h264_mp4toannexb

将 H.264 比特流从长度前缀模式转换为起始码前缀模式（如 ITU-T H.264 规范的附件 B 中定义）。

这是某些流格式所必需的，通常是 MPEG-2 传输流格式（复用器mpegts）。

例如，要将包含 H.264 流的 MP4 文件重新复用为 mpegts 格式ffmpeg，您可以使用以下命令：

ffmpeg -i INPUT.mp4 -codec copy -bsf:v h264_mp4toannexb OUTPUT.ts

mpegts请注意，此过滤器是针对 MPEG-TS（复用器）和原始 H.264（复用器h264）输出格式 自动插入的 。

11.13 h264_redundant_pps

这对某些蓝光流应用了特定的修复，这些蓝光流包含冗余 PPS，修改流的不相关参数，从而混淆需要正确额外数据的其他转换。

11.14 hevc_metadata

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

aud

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

‘insert’

‘remove’

sample_aspect_ratio

在 VUI 参数中设置流中的样本宽高比。

video_format

video_full_range_flag

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

colour_primaries

transfer_characteristics

matrix_coefficients

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

chroma_sample_loc_type

设置流中的色度样本位置（参见 H.265 第 E.3.1 节和图 E.1）。

tick_rate

在 VPS 和 VUI 参数 (time_scale / num_units_in_tick) 中设置滴答率。结合num_ticks_poc_diff_one，这可以在流中设置恒定的帧速率。请注意，当流位于容器中时，它可能会被容器参数覆盖。

num_ticks_poc_diff_one

在VPS和VUI中设置poc_proportional_to_timing_flag并使用该值设置num_ticks_poc_diff_one_minus1（参见H.265第7.4.3.1节和E.3.1节）。忽略如果滴答率也没有设置。

crop_left

crop_right

crop_top

crop_bottom

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

这些字段以像素为单位设置。请注意，如果对色度进行二次采样，某些尺寸可能无法表示（H.265 第 7.4.3.2.1 节）。

level

设置 VPS 和 SPS 中的级别。参见 H.265 A.4 节以及表 A.6 和 A.7。

参数必须是级别的名称（例如，'5.1'）， general_level_idc值（例如，'153' 对于级别 5.1)，或特殊名称 '汽车' 指示过滤器应尝试从输入流属性中猜测级别。