1. 说明
2. Syntax 语法
2.1 Quoting and escaping 引用和转义
2.2 Date 日期
2.3 Time duration 持续时间
2.4 Video size 视频大小
2.5 Video rate 视频速率
2.6 Ratio 比率
2.7 Color 颜色
2.8 Channel Layout 通道布局
2.8.1 各个频道由 id 标识,如下表所示:
2.8.2 可以使用以下标识符指定标准通道布局组合:
2.8.3 各频道id空间图示:
2.8.4 自定义通道布局
3 Expression Evaluation 表达式评估
3.1 functions
3.2 constants 常数
3.3. International System prefixes 国际系统前缀
下文是ffmpeg官方页面(2021-06-17)的google自动翻译, 请参阅如下原文。
1. 说明
本文档描述了 libavutil 库提供的一些通用功能和实用程序。
2. Syntax 语法
本节记录了 FFmpeg 库和工具使用的语法和格式。
2.1 Quoting and escaping 引用和转义
除非明确指定,FFmpeg 采用以下引用和转义机制。应用以下规则:
- ‘'’ and ‘\’ 是特殊字符(分别用于引用和转义)。除了它们之外,根据使用转义和引用的特定语法,可能还有其他特殊字符。
- 特殊字符通过在它前面加上 ‘\’ 进行转义。
- 包含在 ‘''’ 之间的所有字符 字面上包含在解析的字符串中。引号字符 ''' 本身不能被引用,因此您可能需要关闭引用并转义它。
- 除非转义或引用,否则将从解析的字符串中删除前导和尾随空格。
请注意,在使用命令行或脚本时,您可能需要添加第二级转义,这取决于所采用的 shell 语言的语法。
在av_get_token定义 的函数libavutil / avstring.h 可用于根据上面定义的规则解析引用或转义的标记。
工具 tools/ffescape 在FFmpeg 源代码树中的 可用于自动引用或转义脚本中的字符串。
2.2 Date 日期
接受的语法是:
[(YYYY-MM-DD|YYYYMMDD)[T|t| ]]((HH:MM:SS[.m...]]])|(HHMMSS[.m...]]]))[Z]
now
如果值为“now”,则表示当前时间。
时间是本地时间,除非附加了 Z,在这种情况下,它被解释为 UTC。如果未指定年月日部分,则采用当前年月日。
2.3 Time duration 持续时间
有两种可接受的语法来表示持续时间。
[-][HH:]MM:SS[.m...]
HH表示小时数,MM表示分钟数,最多 2 位,SS表示秒数,最多 2 位。末尾的m表示SS 的十进制值 。
或者
[-]S+[.m...][s|ms|us]
S表示秒数,带有可选的小数部分 m。可选的文字后缀 's', 'ms', 'us' 表示将值分别解释为秒、毫秒或微秒。
在这两个表达式中,可选的 '-' 表示负持续时间。
Examples
The following examples are all valid time duration:
‘55’55 seconds
‘0.2’0.2 seconds
‘200ms’200 milliseconds, that’s 0.2s
‘200000us’200000 microseconds, that’s 0.2s
‘12:03:45’12 hours, 03 minutes and 45 seconds
‘23.189’23.189 seconds
2.4 Video size 视频大小
指定源视频的尺寸, 它可以是宽度x高度形式的字符串, 或者是尺寸缩写的名称。以下缩写被认可:
name | size | X*Y ↓ | y/(x/16);16:? |
sqcif | 128x96 | 12288 | 12 |
qqvga | 160x120 | 19200 | 12 |
qcif | 176x144 | 25344 | 13.0909 |
hqvga | 240x160 | 38400 | 10.6667 |
cga | 320x200 | 64000 | 10 |
qvga | 320x240 | 76800 | 12 |
qntsc | 352x240 | 84480 | 10.9091 |
film | 352x240 | 84480 | 10.9091 |
ntsc-film | 352x240 | 84480 | 10.9091 |
wqvga | 400x240 | 96000 | 9.6 |
qpal | 352x288 | 101376 | 13.0909 |
cif | 352x288 | 101376 | 13.0909 |
fwqvga | 432x240 | 103680 | 8.8889 |
hvga | 480x320 | 153600 | 10.6667 |
ega | 640x350 | 224000 | 8.75 |
nhd | 640x360 | 230400 | 9 |
sntsc | 640x480 | 307200 | 12 |
vga | 640x480 | 307200 | 12 |
ntsc | 720x480 | 345600 | 10.6667 |
4cif | 704x576 | 405504 | 13.0909 |
wvga | 852x480 | 408960 | 9.0141 |
hd480 | 852x480 | 408960 | 9.0141 |
pal | 720x576 | 414720 | 12.8 |
spal | 768x576 | 442368 | 12 |
svga | 800x600 | 480000 | 12 |
qhd | 960x540 | 518400 | 9 |
xga | 1024x768 | 786432 | 12 |
hd720 | 1280x720 | 921600 | 9 |
wxga | 1366x768 | 1049088 | 8.9956 |
sxga | 1280x1024 | 1310720 | 12.8 |
16cif | 1408x1152 | 1622016 | 13.0909 |
wsxga | 1600x1024 | 1638400 | 10.24 |
2kscope | 2048x858 | 1757184 | 6.703 |
uxga | 1600x1200 | 1920000 | 12 |
hd1080 | 1920x1080 | 2073600 | 9 |
2kflat | 1998x1080 | 2157840 | 8.6486 |
2k | 2048x1080 | 2211840 | 8.438 |
2kdci | 2048x1080 | 2211840 | 8.438 |
wuxga | 1920x1200 | 2304000 | 10 |
qxga | 2048x1536 | 3145728 | 12 |
woxga | 2560x1600 | 4096000 | 10 |
qsxga | 2560x2048 | 5242880 | 12.8 |
wqsxga | 3200x2048 | 6553600 | 10.24 |
4kscope | 4096x1716 | 7028736 | 6.703 |
uhd2160 | 3840x2160 | 8294400 | 9 |
4kflat | 3996x2160 | 8631360 | 8.6486 |
4k | 4096x2160 | 8847360 | 8.438 |
4kdci | 4096x2160 | 8847360 | 8.438 |
wquxga | 3840x2400 | 9216000 | 10 |
hsxga | 5120x4096 | 20971520 | 12.8 |
whsxga | 6400x4096 | 26214400 | 10.24 |
uhd4320 | 7680x4320 | 33177600 | 9 |
whuxga | 7680x4800 | 36864000 | 10 |
2.5 Video rate 视频速率
指定视频的帧速率,表示为每秒生成的帧数。它必须是格式为frame_rate_num / frame_rate_den的字符串 、整数、浮点数或有效的视频帧速率缩写。
以下缩写被认可:
‘ntsc’30000/1001
‘pal’25/1
‘qntsc’30000/1001
‘qpal’25/1
‘sntsc’30000/1001
‘spal’25/1
‘film’24/1
‘ntsc-film’24000/1001
2.6 Ratio 比率
比率可以表示为表达式,或以分子:分母的形式表示 。
请注意,无限 (1/0) 或负值的比率被认为是有效的,因此如果要排除这些值,则应检查返回值。
未定义的值可以使用“0:0”字符串表示。
2.7 Color 颜色
它可以是如下定义的颜色名称(不区分大小写匹配)或 [0x|#]RRGGBB[AA]序列,可能后跟 @ 和表示 alpha 分量的字符串。
alpha分量可以是由“0x”后跟一个十六进制数或0.0到1.0之间的十进制数组成的字符串,表示不透明度值('0x00' 或者 '0.0' 表示完全透明,'0xff' 或者 '1.0' 完全不透明)。如果未指定 alpha 分量,则 '0xff' 假设。
字符串 'random' 将产生随机颜色。
识别以下颜色名称:
$ ffmpeg -colors | color | cn | #RRGGBB |
AliceBlue | #f0f8ff | 爱丽丝蓝 | #f0f8ff |