ffmpeg 文档

目录

1 纲要

ffmpeg [全局选项] {[输入文件选项] -iinput_url} ... {[输出文件选项] output_url} ...

2 描述

ffmpeg是一种通用的媒体转换器。它可以读取各种输入 —— 包括实时获取/记录设备 —— 过滤和转码它们至大量的输出格式。

ffmpeg从任意数量的输入读取（可以是常规文件、管道、网络流、抓取设备等），由-i选项指定，并写入任意数量的输出，这些输出由普通输出 URL 指定。命令行中无法解析为选项的任何内容都视为输出 URL。

每个输入或输出原则上都可以包含任意数量的不同类型的基本流（视频/音频/字幕/附件/数据），但容器格式可能限制允许的流数量和/或类型。从哪些输入选择哪个流放入哪个输出是自动完成或通过-map选项完成（参见流选择章节）。

要在选项中引用输入/输出，必须使用它们的索引（从0开始）。例如，第一个输入是0，第二个是1，等等。同样，输入/输出中的流通过其索引引用。例如，2:3指第三个输入或输出中的第四个流。另请参见流说明符章节。

作为一般规则，选项应用于下一指定的文件。因此顺序很重要，而且您可以在命令行中多次出现相同的选项。然后每个出现的选项应用于下一个输入或输出文件。 该规则的例外是全局选项（例如，详细级别），应首先指定。

不要混合输入和输出文件 —— 首先指定所有输入文件，然后指定所有输出文件。也不要混合属于不同文件的选项。所有选项仅适用于下一输入或输出文件，并且在文件之间会被重置。

以下是一些简单的示例。

• 通过重新编码媒体流，将输入的媒体文件转换为其他格式：

  ffmpeg -i input.avi output.mp4
  

• 将输出文件的视频比特率设置为64 kbit/s：

  ffmpeg -i input.avi -b:v 64k -bufsize 64k output.mp4
  

• 将输出文件的帧率强制设置为24 fps：

  ffmpeg -i input.avi -r 24 output.mp4
  

• 将输入文件的帧率（仅对原始格式有效）强制设置为1 fps，输出文件的帧率设置为24 fps：

  ffmpeg -r 1 -i input.m2v -r 24 output.mp4
  

对于原始输入文件，可能需要指定格式选项。

3 详细描述

ffmpeg构建了一个由以下列出的组件组成的转码管道。程序操作包括从输入源流入数据块，沿管道向汇点移动数据，同时经过途中的组件进行转换。

提供以下类型的组件：

• Demuxers（“解复用器”的简称）读取输入源以提取
  • 全局属性，例如元数据或章节；
  • 输入基本流及其属性的列表

  为每个-i选项创建一个解复用器实例，并发送已编码的packets到decoders或muxers.

  在其他文献中，解复用器有时被称为splitters，因为其主要功能是将文件拆分为基本流（尽管某些文件仅包含一个基本流）。

  解复用器的示意图如下：

  ┌──────────┬───────────────────────┐
  │ demuxer  │                       │ packets for stream 0
  ╞══════════╡ elementary stream 0   ├──────────────────────►
  │          │                       │
  │  global  ├───────────────────────┤
  │properties│                       │ packets for stream 1
  │   and    │ elementary stream 1   ├──────────────────────►
  │ metadata │                       │
  │          ├───────────────────────┤
  │          │                       │
  │          │     ...........       │
  │          │                       │
  │          ├───────────────────────┤
  │          │                       │ packets for stream N
  │          │ elementary stream N   ├──────────────────────►
  │          │                       │
  └──────────┴───────────────────────┘
       ▲
       │
       │ read from file, network stream,
       │     grabbing device, etc.
       │
  

• Decoders接收已编码（压缩）的packets数据，针对某个音频、视频或字幕基本流，将其解码为原始数据frames（视频为像素数组，音频为PCM）。解码器通常与一个基本流相关联（并接收其输入）demuxer，但有时也可能独立存在（参见环回解码器).

  解码器的示意图如下：

            ┌─────────┐
   packets  │         │ raw frames
  ─────────►│ decoder ├────────────►
            │         │
            └─────────┘
  

• Filtergraphs处理并转换原始音频或视频frames。由一个或多个独立的filters链接为图构成的过滤图组成。过滤图有两种类型 -simple和complex，分别由-filter和-filter_complex选项进行配置。

  一个简单的过滤图与一个output elementary stream关联；它接收待过滤的输入decoder并将过滤后的输出发送到该输出流的encoder.

  一个简单的视频过滤图进行去隔行（使用yadif去隔行滤镜）后紧接着调整大小（使用scale滤镜）的示意图如下：

               ┌────────────────────────┐
               │  simple filtergraph    │
   frames from ╞════════════════════════╡ frames for
   a decoder   │  ┌───────┐  ┌───────┐  │ an encoder
  ────────────►├─►│ yadif ├─►│ scale ├─►│────────────►
               │  └───────┘  └───────┘  │
               └────────────────────────┘
  

  复杂的过滤图是独立的，不与任何特定的流相关联。它可能有多个（或零个）输入，可能是不同类型（音频或视频）的，每个输入接收数据要么来自解码器，要么来自另一个复杂过滤图的输出。它还具有一个或多个输出，输出要么连接到编码器，要么连接到另一个复杂过滤图的输入。

  以下示例是一个具有3个输入和2个输出（全部为视频）的复杂过滤图的示意图：

            ┌─────────────────────────────────────────────────┐
            │               complex filtergraph               │
            ╞═════════════════════════════════════════════════╡
   frames   ├───────┐  ┌─────────┐      ┌─────────┐  ┌────────┤ frames
  ─────────►│input 0├─►│ overlay ├─────►│ overlay ├─►│output 0├────────►
            ├───────┘  │         │      │         │  └────────┤
   frames   ├───────┐╭►│         │    ╭►│         │           │
  ─────────►│input 1├╯ └─────────┘    │ └─────────┘           │
            ├───────┘                 │                       │
   frames   ├───────┐ ┌─────┐ ┌─────┬─╯              ┌────────┤ frames
  ─────────►│input 2├►│scale├►│split├───────────────►│output 1├────────►
            ├───────┘ └─────┘ └─────┘                └────────┤
            └─────────────────────────────────────────────────┘
  

  第二个输入的帧叠加在第一个输入的帧上。第三个输入的帧被重新调整大小，然后被复制为两个相同的流。将其中一个叠加在前两个输入组合的结果上，并将结果作为过滤图的第一个输出。另一份副本最终成为过滤图的第二个输出。

• Encoders接收原始音频、视频或字幕frames并将其编码成编码的packets。编码（压缩）过程通常是lossy有损的 - 它通过降低流的质量来减小输出的大小；某些编码器是lossless无损的，但代价是输出大小显著增加。视频或音频编码器从某个过滤图的输出中接收输入，字幕编码器从解码器接收输入（因为字幕过滤尚不支持）。每个编码器都与某个复用器的output elementary stream相关联，并将其输出发送给该复用器。

  编码器的示意图如下：

               ┌─────────┐
   raw frames  │         │ packets
  ────────────►│ encoder ├─────────►
               │         │
               └─────────┘
  

• Muxers（“复用器”的简称）接收编码的packets，针对它们的基本流从编码器（transcoding路径）或直接从解复用器（streamcopy路径），将它们交织（当存在多个基本流时），并将生成的字节写入输出文件（或管道、网络流等）。

  复用器的示意图如下：

                         ┌──────────────────────┬───────────┐
   packets for stream 0  │                      │   muxer   │
  ──────────────────────►│  elementary stream 0 ╞═══════════╡
                         │                      │           │
                         ├──────────────────────┤  global   │
   packets for stream 1  │                      │properties │
  ──────────────────────►│  elementary stream 1 │   and     │
                         │                      │ metadata  │
                         ├──────────────────────┤           │
                         │                      │           │
                         │     ...........      │           │
                         │                      │           │
                         ├──────────────────────┤           │
   packets for stream N  │                      │           │
  ──────────────────────►│  elementary stream N │           │
                         │                      │           │
                         └──────────────────────┴─────┬─────┘
                                                      │
                       write to file, network stream, │
                           grabbing device, etc.      │
                                                      │
                                                      ▼
  

3.1 流复制

中最简单的管道是单流ffmpeg，即复制一个streamcopy的分组而无需解码、过滤或编码它们。例如，假设有一个名为input elementary stream’s packets without decoding, filtering, or encoding them. As an example, consider an input file called INPUT.mkv的输入文件，包含3个基本流，我们从中提取第二个写入文件OUTPUT.mp4。这样的管道示意图如下：

┌──────────┬─────────────────────┐
│ demuxer  │                     │ unused
╞══════════╡ elementary stream 0 ├────────╳
│          │                     │
│INPUT.mkv ├─────────────────────┤          ┌──────────────────────┬───────────┐
│          │                     │ packets  │                      │   muxer   │
│          │ elementary stream 1 ├─────────►│  elementary stream 0 ╞═══════════╡
│          │                     │          │                      │OUTPUT.mp4 │
│          ├─────────────────────┤          └──────────────────────┴───────────┘
│          │                     │ unused
│          │ elementary stream 2 ├────────╳
│          │                     │
└──────────┴─────────────────────┘

上述管道可以通过以下命令行构建：

ffmpeg -i INPUT.mkv -map 0:1 -c copy OUTPUT.mp4

在这条命令中

• 只有一个输入文件INPUT.mkv;
• 此输入文件没有输入选项；
• 只有一个输出文件OUTPUT.mp4;
• 此输出文件有两个输出选项：
  • -map 0:1选择要使用的输入流 - 来自索引为0（即第一个）的输入，选择索引为1（即第二个）的流；
  • -c copy选择copy编码器，即进行流复制而无需解码或编码。

流复制用于更改基本流计数、容器格式或修改容器级别元数据。由于没有解码或编码，它非常快且没有质量损失。然而，在某些情况下可能无法工作，原因可能是各种因素（例如目标容器所需的某些信息在源中不可用）。显然，无法使用过滤器，因为过滤器作用于解码后的帧。

可以构建更复杂的流复制场景，例如将两个输入文件的流组合为一个输出：

┌──────────┬────────────────────┐         ┌────────────────────┬───────────┐
│ demuxer 0│                    │ packets │                    │   muxer   │
╞══════════╡elementary stream 0 ├────────►│elementary stream 0 ╞═══════════╡
│INPUT0.mkv│                    │         │                    │OUTPUT.mp4 │
└──────────┴────────────────────┘         ├────────────────────┤           │
┌──────────┬────────────────────┐         │                    │           │
│ demuxer 1│                    │ packets │elementary stream 1 │           │
╞══════════╡elementary stream 0 ├────────►│                    │           │
│INPUT1.aac│                    │         └────────────────────┴───────────┘
└──────────┴────────────────────┘

可以通过以下命令构建：

ffmpeg -i INPUT0.mkv -i INPUT1.aac -map 0:0 -map 1:0 -c copy OUTPUT.mp4

输出-map选项此处被使用了两次，在输出文件中创建了两个流，一个由第一个输入提供，另一个由第二个输入提供。出现的单个-c选项实例将流复制选择为两个流的处理方式。您还可以结合使用多个此选项实例和流说明符来对每个流应用不同值，如以下章节中所示。

相反的场景是将单个输入的多个流分割成多个输出：

┌──────────┬─────────────────────┐          ┌───────────────────┬───────────┐
│ demuxer  │                     │ packets  │                   │ muxer 0   │
╞══════════╡ elementary stream 0 ├─────────►│elementary stream 0╞═══════════╡
│          │                     │          │                   │OUTPUT0.mp4│
│INPUT.mkv ├─────────────────────┤          └───────────────────┴───────────┘
│          │                     │ packets  ┌───────────────────┬───────────┐
│          │ elementary stream 1 ├─────────►│                   │ muxer 1   │
│          │                     │          │elementary stream 0╞═══════════╡
└──────────┴─────────────────────┘          │                   │OUTPUT1.mp4│
                                            └───────────────────┴───────────┘

通过以下命令构建：

ffmpeg -i INPUT.mkv -map 0:0 -c copy OUTPUT0.mp4 -map 0:1 -c copy OUTPUT1.mp4

注意即使值相同，每个输出文件仍需单独一个-c选项实例。这是因为非全局选项（大多数选项是非全局的）仅适用在它们放置的文件前的上下文中。

这些示例当然可以进一步推广为任意数量输入与任意数量输出的任意重映射。

3.2 转码

Transcoding是解码流然后重新编码它的过程。由于编码通常计算量大，且在大多数情况下会降低流质量（即lossy），因此您应仅在必要时进行转码，其他情况下使用流复制。转码的典型原因包括：

• 应用过滤器 - 例如调整大小、去隔行或叠加视频；重新采样或混音音频；
• 您需要将流提供给无法解码原始编解码器的设备。

注意ffmpeg将转码所有的音频、视频和字幕流，除非您为它们指定了-c copy选项。

考虑一个示例管道，它从包含一个音频流和一个视频流的输入文件中读取，转码视频并复制音频到一个单一的输出文件。这可以通过以下图示表示

┌──────────┬─────────────────────┐
│ demuxer  │                     │       audio packets
╞══════════╡ stream 0 (audio)    ├─────────────────────────────────────╮
│          │                     │                                     │
│INPUT.mkv ├─────────────────────┤ video    ┌─────────┐     raw        │
│          │                     │ packets  │  video  │ video frames   │
│          │ stream 1 (video)    ├─────────►│ decoder ├──────────────╮ │
│          │                     │          │         │              │ │
└──────────┴─────────────────────┘          └─────────┘              │ │
                                                                     ▼ ▼
                                                                     │ │
┌──────────┬─────────────────────┐ video    ┌─────────┐              │ │
│ muxer    │                     │ packets  │  video  │              │ │
╞══════════╡ stream 0 (video)    │◄─────────┤ encoder ├──────────────╯ │
│          │                     │          │(libx264)│                │
│OUTPUT.mp4├─────────────────────┤          └─────────┘                │
│          │                     │                                     │
│          │ stream 1 (audio)    │◄────────────────────────────────────╯
│          │                     │
└──────────┴─────────────────────┘

并通过以下命令行实现：

ffmpeg -i INPUT.mkv -map 0:v -map 0:a -c:v libx264 -c:a copy OUTPUT.mp4

注意它如何使用流说明符:v和:a选择输入流，并为它们应用不同的-c选项值；有关更多详细信息，请参阅流说明符部分。

3.3 过滤

在转码时，可以在编码之前对音频和视频流进行过滤，用以下任意一个simple或complex滤镜图。

3.3.1 简单滤镜图

简单滤镜图是那些仅具有一个输入和一个输出的滤镜图，且两者类型相同（音频或视频）。它们通过每流配置选项设置-filter选项（使用-vf和-af分别作为-filter:v（视频）和-filter:a（音频）的别名）。注意，简单滤镜图与其输出流绑定，因此例如如果您有多个音频流，-af将为每个音频流创建一个单独的滤镜图。

以上转码示例添加了滤镜（为清楚起见省略音频）看起来像这样：

┌──────────┬───────────────┐
│ demuxer  │               │          ┌─────────┐
╞══════════╡ video stream  │ packets  │  video  │ frames
│INPUT.mkv │               ├─────────►│ decoder ├─────►───╮
│          │               │          └─────────┘         │
└──────────┴───────────────┘                              │
                                  ╭───────────◄───────────╯
                                  │   ┌────────────────────────┐
                                  │   │  simple filtergraph    │
                                  │   ╞════════════════════════╡
                                  │   │  ┌───────┐  ┌───────┐  │
                                  ╰──►├─►│ yadif ├─►│ scale ├─►├╮
                                      │  └───────┘  └───────┘  ││
                                      └────────────────────────┘│
                                                                │
                                                                │
┌──────────┬───────────────┐ video    ┌─────────┐               │
│ muxer    │               │ packets  │  video  │               │
╞══════════╡ video stream  │◄─────────┤ encoder ├───────◄───────╯
│OUTPUT.mp4│               │          │         │
│          │               │          └─────────┘
└──────────┴───────────────┘

3.3.2 复杂滤镜图

复杂滤镜图是不能简单地描述为对一个流进行线性处理链的情况。例如，当图具有多个输入和/或输出，或者当输出流类型与输入流类型不同时，就属于复杂滤镜图。复杂滤镜图通过-filter_complex选项配置。注意，这个选项是全局的，因为复杂滤镜图本质上无法明确地与单一流或文件相关联。每次使用-filter_complex都会创建一个新的复杂滤镜图，而且可以有任意数量的复杂滤镜图。

一个复杂滤镜图的简单示例是overlay滤镜，它有两个视频输入和一个视频输出，其中一个视频叠加在另一个视频上。这的音频对应滤镜是amix滤镜。

3.4 回环解码器

虽然解码器通常与分流器流相关联，但也可以创建“回环”解码器，这种解码器解码某些编码器的输出，并允许其反馈到复杂滤镜图中。这是通过-dec指令完成，指令参数为要解码的输出流的索引。每个这样的指令都会创建一个新的回环解码器，从零开始依次编号。这些编号随后应在复杂滤镜图链接标签中使用，以引用回环解码器，如-filter_complex.

的文档中所述。-dec解码的AV选项可以通过放置在

之前传递给回环解码器，类似于输入/输出选项。

ffmpeg -i INPUT                                        \
  -map 0:v:0 -c:v libx264 -crf 45 -f null -            \
  -threads 3 -dec 0:0                                  \
  -filter_complex '[0:v][dec:0]hstack[stack]'          \
  -map '[stack]' -c:v ffv1 OUTPUT

例如，以下示例：

• 读取一个输入视频并libx264（第2行）以低质量编码它；
• （第3行）使用3线程解码此编码流；
• （第4行）将解码的视频与原始输入视频并排放置；
• （第5行）组合的视频进行无损编码，然后写入OUTPUT.

这样的转码流水线可以用以下图表示：

┌──────────┬───────────────┐
│ demuxer  │               │   ┌─────────┐            ┌─────────┐    ┌────────────────────┐
╞══════════╡ video stream  │   │  video  │            │  video  │    │ null muxer         │
│   INPUT  │               ├──►│ decoder ├──┬────────►│ encoder ├─┬─►│(discards its input)│
│          │               │   └─────────┘  │         │(libx264)│ │  └────────────────────┘
└──────────┴───────────────┘                │         └─────────┘ │
                                 ╭───────◄──╯   ┌─────────┐       │
                                 │              │loopback │       │
                                 │ ╭─────◄──────┤ decoder ├────◄──╯
                                 │ │            └─────────┘
                                 │ │
                                 │ │
                                 │ │  ┌───────────────────┐
                                 │ │  │complex filtergraph│
                                 │ │  ╞═══════════════════╡
                                 │ │  │  ┌─────────────┐  │
                                 ╰─╫─►├─►│   hstack    ├─►├╮
                                   ╰─►├─►│             │  ││
                                      │  └─────────────┘  ││
                                      └───────────────────┘│
                                                           │
┌──────────┬───────────────┐  ┌─────────┐                  │
│ muxer    │               │  │  video  │                  │
╞══════════╡ video stream  │◄─┤ encoder ├───────◄──────────╯
│  OUTPUT  │               │  │ (ffv1)  │
│          │               │  └─────────┘
└──────────┴───────────────┘

4 流选择

ffmpeg提供-map选项以手动控制每个输出文件中的流选择。用户可以跳过-map并让ffmpeg执行如以下所述的自动流选择。-vn / -an / -sn / -dn选项可用于跳过人工映射或自动选择的视频、音频、字幕和数据流的包含，但复杂滤镜图的输出流除外。

4.1 描述

以下子章节描述了流选择中涉及的各种规则。接下来的示例表明了这些规则如何被应用。

尽管已尽力准确反映程序的行为，但FFmpeg仍在持续开发中，因此代码可能自撰写本文以来已发生更改。

4.1.1 自动流选择

如果未为特定输出文件提供任何映射选项，ffmpeg会检查输出格式以确定可以包含哪些类型的流，例如视频、音频和/或字幕。对于每种可接受的流类型，ffmpeg会从所有输入中选择一个流（如果可用）。

它将根据以下标准选择该流：

• 对于视频，它是分辨率最高的流；
• 对于音频，它是频道数最多的流；
• 对于字幕，它是找到的第一个字幕流，但有一个警告。输出格式的默认字幕编码器可能是基于文本的或基于图像的，并且仅会选择同类型的字幕流。

如果多个相同类型的流得到同等评价，将选择索引最小的流。

数据或附件流不会被自动选择，仅能通过-map.

包括。

4.1.2 手动流选择-map当使用

映射选项时，只有用户映射的流会包含在该输出文件中，有一个不能包含的复杂滤镜图的输出流排序的例外。

If there are any complex filtergraph output streams with unlabeled pads, they will be added to the first output file. This will lead to a fatal error if the stream type is not supported by the output format. In the absence of the map option, the inclusion of these streams leads to the automatic stream selection of their types being skipped. If map options are present, these filtergraph streams are included in addition to the mapped streams.

复杂滤镜图的输出流必须映射一次且仅一次。

4.1.4 流处理

流处理独立于流选择，但字幕有一个例外。流处理是通过特定-codec文件线内的output选项设置的。尤其是，编解码器选项在流选择之后由ffmpeg应用，因此不会影响流选择。如果对某一流类型未设置任何选项，ffmpeg将选择由输出文件格式注册的默认编码器。-codec字幕存在一个例外。如果为输出文件指定了字幕编码器，将包括找到的第一个字幕流，无论是文本还是图像。即使用户手动设置编码器时，流选择过程也不能检查编码后的流是否能够写入的输出文件中。如果不能，则ffmpeg将中止并输出文件无法被处理。

An exception exists for subtitles. If a subtitle encoder is specified for an output file, the first subtitle stream found of any type, text or image, will be included. ffmpeg does not validate if the specified encoder can convert the selected stream or if the converted stream is acceptable within the output format. This applies generally as well: when the user sets an encoder manually, the stream selection process cannot check if the encoded stream can be muxed into the output file. If it cannot, ffmpeg will abort and all output files will fail to be processed.

4.2 示例

以下示例说明了ffmpeg流选择方法的行为、特点和限制。

它们假设以下三个输入文件。

input file 'A.avi'
      stream 0: video 640x360
      stream 1: audio 2 channels

input file 'B.mp4'
      stream 0: video 1920x1080
      stream 1: audio 2 channels
      stream 2: subtitles (text)
      stream 3: audio 5.1 channels
      stream 4: subtitles (text)

input file 'C.mkv'
      stream 0: video 1280x720
      stream 1: audio 2 channels
      stream 2: subtitles (image)

示例：自动流选择

ffmpeg -i A.avi -i B.mp4 out1.mkv out2.wav -map 1:a -c:a copy out3.mov

指定了三个输出文件，对于前两个，没有设置-map映射选项，所以ffmpeg将自动选择这些两个文件的流。

out1.mkv是一个Matroska容器文件，接受视频、音频和字幕流，因此ffmpeg将尝试选择每种类型中的一个。
对于视频，它会选择stream 0来自B.mp4，它在所有输入视频流中具有最高的分辨率。
对于音频，它会选择stream 3来自B.mp4，因为它拥有最多的频道。
对于字幕，它会选择来自stream 2，这是B.mp4中的第一个字幕流，与A.avi及B.mp4.

out2.wav仅接受音频流，所以仅选择stream 3来自B.mp4的音频。

对于out3.mov，由于设置了一个-map映射选项，没有自动选择流。-map 1:a映射选项会选择来自第二个输入B.mp4的所有音频流。不会包含其他流到输出文件中。

对于前两个输出，所有包含的流都会转码。选择的编码器是每个输出格式注册的默认编码器，这些编码器可能与所选输入流的编解码器不匹配。

对于第三个输出，音频流的编解码器选项被设置为copy，因此不会进行解码-滤镜-编码操作，或者can进行。选定流的数据包将从输入文件传输并在输出文件中复用。

示例：自动字幕选择

ffmpeg -i C.mkv out1.mkv -c:s dvdsub -an out2.mkv

尽管out1.mkv是接受字幕流的Matroska文件，但仅会选择一个视频和音频流。C.mkv的字幕流基于图像，而Matroska复用器的默认字幕编码器则基于文本，所以预期的字幕转码操作失败，因此不会选择该流。然而，在out2.mkv中，命令中指定了字幕编码器，因此字幕流被选择添加到视频流中。-an的存在禁用out2.mkv.

音频流的选择。

ffmpeg -i A.avi -i C.mkv -i B.mp4 -filter_complex "overlay" out1.mp4 out2.srt

示例：未标注的滤镜图输出-filter_complex这里设置了一个滤镜图并使用overlay选项，包含单个视频滤镜。A.avi和C.mkv过滤器的输出端没有标签，因此发送到第一个输出文件。out1.mp4由于此原因，视频流的自动选择被跳过，它本会选择流。B.mp4具有最多声道的音频流。stream 3在B.mp4被自动选择。然而，没有选择字幕流，因为MP4格式没有默认字幕编码器注册，并且用户没有指定字幕编码器。

第二个输出文件，out2.srt仅接受基于文本的字幕流。因此，尽管第一个可用的字幕流属于C.mkv，它是基于图像的，因此被跳过。选定的流，stream 2在B.mp4中，是第一个基于文本的字幕流。

示例：带标签过滤器图输出。

ffmpeg -i A.avi -i B.mp4 -i C.mkv -filter_complex "[1:v]hue=s=0[outv];overlay;aresample" \
       -map '[outv]' -an        out1.mp4 \
                                out2.mkv \
       -map '[outv]' -map 1:a:0 out3.mkv

上述命令将失败，因为标记为[outv]的输出端被映射了两次。没有输出文件会被处理。

ffmpeg -i A.avi -i B.mp4 -i C.mkv -filter_complex "[1:v]hue=s=0[outv];overlay;aresample" \
       -an        out1.mp4 \
                  out2.mkv \
       -map 1:a:0 out3.mkv

上述命令也会失败，因为色调过滤器输出有标签，[outv]，并未被映射到任何地方。

命令应修改为如下，

ffmpeg -i A.avi -i B.mp4 -i C.mkv -filter_complex "[1:v]hue=s=0,split=2[outv1][outv2];overlay;aresample" \
        -map '[outv1]' -an        out1.mp4 \
                                  out2.mkv \
        -map '[outv2]' -map 1:a:0 out3.mkv

视频流从B.mp4被发送到色调过滤器，通过拆分过滤器复制一次输出，并将两个输出贴上标签。然后各自一个副本被映射到第一个和第三个输出文件。

叠加过滤器需要两个视频输入，使用了前两个未使用的视频流。这些流是来自A.avi和C.mkv的流。叠加输出没有标签，因此被发送到第一个输出文件out1.mp4，无论是否存在-map选项。

aresample过滤器被发送到第一个未使用的音频流，即来自A.avi的流。由于这个过滤器输出也是无标签的，它也被映射到第一个输出文件。存在-an只抑制音频流的自动或手动选择，而不是从过滤器图发送的输出。这些映射的流都将排在out1.mp4.

中映射的流之前。out2.mkv的视频、音频和字幕流完全由自动流选择决定。

out3.mkv由色调过滤器克隆的视频输出和来自B.mp4.

的第一个音频流组成。

所有数值选项，如果未另行说明，接受代表数字的字符串作为输入，可以后跟一个SI单位前缀，例如：'K'、'M'或'G'。

如果SI单位前缀后面加上'i'，完整前缀将被解释为二进制倍数的单位前缀，基于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.

的文件加载过滤器图描述。

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

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

流说明符可以匹配多个流，因此选项将应用于所有匹配的流。例如：-b:a 128k中的流说明符匹配所有音频流。

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

流说明符的可能形式有：

流索引

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

流类型[:附加流说明符]

流类型是以下之一：'v'或'V'表示视频，'a'表示音频，'s'表示字幕，'d'表示数据，以及't'表示附件。'v'匹配所有视频流，'V'仅匹配不是附加图片、视频缩略图或封面艺术的视频流。如果附加流说明符被使用，那么它匹配类型为该类型且匹配附加流说明符的流。否则，它匹配所有指定类型的流。

g:组说明符[:附加流说明符]

匹配属于说明符组说明符的组内的流。如果附加流说明符被使用，那么它匹配属于该组且匹配附加流说明符. 组说明符可能是以下之一：

组索引

匹配具有此组索引的流。

#组ID or i:组ID

匹配具有此组ID的流。

p:节目ID[:附加流说明符]

匹配属于ID为节目ID的节目中的流。如果附加流说明符被使用，那么它匹配属于该节目且匹配附加流说明符.

#流ID or i:流ID

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

m:键[:值]

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

disp:倾向[:附加流说明符]

匹配具有指定配置的流。配置是一组一个或多个配置（如打印的那样-dispositions选项）用'+'连接。

u

匹配具有可用配置的流，编解码器必须被定义，并且必须包含必要的信息，例如视频尺寸或音频采样率。

注意在ffmpeg中，通过元数据匹配只针对输入文件正常工作。

5.2 通用选项

这些选项在所有 ff* 工具中共享。

-L

显示许可证。

-h, -?, -help, --help [参数]

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

参数的可能值参数有：

long

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

full

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

decoder=解码器名称

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

encoder=编码器名称

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

demuxer=解复用器名称

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

muxer=复用器名称

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

filter=滤镜名称

打印有关指定滤镜的详细信息滤镜名称。使用-filters选项获取所有滤镜的列表。

bsf=比特流滤镜名称

打印有关指定比特流滤镜的详细信息比特流滤镜名称。 使用-bsfs选项获取所有比特流滤镜的列表。

protocol=协议名称

打印有关指定协议的详细信息协议名称。 使用-protocols选项获取所有协议的列表。

-version

显示版本。

-buildconf

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

-formats

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

-demuxers

显示可用的解复用器。

-muxers

显示可用的复用器。

-devices

显示可用的设备。

-codecs

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

请注意，术语“编解码器”在本文档中作为对更正确称为媒体比特流格式的简称。

-decoders

显示可用的解码器。

-encoders

显示所有可用的编码器。

-bsfs

显示可用的比特流滤镜。

-protocols

显示可用的协议。

-filters

显示可用的 libavfilter 滤镜。

-pix_fmts

显示可用的像素格式。

-sample_fmts

显示可用的采样格式。

-layouts

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

-dispositions

显示流的配置。

-colors

显示已识别的颜色名称。

-sources 设备[,选项1=值1[,选项2=值2]...]

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

ffmpeg -sources pulse,server=192.168.0.4

-sinks 设备[,选项1=值1[,选项2=值2]...]

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

ffmpeg -sinks pulse,server=192.168.0.4

-loglevel [标志+]日志级别 | -v [标志+]日志级别

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

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

‘repeat’

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

‘level’

表示日志输出应该在每条消息行前加上[level]前缀。这可以替代日志着色使用，例如将日志转储到文件时。

‘time’

表示日志行前应该加上时间信息。

‘datetime’

表示日志行前应该加上日期和时间信息。

标志也可以单独使用，通过加上'+'/'-'前缀用于设置/重置单个标志而不影响其他标志或更改日志级别。当同时设置这两者标志和日志级别，在最后一个之间需要一个’+’分隔符标志值之前和日志级别.

日志级别是一个包含以下值之一的字符串或数字：

‘quiet, -8’

不显示任何内容；保持安静。

‘panic, 0’

仅显示可能导致进程崩溃的致命错误，例如断言失败。目前尚未用于任何内容。

‘fatal, 8’

仅显示致命错误。这些是进程无法继续运行的错误。

‘error, 16’

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

‘warning, 24’

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

‘info, 32’

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

‘verbose, 40’

与info相同，但更详尽。

‘debug, 48’

显示所有内容，包括调试信息。

‘trace, 56’

比如要启用重复的日志输出，可以添加level前缀，并设置日志级别为verbose:

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

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

ffmpeg [...] -loglevel +repeat

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

-report

将完整的命令行和日志输出转储到一个名为程序-YYYYMMDD-HHMMSS.log的文件中。此文件位于当前目录中。 该文件对于错误报告非常有用。 同时还意味着-loglevel debug.

设置环境变量FFREPORT为任何值都会产生相同效果。如果值是由冒号分隔的键值对序列，这些选项将影响报告；如果选项值包含特殊字符或选项分隔符’:’，则必须进行转义（请参阅 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 计数 (global)

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

ffmpeg -cpucount 2

-max_alloc 字节

设置使用 ffmpeg 的分配函数分配堆内块的最大大小限制。使用极度谨慎的方式。不要在不了解全部后果的情况下使用。 默认值为 INT_MAX。

5.3 AVOptions

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

generic

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

private

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

例如，要对 MP3 文件写入 ID3v2.3 标头而不是默认 ID3v2.4，使用id3v2_versionMP3 多路器的私有选项：

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 的旧的未文档化方式现已过时，将很快被移除。

5.4 主要选项

-f 格式 (input/output)

强制输入或输出文件格式。对于输入文件通常会自动检测格式，对于输出文件格式将通过文件扩展名进行猜测，因此在大多数情况下不需要此选项。

-i URL (input)

输入文件 URL

-y (global)

覆盖输出文件而无需询问。

-n (global)

不覆盖输出文件，如果指定的输出文件已经存在则立即退出。

-stream_loop 数字 (input)

设置输入流应该循环的次数。循环 0 表示不循环，循环 -1 表示无限循环。

-recast_media (global)

允许强制使用与解复用器检测或指定的媒体类型不同的解码器。这对解码作为数据流复用的媒体数据非常有用。

-c[:流说明符] 编解码器 (input/output,per-stream)

-codec[:流说明符] 编解码器 (input/output,per-stream)

为一个或多个流选择一个编码器（当在输出文件之前使用时）或解码器（当在输入文件之前使用时）。编解码器是一个解码器/编码器的名称或者一个特殊值copy（仅输出）表示不重新编码流。

例如

ffmpeg -i INPUT -map 0 -c:v libx264 -c:a copy OUTPUT

对所有视频流使用 libx264 编码，对所有音频流直接复制。

对于每个流，最后一个匹配的c选项会被应用，因此

ffmpeg -i INPUT -map 0 -c copy -c:v:1 libx264 -c:a:137 libvorbis OUTPUT

会复制所有流，除第二个视频流将使用 libx264 编码，以及第138个音频流将使用 libvorbis 编码。

-t 持续时间 (input/output)

当作为输入选项（在-i之前）使用时，限制从输入文件读取的数据持续时间。

当作为输出选项（在输出 URL 之前使用），在输出持续时间达到持续时间.

时停止写入。持续时间（ffmpeg-utils）ffmpeg-utils(1) 手册中的时间长度部分.

-to 和 -t 互相排斥，并且 -t 优先。

-to 位置 (input/output)

停止写入输出或读取输入位置位置. 位置必须是一个时间持续时间的规范， 参见(ffmpeg-utils) ffmpeg-utils(1) 手册中的时间持续时间部分.

-to 和 -t 是互斥的，并且 -t 优先。

-fs 文件大小限制 (output)

设置文件大小限制，以字节为单位。一旦超出限制，就不会再写入字节块。输出文件的大小会稍大于请求的文件大小。

-ss 位置 (input/output)

作为输入选项使用时（在-i之前），在此输入文件中跳转至位置。请注意，在大多数格式中不可能精确地跳转，因此ffmpeg将跳转到最接近的位置点之前位置。 在进行转码时，并且-accurate_seek启用时（默认情况下），此段在跳转点和位置之间的额外部分将被解码并丢弃。在进行流复制或当-noaccurate_seek使用时，它将被保留。

作为输出选项使用时（在输出 URL 之前），会解码但丢弃输入，直到时间戳达到位置.

位置必须是一个时间持续时间的规范， 参见(ffmpeg-utils) ffmpeg-utils(1) 手册中的时间持续时间部分.

-sseof 位置 (input)

类似于-ss选项，但是相对于文件的 “文件末尾”。即负值表示更早的位置，0 表示文件末尾。

-isync 输入索引 (input)

将一个输入指定为同步源。

这将采用目标和参考输入的起始时间之间的差值，并将该差值加到目标文件的时间戳上。两个输入的源时间戳应来自相同的时钟源，以获得预期的结果。如果copyts被设置，则start_at_zero也必须被设置。如果任一输入没有起始时间戳，则不进行同步调整。

可接受的值是那些引用有效 ffmpeg 输入索引的值。如果同步参考自身是目标索引或-1，则对目标时间戳不进行任何调整。同步参考本身不能与任何其他输入同步。

默认值为-1.

-itsoffset 偏移量 (input)

设置输入时间偏移。

偏移量必须是一个时间持续时间的规范， 参见(ffmpeg-utils) ffmpeg-utils(1) 手册中的时间持续时间部分.

偏移量被加到输入文件的时间戳上。指定正偏移意味着相应的流将通过偏移量.

-itsscale 比例 (input,per-stream)

重新缩放输入时间戳。比例应该是一个浮点数。

-timestamp 日期 (output)

在容器中设置录制时间戳。

日期必须是一个日期规范， 参见(ffmpeg-utils) ffmpeg-utils(1) 手册中的日期部分.

-metadata[:metadata_specifier] 键=值 (output,per-metadata)

设置一个元数据键/值对。

可选项元数据说明符可以被用来设置元数据 到流、章节或节目上。参见-map_metadata文档以了解详细信息。

此选项会覆盖通过-map_metadata设置的元数据。也可以通过使用空值来删除元数据。

例如，设置输出文件中的标题：

ffmpeg -i in.avi -metadata title="my title" out.flv

设置第一音频流的语言：

ffmpeg -i INPUT -metadata:s:a:0 language=eng OUTPUT

-disposition[:stream_specifier] 值 (output,per-stream)

设置流的处置标志。

默认值：默认情况下，所有处置标志会从输入流复制， 除非此选项所适用的输出流被复杂过滤器图处理 - 在这种情况下默认不设置处置标志。

值是由 ‘+’ 或 ‘-’ 分隔的处置标志序列。‘+’ 前缀添加指定的处置，‘-’则移除它。如果第一个标志也 带有 ‘+’ 或 ‘-’ 前缀，结果处置是默认值通过值更新而来的。如果第一个标志没有前缀，结果处置是值。也可以通过将其设置为 0 来清除处置。

如果没有为输出文件指定任何-disposition选项，ffmpeg 将会 自动为每种类型的第一个流设置 ‘默认’ 处置标志， 当输出文件中有多个此类型的流且该类型没有流被标记为默认时。

该-dispositions选项列出了已知的处置标志。

例如，要使第二个音频流为默认流：

ffmpeg -i in.mkv -c copy -disposition:a:1 default out.mkv

要使第二个字幕流为默认流，并从第一个字幕流中移除默认 处置标志：

ffmpeg -i in.mkv -c copy -disposition:s:0 0 -disposition:s:1 default out.mkv

嵌入封面/缩略图的方法：

ffmpeg -i in.mp4 -i IMAGE -map 0 -map 1 -c copy -c:v:1 png -disposition:v:1 attached_pic out.mp4

为从第一个音频流中添加 ‘原始’ 并移除 ‘注释’ 标志，而不移除 其其他处置标志的方法：

ffmpeg -i in.mkv -c copy -disposition:a:0 +original-comment out.mkv

从第一个音频流中移除 ‘原始’ 标志并添加 ‘注释’ 标志，而不移除 其其他处置标志的方法：

ffmpeg -i in.mkv -c copy -disposition:a:0 -original+comment out.mkv

为仅在第一个音频流上设置 ‘原始’ 和 ‘注释’ 标志（并移除其 其他所有处置标志）的方法：

ffmpeg -i in.mkv -c copy -disposition:a:0 original+comment out.mkv

从第一个音频流中移除所有处置标志的方法：

ffmpeg -i in.mkv -c copy -disposition:a:0 0 out.mkv

并非所有复用器都支持嵌入缩略图，支持的也只支持少数格式，如 JPEG 或 PNG。

-program [title=标题:][program_num=节目编号:]st=流[:st=流...] (output)

以指定的标题, 节目编号创建一个节目并添加指定的流。

-stream_group [map=输入文件 ID=流组][type=类型:]st=流[:st=流][:stg=流组][:id=流组ID...] (output)

创建指定类型的流组类型和流组ID，或者通过映射一个输入组，添加指定的流和/或之前定义的(s) and/or previously defined 流组到其中。

类型可以是以下之一：

iamf_audio_element

将属于同一个IAMF音频元素的流进行分组

对于这个组类型类型，以下选项可用

audio_element_type

音频元素类型。支持以下值：

channel

可扩展信道音频表示

scene

全方向音频表示

demixing

用于重构可扩展信道音频表示的解混信息。 此选项必须用‘,’分隔，包含以下 键=值选项

parameter_id

帧中参数块可能引用的标识符

dmixp_mode

解混参数的预定义组合

recon_gain

用于重构可扩展信道音频表示的恢复增益信息。 此选项必须用‘,’分隔，包含以下 键=值选项

parameter_id

帧中参数块可能引用的标识符

layer

音频元素中定义信道布局的一个层。 此选项必须用‘,’分隔。可以定义多个用‘,’分隔的条目， 且至少需要设置一个。

它包含以下以“:”分隔的键=值选项

ch_layout

该层的信道布局

flags

以下标志可用：

recon_gain

是否标志恢复增益是否作为元数据出现在帧中的参数块中

output_gain

output_gain_flags

哪些信道应用了输出增益。以下标志可用：

FL

FR

BL

BR

TFL

TFR

ambisonics_mode

全向音频模式。如果audio_element_type设置为信道，则此项无效。

支持以下值：

mono

每个全向音频信道作为组中单独的单声流进行编码

default_w

默认权重值

iamf_mix_presentation

将属于同一个IAMF音频元素和同一个IAMF混音演示引用的所有流进行分组

对于这个组类型，以下选项可用

submix

混音演示中的一个子混音。 此选项必须用‘,’分隔。可以定义多个用‘,’分隔的条目， 且至少需要设置一个。

它包含以下以“:”分隔的键=值选项

parameter_id

帧中参数块可能引用的标识符，用于对混合音频信号进行后处理以生成用于回放的音频信号

parameter_rate

帧中参数块中参数ID字段的采样率持续时间参数ID以

default_mix_gain

默认混合增益值，当没有共享同一参数ID的参数块存在时应用参数ID在给定的帧中

element

引用此混音演示中用于生成最终输出音频信号的音频元素。 此选项必须用‘|’分隔。可以定义多个用‘|’分隔的条目， 且至少需要设置一个。

它包含以下以“:”分隔的键=值选项：

stg

The 音频元素的流组ID此子混音所引用的

parameter_id

帧中参数块可能引用的标识符，用于对引用并渲染的音频元素进行处理，然后 与其他处理过的音频元素相加

parameter_rate

帧中参数块中参数ID字段的采样率持续时间参数ID以

default_mix_gain

默认混合增益值，当没有共享同一参数ID的参数块存在时应用参数ID在给定的帧中

annotations

描述子混音元素的键=值字符串，其中“键”是符合BCP-47的字符串， 指定“值”字符串的语言。“键”必须与混音的注释

headphones_rendering_mode

指示在耳机播放时，基于信道的输入音频元素是渲染到立体扬声器还是通过双耳渲染器空间化。 如果引用的音频元素的audio_element_type设置为信道，则此选项无效。

支持以下值：

stereo

binaural

layout

指定对此子混音进行响度测量时使用的布局。 此选项必须用‘|’分隔。可以定义多个用‘|’分隔的条目， 且至少需要设置一个。

它包含以下以“:”分隔的键=值选项：

layout_type

loudspeakers

布局遵循ITU-2051-3的扬声器音响系统惯例。

binaural

布局为双耳。

sound_system

信道布局匹配ITU-2051-3中的A到J声系统，以及7.1.2和3.1.2。 如果布局类型设置为双耳，则此项无效。

integrated_loudness

程序综合响度信息，定义于ITU-1770-4。

digital_peak

音频信号的数字（采样）峰值，定义于ITU-1770-4。

true_peak

音频信号的真实峰值，定义于ITU-1770-4。

dialog_anchored_loudness

对话响度信息，定义于ITU-1770-4。

album_anchored_loudness

专辑响度信息，定义于ITU-1770-4。

annotations

描述混音的键=值字符串，其中“键”是符合BCP-47的字符串， 指定“值”字符串的语言。“键”必须与所有子混音元素的注释相同

例如，从多个WAV输入文件创建一个可扩展的5.1 IAMF文件

ffmpeg -i front.wav -i back.wav -i center.wav -i lfe.wav
-map 0:0 -map 1:0 -map 2:0 -map 3:0 -c:a opus
-stream_group type=iamf_audio_element:id=1:st=0:st=1:st=2:st=3,
demixing=parameter_id=998,
recon_gain=parameter_id=101,
layer=ch_layout=stereo,
layer=ch_layout=5.1(side),
-stream_group type=iamf_mix_presentation:id=2:stg=0:annotations=en-us=Mix_Presentation,
submix=parameter_id=100:parameter_rate=48000|element=stg=0:parameter_id=100:annotations=en-us=Scalable_Submix|layout=sound_system=stereo|layout=sound_system=5.1(side)
-streamid 0:0 -streamid 1:1 -streamid 2:2 -streamid 3:3 output.iamf

将一个带有四个数据流的输入IAMF文件中的两个流组（音频元素和混音演示）复制到一个mp4输出中

ffmpeg -i input.iamf -c:a copy -stream_group map=0=0:st=0:st=1:st=2:st=3 -stream_group map=0=1:stg=0
-streamid 0:0 -streamid 1:1 -streamid 2:2 -streamid 3:3 output.mp4

-target 类型 (output)

指定目标文件类型（vcd, svcd, dvd, dv, dv50). 类型可以用pal-, ntsc-或film-作为前缀以使用相应的标准。所有格式选项（比特率、编解码器、缓冲区大小）会 自动设置。您只需输入：

ffmpeg -i myfile.avi -target vcd /tmp/vcd.mpg

尽管如此，您可以指定其他选项，只要确保它们不会与标准冲突，例如：

ffmpeg -i myfile.avi -target vcd -bf 2 /tmp/vcd.mpg

为每个目标设置的参数如下。

VCD

pal制式:
-f vcd -muxrate 1411200 -muxpreload 0.44 -packetsize 2324
-s 352x288 -r 25
-codec:v mpeg1video -g 15 -b:v 1150k -maxrate:v 1150k -minrate:v 1150k -bufsize:v 327680
-ar 44100 -ac 2
-codec:a mp2 -b:a 224k

ntsc制式:
-f vcd -muxrate 1411200 -muxpreload 0.44 -packetsize 2324
-s 352x240 -r 30000/1001
-codec:v mpeg1video -g 18 -b:v 1150k -maxrate:v 1150k -minrate:v 1150k -bufsize:v 327680
-ar 44100 -ac 2
-codec:a mp2 -b:a 224k

电影:
-f vcd -muxrate 1411200 -muxpreload 0.44 -packetsize 2324
-s 352x240 -r 24000/1001
-codec:v mpeg1video -g 18 -b:v 1150k -maxrate:v 1150k -minrate:v 1150k -bufsize:v 327680
-ar 44100 -ac 2
-codec:a mp2 -b:a 224k

SVCD

PAL制式:
-f svcd -packetsize 2324
-s 480x576 -pix_fmt yuv420p -r 25
-codec:v mpeg2video -g 15 -b:v 2040k -maxrate:v 2516k -minrate:v 0 -bufsize:v 1835008 -scan_offset 1
-ar 44100
-codec:a mp2 -b:a 224k

NTSC制式:
-f svcd -packetsize 2324
-s 480x480 -pix_fmt yuv420p -r 30000/1001
-codec:v mpeg2video -g 18 -b:v 2040k -maxrate:v 2516k -minrate:v 0 -bufsize:v 1835008 -scan_offset 1
-ar 44100
-codec:a mp2 -b:a 224k

电影:
-f svcd -packetsize 2324
-s 480x480 -pix_fmt yuv420p -r 24000/1001
-codec:v mpeg2video -g 18 -b:v 2040k -maxrate:v 2516k -minrate:v 0 -bufsize:v 1835008 -scan_offset 1
-ar 44100
-codec:a mp2 -b:a 224k

DVD

PAL制式:
-f dvd -muxrate 10080k -packetsize 2048
-s 720x576 -pix_fmt yuv420p -r 25
-codec:v mpeg2video -g 15 -b:v 6000k -maxrate:v 9000k -minrate:v 0 -bufsize:v 1835008
-ar 48000
-codec:a ac3 -b:a 448k

NTSC制式:
-f dvd -muxrate 10080k -packetsize 2048
-s 720x480 -pix_fmt yuv420p -r 30000/1001
-codec:v mpeg2video -g 18 -b:v 6000k -maxrate:v 9000k -minrate:v 0 -bufsize:v 1835008
-ar 48000
-codec:a ac3 -b:a 448k

电影:
-f dvd -muxrate 10080k -packetsize 2048
-s 720x480 -pix_fmt yuv420p -r 24000/1001
-codec:v mpeg2video -g 18 -b:v 6000k -maxrate:v 9000k -minrate:v 0 -bufsize:v 1835008
-ar 48000
-codec:a ac3 -b:a 448k

DV

PAL制式:
-f dv
-s 720x576 -pix_fmt yuv420p -r 25
-ar 48000 -ac 2

NTSC制式:
-f dv
-s 720x480 -pix_fmt yuv411p -r 30000/1001
-ar 48000 -ac 2

电影:
-f dv
-s 720x480 -pix_fmt yuv411p -r 24000/1001
-ar 48000 -ac 2

目标dv50与目标完全相同dv目标除了像素格式设置为yuv422p针对所有三个标准。

任何用户设置的参数值将覆盖目标预设值。在这种情况下，输出可能不符合目标标准。

-dn (input/output)

作为输入选项，阻止过滤或自动选择或映射文件的所有数据流以输出。参见-discard选项以单独禁用流。

作为输出选项，禁用数据记录，即自动选择或映射任何数据流。有关完全手动控制，请参阅-map选项。

-dframes 数量 (output)

设置要输出的数据帧数。这是-frames:d的废弃别名，建议使用后者。

-frames[:流选择符] 帧计数 (output,per-stream)

写入指定流后停止帧计数数据帧。

-q[:流选择符] 质量 (output,per-stream)

-qscale[:流选择符] 质量 (output,per-stream)

使用固定质量比例(可变比特率)。质量/质量比例的含义取决于具体的编解码器。如果质量比例没有使用流选择符那么它仅适用于视频流，这是为了保持与之前行为的兼容性，因为为两个不同的编解码器（音频和视频）指定同样值通常不是无流选择符时的预期。

-filter[:流选择符] 滤镜图 (output,per-stream)

创建指定的滤镜图滤镜图并使用过滤该流。

滤镜图是要应用于流的滤镜图描述，必须具有与流相同类型的单一输入和单一输出。在滤镜图中，输入与标签in相关联，输出与标签out相关联。具体语法请参阅ffmpeg-filters手册。

参见-filter_complex选项如果需要创建具有多个输入和/或输出的滤镜图。

-reinit_filter[:流选择符] 整数 (input,per-stream)

此布尔选项确定当输入帧参数在流中间发生变化时，向这一流提供的滤镜图是否会被重新初始化。筛选器通常不能处理输入帧属性的变化，因此默认会启用。重新初始化时现有的滤镜状态会丢失，例如某些筛选器中的帧计数引用。重新初始化时任何缓冲帧都会丢失。触发重新初始化的属性变化包括：视频流的分辨率或像素格式；音频流的采样格式、采样率、通道数或通道布局。n reference available in some filters. Any frames buffered at time of reinitialization are lost. The properties where a change triggers reinitialization are, for video, frame resolution or pixel format; for audio, sample format, sample rate, channel count or channel layout.

-drop_changed[:流选择符] 整数 (input,per-stream)

此布尔选项决定在中间出现参数不同的帧时是否丢弃该帧，而不是重新初始化滤镜图，因为那会导致丢失滤镜状态。通常用于避免实时流输入中已损坏但仍可解码的分组。默认值为false。

-filter_threads 线程数 (global)

定义用于处理滤镜管道的线程数。每个管道将生成一个具有这么多线程的线程池以实现并行处理。默认为可用的CPU数量。

-pre[:流选择符] 预设名 (output,per-stream)

为匹配的流指定预设。

-stats (global)

以"info"级日志记录编码进度/统计数据（参见-loglevel）。默认启用，若明确禁用需要指定-nostats.

-stats_period 时间 (global)

设置编码进度/统计数据的更新周期。默认是0.5秒。

-print_graphs (global)

以-print_graphs_format选项设置的格式将执行图细节打印到标准错误。

-print_graphs_file 文件名 (global)

以-print_graphs_format选项设置的格式将执行图细节写入指定文件。

-print_graphs_format 格式 (global)

设置输出格式（可用格式有：default, compact, csv, flat, ini, json, xml, mermaid, mermaidhtml）。默认格式为json。

-progress 网址 (global)

发送程序友好的进度信息到网址.

进度信息会定期写入以及编码过程结束时写入。内容由“键=值”组成。键仅包含字母数字字符。每个进度信息序列的最后一个键总是“progress”，值为“continue”或“end”。

更新周期通过-stats_period.

设置。例如，将进度信息记录到标准输出：

ffmpeg -progress pipe:1 -i in.mkv out.mkv

-stdin

启用标准输入上的交互。默认启用，除非标准输入已被用作输入。若明确禁用交互需指定-nostdin.

关闭标准输入交互是有用的，例如，当ffmpeg在后台进程组运行时。可以通过ffmpeg ... < /dev/null实现类似结果，但需要一个shell。

-debug_ts (global)

打印时间戳/延迟信息。默认关闭，此选项主要用于测试和调试目的，输出格式可能随着版本改变，所以不建议用于便携式脚本。

参见选项-fdebug ts.

-attach 文件名 (output)

向输出文件添加附件。这在一些格式如Matroska中支持，例如用于渲染字幕的字体。附件作为流的特定类型实现，因此此选项会向文件添加新流。然后可以像往常一样对该流使用每流选项。用此选项创建的附件流将在所有其他流（例如那些通过-map或自动映射创建的流）之后创建。

注意，对于Matroska还必须设置mimetype元数据标签：

ffmpeg -i INPUT -attach DejaVuSans.ttf -metadata:s:2 mimetype=application/x-truetype-font out.mkv

（假设附件流将在输出文件中为第三个）。

-dump_attachment[:流选择符] 文件名 (input,per-stream)

将匹配的附件流提取到名为的文件中。。如果文件名为空，则将使用filename元数据标签的值。

例如，将第一个附件提取到一个名为“out.ttf”的文件中：

ffmpeg -dump_attachment:t:0 out.ttf -i INPUT

要根据filename标签提取所有附件到文件：

ffmpeg -dump_attachment:t "" -i INPUT

技术说明 —— 附件作为编解码器的额外数据实现，因此此选项实际上可用于从任何流中提取额外数据，而不仅仅是附件。

5.5 视频选项

-vframes 编号 (output)

设置输出的视频帧数。这是的一个已废弃别名，您应该改用-frames:v来代替。

-r[:流说明符] 帧率 (input/output,per-stream)

设置帧率（Hz值、分数或缩写）。

作为输入选项，忽略文件中存储的任何时间戳，而是假设恒定帧率生成时间戳帧率。这与某些输入格式（如image2或v4l2）使用的输入选项并不相同（在FFmpeg的较早版本中它们是相同的）。如果不确定使用-framerate而不是输入选项-framerate。-r.

作为输出选项：

video encoding

在编码之前复制或删除帧以实现恒定的输出帧率帧率。.

video streamcopy

指示复用器帧率是流的帧率。在此情况下不会丢失或复制数据。如果帧率不匹配数据包时间戳确定的实际流帧率，这可能会生成无效文件。另请参见setts比特流过滤器。

-fpsmax[:流说明符] 帧率 (output,per-stream)

设置最大帧率（Hz值、分数或缩写）。

当输出帧率为自动设置且高于该值时，限制输出帧率。在批量处理或输入帧率被错误检测为非常高时很有用。不能与-r一起设置。在流拷贝期间被忽略。

-s[:流说明符] 尺寸 (input/output,per-stream)

设置帧尺寸。

作为输入选项，这是video_size私有选项的快捷方式，该选项被某些解复用器识别。对于未在文件中存储或可配置的帧尺寸，如原始视频或视频抓取器，此选项非常有用。

作为输出选项，这会将scale视频过滤器插入到end对应的过滤器图形中。请直接使用scale过滤器将其插入到开头或其他地方。

格式是‘wxh’（默认 - 与源相同）。

-aspect[:流说明符] 纵横比 (output,per-stream)

设置视频显示的纵横比，由纵横比指定。.

纵横比可以是浮点数字符串，也可以是分子:分母形式的字符串，其中分子和分母是纵横比的分子和分母。例如 "4:3"、"16:9"、"1.3333" 和 "1.7777" 是有效的参数值。

如果与-vcodec copy一起使用，它会影响存储在容器级别的纵横比，但不会影响存储在编码帧中的纵横比（如果存在）。

-display_rotation[:流说明符] 旋转 (input,per-stream)

设置视频旋转元数据。

旋转是一个十进制数字，指定视频在显示前逆时针旋转的度数。

该选项会覆盖文件中存储的旋转/显示变换元数据（如果有）。当视频被转码（而不是复制）并且-autorotate已启用时，视频将在过滤阶段进行旋转。否则，如果复用器支持，该元数据将写入输出文件。

如果-display_hflip和/或-display_vflip选项被提供，它们将在此选项指定的旋转之后应用。

-display_hflip[:流说明符] (input,per-stream)

设置显示时是否应水平翻转图像。

有关更多详细信息，请参阅-display_rotation选项。

-display_vflip[:流说明符] (input,per-stream)

设置显示时是否应垂直翻转图像。

有关更多详细信息，请参阅-display_rotation选项。

-vn (input/output)

作为输入选项，阻止过滤或自动选择或映射文件中的所有视频流到任何输出。请参阅-discard选项以单独禁用流。

作为输出选项，禁用视频录制，即不会自动选择或映射任何视频流。有关完全手动控制，请参阅-map选项。

-vcodec 编解码器 (output)

设置视频编解码器。这是-codec:v.

-pass[:的别名。] n (output,per-stream)

选择通行次序（1或2）。它用于进行两次通行视频编码。在第一通行中，视频的统计信息被记录到日志文件中（另请参见选项-passlogfile），在第二通行中，该日志文件被用于以准确的请求比特率生成视频。在第一个通行中，您可以仅停用音频并将输出设置为null，例如以下是Windows和Unix的示例：

ffmpeg -i foo.mov -c:v libxvid -pass 1 -an -f rawvideo -y NUL
ffmpeg -i foo.mov -c:v libxvid -pass 1 -an -f rawvideo -y /dev/null

-passlogfile[:流说明符] 前缀 (output,per-stream)

将两次通行的日志文件名前缀设置为前缀，默认文件名前缀为“ffmpeg2pass”。完整文件名将为PREFIX-N.log，其中 N 是特定于输出流的编号。

-vf 过滤器图形 (output)

创建由过滤器图形指定的过滤器图形，并使用它来过滤流。

这是一个-filter:v的别名，请参见-filter 选项。.

-autorotate

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

-autoscale

根据第一帧的分辨率自动缩放视频。默认启用，使用-noautoscale来禁用它。当自动缩放被禁用时，过滤器图的所有输出帧可能分辨率不同，且可能不适合某些编码器/复用器。因此，除非完全了解相关影响，否则不建议禁用自动缩放。 自行禁用自动缩放风险自负。

5.6 高级视频选项

-pix_fmt[:流选择器] 格式 (input/output,per-stream)

设置像素格式。使用-pix_fmts查看所有支持的像素格式。 如果所选的像素格式无法选择，ffmpeg会打印警告并选择编码器支持的最佳像素格式。 如果pix_fmt以+前缀开头，ffmpeg会在无法选择请求的像素格式时退出并报错，同时禁用过滤器图内部的自动转换。 如果pix_fmt为单一+，ffmpeg会选择与输入(或图输出)相同的像素格式，并禁用自动转换。

-sws_flags 标志 (input/output)

为libswscale库设置默认标志。这些标志由自动插入的scale过滤器以及简单过滤器图内部的过滤器使用，如果未在过滤器图定义中被覆盖。

请参阅ffmpeg-scaler手册以获取缩放选项列表。

-rc_override[:流选择器] 覆盖 (output,per-stream)

为特定区间设置速率控制覆盖，格式为"int,int,int"列表，用斜线分隔。前两个值是开始和结束帧号，最后一个是正值时表示使用的量化器，负值时表示质量因子。

-vstats

将视频编码统计数据导出到vstats_HHMMSS.log。参见vstats文件格式部分以查看格式描述。

-vstats_file 文件

将视频编码统计数据导出到文件。参见vstats文件格式部分以查看格式描述。

-vstats_version 文件

指定使用的vstats格式版本。默认为2。参见vstats文件格式部分以查看格式描述。

-vtag fourcc/tag (output)

强制视频标签/fourcc。这是-tag:v.

-force_key_frames[:的别名] 时间[,时间...] (output,per-stream)

-force_key_frames[:流选择器] expr:表达式 (output,per-stream)

-force_key_frames[:流选择器] source (output,per-stream)

force_key_frames可以采用以下形式的参数：

时间[,时间...]

如果参数由时间戳组成，ffmpeg会根据编码器时间基将指定的时间四舍五入到最近的输出时间戳，并在第一个时间戳等于或大于计算后时间戳的帧处强制关键帧。注意，如果编码器时间基过粗，则关键帧可能会强制在时间戳低于指定时间的帧上。 默认的编码器时间基为输出帧率的倒数，但可能通过-enc_time_base.

设置为其他值。chapters[delta]"之一，则它被扩展为文件中所有章节开始时间点的时间，加上delta，以秒为单位表达。 此选项可确保在输出文件中的章节标记或任何指定位置存在一个查找点。

例如，要在5分钟插入一个关键帧，并在每个章节开始时间的0.1秒前插入关键帧：

-force_key_frames 0:05:00,chapters-0.1

expr:表达式

如果参数以expr:前缀开头，则字符串expr会像表达式一样被解释，并对每一帧进行评估。若评估结果为非零，则强制插入关键帧。

表达式中的expr可以包含以下常量：

n

当前处理帧的编号，从0开始

n_forced

强制帧的数量

prev_forced_n

前一个强制帧的编号，如果没有强制关键帧则为NAN。

prev_forced_t

前一个强制帧的时间，如果没有强制关键帧则为NAN。

t

当前处理帧的时间

例如，要每隔5秒强制插入一个关键帧，可以指定：

-force_key_frames expr:gte(t,n_forced*5)

从第13秒开始，每次比上一个强制关键帧晚5秒插入一个关键帧：

-force_key_frames expr:if(isnan(prev_forced_t),gte(t,13),gte(t,prev_forced_t+5))

source

如果参数为source，ffmpeg会在当前编码的帧被其源标记为关键帧时强制插入关键帧。 如果该源帧必须被丢弃，则强制下一个可用帧成为关键帧。

注意，强制插入过多关键帧对某些编码器的预览算法非常有害：使用固定GOP选项或类似方式会更有效率。

-apply_cropping[:流选择器] 来源 (input,per-stream)

根据文件元数据视频解码后自动裁剪。 默认值为all.

none (0)

不应用任何裁剪元数据。

all (1)

同时应用编解码器和容器级别的裁剪。这是默认模式。

codec (2)

应用编解码器级别裁剪。

container (3)

应用容器级别裁剪。

-copyinkf[:流选择器] (output,per-stream)

执行流复制时，也复制开始处发现的非关键帧。

-init_hw_device 类型[=名称][:设备[,key=value...]]

初始化一个类型为type名称为name的新硬件设备，使用指定的设备参数。 如未指定名称，则将获得形式为"type%d"的默认名称。

The meaning of 设备以下参数取决于设备类型：

cuda

设备是CUDA设备的编号。

以下选项被识别：

primary_ctx

如果设置为1，则使用主设备上下文而不是创建新的上下文。

示例：

-init_hw_device cuda:1

选择系统上的第二个设备。

-init_hw_device cuda:0,primary_ctx=1

选择第一个设备并使用主设备上下文。

dxva2

设备是Direct3D 9显示适配器的编号。

d3d11va

设备是Direct3D 11显示适配器的编号。 如果未指定，它将尝试使用默认的Direct3D 11显示适配器或硬件VendorId由‘vendor_id’.

示例：

-init_hw_device d3d11va

在默认的Direct3D 11显示适配器上创建一个d3d11va设备。

-init_hw_device d3d11va:1

在索引为1的Direct3D 11显示适配器上创建一个d3d11va设备。

-init_hw_device d3d11va:,vendor_id=0x8086

在硬件VendorId为0x8086的第一个Direct3D 11显示适配器上创建一个d3d11va设备。

vaapi

设备可以是X11显示名称、DRM渲染节点或DirectX适配器索引。 如果未指定，它将尝试打开默认X11显示（$DISPLAY）然后是第一个DRM渲染节点（/dev/dri/renderD128），或Windows上的默认DirectX适配器。

以下选项被识别：

kernel_driver

当设备未指定时，使用此选项来指定与所需设备相关联的内核驱动程序名称。此选项仅在硬件加速方法drm和vaapi启用时可用。

vendor_id

当设备和内核驱动未指定时，使用此选项来指定与所需设备相关联的供应商ID。此选项仅在硬件加速方法drm和vaapi启用且kernel_driver未指定时可用。

示例：

-init_hw_device vaapi

在默认设备上创建一个vaapi设备。

-init_hw_device vaapi:/dev/dri/renderD129

在DRM渲染节点上创建一个vaapi设备/dev/dri/renderD129.

-init_hw_device vaapi:1

在DirectX适配器1上创建一个vaapi设备。

-init_hw_device vaapi:,kernel_driver=i915

在与内核驱动程序‘i915’.

-init_hw_device vaapi:,vendor_id=0x8086

相关联的设备上创建一个vaapi设备。0x8086’.

vdpau

设备是一个X11显示名称。 如果未指定，它将尝试打开默认X11显示（$DISPLAY).

qsv

设备选择‘MFX_IMPL_*’中的一个值。允许的值是：

auto

sw

hw

auto_any

hw_any

hw2

hw3

hw4

如果未指定，则使用‘auto_any’。 （请注意，通过创建平台适配的子设备（‘dxva2’或‘d3d11va’或‘vaapi’）然后派生一个QSV设备可能更容易实现所需结果。）

以下选项被识别：

child_device

在Linux上指定一个DRM渲染节点或在Windows上指定一个DirectX适配器。

child_device_type

选择平台适配的子设备类型。在Windows上，‘d3d11va’作为默认子设备类型，当--enable-libvpl在配置时指定，‘dxva2’作为默认子设备类型，当--enable-libmfx在配置时指定。在Linux上，用户只能将‘vaapi’作为子设备类型。

示例：

-init_hw_device qsv:hw,child_device=/dev/dri/renderD129

使用‘MFX_IMPL_HARDWARE’创建一个QSV设备，位于DRM渲染节点/dev/dri/renderD129.

-init_hw_device qsv:hw,child_device=1

使用‘MFX_IMPL_HARDWARE’创建一个QSV设备，位于DirectX适配器1。

-init_hw_device qsv:hw,child_device_type=d3d11va

选择子设备类型为‘d3d11va’并使用‘MFX_IMPL_HARDWARE’.

-init_hw_device qsv:hw,child_device_type=dxva2

选择子设备类型为‘dxva2’并使用‘MFX_IMPL_HARDWARE’.

-init_hw_device qsv:hw,child_device=1,child_device_type=d3d11va

使用‘MFX_IMPL_HARDWARE’创建一个QSV设备，位于DirectX适配器1，子设备类型为‘d3d11va’.

-init_hw_device vaapi=va:/dev/dri/renderD129 -init_hw_device qsv=hw1@va

在va上创建一个名为‘/dev/dri/renderD129’的VAAPI设备，然后从设备‘hw1’派生一个名为‘va’.

opencl

设备选择平台和设备，如platform_index.device_index.

设备集也可以使用键值对进行筛选，以仅找到匹配特定平台或设备字符串的设备。

可用作筛选器的字符串是：

platform_profile

platform_version

platform_name

platform_vendor

platform_extensions

device_name

device_vendor

driver_version

device_version

device_profile

device_extensions

device_type

索引和过滤器必须共同唯一地选择一个设备。

示例：

-init_hw_device opencl:0.1

选择第一个平台上的第二个设备。

-init_hw_device opencl:,device_name=Foo9000

选择设备名称中包含字符串Foo9000.

-init_hw_device opencl:1,device_type=gpu,device_extensions=cl_khr_fp16

选择支持cl_khr_fp16扩展的第二个平台上的GPU设备。

vulkan

如果设备是整数，它会通过系统依赖设备列表中的索引选择设备。如果设备是其他字符串，它会选择名称中包含该字符串作为子字符串的第一个设备。

以下选项被识别：

debug

如果设置为1，则启用安装的验证层。

linear_images

如果设置为1，则由硬件上下文分配的图像将是线性的并且可以本地映射。

instance_extensions

一个用加号分隔的附加实例扩展列表以启用。

device_extensions

一个用加号分隔的附加设备扩展列表以启用。

示例：

-init_hw_device vulkan:1

选择系统上的第二个设备。

-init_hw_device vulkan:RADV

选择名称中包含字符串RADV.

-init_hw_device vulkan:0,instance_extensions=VK_KHR_wayland_surface+VK_KHR_xcb_surface

选择第一个设备并启用Wayland和XCB实例扩展。

-init_hw_device 类型[=名称]@来源

初始化一种新硬件设备类型类型称为名称, 从现有名为的设备派生来源.

-init_hw_device list

列出此版本支持的所有硬件设备类型。

-filter_hw_device 名称

将名为的硬件设备传递给任何滤镜图表中的所有滤镜。 这可以用于设置要上传到的设备滤镜，或要映射到的设备hwupload滤镜。其他滤镜可能也会 在需要硬件设备时使用此参数。请注意，通常只有当输入不是硬件帧时才需要这样做—— 当输入是硬件帧时，滤镜会根据收到的帧上下文推导它们所需的设备。hwmap filter. Other filters may also make use of this parameter when they require a hardware device. Note that this is typically only required when the input is not already in hardware frames - when it is, filters will derive the device they require from the context of the frames they receive as input.

这是个全局设置，所以所有滤镜都会接收到相同的设备。

-hwaccel[:流指定符] 硬件加速 (input,per-stream)

使用硬件加速来解码匹配的流。允许的硬件加速值为：

none

不使用任何硬件加速（默认）。

auto

自动选择硬件加速方法。

vdpau

使用 VDPAU（用于 Unix 的视频解码和呈现 API）硬件加速。

dxva2

使用 DXVA2（DirectX 视频加速）硬件加速。

d3d11va

使用 D3D11VA（DirectX 11 视频加速）硬件加速。

vaapi

使用 VAAPI（视频加速 API）硬件加速。

qsv

使用 Intel QuickSync 视频加速进行视频转码。

与大多数其他值不同，此选项不会启用加速解码（若选择了 qsv 解码器则会自动使用），而是启用加速转码， 无需将帧复制到系统内存中。

为使其工作，解码器和编码器都必须支持 QSV 加速，并且不得使用滤镜。

videotoolbox

使用 Video Toolbox 硬件加速。

如果选定的硬件加速不可用或不被所选解码器支持，此选项将无效。

注意，大多数加速方法是为回放设计的，在现代 CPU 上不会比软件解码更快。此外，ffmpeg通常需要将解码后的帧从 GPU 内存复制到系统内存， 从而进一步损失性能。因此，此选项主要用于测试。

-hwaccel_device[:流指定符] 硬件加速设备 (input,per-stream)

选择一个设备用于硬件加速。

此选项仅在-hwaccel选项也被指定时有意义。 它可以通过名称引用已创建的设备，也可以模仿-init_hw_device创建新设备， 就像在立即调用-init_hw_device’ 类型:硬件加速设备之前一样。

-hwaccels

列出此版本启用的所有硬件加速组件。 实际运行时可用性取决于硬件和已安装的合适驱动程序。

-fix_sub_duration_heartbeat[:流指定符]

设置一个特定的输出视频流作为心跳流， 用以根据接收到的随机访问包分割并推动当前进行中的字幕。

这降低了尚未接收到结束包或后续字幕的字幕的延迟。 但会出现字幕事件重复的可能性，以涵盖完整的持续时间。因此， 在字幕事件输出时的延时不重要的情况下， 不应使用此选项。

需要-fix_sub_duration为相关的输入字幕流设置。 这需要输入字幕流直接映射到包含心跳流的相同输出。

5.7 音频选项

-aframes 编号 (output)

设置要输出的音频帧数。这是-frames:a的过时别名，建议使用后者。

-ar[:流指定符] 频率 (input/output,per-stream)

设置音频采样频率。输出流默认设置为对应输入流的频率。 对于输入流，此选项仅对音频捕获设备和原始解复用器有意义， 并映射到对应的解复用器选项。

-aq 质量 (output)

设置音频质量（编解码器特定，可变比特率）。这是 -q:a 的别名。

-ac[:流指定符] 声道 (input/output,per-stream)

设置音频通道数。输出流默认设置为输入音频通道数。 对于输入流，此选项仅对音频捕获设备和原始解复用器有意义， 并映射到对应的解复用器选项。

-an (input/output)

作为输入选项，阻止过滤或自动选择或映射文件中的所有音频流。参见-discard选项单独禁用流。

作为输出选项，禁用音频记录，即不自动选择或映射任何音频流。为实现完全手动控制，请参见-map选项。

-acodec 编解码器 (input/output)

设置音频编解码器。这是-codec:a.

-sample_fmt[:的别名。] 样本格式 (output,per-stream)

设置音频样本格式。使用-sample_fmts获取支持的样本格式列表。

-af 滤镜图 (output)

创建由滤镜图指定的滤镜图并用于过滤流。

这是-filter:a的别名，参见-filter 选项.

5.8 高级音频选项

-atag 四字符代码/标记 (output)

强制音频标记/四字符代码。这是-tag:a.

-ch_layout[:的别名。] 布局 (input/output,per-stream)

是-channel_layout.

-channel_layout[:的别名。] 设置音频通道布局。输出流的默认布局为输入通道布局。 输入流会覆盖其通道布局。并非所有解码器都会遵守覆盖的通道布局。 此选项还用于设置音频抓取设备和原始解复用器的通道布局， 并映射到对应的解复用器选项。 (input/output,per-stream)

Set the audio channel layout. For output streams it is set by default to the input channel layout. For input streams it overrides the channel layout of the input. Not all decoders respect the overridden channel layout. This option also sets the channel layout for audio grabbing devices and raw demuxers and is mapped to the corresponding demuxer option.

-guess_layout_max 通道数 (input,per-stream)

如果某些输入通道布局未知，则尝试仅在通道数 不超过指定通道数时猜测。比如，值为 2 会让ffmpeg识别 1 个通道为单声道，2 个通道为立体声， 但不会将 6 个通道识别为 5.1 声道。默认值始终尝试猜测。 使用 0 禁用所有猜测。使用-channel_layout选项显式指定输入布局也会禁用猜测。

5.9 字幕选项

-scodec 编解码器 (input/output)

设置字幕编解码器。这是-codec:s.

-sn (input/output)

作为输入选项，阻止过滤或自动选择/映射文件中的所有字幕流。参见-discard选项单独禁用流。

作为输出选项，禁用字幕记录，即不自动选择或映射任何字幕流。 为实现完全手动控制，请参见-map选项。

5.10 高级字幕选项

-fix_sub_duration

修复字幕持续时间。等待同一字幕流中的下一个包到来， 调整第一个包的持续时间以避免重叠。 对于某些字幕编解码器（尤其是 DVB 字幕）这是必要的， 因为原始包中的持续时间只是粗略估计， 真正的结束是通过一个空字幕帧标记的。 如果在需要时未使用此选项，可能会导致持续时间被夸大或因 时间戳非单调性导致复用失败。

请注意，此选项会延迟所有数据的输出，直到解码下一个 字幕包为止：它可能大大增加内存消耗和延迟。

-canvas_size 大小

设置用于渲染字幕的画布大小。

5.11 高级选项

-map [-]输入文件标识[:流标识符][:视图标识符][:?] | [链接标签] (output)

在输出文件中创建一个或多个流。此选项有两种形式用于指定数据源：第一种形式从某个输入文件中选择一个或多个流（用-i指定），第二种形式从复杂的筛选图中获取输出（用-filter_complex).

在第一种形式下，每个来自索引为输入文件标识的输入文件的流都会创建一个输出流。如果指定了流标识符，则仅使用符合此标识符的流（参见流标识符部分的流标识符语法）。

在流标识符之前添加一个-字符表示创建一个“负”映射。它会禁用已经创建映射中匹配的流。

可以在流标识符之后添加一个可选的视图标识符，用于指定多视点视频中需要使用的视图。视图标识符可以有以下格式之一：

view:视图ID

通过其ID选择视图；视图ID可以设置为 'all' 以使用所有视图并将其交错到一个流中；

vidx:视图索引

通过其索引选择视图；例如0为基础视图，1为第一个非基础视图，等等。

vpos:位置

通过显示位置选择视图；位置可以是left或right

对于转码而言，默认只使用基础视图，即等同于vidx:0。对于流复制，不支持视图标识符，且始终会复制所有视图。

在流索引之后添加一个尾部?允许映射为可选：如果映射未匹配到任何流，则会忽略该映射而不是失败。需要注意，若使用了无效的输入文件索引（例如映射引用了不存在的输入），映射仍然会失败。

另一种[链接标签]形式将从复杂的筛选图中映射输出到输出文件（参见-filter_complex选项）。链接标签必须对应于图中定义的输出链接标签。

可以多次指定该选项，每次添加更多流到输出文件。任何给定的输入流也可以作为源流映射多次到不同的输出流，例如，为了使用不同的编码选项和/或滤镜。创建的流会按照-map选项在命令行中的顺序生成在输出中。

使用此选项将禁用此输出文件的默认映射。

示例：

map everything

将所有流从第一个输入文件映射到输出

ffmpeg -i INPUT -map 0 output

select specific stream

如果第一个输入文件中有两个音频流，这些流用0:0和0:1标识。您可以使用-map选择要放置到输出文件中的流。例如：

ffmpeg -i INPUT -map 0:1 out.wav

将第一个输入文件中的第二个输入流映射到INPUT中（单个）输出流。out.wav.

create multiple streams

从输入文件a.mov中选择索引为2的流（由标识符0:2指定），以及从输入b.mov中选择索引为6的流（由标识符1:6指定），并将它们复制到输出文件out.mov:

ffmpeg -i a.mov -i b.mov -c copy -map 0:2 -map 1:6 out.mov

create multiple streams 2

选择输入文件中的所有视频流和第三个音频流：

ffmpeg -i INPUT -map 0:v -map 0:a:2 OUTPUT

negative map

使用负映射选择除第二个音频流外的所有流

ffmpeg -i INPUT -map 0 -map -0:a:1 OUTPUT

optional map

从第一个输入中映射视频和音频流，并使用尾部?，如果第一个输入中没有音频流，则忽略音频映射：

ffmpeg -i INPUT -map 0:v -map 0:a? OUTPUT

map by language

选择英语音频流：

ffmpeg -i INPUT -map 0:m:language:eng OUTPUT

-ignore_unknown

忽略具有未知类型的输入流，如果尝试复制此类流则不会失败。

-copy_unknown

允许具有未知类型的输入流被复制，而不是在尝试复制此类流时失败。

-map_metadata[:元数据输出说明] 输入文件[:元数据输入说明] (output,per-metadata)

从输入文件设置下一输出文件的元数据信息。请注意，这些是文件索引（从零开始），而不是文件名。可选的元数据输入/输出说明参数指定要复制的元数据。元数据说明符可以有以下形式：

g

全局元数据，即适用于整个文件的元数据

s[:流说明符]

每条流的元数据。流说明符是流标识符章节中描述的流标识符。在输入的元数据说明符中，第一次匹配的流会被复制。在输出的元数据说明符中，所有匹配的流会被复制。

c:章节索引

每章节的元数据。章节索引是从零开始的章节索引。

p:节目索引

每节目的元数据。节目索引是从零开始的节目索引。

如果省略元数据说明符，默认为全局。

默认情况下，全局元数据从第一个输入文件中复制，每流和每章节的元数据与流/章节一起复制。如果创建了任何相关类型的映射，这些默认映射将被禁用。可以使用负文件索引创建仅禁用自动复制的虚拟映射。

例如，要将输入文件第一个流的元数据复制到输出文件的全局元数据：

ffmpeg -i in.ogg -map_metadata 0:s:0 out.mp3

反之，将全局元数据复制到所有音频流：

ffmpeg -i in.mkv -map_metadata:s:a 0:g out.mkv

请注意，简单形式的0在此示例中也适用，因为默认情况下会假定为全局元数据。

-map_chapters 输入文件索引 (output)

从具有索引的输入文件中复制章节输入文件索引到下一个输出文件。如果未指定章节映射，则从第一个具有至少一个章节的输入文件中复制章节。使用负文件索引可禁用任何章节复制。

-benchmark (global)

在编码结束时显示基准信息。 显示使用的真实时间、系统时间和用户时间，以及最大内存消耗。 并非所有系统都支持最大内存消耗，通常在不支持时显示为0。

-benchmark_all (global)

在编码期间显示基准信息。 显示在各步骤（音频/视频编码/解码）中使用的真实时间、系统时间和用户时间。

-timelimit 持续时间 (global)

在 ffmpeg 运行持续时间秒后退出。

-dump (global)

将每个输入数据包转储到标准错误。

-hex (global)

转储数据包时，也转储有效负载。

-readrate 速度 (input)

限制输入读取速度。

其值为正浮点数，表示在一秒钟的墙钟时间内最多应摄取的媒体持续时间（以秒为单位）。 默认值为零，表示没有施加输入速度的限制。 值1表示实时速度等同于-re.

主要用于模拟捕获设备或实时输入流（例如，从文件读取时）。 在输入为实际捕获设备或实时流时，不应使用较低的值，因为可能会导致数据包丢失。

对于输出数据包流速重要的情况（例如实时流），这很有用。

-re (input)

以原生帧速率读取输入。这等同于设置-readrate 1.

-readrate_initial_burst 秒

设置初始读取突发时间（以秒为单位），之后将强制执行-re/-readrate。

-readrate_catchup 速度 (input)

如果输入或输出被阻塞导致实际读取速度落后于指定的读取速率，那么此速率将生效，直到输入赶上指定的读取速率。 必须不低于主读取速率。

-vsync 参数 (global)

-fps_mode[:流指定] 参数 (output,per-stream)

设置视频同步方法/帧速率模式。vsync 应用于所有输出视频流，但可以通过设置 fps_mode 为单个流覆盖。 vsync 已被弃用，将在未来删除。

出于兼容性原因，某些 vsync 的值可以指定为数字（以下表中的括号）。

passthrough (0)

每帧都有其时间戳从解复用器传递给复用器。

cfr (1)

帧将被重复和丢弃以准确实现所请求的恒定帧速率。

vfr (2)

帧将根据时间戳直接传递或被丢弃，以防止两个帧有相同时间戳。

auto (-1)

根据复用器能力在 cfr 和 vfr 之间选择。默认方法。

请注意，时间戳可能会在复用器之后进一步修改。例如，在格式选项avoid_negative_ts启用的情况下。

使用 -map 可以选择应从哪个流中提取时间戳。可以使视频或音频保持不变，并同步其余流到未更改的一方。

-frame_drop_threshold 参数

帧丢弃阈值，指定视频帧可落后多少后丢弃。以帧速率单位表示，因此1.0表示一帧。 默认值为-1.1。 一个可能的用途是在时间戳有噪声时避免丢帧，或者在时间戳精确时提高帧丢弃精度。

-apad 参数 (output,per-stream)

填充输出音频流。这与应用-af apad相同。 参数为过滤器参数的字符串，组成方式与apad过滤器相同。-shortest必须为此输出设置，以使选项生效。

-copyts

不处理输入时间戳，但保留其值而不尝试进行清理。 特别是，不移除初始开始时间偏移值。

请注意，根据vsync选项或特定复用器处理（例如如果格式选项avoid_negative_ts启用）即使选择此选项，输入时间戳和输出时间戳可能不匹配。

-start_at_zero

与copyts一起使用时，将输入时间戳移位，使其从零开始。

这意味着使用例如-ss 50会使输出时间戳从50秒开始，而不考虑输入文件从哪个时间戳开始。

-copytb 模式

指定流复制时如何设置编码器时间轴。模式是一个整型数值，可以采用以下值之一：

1

使用解复用器时间基。

时间基从相应输入解复用器复制到输出编码器。有时需要这样做， 以避免在复制具有可变帧速率的视频流时出现时间戳非单调增加。

0

使用解码器时间基。

时间基从相应输入解码器复制到输出编码器。

-1

尝试自动选择，以生成一个合理的输出。

默认值为-1。

-enc_time_base[:流指定] 时间基 (output,per-stream)

设置编码器时间基。时间基可以采用以下值之一：

0

根据媒体类型分配默认值。

对于视频 - 使用 1/framerate，对于音频 - 使用 1/samplerate。

demux

使用来自解复用器的时间基。

filter

使用来自过滤器图的时间基。

a positive number

使用提供的数字作为时间基。

此字段可以以两个整数的比率提供（例如 1:24, 1:48000），也可以用十进制数提供（例如 0.04166, 2.0833e-5）。

默认值为0。

-bitexact (input/output)

启用（解）复用器和（解）编码器的 bitexact 模式。

-shortest (output)

在最短输出流结束时完成编码。

请注意，此选项可能需要缓冲帧数据，以增加额外的延迟。此延迟的最大量可以通过-shortest_buf_duration选项进行控制。

-shortest_buf_duration 持续时间 (output)

The -shortest选项可能需要缓冲大量数据，当其中至少有一个流是"稀疏"时（即帧之间间隔较大——字幕通常如此）。

此选项控制缓冲帧的最大持续时间，以秒为单位。 较大的值可能允许-shortest选项产生更精确的结果，但会增加内存使用和延迟。

默认值为10秒。

-dts_delta_threshold 阈值

时间戳不连续性 delta 阈值，以秒的小数表示。

此选项启用的时间戳不连续性校正仅适用于接受时间戳不连续的输入格式（其AVFMT_TS_DISCONT标志已启用），例如 MPEG-TS 和 HLS，并在使用-copyts选项时会自动禁用（除非检测到环绕）。

如果检测到时间戳不连续性，其绝对值大于阈值，ffmpeg 将通过减少/增加当前 DTS 和 PTS 值来移除不连续性。

默认值为10。

-dts_error_threshold 阈值

时间戳错误 delta 阈值，以秒的小数表示。

此选项启用的时间戳校正仅适用于不接受时间戳不连续的输入格式（其AVFMT_TS_DISCONT标志未启用）。

如果检测到时间戳不连续性，其绝对值大于阈值，ffmpeg 将丢弃 PTS/DTS 时间戳值。

默认值为3600*30(30小时)，此值是任意选择的，并且相当保守。

-muxdelay 秒 (output)

设置解复用-解码的最大延迟。

-muxpreload 秒 (output)

设置初始解复用-解码延迟。

-streamid 输出流索引:新值 (output)

为输出流分配一个新的流 ID 值。此选项应在适用的输出文件名前指定。如果存在多个输出文件的情况，可以将流 ID 重新分配为不同的值。

例如，为了设置输出 mpegts 文件中流 0 的 PID 为 33，流 1 的 PID 为 36：

ffmpeg -i inurl -streamid 0:33 -streamid 1:36 out.ts

-bsf[:流指定符] 码流过滤器 (input/output,per-stream)

将码流过滤器应用于匹配的流。当作为输入选项使用时，过滤器应用于从解复用器接收的每个包；当作为输出选项使用时，过滤器应用于发送到复用器之前的每个包。

码流过滤器是一个用逗号分隔的码流过滤器规范列表，每个形式为

过滤器[=选项名0=选项值0:选项名1=选项值1:...]

任何要成为选项值一部分的字符‘,=:’需要用反斜杠进行转义。

使用-bsfs选项来获取码流过滤器的列表。

例如

ffmpeg -bsf:v h264_mp4toannexb -i h264.mp4 -c:v copy -an out.h264

应用了h264_mp4toannexb码流过滤器（将封装在 MP4 中的 H.264 转换为 Annex B）到input视频流。

另一方面，

ffmpeg -i file.mov -an -vn -bsf:s mov2textsub -c:s copy -f rawvideo sub.txt

应用了mov2textsub码流过滤器（从 MOV 字幕中提取文本）到output字幕流。然而请注意，由于这两个示例使用了-c copy，在输入或输出上是否应用过滤器影响不大 - 只有在进行转码时情况才会改变。

-tag[:流指定符] 编解码标签 (input/output,per-stream)

强制为匹配的流设置标签/fourcc。

-timecode 小时:分钟:秒SEP帧

指定写入的时间码。分隔符对于非丢帧时间码为‘:’，对于丢帧时间码为‘;’（或‘.’）。

ffmpeg -i input.mpg -timecode 01:02:03.04 -r 30000/1001 -s ntsc output.mpg

-filter_complex 过滤器图 (global)

定义一个复杂的过滤器图，即具有任意数量的输入和/或输出的图。对于简单图 - 即类型相同的一个输入和一个输出，请参见-filter选项。过滤器图是过滤器图的描述，如 ffmpeg-filters 手册中的“过滤器图语法”部分所述。此选项可以多次指定 - 每次使用都会创建一个新的复杂过滤器图。

复杂过滤器图的输入可以来自不同的来源类型，通过相应链接标签的格式区分：

• 要连接输入流，请使用[file_index:stream_specifier]（即与-map具有相同的语法）。如果流指定符匹配多个流，将使用第一个流。对于多视图视频，流指定符之后可以跟随视图指定符，请参阅-map选项的文档了解其语法。
• 要连接循环解码器，请使用 [dec:解码器索引]，其中解码器索引是要连接到给定输入的循环解码器的索引。对于多视图视频，解码器索引之后可以跟随视图指定符，请参阅-map选项的文档了解其语法。
• 要连接另一个复杂过滤器图的输出，请使用其链接标签。例如以下示例：

  ffmpeg -i input.mkv \
    -filter_complex '[0:v]scale=size=hd1080,split=outputs=2[for_enc][orig_scaled]' \
    -c:v libx264 -map '[for_enc]' output.mkv \
    -dec 0:0 \
    -filter_complex '[dec:0][orig_scaled]hstack[stacked]' \
    -map '[stacked]' -c:v ffv1 comparison.mkv
  

  读取输入视频并

  • （第2行）使用一个具有一个输入和两个输出的复杂过滤器图将视频缩放到1920x1080并将结果复制到两个输出；
  • （第3行）使用libx264对一个缩放后的输出进行编码，并将结果写入output.mkv;
  • （第4行）使用循环解码器解码此编码流；
  • （第5行）将循环解码器的输出（即libx264编码的视频）与缩放后的原始输入并排放置；
  • （第6行）组合的视频随后进行无损编码并写入comparison.mkv.

  请注意，这两个过滤器图不能合并为一个，因为在转码管道中会形成一个循环（过滤器图输出进入编码，从编码到解码，然后返回到相同的图），而不允许这样的循环。

未标记的输入将连接到匹配类型的第一个未使用输入流。

可使用-map引用输出链接标签。未标记的输出将添加到第一个输出文件。

请注意，使用此选项可以只使用 lavfi 源而无需普通输入文件。

例如，将图像叠加到视频上

ffmpeg -i video.mkv -i image.png -filter_complex '[0:v][1:v]overlay[out]' -map
'[out]' out.mkv

此处[0:v]指的是第一个输入文件中的第一个视频流，该流链接到叠加过滤器的第一个（主要）输入。同样，第二个输入中的第一个视频流链接到叠加的第二个（叠加）输入。

假设每个输入文件中只有一个视频流，我们可以省略输入标签，因此上述内容等效于

ffmpeg -i video.mkv -i image.png -filter_complex 'overlay[out]' -map
'[out]' out.mkv

此外，我们可以省略输出标签，过滤器图中的单个输出将自动添加到输出文件中，因此我们可以简单地写为

ffmpeg -i video.mkv -i image.png -filter_complex 'overlay' out.mkv

作为特殊例外，可以使用位图字幕流作为输入：它将转换为与文件中最大的视频相同大小的视频，如果没有视频，则为720x576。请注意，这是一个实验性和临时解决方案。一旦 libavfilter 对字幕具有正式支持，它将被移除。

例如，将字幕硬编码到存储在 MPEG-TS 格式中的 DVB-T 录制上，并将字幕延迟1秒：

ffmpeg -i input.ts -filter_complex \
  '[#0x2ef] setpts=PTS+1/TB [sub] ; [#0x2d0] [sub] overlay' \
  -sn -map '#0x2dc' output.mkv

（0x2d0、0x2dc 和 0x2ef 分别是视频、音频和字幕流的 MPEG-TS PID；0:0、0:3 和 0:7也可以使用）

使用 lavfi 源生成5秒纯红色视频：color源：

ffmpeg -filter_complex 'color=c=red' -t 5 out.mkv

-filter_complex_threads 线程数量 (global)

定义用于处理 filter_complex 图的线程数。类似于 filter_threads，但仅用于-filter_complex图。默认值为可用的 CPU 数量。

-lavfi 过滤器图 (global)

定义一个复杂的过滤器图，即具有任意数量的输入和/或输出的图。等同于-filter_complex.

-accurate_seek (input)

此选项启用或禁用使用-ss选项进行准确的输入文件寻址。默认情况下启用，因此在转码时寻址是准确的。使用-noaccurate_seek将其禁用，这可能在某些流为复制且其他流为转码时很有用。

-seek_timestamp (input)

此选项启用或禁用使用-ss选项按时间戳进行输入文件寻址。默认情况下禁用。如果启用，则-ss选项的参数将被视为实际时间戳，并且不会以文件的开始时间为偏移。这仅对不以时间戳0开始的文件（如传输流）有意义。

-thread_queue_size 大小 (input/output)

对于输入，此选项设置从文件或设备读取时的最大排队包数量。对于低延迟/高速率直播流，如果未及时读取包，则可能会丢弃包；设置该值可以强制 ffmpeg 使用单独的输入线程并在包到达时立即读取包。默认情况下，ffmpeg 仅在指定多个输入时这样做。

对于输出，此选项指定可排队到每个复用线程的最大包数。

-sdp_file 文件 (global)

将输出流的 sdp 信息打印到文件这允许在至少一个输出不是rtp流时转储SDP信息。（需要输出格式中至少有一个是rtp）

-discard (input)

允许丢弃指定的流或流中的帧。 任何输入流都可以完全丢弃，使用值all而从流中选择性地丢弃帧发生在解复用器上， 并且并非所有解复用器都支持此功能。

none

不丢弃任何帧。

default

默认值，不丢弃任何帧。

noref

丢弃所有非参考帧。

bidir

丢弃所有双向帧。

nokey

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

all

丢弃所有帧。

-abort_on 标志 (global)

在多种情况下停止并中止。有以下可用标志：

empty_output

没有数据包传递给复用器，输出为空。

empty_output_stream

在一些输出流中没有数据包传递给复用器。

-max_error_rate (global)

设置跨所有输入的解码帧失败的比例阈值，一旦超出，ffmpeg将返回退出代码69。达到此阈值不会终止处理。范围是介于0到1之间的浮点数。默认值为2/3。

-xerror (global)

在发生错误时停止并退出

-max_muxing_queue_size 数据包 (output,per-stream)

在转码音频或视频流时，ffmpeg不会开始写入输出，直到每个这样的流都有一个数据包。在等待发生这种情况时，其它流的数据包会被缓冲。此选项设置与匹配输出流相关的此缓冲区大小（单位为数据包数）。

此选项的默认值应足够高，以满足大多数使用场景，因此只有在确定需要时才修改该选项。

-muxing_queue_data_threshold 字节 (output,per-stream)

这是一个最低阈值，在此之前复用队列大小不会被考虑。每个流默认为50兆字节，并以传递给复用器的数据包的总大小为基础。

-auto_conversion_filters (global)

启用在所有过滤器图形中自动插入格式转换过滤器，包括由-vf, -af, -filter_complex和-lavfi定义的过滤器图形。当过滤器格式协商需要转换时，过滤器初始化将失败。转换仍可以通过在图形中插入相关的转换过滤器（如scale，aresample）来实现。默认启用，如需显式禁用，需要指定-noauto_conversion_filters.

-bits_per_raw_sample[:流说明符] 值 (output,per-stream)

声明在给定的输出流中，每个原始样本的位数为值。请注意，此选项设置的是提供给编码器/复用器的信息，并不会改变流以符合该值。设置与流属性不匹配的值可能会导致编码失败或生成无效的输出文件。

-stats_enc_pre[:流说明符] 路径 (output,per-stream)

-stats_enc_post[:流说明符] 路径 (output,per-stream)

-stats_mux_pre[:流说明符] 路径 (output,per-stream)

将匹配流的每帧编码信息写入由路径.

-stats_enc_pre指定的文件中。当信息是关于原始视频或音频帧时，是在它们被发送到编码器之前写的，而-stats_enc_post是关于编码后的数据包信息，当它们从编码器接收后被写入。-stats_mux_pre信息是在数据包即将发送到复用器时写入的。每帧或每包会在指定的文件中生成一行。该行的格式是由-stats_enc_pre_fmt / -stats_enc_post_fmt / -stats_mux_pre_fmt.

指定的。当多个流的统计信息写入单个文件时，不同流之间的行会交错。这种交错的精确顺序不是固定的，即使在使用相同选项的不同程序调用之间，也不能保证稳定性。

-stats_enc_pre_fmt[:流说明符] 格式说明 (output,per-stream)

-stats_enc_post_fmt[:流说明符] 格式说明 (output,per-stream)

-stats_mux_pre_fmt[:流说明符] 格式说明 (output,per-stream)

指定通过-stats_enc_pre / -stats_enc_post / -stats_mux_pre.

格式说明写入的行的格式。它是一个字符串，可以包含形式为{fmt}. 的指令。是反斜杠转义的 — 使用 \{, \}, 和 \\ 来分别向输出中写入字面量 {, } 或 \。

通过格式给出的指令可以是以下之一：

fidx

输出文件的索引。

sidx

文件中输出流的索引。

n

帧编号。编码前：到目前为止发送到编码器的帧数。 编码后：到目前为止从编码器接收到的数据包数。 复用：到目前为止为该流提交给复用器的数据包数。

ni

输入帧号。与此输出帧或数据包对应的输入帧（即由解码器输出）的索引。如果不可用，则为-1。

tb

此帧/数据包的时间戳表述的时间基，格式为有理数num/den。请注意，编码器和复用器可能使用不同的时间基。

tbi

Timebase for ptsi的时间基，作为有理数num/den。在ptsi可用时可用，0/1否则。

pts

帧或数据包的表示时间戳，以整数形式表示。应乘以时间基以计算表示时间。

ptsi

输入帧的表示时间戳（请参见ni），以整数表示。应乘以tbi以计算表示时间。如果不可用，则打印为(2^63 - 1 = 9223372036854775807)。

t

帧或数据包的表示时间，以十进制数表示。等于pts乘以tb.

ti

输入帧的表示时间（请参见ni），以十进制数表示。等于ptsi乘以tbi。如果不可用，则打印为inf。

dts (packet)

数据包的解码时间戳，以整数形式表示。应乘以时间基以计算表示时间。

dt (packet)

帧或数据包的解码时间，以十进制数表示。等于dts乘以tb.

sn (frame,audio)

到目前为止发送到编码器的音频样本数。

samp (frame,audio)

帧中的音频样本数。

size (packet)

编码数据包的大小（以字节为单位）。

br (packet)

当前比特率（以每秒比特数表示）。

abr (packet)

到目前为止整个流的平均比特率（以每秒比特数表示），如果此时无法确定，则为-1。

key (packet)

如果数据包包含关键帧，则为字符“K”，否则为字符“N”。

带有packet标签的指令只能用于-stats_enc_post_fmt和-stats_mux_pre_fmt.

带有标签的指令frame只能用于-stats_enc_pre_fmt.

带有标签的指令audio只能用于音频流。

默认的格式字符串是：

pre-encoding

{fidx} {sidx} {n} {t}

post-encoding

{fidx} {sidx} {n} {t}

将来，默认格式字符串的末尾可能会添加新项。依赖格式严格保持不变的用户应手动设置格式。

请注意，写入同一文件的不同流的统计信息可能具有不同的格式。

5.12 预设文件

一个预设文件包含一系列选项=值对，每行一个，指定了一系列在命令行上指定起来比较麻烦的选项。以井号（‘#’）字符开头的行会被忽略，并用于提供注释。请查看presetsFFmpeg 源代码树中的目录获取示例。

有两种类型的预设文件：ffpreset 和 avpreset 文件。

5.12.1 ffpreset 文件

ffpreset 文件通过vpre, apre, spre和fpre选项指定。fpre选项以预设名称作为输入，而不是预设文件名，并且可用于任何类型的编解码器。对于vpre, apre和spre选项，预设文件中指定的选项会应用于与预设选项同类型的当前选定编解码器。

传递给vpre, apre和spre预设选项的参数会根据以下规则标识要使用的预设文件：

首先，ffmpeg 会在目录下搜索名为arg.ffpreset 的文件，包括$FFMPEG_DATADIR（如果设置了），以及$HOME/.ffmpeg和在配置时定义的数据目录（通常为PREFIX/share/ffmpeg）或在 win32 上可执行文件旁边的ffpresets文件夹，比如说，如果参数为libvpx-1080p，它会搜索文件libvpx-1080p.ffpreset.

如果没有找到这样的文件，那么 ffmpeg 将会在上述目录中搜索名为codec_name-arg.ffpreset 的文件，其中codec_name是预设文件选项将应用到的编解码器的名称。例如，如果您选择了视频编解码器-vcodec libvpx并使用-vpre 1080p，那么它会搜索文件libvpx-1080p.ffpreset.

5.12.2 avpreset 文件

avpreset 文件通过pre选项指定。它们与 ffpreset 文件类似，但仅允许特定于编码器的选项。因此，选项=值对不能指定编码器。

当使用pre选项时，ffmpeg 将按照以下顺序查找后缀为 .avpreset 的文件：$AVCONV_DATADIR如果设置了）和$HOME/.avconv以及在配置时定义的数据目录（通常为PREFIX/share/ffmpeg）。

首先，ffmpeg 会在上述目录中搜索名为codec_name-arg.avpreset 的文件，其中codec_name是预设文件选项将应用到的编解码器的名称。例如，如果您选择了视频编解码器-vcodec libvpx并使用-pre 1080p，那么它会搜索文件libvpx-1080p.avpreset.

如果没有找到这样的文件，那么 ffmpeg 将会在相同的目录中搜索名为arg.avpreset 的文件。

5.13 vstats 文件格式

选项-vstats和-vstats_file选项启用生成包含有关生成的视频输出的统计信息的文件。

选项控制生成文件的格式版本。-vstats_version option controls the format version of the generated file.

对于版本1格式是：

frame= 帧 q= 帧质量 PSNR= 峰值信噪比 f_size= 帧大小 s_size= 流大小kB time= 时间戳 br= 比特率kbits/s avg_br= 平均比特率kbits/s

对于版本2格式是：

out= 输出文件索引 st= 输出流索引 frame= 帧编号 q= 帧质量f PSNR= 峰值信噪比 f_size= 帧大小 s_size= 流大小kB time= 时间戳 br= 比特率kbits/s avg_br= 平均比特率kbits/s

每个键对应的值描述如下：

avg_br

平均比特率，以 Kbits/s 表示

br

比特率，以 Kbits/s 表示

frame

编码帧的数量

out

输出文件索引

PSNR

峰值信噪比

q

帧的质量

f_size

以字节数表示的编码分组大小

s_size

以KiB表示的流大小

st

输出文件流索引

time

数据包的时间

type

图片类型

另请参见-stats_enc选项提供一种显示编码统计信息的替代方法。

6 实例

6.1 视频和音频抓取

如果你指定输入格式和设备，那么ffmpeg可以直接抓取视频和音频。

ffmpeg -f oss -i /dev/dsp -f video4linux2 -i /dev/video0 /tmp/out.mpg

或者使用ALSA音源（单声道输入，卡ID为1）而不是OSS：

ffmpeg -f alsa -ac 1 -i hw:1 -f video4linux2 -i /dev/video0 /tmp/out.mpg

请注意，在启动带有任何电视查看器的ffmpeg之前，如xawtv（由Gerd Knorr编写），你必须激活正确的视频源和通道。你还需要用标准音量调节器正确设置音频录制电平。

6.2 X11抓取

通过ffmpeg抓取X11显示器

ffmpeg -f x11grab -video_size cif -framerate 25 -i :0.0 /tmp/out.mpg

0.0是X11服务器的显示器.屏幕编号，与DISPLAY环境变量相同。

ffmpeg -f x11grab -video_size cif -framerate 25 -i :0.0+10,20 /tmp/out.mpg

0.0是X11服务器的显示器.屏幕编号，与DISPLAY环境变量相同。10是抓取的x偏移量，20是y偏移量。

6.3 视频和音频文件格式转换

任意受支持的文件格式和协议都可以作为ffmpeg的输入：

示例：

• 你可以使用YUV文件作为输入：

  ffmpeg -i /tmp/test%d.Y /tmp/out.mpg
  

  它将使用以下文件：

  /tmp/test0.Y, /tmp/test0.U, /tmp/test0.V,
  /tmp/test1.Y, /tmp/test1.U, /tmp/test1.V, etc...
  

  Y文件的分辨率是U和V文件的两倍。它们是无头的原始文件。所有合适的视频解码器都可以生成这些文件。如果ffmpeg无法猜测，你必须通过-s选项指定图像大小。

• 你可以从一个原始YUV420P文件输入：

  ffmpeg -i /tmp/test.yuv /tmp/out.avi
  

  test.yuv是一个包含原始YUV平面数据的文件。每帧由Y平面组成，后续为垂直和水平分辨率减半的U和V平面。

• 你可以输出到一个原始YUV420P文件：

  ffmpeg -i mydivx.avi hugefile.yuv
  

• 你可以设置多个输入文件和输出文件：

  ffmpeg -i /tmp/a.wav -s 640x480 -i /tmp/a.yuv /tmp/a.mpg
  

  将音频文件a.wav和原始YUV视频文件a.yuv转换为MPEG文件a.mpg。

• 你还可以同时进行音频和视频转换：

  ffmpeg -i /tmp/a.wav -ar 22050 /tmp/a.mp2
  

  将a.wav转换为22050Hz采样率的MPEG音频。

• 你可以同时编码为多种格式，并定义从输入流到输出流的映射：

  ffmpeg -i /tmp/a.wav -map 0:a -b:a 64k /tmp/a.mp2 -map 0:a -b:a 128k /tmp/b.mp2
  

  将a.wav转换为64 kbits的a.mp2和128 kbits的b.mp2。'-map file:index'指定每个输出流使用的输入流，按照输出流定义的顺序。

• 你可以转码解密的VOB文件：

  ffmpeg -i snatch_1.vob -f avi -c:v mpeg4 -b:v 800k -g 300 -bf 2 -c:a libmp3lame -b:a 128k snatch.avi
  

  这是一个典型的DVD转码示例；输入是一个VOB文件，输出是一个带有MPEG-4视频和MP3音频的AVI文件。注意，在这个命令中，我们使用B帧使MPEG-4流与DivX5兼容，而GOP大小是300，这意味着对于29.97fps的输入视频，每10秒有一个帧内帧。此外，由于音频流是MP3编码的，你需要通过以下命令启用LAME支持--enable-libmp3lame来配置。 映射对DVD转码特别有用，可以获得所需的音频语言。

  注意：若要查看支持的输入格式，请使用ffmpeg -demuxers.

• 你可以从视频中提取图像，或者通过许多图像创建一个视频：

  从视频中提取图像：

  ffmpeg -i foo.avi -r 1 -s WxH -f image2 foo-%03d.jpeg
  

  这将从视频中每秒提取一帧并将其输出为命名为foo-001.jpeg, foo-002.jpeg等的文件。图像将重新调整大小以适应新的WxH值。

  如果你只想提取有限数量的帧，可以将上述命令与-frames:v或-t选项结合使用，或与-ss组合从某个时间点开始提取。

  从许多图像创建视频：

  ffmpeg -f image2 -framerate 12 -i foo-%03d.jpeg -s WxH foo.avi
  

  语法foo-%03d.jpeg指定使用由填充零的三位数字组成的小数号表达序列号。这是C语言printf函数支持的相同语法，但仅支持接受正常整数的格式。

  在导入图像序列时，-i还支持通过选择image2特定的-pattern_type glob选项在内部扩展类似shell的通配模式（globbing）。

  例如，通过匹配glob模式的文件名创建视频foo-*.jpeg:

  ffmpeg -f image2 -pattern_type glob -framerate 12 -i 'foo-*.jpeg' -s WxH foo.avi
  

• 你可以在输出中放置许多相同类型的流：

  ffmpeg -i test1.avi -i test2.avi -map 1:1 -map 1:0 -map 0:1 -map 0:0 -c copy -y test12.nut
  

  生成的输出文件test12.nut将包含输入文件的前四个流，以相反顺序排列。

• 强制CBR视频输出：

  ffmpeg -i myfile.avi -b 4000k -minrate 4000k -maxrate 4000k -bufsize 1835k out.m2v
  

• 四个选项lmin、lmax、mblmin和mblmax使用'lambda'单位，但你可以使用QP2LAMBDA常量轻松从'q'单位转换：

  ffmpeg -i src.ext -lmax 21*QP2LAMBDA dst.ext
  

7 语法

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

7.1 引用和转义

除非特别指定，FFmpeg采用以下引用和转义机制。这些规则适用：

• ‘'’和‘\’是特殊字符（分别用于引用和转义）。除此之外，根据使用转义和引用的具体语法，可能还有其他特殊字符。
• 通过在特殊字符前加‘\’.
• 所有包含在‘''’之间的字符都会字面地包含在解析的字符串中。引用字符‘'’本身不能被引用，因此可能需要关闭引号并转义它。
• 除非转义或引用，解析字符串的前导和尾随空白都会被移除。

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

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

工具tools/ffescape位于FFmpeg源码树中，可以用来在脚本中自动引用或转义字符串。

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

7.2 日期

接受的语法是：

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

如果值是"now"，它将采用当前时间。

时间为本地时间，除非追加Z，此时它将被解释为UTC。 如果未指定年月日部分，它将采用当前年月日。

7.3 时间持续

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

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

HH表示小时数，MM表示最多2位数字的分钟数，SS表示最多2位数字的秒数。米在最后表示十进制值秒.

or

[-]秒+[.米...][s|ms|us]

秒表示秒数，可包含可选的小数部分米。 可选的文字后缀‘s’, ‘ms’或‘us’表示将值解释为秒、毫秒或微秒。

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

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

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

7.5 视频帧率

指定视频的帧率，以每秒生成的帧数表示。必须是以下格式的字符串帧率分子/帧率分母，一个整数值，一个浮点数或一个有效的视频帧率缩写。

可以识别以下缩写:

‘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

7.6 比率

比率可以表示为一个表达式，或者形式为分子:分母.

请注意，无穷大（1/0）或负值的比率被认为是有效的，因此如果要排除这些值，需要对返回值进行检查。

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

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