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的封包而无需解码、过滤或编码它们。例如，考虑名为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以低质量进行编码；
• 使用 3 个线程解码该编码流；
• 将解码的视频与原始输入视频并排放置；
• 然后将组合视频无损编码并写入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时，仅用户映射的流会包含在该输出文件中，复杂过滤图输出描述的情况除外。

4.1.3 复杂过滤图

如果存在任何未标记的复杂过滤图输出流，它们将被添加到第一个输出文件中。如果输出格式不支持该流类型，会导致致命错误。在没有映射选项的情况下，包含这些流将跳过其类型的自动流选择。如果存在映射选项，这些过滤图流将与映射流一起包含。

具有标记接触点的复杂过滤图输出流必须被映射一次且只能一次。

4.1.4 流处理

流处理独立于流选择，除了字幕描述的情况。流处理通过-codec选项设置，与特定output文件中的流相关联。尤其是，编解码器选项由 ffmpeg 在流选择过程之后应用，因此不会影响流选择过程。如果没有为流类型指定-codec选项，ffmpeg 将选择默认的由输出文件复用器注册的编码器。

字幕除外。如果为输出文件指定了字幕编码器，找到的任何类型的第一个字幕流，无论是文本还是图像，都将包含在内。ffmpeg 不会验证指定的编码器是否可以转换所选流或转换后的流是否可接受在输出格式中。这通常适用：当用户手动设置编码器时，流选择过程无法检查编码后的流能否复用到输出文件中。如果不能，ffmpeg 将中止并all输出文件将无法处理。

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虽然C.mkv是一个接受字幕流的 Matroska 容器文件，但仅选择视频和音频流。out2.mkv中的字幕流是基于图像的，而 Matroska 复用器的默认字幕编码器是基于文本的，因此预期字幕的转码操作将失败，故不会选择该流。但在-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选项。

重采样音频过滤器被发送到第一个未使用的音频流，即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 [参数]

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

参数的可能值是： are:

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

默认情况下，程序将日志输出到stderr。如果终端支持彩色，错误和警告会被颜色标记。通过设置环境变量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 count (global)

覆盖CPU数的检测。此选项旨在用于测试。如果您不知道所做的具体操作，请勿使用它。

ffmpeg -cpucount 2

-max_alloc 字节

设定ffmpeg的malloc函数家族在堆上分配块的最大尺寸限制。使用极度谨慎时请使用此选项。如果不了解这样做的全部后果，请不要使用。默认值为INT_MAX。

5.3 AVOptions

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

generic

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

private

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

例如，要写入ID3v2.3头而不是默认的ID3v2.4头到一个MP3文件，请使用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。

注意：不能为布尔值的AVOptions使用-nooption语法，请使用-option 0/-option 1.

注意：旧的未公开的通过在选项名称前加上v/a/s来指定按流设置的AVOptions的方法现已过时，很快将被移除。

5.4 主要选项

-f fmt (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启用（默认情况下），这个定位点与位置之间的附加段将被解码并丢弃。对于流拷贝或者启用 will be decoded and discarded. When doing stream copy or when -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

并非所有复用器支持嵌入缩略图，并且那些支持的仅支持少量格式，例如JPEG或PNG。

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

标题

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

创建具有指定标题, 节目编号并添加指定的流。

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

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

类型可以是以下之一：

iamf_audio_element

分组属于同一个 IAMF 音频单元的流s that belong to the same IAMF Audio Element

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

audio_element_type

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

channel

可扩展的频道音频表示

scene

Ambisonics 表示

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

Ambisonics 模式。如果音频单元类型设置为频道，则此选项无效。

支持以下值：

mono

每个 Ambisonics 通道作为组中的单独单声道流进行编码

default_w

默认权重值

iamf_mix_presentation

分组属于所有 IAMF 音频单元同一 IAMF 混合陈述引用的流s that belong to all IAMF Audio Element the same IAMF Mix Presentation references

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

submix

混合陈述中的一个子混合。 此选项必须与其他选项用逗号分开。可以定义多个逗号分隔的条目，且至少要设置一个。

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

parameter_id

帧中可引用的用于后处理混合音频信号以生成播放音频信号的参数块标识符

parameter_rate

帧中参数块中对应此参数 ID的采样率持续时间字段表示为

default_mix_gain

当没有共享相同参数 ID的参数块用于指定帧时，应用的默认混合增益值

element

引用此混合陈述中用于生成最终输出音频信号以进行播放的音频单元。 此选项必须与其他选项用"|"分开。可以定义多个"|"分隔的条目，且至少要设置一个。

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

stg

The 流组 ID此子混合引用的音频单元

parameter_id

帧中可引用的参数块标识符，可用于对引用和渲染的音频单元进行任何处理，然后与其他处理的音频单元混合

parameter_rate

帧中参数块中对应此参数 ID的采样率持续时间字段表示为

default_mix_gain

当没有共享相同参数 ID的参数块用于指定帧时，应用的默认混合增益值

annotations

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

headphones_rendering_mode

指示当通过耳机回放时，基于频道的输入音频单元是渲染到立体声扬声器还是通过双耳渲染器进行空间化。 如果引用的音频单元的音频单元类型设置为频道，则此选项无效。

支持以下值：

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触发重新初始化的属性变化包括： 对于视频，帧分辨率或像素格式； 对于音频，采样格式、采样率、通道数或通道布局。

-drop_changed[:流_指定符] 整数 (input,per-stream)

该布尔选项决定在中流帧参数不同的情况下， 是丢弃该帧还是重新初始化过滤图，重新初始化会导致过滤状态丢失。 在实时流媒体输入中，通常为了避免损坏但可解码的包更为有用。默认值为假。

-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 URL (global)

将程序友好的进度信息发送到URL.

进度信息将会定期发送，并在编码过程结束时发送。格式为“键=值”行。键仅包含字母数字字符。一组进度信息中的最后一个键总是"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)

设置帧率（赫兹值、分数或简称）。

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

作为输出选项：

video encoding

在编码之前进行帧复制或丢弃，以实现固定的输出帧率帧率.

video streamcopy

向复用器标明帧率是流的帧率。在此情况下不会丢失或复制任何数据。如果帧率与通过分组时间戳确定的实际流帧率不一致，可能会生成无效文件。 另请参见setts比特流过滤器。

-fpsmax[:流指定符] 帧率 (output,per-stream)

设置最大帧率（赫兹值、分数或简称）。

在输出帧率自动设置且高于该值时限制输出帧率。 在批量处理或输入帧率误检测为非常高时较为有用。 它不能与-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，例如：

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的别名，请参阅过滤器选项。.

-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)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/标签 (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[如果时间参数之一是"deltadelta秒表示的时间。 此选项可用于确保输出文件中章节标记或其他设计位置存在一个可寻点。

例如，在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)

要在上一个强制帧后5秒强制一个关键帧，从第13秒开始：

-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 类型[=名称][:设备[,键=值...]]

初始化一个新的硬件设备，其类型为type，名称为name，使用指定的设备参数。 如果未指定名称，系统会赋予其默认名称，形式为 "type%d"。

的含义设备以下参数取决于设备类型：

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

在与供应商ID‘’相关的设备上创建VAAPI设备。$DISPLAY).

qsv

设备是一个X11显示名称。未指定时，将尝试打开默认X11显示 (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’在配置已指定时作为默认子设备类型。在Linux上，用户只能使用‘--enable-libmfx is specified at configuration time. On Linux user can use ‘vaapi’作为子设备类型。

示例：

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

使用‘MFX_IMPL_HARDWARE’在DRM渲染节点上创建QSV设备。/dev/dri/renderD129.

-init_hw_device qsv:hw,child_device=1

使用‘MFX_IMPL_HARDWARE’在DirectX适配器1上创建QSV设备。

-init_hw_device qsv:hw,child_device_type=d3d11va

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

-init_hw_device qsv:hw,child_device_type=dxva2

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

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

使用‘MFX_IMPL_HARDWARE’在DirectX适配器1上创建子设备类型为‘d3d11va’.

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

创建一个名为‘va’的VAAPI设备，/dev/dri/renderD129然后从设备‘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

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

vulkan

如果设备是一个整数，则根据系统相关的设备列表以索引选择设备。如果设备是其他字符串，则选择第一个名称包含该字符串的设备。

支持以下选项：

debug

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

linear_images

如果设置为1，则hwcontext分配的图像将是线性的并且可以在本地映射。

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

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

-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视频加速）硬件加速。

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

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

-fix_sub_duration_heartbeat[:流规格化]

设置特定输出视频流作为心跳流，用于拆分并传递当前处理中字幕，收到随机访问包时会立即处理。

这可以降低字幕延迟，但可能导致字幕事件的重复，以确保覆盖整个持续时间。对于不需要关注字幕传递到输出的时间延迟的使用场景，不应使用此选项。

需要-fix_sub_duration为相关输入字幕流设置，使其生效，同时输入字幕流必须直接映射到包含心跳流的相同输出。

5.7 音频选项

-aframes 数字 (output)

设置输出的音频帧数量。这是-frames:a的废弃别名，应该改用此选项。

-ar[:流规格化] 频率 (input/output,per-stream)

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

-aq 质量 (output)

设置音频质量（编解码器特定的，VBR）。这是-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 fourcc/标签 (output)

强制音频标签/fourcc。这是-tag:a.

-ch_layout[:的别名。] 流规格化 (input/output,per-stream)

布局-channel_layout.

-channel_layout[:别名为] 布局 (input/output,per-stream)

设置音频通道布局。对于输出流，默认设置为输入通道布局。 对于输入流，此选项覆盖输入的通道布局。但并非所有解码器都会遵循覆盖的通道布局。此选项还为音频抓取设备和原始解复用器设置通道布局，并映射到相应解复用器选项。

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

5.10 高级字幕选项

-fix_sub_duration

修复字幕时长。对于每个字幕，等待同一流中的下一个数据包，并调整第一个字幕的时长以避免重叠。 对于一些字幕编解码器（特别是DVB字幕），这是必要的，因为原始包中的时长只是一个粗略的估计，结束实际上是由一个空字幕帧标志的。如果在必要时未使用此选项，可能会导致时长被放大或由于非单调时间戳而出现复用失败。

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

-canvas_size 大小

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

5.11 高级选项

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

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

在第一种形式中，为输入文件中索引为input_file_id的每个流创建一个输出流。如果提供了stream_specifier，则仅使用匹配指定符的流（详见流指定符章节了解stream_specifier的语法）。

在流标识符前加一个-字符会创建一个“否定”映射。它会禁用已经创建映射的匹配流。

可以在流指定符之后提供一个可选的view_specifier，用于多视图视频中指定要使用的视图。视图指定符可以采用以下格式之一：

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运行持续时间秒的CPU用户时间后退出。

-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/帧率；对于音频，使用1/采样率。

demux

使用解复用器的时间基数。

filter

使用过滤图的时间基数。

a positive number

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

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

默认值是0。

-bitexact (input/output)

启用（去）复用器和（解）编码器的精确位模式

-shortest (output)

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

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

-shortest_buf_duration 持续时间 (output)

该-shortest选项可能需要在至少一个流是“稀疏”的情况下（即帧之间有较大间隔——这通常发生在字幕流中）缓冲潜在的大量数据。

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

默认值为10秒。

-dts_delta_threshold 阈值

时间戳不连续性的差值阈值，以秒的十进制数字表示。

该选项启用的时间戳不连续性校正仅适用于接受时间戳不连续性的输入格式（即AVFMT_TS_DISCONT标志已启用），例如MPEG-TS和HLS。-copyts（除非检测到包装情况）时自动禁用。

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

默认值为10。

-dts_error_threshold 阈值

时间戳错误差值阈值，以秒的十进制数字表示。

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

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

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

-muxdelay 秒 (output)

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

-muxpreload 秒 (output)

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

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

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

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

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]指代第一个输入文件中的第一个视频流，该文件链接到overlay滤镜的第一个（主）输入。同样地，第二个输入中的第一个视频流链接到overlay滤镜的第二个（覆盖）输入。

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

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同样也可以工作)color生成5秒纯红色视频使用lavfi

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

的时间基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控制生成文件的格式版本。

对于版本1，格式为：

frame= FRAME q= FRAME_QUALITY PSNR= PSNR f_size= FRAME_SIZE s_size= STREAM_SIZEkB time= TIMESTAMP br= BITRATEkbits/s avg_br= AVERAGE_BITRATEkbits/s

对于版本2，格式为：

out= OUT_FILE_INDEX st= OUT_FILE_STREAM_INDEX frame= FRAME_NUMBER q= FRAME_QUALITYf PSNR= PSNR f_size= FRAME_SIZE s_size= STREAM_SIZEkB time= TIMESTAMP br= BITRATEkbits/s avg_br= AVERAGE_BITRATEkbits/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转换为22050 Hz采样率的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 kbps的a.mp2和128 kbps的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编码的，因此您需要通过传递--enable-libmp3lame到配置中启用LAME支持。映射在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）。

  例如，从符合通配符模式的文件名创建视频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表示分钟数（最多两位数字），SS表示秒数（最多两位数字）。m末尾表示小数的值是秒.

or

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

秒表示秒数，可带有可选的小数部分m。 可选的文字后缀‘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