19.重新采样器选项
音频重采样器支持以下命名选项。
可以通过在FFmpeg工具中指定-option值，为aresample过滤器指定option = value，通过在SwrContext选项中显式设置值或使用libavutil / opt.h``API进行编程来设置选项。
ich，in_channel_count
设置输入通道的数量。默认值为0。如果设置了相应的通道布局in_channel_layout，则不必设置此值。
och，out_channel_count
设置输出通道的数量。默认值为0。如果设置了相应的通道布局out_channel_layout，则不必设置此值。
uch，used_channel_count
设置已使用输入通道的数量。默认值为0。此选项仅用于特殊重映射。
isr，in_sample_rate
设置输入采样率。默认值为0。
osr，out_sample_rate
设置输出采样率。默认值为0。
isf，in_sample_fmt
指定输入样本格式。它默认设置为none。
osf，out_sample_fmt
指定输出样本格式。它默认设置为none。
tsf，internal_sample_fmt
设置内部样本格式。默认值为none。未明确设置时，将自动选择此选项。
icl，in_channel_layout
ocl，out_channel_layout
设置输入/输出通道布局。
有关所需语法，请参阅（ffmpeg-utils）channel布局语法。
clev，center_mix_level
设置中心混音水平。它是以deciBel表示的值，并且必须在区间[-32,32]中。
slev，surround_mix_level
设置环绕声混音水平。它是以deciBel表示的值，并且必须在区间[-32,32]中。
lfe_mix_level
将LFE混音设置为非LFE级别。当有LFE输入但没有LFE输出时使用。它是以deciBel表示的值，并且必须在区间[-32,32]中。
rmvol，rematrix_volume
设置rematrix卷。默认值为1.0。
rematrix_maxval
设置重新矩阵的最大输出值。这可用于防止削波与防止音量减小。值1.0可防止剪裁。
flags, swr_flags
设置转换器使用的标志。 默认值为0。
它支持以下各个标志：
| 值 | 解释 |
|---|---|
| res | 强制重新采样，即使输入和输出采样率匹配，此标志也会强制使用重采样 |
dither_scale
设置抖动比例。 默认值为1。
dither_method
设置抖动方法。 默认值为0。
支持如下的值：
| 值 | 解释 |
|---|---|
| rectangular | 选择矩形抖动 |
| triangular | 选择三角形抖动 |
| triangular_hp | 选择高通三角形抖动 |
| lipshitz | 选择Lipshitz噪音塑造抖动 |
| shibata | 选择Shibata噪音整形抖动 |
| low_shibata | 选择低Shibata噪声整形抖动 |
| high_shibata | 选择高Shibata噪声整形抖动 |
| f_weighted | 选择f加权噪声整形抖动 |
| modified_e_weighted | 选择修改的e加权噪声整形抖动 |
| improved_e_weighted | 选择改进的e加权噪声整形抖动 |
resampler
设置重采样引擎。 默认值为swr。
支持的值如下：
| 值 | 解释 |
|---|---|
| swr | 选择原生SW重采样器; 过滤器选项精度和cheby在这种情况下不适用 |
| soxr | 选择SoX重采样器（如果可用）; 补偿和过滤器选项filter_size，phase_shift，exact_rational，filter_type和kaiser_beta在这种情况下不适用 |
filter_size
仅对于swr，设置重采样过滤器大小，默认值为32。
phase_shift
仅对于swr，设置重采样相移，默认值为10，并且必须在区间[0,30]中。
linear_interp
启用时使用线性插值（默认值）。 如果要在exact_rational失败时保持速度而不是质量，请禁用它。
exact_rational
仅对于swr，启用时，尝试根据输入和输出采样率使用精确的phase_count。 但是，如果它大于1 << phase_shift，则phase_count将为1 << phase_shift作为后退。 默认值已启用。
cutoff
设置截止频率（swr：6dB点; soxr：0dB点）比率; 必须是介于0和1之间的浮点值。默认值为0.97（swr）和0.91（soxr）（采样率为44100，保留整个音频频段为20kHz）。
precision
仅对于soxr，将计算重采样信号的位精度。 默认值20（通过适当的抖动，适用于目标位深度为16），可以得到SoX的High Quality; 值28表示SoX的Very High Quality。
cheby
仅对于soxr，选择passband rolloff none（Chebyshev）和irrational比率的更高精度近似。 默认值为0。
async
仅对于swr，使用拉伸，挤压，填充和修剪的简单1参数音频同步到时间戳。 将此值设置为1将启用填充和修剪，较大的值表示样本中每秒可以拉伸或挤压数据的最大量。 默认值为0，因此不会应用补偿使样本与音频时间戳匹配。
first_pts
仅对于swr，假设第一个pts应为此值。 时间单位是1 / sample rate。 这允许在流的开始处进行padding/trimming。 默认情况下，不会对第一帧的预期pts做出假设，因此不会进行填充或修剪。 例如，如果音频流在视频流之后开始，则可以将其设置为0以用静音填充开头，或者由于编码器延迟而用负pts修剪任何样本。
min_comp
仅对于swr，设置时间戳和音频数据之间的最小差异（以秒为单位），以触发拉伸/挤压/填充或修剪数据，使其与时间戳匹配。 默认情况下，拉伸/挤压/填充和修剪被禁用（min_comp'= FLT_MAX）。
min_hard_comp
仅对于swr，设置时间戳和音频数据之间的最小差异（以秒为单位）以触发添加/删除样本以使其与时间戳匹配。 此选项实际上是在hard (trim/fill)和soft (squeeze/stretch)补偿之间进行选择的阈值。 请注意，默认情况下，通过min_comp禁用所有补偿。 默认值为0.1。
comp_duration
仅对于swr，设置延长/挤压数据的持续时间（以秒为单位），使其与时间戳匹配。 必须是非负双浮点值，默认值为1.0。
max_soft_comp
仅对于swr，设置拉伸/挤压数据的最大因子，使其与时间戳匹配。 必须是非负双浮点值，默认值为0。
matrix_encoding
选择矩阵立体声编码。
它接受以下值：
| 值 | 解释 |
|---|---|
| none | 选择none
|
| dolby | 选择dolby
|
| dplii | 选择Dolby Pro Logic II
|
默认值是none。
filter_type
仅对于swr，选择重采样过滤器类型。 这仅影响重采样操作。
它接受以下值：
| 值 | 解释 |
|---|---|
| cubic | 选择立方体 |
| blackman_nuttall | 选择Blackman Nuttall窗口sinc
|
| kaiser | 选择Kaiser窗口sinc
|
kaiser_beta
仅对于swr，设置Kaiser窗口beta值。 必须是区间[2,16]中的双浮点值，默认值为9。
output_sample_bits
仅对于swr，设置用于抖动的已使用输出采样位数。 必须是区间[0,64]中的整数，默认值为0，这意味着它不被使用。
20.缩放选项
视频缩放器支持以下命名选项。
可以通过在FFmpeg工具中指定-option值来设置选项。 对于程序化使用，可以在SwsContext选项中或通过libavutil / opt.h``API显式设置它们。
sws_flags
设置缩放器标志。 这也用于设置缩放算法。 只应选择一个算法。 默认值为bicubic。
它接受以下值：
| 值 | 解释 |
|---|---|
| fast_bilinear | 选择快速双线性缩放算法 |
| bilinear | 选择双线性缩放算法 |
| bicubic | 选择双三次缩放算法 |
| experimental | 选择实验缩放算法 |
| neighbor | 选择最近邻居重新缩放算法 |
| area | 选择平均区域重新缩放算法 |
| bicublin | 为亮度分量选择双三次缩放算法，为色度分量选择双线性 |
| gauss | 选择高斯重新缩放算法 |
| sinc | 选择sinc重新缩放算法 |
| lanczos | 选择Lanczos重新缩放算法 |
| spline | 选择自然双三次样条重新缩放算法 |
| print_info | 启用打印/调试日志记录 |
| accurate_rnd | 启用精确舍入 |
| full_chroma_int | 启用全色度插值 |
| full_chroma_inp | 选择全色度输入 |
| bitexact | 启用bitexact输出 |
srcw
设置源宽度。
srch
设置源高度。
dstw
设置目标宽度。
dsth
设置目的地高度。
src_format
设置源像素格式（必须表示为整数）。
dst_format
设置目标像素格式（必须表示为整数）。
src_range
选择源范围。
dst_range
选择目的地范围。
param0，param1
设置缩放算法参数。 指定的值特定于某些缩放算法，并被其他人忽略。 指定的值是浮点数值。
sws_dither
设置抖动算法。 接受以下值之一。 默认值为auto。
| 值 | 解释 |
|---|---|
| auto | 自动选择 |
| none | 没有抖动 |
| bayer | bayer抖动 |
| ed | 误差扩散抖动 |
| a_dither | 算术抖动，基于加法 |
| x_dither | 算术抖动，使用xor（更随机/更不明显的图案化a_dither） |
alphablend
设置alpha混合以在输入具有alpha但输出不具有alpha时使用。 默认值为none。
| 值 | 解释 |
|---|---|
| uniform_color | 混合均匀的背景颜色 |
| checkerboard | 混合到棋盘上 |
| none | 没有混合 |
21.过滤简介
通过libavfilter库启用FFmpeg中的过滤。
在libavfilter中，过滤器可以有多个输入和多个输出。 为了说明可能的事情，我们考虑以下过滤器图。
[main]
input --> split ---------------------> overlay --> output
| ^
|[tmp] [flip]|
+-----> crop --> vflip -------+
此过滤器图将输入流分成两个流，然后通过裁剪过滤器和vflip过滤器发送一个流，然后通过将其重叠在顶部将其与另一个流合并。 可以使用以下命令来实现此目的：
ffmpeg -i INPUT -vf "split [main][tmp]; [tmp] crop=iw:ih/2:0:0, vflip [flip]; [main][flip] overlay=0:H/2" OUTPUT
结果是视频的上半部分镜像到输出视频的下半部分。
同一线性链中的过滤器用逗号分隔，过滤器的不同线性链用分号分隔。在我们的示例中，crop，vflip在一个线性链中，split和overlay分别在另一个中。线性链连接的点由方括号括起来的名称标记。在该示例中，分割滤波器生成两个与标签[main]和[tmp]相关联的输出。
发送到分割的第二个输出（标记为[tmp]）的流通过裁剪滤镜处理，裁剪滤镜裁掉视频的下半部分，然后垂直翻转。叠加滤波器输入分割滤波器的第一个未改变的输出（标记为[main]），并在其下半部分覆盖由crop，vflip滤波器链生成的输出。
有些过滤器会输入一个参数列表：它们在过滤器名称和等号后面指定，并用冒号分隔。
存在所谓的没有音频/视频输入的源滤波器，以及不具有音频/视频输出的宿滤波器。
22. graph2dot
FFmpeg``tools目录中包含的graph2dot程序可用于解析filtergraph描述并以点语言发出相应的文本表示。
调用命令如下：
graph2dot -h
看看如何使用graph2dot。
然后，可以将点描述传递给dot程序（来自graphviz程序套件），并获得filtergraph的图形表示。
例如命令序列：
echo GRAPH_DESCRIPTION | \
tools/graph2dot -o graph.tmp && \
dot -Tpng graph.tmp -o graph.png && \
display graph.png
可用于创建和显示表示GRAPH_DESCRIPTION字符串描述的图形的图像。 请注意，此字符串必须是完整的自包含图形，并明确定义其输入和输出。 例如，命令行具有以下形式：
ffmpeg -i infile -vf scale=640:360 outfile
GRAPH_DESCRIPTION字符串必须是以下形式：
nullsrc,scale=640:360,nullsink
可能还需要设置nullsrc参数并添加格式过滤器以模拟特定的输入文件。
23.滤波器描述
滤波器图是连接滤波器的有向图。 它可以包含循环，并且一对过滤器之间可以有多个链接。 每个链路在一侧具有一个输入焊盘，将其连接到一个用于输入的滤波器，另一侧的一个输出焊盘将其连接到接受其输出的一个滤波器。
filtergraph中的每个过滤器都是应用程序中注册的过滤器类的实例，它定义了过滤器的特征和输入和输出焊盘的数量。
没有输入焊盘的滤波器称为source，没有输出焊盘的滤波器称为sink。
23.1 Filtergraph语法
filtergraph有一个文本表示，由ffmpe中的-filter'/' - vf'/' - af和-filter_complex选项以及ffplay中的-vf'/' - af识别，并由libavfilter / avfilter.h中定义的avfilter_graph_parse_ptr（）函数。
过滤链由一系列连接的过滤器组成，每个过滤器连接到序列中的前一个过滤器。过滤链由， - 分隔的过滤器描述列表表示。
filtergraph由一系列过滤链组成。一系列过滤链由;列表表示 -分离的过滤链描述。
过滤器由以下形式的字符串表示：[in_link_1] ... [in_link_N] filter_name @ id = arguments [out_link_1] ... [out_link_M]
filter_name是过滤器类的名称，其描述的过滤器是其实例，并且必须是在程序中注册的过滤器类之一的名称，可选地后跟@id。筛选器类的名称后跟可选的字符串= arguments。
arguments是一个字符串，其中包含用于初始化过滤器实例的参数。它可能有以下两种形式之一：
一个
：-key=value对的分隔列表。一个
：- 分隔的值列表。 在这种情况下，键被假定为声明它们的顺序中的选项名称。 例如。 淡入淡出过滤器按此顺序声明三个选项 -type，start_frame和nb_frames。 然后参数列表：0：30表示将值分配给选项type，0分配给start_frame，30分配给nb_frames。：- 混合直接值和长key=value对的分隔列表。 直接值必须在key=value对之前，并遵循前一点的相同约束顺序。 可以按任何首选顺序设置以下key = value对。
如果选项值本身是项目列表（例如，格式过滤器采用像素格式列表），则列表中的项目通常用|分隔。
可以使用字符'作为起始和结束标记引用参数列表，并使用字符\来引用引用文本中的字符;否则，当遇到下一个特殊字符（属于集合[] =;，）时，参数字符串被视为终止。
过滤器的名称和参数可选地前面和后面是链接标签列表。链接标签允许用户命名链接并将其与过滤器输出或输入板相关联。前面的标签in_link_1 ... in_link_N与滤波器输入焊盘相关联，以下标签out_link_1 ... out_link_M与输出焊盘相关联。
当在filtergraph中找到两个具有相同名称的链接标签时，将创建相应输入和输出板之间的链接。
如果未标记输出焊盘，则默认情况下将其链接到滤波器链中下一个滤波器的第一个未标记输入焊盘。例如在过滤链中
nullsrc, split[L1], [L2]overlay, nullsink
分离滤波器实例有两个输出pads，而叠加滤波器实例有两个输入pads。 分割的第一输出垫标记为L1，覆盖的第一输入垫标记为L2，并且分割的第二输出垫链接到覆盖的第二输入垫，其均未标记。
在过滤器描述中，如果未指定第一个过滤器的输入标签，则假定为in; 如果未指定最后一个过滤器的输出标签，则假定为out。
在完整的滤波链中，必须连接所有未标记的滤波器输入和输出焊盘。 如果所有滤波器链的所有滤波器输入和输出焊盘都连接在一起，则滤波器图被认为是有效的。
Libavfilter将自动插入需要格式转换的缩放过滤器。 可以通过预先添加sws_flags = flags为自动插入的缩放器指定swscale标志; 到filtergraph描述。
以下是filtergraph语法的BNF描述：
NAME ::= sequence of alphanumeric characters and '_'
FILTER_NAME ::= NAME["@"NAME]
LINKLABEL ::= "[" NAME "]"
LINKLABELS ::= LINKLABEL [LINKLABELS]
FILTER_ARGUMENTS ::= sequence of chars (possibly quoted)
FILTER ::= [LINKLABELS] FILTER_NAME ["=" FILTER_ARGUMENTS] [LINKLABELS]
FILTERCHAIN ::= FILTER [,FILTERCHAIN]
FILTERGRAPH ::= [sws_flags=flags;] FILTERCHAIN [;FILTERGRAPH]
23.2 Notes on filtergraph escaping
Filtergraph描述组合需要几个级别的转义。 有关使用的转义过程的更多信息，请参阅（ffmpeg-utils）quoting_and_escaping。
第一级转义会影响每个过滤器选项值的内容，其中可能包含特殊字符：用于分隔值或其中一个转义字符\。
第二级转义会影响整个过滤器描述，其中可能包含转义字符\或特殊字符[] ,; filtergraph描述使用的。
最后，当在shell命令行上指定filtergraph时，需要对其中包含的shell特殊字符执行第三级转义。
例如，考虑将以下字符串嵌入到drawtext过滤器描述text值中：
this is a 'string': may contain one, or more, special characters
此字符串包含'特殊转义字符和：特殊字符，因此需要以这种方式转义：
text=this is a \'string\'\: may contain one, or more, special characters
将过滤器描述嵌入到filtergraph描述中时，需要第二级转义，以便转义所有filtergraph特殊字符。 因此上面的例子变成：
drawtext=text=this is a \\\'string\\\'\\: may contain one\, or more\, special characters
（请注意，除了\'转义特殊字符外，还需要进行转义）。
最后，在shell命令中编写filtergraph描述时需要额外的转义级别，这取决于所采用的shell的转义规则。 例如，假设\是特殊的并且需要使用另一个\来转义，前一个字符串最终将导致：
-vf "drawtext=text=this is a \\\\\\'string\\\\\\'\\\\: may contain one\\, or more\\, special characters"
24.时间表编辑
某些过滤器支持通用的enable选项。 对于支持时间轴编辑的过滤器，可以将此选项设置为在将帧发送到过滤器之前计算的表达式。 如果评估非零，则将启用过滤器，否则帧将不变地发送到过滤器图中的下一个过滤器。
表达式接受以下值：
t
时间戳以秒表示，如果输入时间戳未知，则为NAN.
n
输入帧的序号，从0开始
pos
输入框文件中的位置，如果未知，则为NAN
w
h
视频输入帧的宽度和高度。
此外，这些过滤器支持enable命令，可用于重新定义表达式。
与任何其他过滤选项一样，enable选项遵循相同的规则。
例如，要启用模糊滤镜（smartblur）10秒到3分钟，曲线滤镜从3秒开始：
smartblur = enable='between(t,10,3*60)',
curves = enable='gte(t,3)' : preset=cross_process
请参阅ffmpeg -filters以查看哪些过滤器具有时间轴支持。
25.具有多个输入的过滤器选项（帧同步）
一些具有多个输入的过滤器支持一组通用选项。 这些选项只能通过名称设置，而不能使用简短表示法。
eof_action
在辅助输入上遇到EOF时要采取的操作; 它接受以下值之一：
| 值 | 解释 |
|---|---|
| repeat | 重复最后一帧（默认） |
| endall | 结束两个流 |
| pass | 通过主输入 |
shortest
如果设置为1，则在最短输入终止时强制输出终止。 默认值为0。
repeatlast
如果设置为1，则强制过滤器扩展辅助流的最后一帧，直到主流结束。 值为0将禁用此行为。 默认值为1。
