2021-06-30

ffmpeg-metadata

1. 设置元数据
	1.1 设置文件标题
	1.2 删除所有流标题
	1.3 设置音频流语言
	1.4 选项说明
2. 元数据文件-章节
	2.1 提取元数据
	2.2 编辑元数据文件
	2.3 加载元数据文件
	2.4 元数据文件说明
	2.5 选项说明
3. 设置默认流
	3.1 删除第一个音频流的默认属性,设置第二个音频流为默认
	3.2 选项说明

1. 设置元数据

1.1 设置文件标题

$ ffmpeg -i Jurassic.World.mkv -map 0 -c copy -metadata title="Jurassic World" out.mkv
$ ffprobe -hide_banner out.mkv 
Input #0, matroska,webm, from 'out.mkv':
  Metadata:
    title           : Jurassic World

1.2 删除所有流标题

$ ffmpeg -i Jurassic.World-2015.mkv -map 0 -c copy -metadata:s title="" out.mkv
删除0号流标题
$ ffmpeg -i Jurassic.World-2015.mkv -map 0 -c copy -metadata:s:0 title="" out.mkv
修改前: 
$ ffprobe -hide_banner Jurassic.World.mkv 
Input #0, matroska,webm, from 'Jurassic.World-2015.mkv':
  Metadata:
    title           : www.------.com
  Stream #0:0(eng): Video: h264 (High), yuv420p(tv, bt709/bt709/unknown, progressive), 1920x960, SAR 1:1 DAR 2:1, 23.98 fps, 23.98 tbr, 1k tbn, 47.95 tbc (default)
    Metadata:
      title           : ------.com
  Stream #0:1(hin): Audio: aac (LC), 48000 Hz, stereo, fltp
    Metadata:
      title           : ------.com
  Stream #0:2(eng): Audio: aac (LC), 48000 Hz, stereo, fltp (default)
    Metadata:
      title           : ------.com

1.3 设置音频流语言

$ ffprobe -hide_banner Jurassic.World-2015.mkv 
  Stream #0:1(hin): Audio: aac (LC), 48000 Hz, stereo, fltp
$ ffmpeg -i Jurassic.World-2015.mkv -map 0 -c copy -metadata:s:a:0 language=eng out.mkv
$ ffprobe -hide_banner out.mkv 
  Stream #0:1(eng): Audio: aac (LC), 48000 Hz, stereo, fltp

1.4 选项说明

-metadata[:metadata_specifier] key=value (output,per-metadata)
设置元数据键/值对。可以给出可选的metadata_specifier来设置流、章节或节目的元数据。有关-map_metadata 详细信息,请参阅文档。
此选项会覆盖使用-map_metadata. 也可以使用空值删除元数据。
例如,在输出文件中设置标题:
  ffmpeg -i in.avi -metadata title="my title" out.flv
设置第一个音频流的语言:
  ffmpeg -i INPUT -metadata:s:a:0 language=eng OUTPUT

-map_chapters input_file_index (output)
将具有索引input_file_index 的输入文件中的章节复制到下一个输出文件。如果未指定章节映射,则从包含至少一个章节的第一个输入文件复制章节。使用负文件索引禁用任何章节复制。

-program [title=title:][program_num=program_num:]st=stream[:st=stream...] (output)
创建具有指定的节目标题,program_num和指定添加 流(多个)给它。

2. 元数据文件-章节

2.1 提取元数据

分别提取包含及不包含章节的元数据
$ ffmpeg -i IceAge3.mp4 -f ffmetadata fmetadata.txt

2.2 编辑元数据文件

参照编辑元数据文件, 添加章节
[CHAPTER]
TIMEBASE=1/1000
START=190000
# 00:03:10 - 00:06:00 | 170
END=360000
title=Chapter 02a False alarm!
[CHAPTER]
TIMEBASE=1/1000
START=360000
# 00:06:00 - 00:11:00 | 300
END=660000
title=Chapter 03a Playground for Junior
...

2.3 加载元数据文件

$ ffmpeg -i IceAge3.mp4 -i fmetadata.txt -map_metadata 1 -codec copy out.mp4
打开这个新的视频文件, VLC播放器下面多出了前进或后退到章节的按钮. 鼠标移动到进度栏, 就会显示出章节的节点及当前位置的标题名称.

2.4 元数据文件说明

FFmpeg 能够将媒体文件中的元数据转储到一个简单的 UTF-8 编码的类似 INI 的文本文件中,然后使用元数据复用器/解复用器将其加载回来。
文件格式如下:
  • 一个文件由一个标题和许多元数据标签组成,这些标签分为多个部分,每个部分占一行。
  • 标头是一个‘;FFMETADATA’字符串,后跟一个版本号(现在是 1)。
  • 元数据标签的形式为‘key=value’
  • 全局元数据紧跟在标头之后
  • 在全局元数据之后,可能会有包含每个流/每个章节(per-stream/per-chapter)元数据的部分。
  • 一个部分以大写的部分名称(即 STREAM 或 CHAPTER)在方括号(‘[’、‘]’)中开始,并以下一个部分或文件结尾结束。
  • 在chapter章节部分的开头,可能有一个可选的时基用于开始/结束值。它必须采用‘TIMEBASE=num/den’形式,其中 num 和 den 是整数。如果缺少时基,则假定开始/结束时间以纳秒为单位。
  • 接下来,chapter章节部分必须包含格式为‘START=num’、‘END=num’的章节开始和结束时间,其中 num 是一个正整数。
  • 空行和以“;”或“#”开头的行将被忽略。
  • 包含特殊字符(‘=’、‘;’、‘#’、‘\’和换行符)的元数据键或值必须用反斜杠‘\’转义。
  • 请注意,元数据中的空格被认为是标签的一部分(e.g. ‘foo = bar’)(这里的 key 是 ‘foo ’, value 是 ‘ bar’).
ffmetadata 文件可能如下所示:
;FFMETADATA1
title=bike\\shed
;this is a comment
artist=FFmpeg troll team

[CHAPTER]
TIMEBASE=1/1000
START=0
#chapter ends at 0:01:00
END=60000
title=chapter \#1
[STREAM]
title=multi\
line
通过使用 ffmetadata muxer 和 demuxer,可以将元数据从输入文件提取到 ffmetadata 文件,然后将文件转码为带有编辑过的 ffmetadata 文件的输出文件。
使用 ffmpeg 提取 ffmetadata 文件如下:
ffmpeg -i INPUT -f ffmetadata FFMETADATAFILE
从 FFMETADATAFILE 文件重新插入编辑过的元数据信息可以通过以下方式完成:
ffmpeg -i INPUT -i FFMETADATAFILE -map_metadata 1 -codec copy OUTPUT

2.5 选项说明

-map_metadata[: metadata_spec_out ] infile [: metadata_spec_in ] ( output,per-metadata )
从infile设置输出文件的元数据信息。请注意,这些是文件索引(从零开始),而不是文件名。可选的metadata_spec_in/out参数指定要复制的元数据。元数据说明符可以具有以下形式:
g  全局元数据,即适用于整个文件的元数据
s[:stream_spec]  每个流元数据。stream_spec是流说明符,如流说明符章节中所述。在输入元数据说明符中,复制第一个匹配的流。在输出元数据说明符中,所有匹配的流都被复制到。
c:chapter_index  每章元数据。chapter_index是从零开始的章节索引。
p:program_index  每个程序的元数据。program_index是从零开始的节目索引。
如果省略元数据说明符,则默认为全局。
默认情况下,全局元数据从第一个输入文件复制,每个流和每个章节的元数据与流/章节一起复制。通过创建相关类型的任何映射来禁用这些默认映射。负文件索引可用于创建仅禁用自动复制的虚拟映射。
例如,将元数据从输入文件的第一个流复制到输出文件的全局元数据:
  ffmpeg -i in.ogg -map_metadata 0:s:0 out.mp3
反过来,也就是将全局元数据复制到所有音频流:
  ffmpeg -i in.mkv -map_metadata:s:a 0:g out.mkv
请注意,简单的0在此示例中也能正常工作,因为默认情况下采用全局元数据。

3. 设置默认流

3.1 删除第一个音频流的默认属性,设置第二个音频流为默认

$ ffmpeg -i input.mkv -hide_banner
  Stream #0:0: Video: h264 (High), yuv420p(tv, progressive), 1080x454 [SAR 908:909 DAR 240:101], SAR 1:1 DAR 540:227, 23.98 fps, 23.98 tbr, 1k tbn, 47.95 tbc (default)
  Stream #0:1(hin): Audio: vorbis, 48000 Hz, 5.1, fltp (default)
  Stream #0:2(eng): Audio: vorbis, 48000 Hz, 5.1, fltp
  Stream #0:3(eng): Subtitle: ass (default)

$ ffmpeg -i input.mkv -map 0 -c copy -disposition:a:0 0 -disposition:a:1 default out.mkv

$ ffprobe -hide_banner out.mkv 
  Stream #0:0: Video: h264 (High), yuv420p(tv, progressive), 1080x454 [SAR 908:909 DAR 240:101], SAR 1:1 DAR 540:227, 23.98 fps, 23.98 tbr, 1k tbn, 47.95 tbc (default)
  Stream #0:1(hin): Audio: vorbis, 48000 Hz, 5.1, fltp
  Stream #0:2(eng): Audio: vorbis, 48000 Hz, 5.1, fltp (default)
  Stream #0:3(eng): Subtitle: ass (default)

3.2 选项说明

$ man ffmpeg |grep -A 10 disposition
-disposition[:stream_specifier] value (output,per-stream)
设置流的处置。此选项会覆盖从输入流复制的处置。也可以通过将其设置为 0 来删除处置。
认可以下处置:
default; dub 配音; original 原来的; comment 评论; lyrics 歌词; karaoke 卡拉OK; forced 被迫; hearing_impaired 听力障碍; visual_impaired 视觉障碍; clean_effects 清洁效果; attached_pic 附加图片; captions 字幕; descriptions 说明; dependent 依赖; metadata 元数据.
例如,要使第二个音频流成为默认流:
  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
并非所有多路复用器都支持嵌入式缩略图,支持的多路复用器仅支持几种格式,例如 JPEG 或 PNG。

2021-06-26

FFmpeg-Screen-Recording

1. Linux 系统
2. 苹果 OS X 系统
3. Windows 系统
	3.1 使用 DirectShow ​device设备采集音视频数据:
	3.2 使用内置 GDI 屏幕抓取器
4. 硬件编码
5. 无损录制
6. 无损录音
7. 更多例子参考
8. See also

以下是一些使用 ffmpeg 捕获桌面和录制屏幕视频的解决方案。
为简洁起见,这些命令没有指定任何额外的编码器设置。
默认情况下,这些命令将使用 x264 编码器,这在现代机器上应该相当快。

1. Linux 系统

使用 x11grab 设备采集视频图像:
$ ffmpeg -video_size 1024x768 -framerate 25 -f x11grab -i :0.0+100,200 output.mp4
这条命令将会从桌面图像的左上角偏移坐标位置为 (x=100, y=200)处获取宽高为1024x768的图像, .
如果需要加入音频,则采集 ALSA: 
$ ffmpeg -video_size 1024x768 -framerate 25 -f x11grab -i :0.0+100,200 -f alsa -ac 2 -i hw:0 output.mkv
或者采集 pulse 输入设备:
$ ffmpeg -video_size 1024x768 -framerate 25 -f x11grab -i :0.0+100,200 -f pulse -ac 2 -i default output.mkv

2. 苹果 OS X 系统

使用 avfoundation 设备采集音视频:
ffmpeg -f avfoundation -list_devices true -i ""
这条命令执行后将列出所有 avfoundation 的音频、视频采集设备列表。 可以通过指定想要采集的设备名采集音频、视频:
ffmpeg -f avfoundation -i "<screen device index>:<audio device index>" out.mov
这条命令执行后将会从 <screen device index> 编号处获得视频图像,从 <audio device index> 编号处获得音频数据写入至输出文件 out.mov 中.

3. Windows 系统

3.1 使用 DirectShow device设备采集音视频数据:

ffmpeg -f dshow -i video="screen-capture-recorder" output.flv
执行这条命令后将会 从DirectShow 设备中获得桌面图像并输出为output。flv文件. 
如果需要采集视频外还需要采集音频则使用如下命令:
ffmpeg -f dshow -i video="UScreenCapture":audio="Microphone" output.flv
如果你想获得正在从扬声器播放的音频,需要配置 “Stereo Mix” 设备
或者
ffmpeg -f dshow -i video="UScreenCapture" -f dshow -i audio="Microphone" output.flv
可以通过如下命令行列出所有dshow设备:
ffmpeg -list_devices true -f dshow -i dummy
同样可以使用 gdigrab 输入设备从Widnows系统桌面获得屏幕图像.

3.2 使用内置 GDI 屏幕抓取器

您还可以使用gdigrab作为输入设备从 Windows 屏幕抓取视频。
要将所有显示捕获为一个大的连续显示:
ffmpeg -f gdigrab -framerate 30 -i desktop output.mkv

如果你想限制到一个区域,并显示被抓取的区域:
ffmpeg -f gdigrab -framerate 30 -offset_x 10 -offset_y 20 -video_size 640x480 -show_region 1 -i desktop output.mkv

获取名为“Calculator”的窗口的内容:
ffmpeg -f gdigrab -framerate 30 -i title=Calculator output.mkv

4. 硬件编码

您可以使用硬件加速来加速编码并减少 CPU 的负载。例如,使用 NVIDIA 硬件编码:
ffmpeg -f gdigrab -framerate 30 -i desktop -c:v h264_nvenc -qp 0 output.mkv

5. 无损录制

如果你想很好的将桌面图像录制下来,x264编码器可以做到,使用无损编码方式即可,例如:
$ ffmpeg -video_size 1920x1080 -framerate 30 -f x11grab -i :0.0 -c:v libx264 -qp 0 -preset ultrafast capture.mkv
-qp 0 这个参数是设置 x264 的压缩参数为无损压缩, -preset ultrafast 预设值参数将会尽快的进行 x264 编码压缩.
这么做在当前主流的硬件设备上做不丢帧的编码是可以做到足够快的,并且还不会占用全部的CPU。

可以通过一次录制,一次编码的方式进行无损编码压缩,录制的时候以最快速度将视频图像录制下来,然后对录制下来的图像进行慢速压缩,这样可以保证图像质量,并且可以保证视频不丢帧
$ ffmpeg -i capture.mkv -c:v libx264 -qp 0 -preset veryslow capture_smaller.mkv

6. 无损录音

如果您的 CPU 不够快,则编码过程可能需要很长时间。为了加快编码过程,您可以使用无损编码并禁用高级编码器选项,例如:
ffmpeg -video_size 1920x1080 -framerate 30 -f x11grab -i :0.0 -c:v libx264rgb -crf 0 -preset ultrafast output.mkv
-crf 0告诉 x264 以无损模式编码;-preset ultrafast建议它做这么快。注意使用libx264rgb而不是libx264; 后者将进行从 RGB 到 yuv444p 的有损转换。

编码器在大多数现代硬件上应该足够快,可以在没有任何丢帧的情况下进行录制,甚至为其他应用程序留出足够的 CPU 空间。
如果您要存档录音或担心文件大小,请再次无损重新编码,但预设速度较慢。请注意,由于初始录制是无损的,重新编码也是无损的,因此在此过程中不会以任何方式引入质量损失。
ffmpeg -i output.mkv -c:v libx264rgb -crf 0 -preset veryslow output-smaller.mkv

7. 更多例子参考

如果你的配置比较低, 使用下面的命令可能会提高你的音视频编码效率,但是质量会稍微有些降低. 在这种情况下,首先你需要获取并将获取的图像保存为未压缩的视频/音频,并且当你完成抓取过程然后开始将它转换为任何你所需要的编码:

Linux:
$ ffmpeg -framerate 25 -video_size 1024x768 -f x11grab -i :0.0+100,200 -f alsa -ac 2 -i pulse -vcodec libx264 -crf 0 -preset ultrafast -acodec pcm_s16le output.mkv
$ ffmpeg -i output.mkv -acodec ... -vcodec ... final.mkv

Windows:
ffmpeg -f dshow -i video="screen-capture-recorder":audio="Microphone" -vcodec libx264 -crf 0 -preset ultrafast -acodec pcm_s16le output.mkv
ffmpeg -i output.flv -acodec ... -vcodec ... final.mkv

8. See also

Windows 替代设备列表: 

ffmpeg-map

1. 使用 -map 选项选择流
	1.1 examples简单的例子
	1.2 behavior默认行为
2. Syntax语法
	2.1 Modifiers修饰符
	2.2 Order顺序
3. Examples例子
	3.1 选择所有流
	3.2 特定类型的流
	3.3 仅特定视频流
	3.4 来自不同文件的视频和音频
	3.5 除音频外的所有内容
	3.6 特定语言
	3.7 从过滤器中选择输出
	3.8 多路输出
	3.9 可选映射
	3.a 重新排序流
4. See also

1. 使用 -map 选项选择流

  • top 命令不使用任何流说明符。这是一种绝对的映射方法,无论类型如何,都会选择特定的流。
    • -map 0:0  第一个输入文件的第一个流
    • -map 1:3  第二个输入文件的第四个流
  • bottom 命令包括流说明符(v视频, a音频, s字幕, m元数据)以将流限制为特定类型。
    • -map 0:v:0  第一个输入文件的第一个视频流
    • -map 1:a:2  第二个输入文件的第三个音频流
    • -map 1:s:1  第二个输入文件的第二个字幕流

1.1 examples简单的例子

  • -map 0  从输入索引 #0(第一个输入)中选择所有流。
  • -map 1:a  从输入索引 #1(第二个输入)中选择所有音频流。
  • -map 3:s:4  从输入索引#3(第四个输入)选择字幕流索引#4(第五个字幕流)。
  • -map 0 -map -0:s  将从输入索引 #0(第一个输入)中选择除字幕之外的所有流。-指负映射。

1.2 behavior默认行为

如果您不使用该-map选项,则默认流选择行为将自动选择流。
  • 默认流选择不会自动选择所有流。
  • 每种类型仅选择 1 个流。例如,如果输入有 3 个视频流,它只会选择 1 个。
  • 默认流选择将根据特定标准选择流。
  • 使用该-map选项会禁用默认流选择行为,并允许您手动选择流。

2. Syntax语法

-map input_file_index:stream_type_specifier:stream_index

  • input_file_index  指的是一个输入,默认情况下将包括它的所有流。
  • stream_type_specifier  (可选)是一个流说明符,它将选择限制为特定的流类型。流符包括vIDEO,aUDIO,subtitles,dATA,一个ttachments。下面的大多数示例都使用流说明符。
  • stream_index  (可选)将选择一个特定的流。如果stream_type_specifier使用,则stream_indexonly 引用选定的流类型并忽略所有其他流类型。
注意:索引号从 0 开始。所以第一个输入或流是#0,第二个输入或流是#1,第三个输入或流是#2,等等。

2.1 Modifiers修饰符

  • -索引input_file_index,如-map -0:v,创建了一个负的映射。这不包括先前map已经选择的流。
  • 尾随?,例如-map 1:a?,将允许map是可选的。如果map不匹配任何流,则map将被忽略而不是失败。请注意,如果使用无效,映射仍然会失败input_file_index;例如,如果map引用不存在的输入。

2.2 Order顺序

-map order 确定输出中的流顺序。
映射按顺序应用。这在使用负映射时很有用。

3. Examples例子

提示:您可以添加-c copy到这些示例中的许多以启用流复制模式。如果您只想多路复用并避免编码,这很有用。

3.1 选择所有流

单输入:
ffmpeg -i input.avi -map 0 output.mkv

多个输入:
ffmpeg -i input0.mkv -i input1.mp4 -i input2.wav -map 0 -map 1 -map 2 output.mkv

使用流复制重新混合(无编码):
ffmpeg -i input.avi -map 0 -c copy output.mkv

3.2 特定类型的流

仅视频流
ffmpeg -i input.mp4 -map 0:v output.mp4
仅音频流
ffmpeg -i input.mp4 -map 0:a output.mp4

3.3 仅特定视频流

选择第 5 个视频流:
ffmpeg -i input.mkv -map 0:v:4 output.mp4

3.4 来自不同文件的视频和音频

ffmpeg -i video.mp4 -i audio.m4a -map 0:v -map 1:a output.mp4

3.5 除音频外的所有内容

使用负映射:
ffmpeg -i input.mp4 -map 0 -map -0:a output.mp4

3.6 特定语言

包括所有视频和所有带有西班牙语元数据的流:
ffmpeg -i input.mkv -map 0:v -map 0:m:language:spa output.mp4
见ISO名单639-1码为3个字母的语言名称。

3.7 从过滤器中选择输出

在这个例子中,过滤后的视频被命名[v],过滤后的音频被命名为[a]:
ffmpeg -i input.mp4 -i logo.png -i audio.mp3 -filter_complex "[0]scale=1280:-1[bg];[bg][1]overlay[v];[2:a]volume=-3dB[a]" -map "[v]" -map "[a]" output.mp4
您几乎可以使用任何任意名称来标记过滤器输出。

3.8 多路输出

将视频输出到video.mp4. 将音频流索引 #1(第二个音频流)输出到audio_1.mp3. 将音频流索引 #3(第四个音频流)输出到audio_3.wav:
ffmpeg -i input.mkv -map 0:v video.mp4 -map 0:a:1 audio_1.mp3 -map 0:a:3 audio_3.wav

3.9 可选映射

如果流不存在, 添加尾随问号 ( ?)-map将忽略映射。
要映射视频和音频流并在不存在音频流时忽略音频映射:
ffmpeg -i input.webm -map 0:v -map 0:a? output.mkv
如果改为使用-map 0:a,并且没有音频流,ffmpeg则将失败并显示Stream map '0:a' matches no streams. To ignore this, add a trailing '?' to the map..

3.a 重新排序流

你的顺序-map选择决定了输出流的顺序。在这个例子中,输入文件将音频作为流#0 和视频作为流#1(这可能但不寻常)。重新定位视频的示例,使其首先列出,然后是音频:
ffmpeg -i input.mp4 -map 0:v -map 0:a -c copy output.mp4

4. See also

2021-06-22

ffmpeg-utils

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

下文是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
AntiqueWhite #faebd7 古董白 #faebd7
Aqua #00ffff 水族 #00ffff
Aquamarine #7fffd4 蓝晶 #7fffd4
Azure #f0ffff 天蓝色 #f0ffff
Beige #f5f5dc 浅褐色的 #f5f5dc
Bisque #ffe4c4 浓汤 #ffe4c4
Black #000000 黑色的 #000000
BlanchedAlmond #ffebcd 杏仁白 #ffebcd
Blue #0000ff 蓝色的 #0000ff
BlueViolet #8a2be2 紫罗兰色 #8a2be2
Brown #a52a2a 棕色的 #a52a2a
BurlyWood #deb887 原木色 #deb887
CadetBlue #5f9ea0 藏青 #5f9ea0
Chartreuse #7fff00 黄绿色 #7fff00
Chocolate #d2691e 巧克力 #d2691e
Coral #ff7f50 珊瑚 #ff7f50
CornflowerBlue #6495ed 矢车菊蓝 #6495ed
Cornsilk #fff8dc 玉米穗黄 #fff8dc
Crimson #dc143c 深红色 #dc143c
Cyan #00ffff 青色 #00ffff
DarkBlue #00008b 深蓝 #00008b
DarkCyan #008b8b 深青色 #008b8b
DarkGoldenRod #b8860b 深金黄 #b8860b
DarkGray #a9a9a9 深灰色 #a9a9a9
DarkGreen #006400 深绿色 #006400
DarkKhaki #bdb76b 深卡其色 #bdb76b
DarkMagenta #8b008b 深洋红色 #8b008b
DarkOliveGreen #556b2f 深橄榄绿 #556b2f
Darkorange #ff8c00 深橙色 #ff8c00
DarkOrchid #9932cc 深兰花紫 #9932cc
DarkRed #8b0000 深红 #8b0000
DarkSalmon #e9967a 深橙红 #e9967a
DarkSeaGreen #8fbc8f 海藻绿 #8fbc8f
DarkSlateBlue #483d8b 深青蓝 #483d8b
DarkSlateGray #2f4f4f 深青灰 #2f4f4f
DarkTurquoise #00ced1 深粉蓝 #00ced1
DarkViolet #9400d3 暗紫 #9400d3
DeepPink #ff1493 深粉红 #ff1493
DeepSkyBlue #00bfff 深蓝 #00bfff
DimGray #696969 暗灰色 #696969
DodgerBlue #1e90ff 道奇蓝 #1e90ff
FireBrick #b22222 耐火砖 #b22222
FloralWhite #fffaf0 花白 #fffaf0
ForestGreen #228b22 森林绿 #228b22
Fuchsia #ff00ff 紫红色 #ff00ff
Gainsboro #dcdcdc 亮灰 #dcdcdc
GhostWhite #f8f8ff 鬼白 #f8f8ff
Gold #ffd700 金色的 #ffd700
GoldenRod #daa520 金棒 #daa520
Gray #808080 灰色的 #808080
Green #008000 绿色的 #008000
GreenYellow #adff2f 黄绿色 #adff2f
HoneyDew #f0fff0 甘露 #f0fff0
HotPink #ff69b4 亮粉色 #ff69b4
IndianRed #cd5c5c 印度红 #cd5c5c
Indigo #4b0082 靛青 #4b0082
Ivory #fffff0 象牙 #fffff0
Khaki #f0e68c 卡其色 #f0e68c
Lavender #e6e6fa 薰衣草 #e6e6fa
LavenderBlush #fff0f5 淡紫 #fff0f5
LawnGreen #7cfc00 草坪绿 #7cfc00
LemonChiffon #fffacd 粉黄 #fffacd
LightBlue #add8e6 浅蓝 #add8e6
LightCoral #f08080 珊瑚色 #f08080
LightCyan #e0ffff 淡青色 #e0ffff
LightGoldenRodYellow #fafad2 浅金黄色 #fafad2
LightGreen #90ee90 浅绿色 #90ee90
LightGrey #d3d3d3 浅灰色 #d3d3d3
LightPink #ffb6c1 淡粉色 #ffb6c1
LightSalmon #ffa07a 橙红 #ffa07a
LightSeaGreen #20b2aa 光海绿 #20b2aa
LightSkyBlue #87cefa 淡天蓝 #87cefa
LightSlateGray #778899 浅灰色 #778899
LightSteelBlue #b0c4de 轻钢蓝 #b0c4de
LightYellow #ffffe0 淡黄色 #ffffe0
Lime #00ff00 酸橙 #00ff00
LimeGreen #32cd32 青柠 #32cd32
Linen #faf0e6 亚麻布 #faf0e6
Magenta #ff00ff 品红 #ff00ff
Maroon #800000 栗色 #800000
MediumAquaMarine #66cdaa 草绿 #66cdaa
MediumBlue #0000cd 暗蓝 #0000cd
MediumOrchid #ba55d3 暗兰花 #ba55d3
MediumPurple #9370d8 暗紫 #9370d8
MediumSeaGreen #3cb371 暗海藻 #3cb371
MediumSlateBlue #7b68ee 青蓝 #7b68ee
MediumSpringGreen #00fa9a 嫩绿 #00fa9a
MediumTurquoise #48d1cc 粉蓝 #48d1cc
MediumVioletRed #c71585 暗紫 #c71585
MidnightBlue #191970 黑蓝 #191970
MintCream #f5fffa 薄荷乳白 #f5fffa
MistyRose #ffe4e1 粉玫瑰红 #ffe4e1
Moccasin #ffe4b5 莫卡辛 #ffe4b5
NavajoWhite #ffdead 纳瓦霍白 #ffdead
Navy #000080 海军 #000080
OldLace #fdf5e6 旧布黄 #fdf5e6
Olive #808000 橄榄 #808000
OliveDrab #6b8e23 淡绿褐 #6b8e23
Orange #ffa500 橙色 #ffa500
OrangeRed #ff4500 橙红色 #ff4500
Orchid #da70d6 兰花 #da70d6
PaleGoldenRod #eee8aa 淡金黄 #eee8aa
PaleGreen #98fb98 浅绿色 #98fb98
PaleTurquoise #afeeee 淡蓝绿 #afeeee
PaleVioletRed #d87093 淡紫红色 #d87093
PapayaWhip #ffefd5 粉木瓜橙 #ffefd5
PeachPuff #ffdab9 粉桃红 #ffdab9
Peru #cd853f 秘鲁 #cd853f
Pink #ffc0cb 粉色的 #ffc0cb
Plum #dda0dd 李子 #dda0dd
PowderBlue #b0e0e6 粉蓝色 #b0e0e6
Purple #800080 紫色的 #800080
Red #ff0000 红色的 #ff0000
RosyBrown #bc8f8f 玫瑰褐 #bc8f8f
RoyalBlue #4169e1 宝蓝色 #4169e1
SaddleBrown #8b4513 马鞍棕 #8b4513
Salmon #fa8072 三文鱼 #fa8072
SandyBrown #f4a460 桑迪布朗 #f4a460
SeaGreen #2e8b57 海绿色 #2e8b57
SeaShell #fff5ee 贝壳 #fff5ee
Sienna #a0522d 赭色 #a0522d
Silver #c0c0c0 银色的 #c0c0c0
SkyBlue #87ceeb 天蓝色 #87ceeb
SlateBlue #6a5acd 青蓝 #6a5acd
SlateGray #708090 青灰 #708090
Snow #fffafa #fffafa
SpringGreen #00ff7f 嫩绿 #00ff7f
SteelBlue #4682b4 钢蓝 #4682b4
Tan #d2b48c 黄褐色 #d2b48c
Teal #008080 青色 #008080
Thistle #d8bfd8 #d8bfd8
Tomato #ff6347 番茄 #ff6347
Turquoise #40e0d0 绿松石 #40e0d0
Violet #ee82ee 紫罗兰 #ee82ee
Wheat #f5deb3 小麦 #f5deb3
White #ffffff 白色的 #ffffff
WhiteSmoke #f5f5f5 白色的烟 #f5f5f5
Yellow #ffff00 黄色的 #ffff00
YellowGreen #9acd32 黄绿色 #9acd32

2.8 Channel Layout 通道布局

通道布局指定多通道音频流中通道的空间布置。为了指定通道布局,FFmpeg 使用了一种特殊的语法。

2.8.1 各个频道由 id 标识,如下表所示:

NAME DESCRIPTION cn use
FL front left 左前 27
FR front right 右前 27
FC front center 前中 21
LFE low frequency 低频 12
BL back left 左后 11
BR back right 右后 11
FLC front left-of-center 前中左 6
FRC front right-of-center 前中右 6
BC back center 后中 10
SL side left 左侧 14
SR side right 右侧 14
TC top center 顶中心 1
TFL top front left 顶左前 2
TFC top front center 顶前中 2
TFR top front right 顶右前 2
TBL top back left 顶左后 2
TBC top back center 顶后中 2
TBR top back right 顶右后 2
TSL top side left 顶左侧 1
TSR top side right 顶右侧 1
DL downmix left 左缩混 1
DR downmix right 右缩混 1
WL wide left 宽左 1
WR wide right 宽右 1
SDL surround direct left 环绕左 0
SDR surround direct right 环绕右 0
LFE2 low frequency 2 低频2 1
BFC bottom front center 底前中 1
BFL bottom front left 底左前 1
BFR bottom front right 底右前 1

2.8.2 可以使用以下标识符指定标准通道布局组合:

NAME DECOMPOSITION channel FL FR FC LFE BL BR FLC FRC BC SL SR other Top/Bottom …
mono FC 1

FC









stereo FL+FR 2 FL FR










2.1 FL+FR+LFE 3 FL FR
LFE








3 FL+FR+FC 3 FL FR FC









3.0(back) FL+FR+BC 3 FL FR





BC



3.1 FL+FR+FC+LFE 4 FL FR FC LFE








4 FL+FR+FC+BC 4 FL FR FC




BC



quad FL+FR+BL+BR 4 FL FR

BL BR






quad(side) FL+FR+SL+SR 4 FL FR






SL SR

4.1 FL+FR+FC+LFE+BC 5 FL FR FC LFE



BC



5 FL+FR+FC+BL+BR 5 FL FR FC
BL BR






5.0(side) FL+FR+FC+SL+SR 5 FL FR FC





SL SR

5.1 FL+FR+FC+LFE+BL+BR 6 FL FR FC LFE BL BR






5.1(side) FL+FR+FC+LFE+SL+SR 6 FL FR FC LFE




SL SR

6 FL+FR+FC+BC+SL+SR 6 FL FR FC




BC SL SR

6.0(front) FL+FR+FLC+FRC+SL+SR 6 FL FR



FLC FRC
SL SR

hexagonal FL+FR+FC+BL+BR+BC 6 FL FR FC
BL BR

BC



6.1 FL+FR+FC+LFE+BC+SL+SR 7 FL FR FC LFE



BC SL SR

6.1(back) FL+FR+FC+LFE+BL+BR+BC 7 FL FR FC LFE BL BR

BC



6.1(front) FL+FR+LFE+FLC+FRC+SL+SR 7 FL FR
LFE

FLC FRC
SL SR

7 FL+FR+FC+BL+BR+SL+SR 7 FL FR FC
BL BR


SL SR

7.0(front) FL+FR+FC+FLC+FRC+SL+SR 7 FL FR FC


FLC FRC
SL SR

7.1 FL+FR+FC+LFE+BL+BR+SL+SR 8 FL FR FC LFE BL BR


SL SR

7.1(wide) FL+FR+FC+LFE+BL+BR+FLC+FRC 8 FL FR FC LFE BL BR FLC FRC




7.1(wide-side) FL+FR+FC+LFE+FLC+FRC+SL+SR 8 FL FR FC LFE

FLC FRC
SL SR

octagonal FL+FR+FC+BL+BR+BC+SL+SR 8 FL FR FC
BL BR

BC SL SR

hexadecagonal FL+FR+FC+BL+BR+BC+SL+SR+
TFL+TFC+TFR+TBL+TBC+TBR+WL+WR
16 FL FR FC
BL BR

BC SL SR WL;WR TFL;TFC;TFR;
TBL;TBC;TBR
downmix DL+DR 2










DL;DR
22.2 FL+FR+FC+LFE+BL+BR+FLC+FRC+BC+SL+SR+
TC+TFL+TFC+TFR+TBL+TBC+TBR+TSL+TSR+
LFE2+BFC+BFL+BFR
24 FL FR FC LFE BL BR FLC FRC BC SL SR LFE2 TC;TFL;TFC;TFR;TBL;
TBC;TBR;TSL;TSR
BFC;BFL;BFR

2.8.3 各频道id空间图示:


TFL


TFC


TFR

T
S
L







T
S
R





TC













TBL


TBC


TBR











S
D
L
FL W
L
FLC
FC
FRC W
R
FR S
D
R
S
L





S
R










BL

BC

BR












BFL


BFC


BFR












DL






DR






















2.8.4 自定义通道布局

自定义通道布局可以指定为一系列术语,以“+”或“|”分隔。每个术语可以是:
  • 标准通道布局的名称(e.g. ‘mono’, ‘stereo’, ‘4.0’, ‘quad’, ‘5.0’, etc.)
  • 单个频道的名称(e.g. ‘FL’, ‘FR’, ‘FC’, ‘LFE’, etc.)
  • 十进制数的通道数,后跟“c”,产生该通道数的默认通道布局(请参阅函数 av_get_default_channel_layout)。请注意,并非所有通道计数都有默认布局。
  • 十进制数的通道数,后跟“C”,产生具有指定通道数的未知通道布局。请注意,并非所有通道布局规范字符串都支持未知的通道布局。
  • 一个信道布局掩模mask,以十六进制开始以“0x”(见 AV_CH_*宏在libavutil/channel_layout.h.
在 libavutil 版本 53 之前,指定通道数的尾随字符“c”是可选的,但现在是必需的,而通道布局掩码也可以指定为十进制数(当且仅当后面没有“c”或“C”)。
另请参阅中av_get_channel_layout定义 的函数libavutil/channel_layout.h.

3. Expression Evaluation 表达式评估

在计算算术表达式时,FFmpeg 使用内部公式计算器,通过 libavutil/eval.h 界面。
表达式可能包含一元、二元运算符、常量和函数。
两个表达式expr1和expr2可以组合形成另一个表达式“ expr1 ; expr2 ”。 expr1和expr2依次求值,新表达式求值为expr2的值。
可以使用以下二元运算符:+, -, *, /, ^。
可以使用以下一元运算符:+, -.

3.1 functions

可以使用以下功能:
abs(x) Compute absolute value of x. 计算x 的绝对值。
acos(x) Compute arccosine of x. 计算x 的反余弦值。
sin(x) Compute arcsine of x. 计算x 的反正弦。
atan(x) Compute arctangent of x. 计算x 的反正切。
atan2(x, y) Compute principal value of the arc tangent of y/x. 计算y / x 的反正切的主值。
between(x, min, max) Return 1 if x is greater than or equal to min and lesser than or equal to max, 0 otherwise. 如果x大于或等于min且小于或等于max,则返回 1,否则返回0。
bitand(x, y) bitor(x, y) Compute bitwise and/or operation on x and y. 在x和y上计算按位和/或运算。
  x和y的计算结果在执行按位运算之前转换为整数。
  请注意,转换为整数和转换回浮点数都会失去精度。当心大数(通常为 2^53 及更大)的意外结果。
ceil(expr) Round the value of expression expr upwards to the nearest integer. For example, "ceil(1.5)" is "2.0". 将表达式expr的值向上舍入到最接近的整数。例如,“ceil(1.5)”是“2.0”。
clip(x, min, max) Return the value of x clipped between min and max. 返回裁剪在min和max之间的x值。
cos(x) Compute cosine of x. 计算x 的余弦。
cosh(x) Compute hyperbolic cosine of x. 计算x 的双曲余弦值。
eq(x, y) Return 1 if x and y are equivalent, 0 otherwise. 如果x和y相等,则返回 1 ,否则返回0。
exp(x) Compute exponential of x (with base e, the Euler’s number). 计算x 的指数(基数e为欧拉数)
floor(expr) Round the value of expression expr downwards to the nearest integer. For example, "floor(-1.5)" is "-2.0". 将表达式expr的值向下舍入到最接近的整数。例如,“地板(-1.5)”是“-2.0”。
gauss(x) Compute Gauss function of x, corresponding to exp(-x*x/2) / sqrt(2*PI). 计算x 的高斯函数,对应于 exp(-x*x/2) / sqrt(2*PI)。
gcd(x, y) Return the greatest common divisor of x and y. If both x and y are 0 or either or both are less than zero then behavior is undefined. 返回x和y 的最大公约数。如果x和 y均为 0 或其中一个或两者都小于零,则行为未定义。
gt(x, y) Return 1 if x is greater than y, 0 otherwise. 如果x大于y则返回 1 ,否则返回0。
gte(x, y) Return 1 if x is greater than or equal to y, 0 otherwise. 如果x大于或等于y则返回 1 ,否则返回0。
hypot(x, y) This function is similar to the C function with the same name; it returns "sqrt(x*x + y*y)", the length of the hypotenuse of a right triangle with sides of length x and y, or the distance of the point (x, y) from the origin. 这个函数类似于同名的C函数;它返回“sqrt( x * x + y * y )”,即边长为x和y的直角三角形斜边的长度,或点 ( x , y ) 与原点的距离。
if(x, y) Evaluate x, and if the result is non-zero return the result of the evaluation of y, return 0 otherwise. 计算x,如果结果非零,则返回y的计算结果,否则返回 0。
if(x, y, z) Evaluate x, and if the result is non-zero return the evaluation result of y, otherwise the evaluation result of z. 计算x,如果结果非零返回y 的计算结果,否则返回z 的计算结果。
ifnot(x, y) Evaluate x, and if the result is zero return the result of the evaluation of y, return 0 otherwise. 计算x,如果结果为零,则返回y的计算结果,否则返回 0。
ifnot(x, y, z) Evaluate x, and if the result is zero return the evaluation result of y, otherwise the evaluation result of z. 计算x,如果结果为零则返回y 的计算结果,否则返回z 的计算结果。
isinf(x) Return 1.0 if x is +/-INFINITY, 0.0 otherwise. 如果x是 +/-INFINITY,则返回 1.0 ,否则返回0.0。
isnan(x) Return 1.0 if x is NAN, 0.0 otherwise. 如果x是 NAN,则返回 1.0 ,否则返回0.0。
ld(var) Load the value of the internal variable with number var, which was previously stored with st(var, expr). The function returns the loaded value. 加载编号为var的内部变量的值,该值 之前是用 st( var , expr )存储的。该函数返回加载的值。
lerp(x, y, z) Return linear interpolation between x and y by amount of z. 按z的量返回x和y之间的线性插值。
log(x) Compute natural logarithm of x. 计算x 的自然对数。
lt(x, y) Return 1 if x is lesser than y, 0 otherwise. 如果x小于y则返回 1 ,否则返回0。
lte(x, y) Return 1 if x is lesser than or equal to y, 0 otherwise. 如果x小于或等于y,则返回 1 ,否则返回0。
max(x, y) Return the maximum between x and y. 返回x和y之间的最大值。
min(x, y) Return the minimum between x and y. 返回x和y之间的最小值。
mod(x, y) Compute the remainder of division of x by y. 计算x除以y的余数。
not(expr) Return 1.0 if expr is zero, 0.0 otherwise. 如果expr为零,则返回 1.0 ,否则返回0.0。
pow(x, y) Compute the power of x elevated y, it is equivalent to "(x)^(y)". 计算x提升y的幂,它等价于“( x )^( y )”。
print(t) print(t, l) Print the value of expression t with loglevel l. If l is not specified then a default log level is used. Returns the value of the expression printed. 使用日志级别l打印表达式t的值。如果 未指定l则使用默认日志级别。返回打印的表达式的值。Prints t with loglevel l
random(x) Return a pseudo random value between 0.0 and 1.0. x is the index of the internal variable which will be used to save the seed/state. 返回一个介于 0.0 和 1.0 之间的伪随机值。x是用于保存种子/状态的内部变量的索引。
root(expr, max) Find an input value for which the function represented by expr with argument ld(0) is 0 in the interval 0..max. 
  在区间 0.. max 中查找由expr表示的函数 和参数ld(0)为 0的输入值。
  expr中的表达式必须表示连续函数,否则结果未定义。
  ld(0)用于表示函数输入值,这意味着给定的表达式将使用表达式可以访问的各种输入值进行多次计算 ld(0)。当表达式的计算结果为 0 时,将返回相应的输入值。
round(expr) Round the value of expression expr to the nearest integer. For example, "round(1.5)" is "2.0". 将表达式expr的值四舍五入到最接近的整数。例如,“round(1.5)”是“2.0”。
sgn(x) Compute sign of x. 计算x 的符号。
sin(x) Compute sine of x. 计算x 的正弦值。
sinh(x) Compute hyperbolic sine of x. 计算x 的双曲正弦值。
sqrt(expr) Compute the square root of expr. This is equivalent to "(expr)^.5". 计算expr 的平方根。这相当于“( expr )^.5”。
squish(x) Compute expression 1/(1 + exp(4*x)). 计算表达式1/(1 + exp(4*x))。
st(var, expr) Store the value of the expression expr in an internal variable. var specifies the number of the variable where to store the value, and it is a value ranging from 0 to 9. The function returns the value stored in the internal variable. Note, Variables are currently not shared between expressions. 将表达式expr的值存储在内部变量中。var指定存储值的变量的编号,它是一个范围从 0 到 9 的值。该函数返回存储在内部变量中的值。请注意,变量当前不在表达式之间共享。
tan(x) Compute tangent of x. 计算x 的切线。
tanh(x) Compute hyperbolic tangent of x. 计算x 的双曲正切值。
taylor(expr, x) taylor(expr, x, id) Evaluate a Taylor series at x, given an expression representing the ld(id)-th derivative of a function at 0.
  计算x处的泰勒级数,给定一个表达式,表示ld(id)函数在 0 处的-th 导数。
  当级数不收敛时,结果是不确定的。
  ld(id)用于表示expr 中的导数顺序,这意味着给定的表达式将使用表达式可以访问的各种输入值进行多次计算 ld(id)。如果未指定id,则假定为 0。
  请注意,当您在 y 而不是 0 处有导数时, taylor(expr, x-y)可以使用。
time(0) Return the current (wallclock) time in seconds. 以秒为单位返回当前(挂钟)时间。
trunc(expr) Round the value of expression expr towards zero to the nearest integer. For example, "trunc(-1.5)" is "-1.0". 将表达式expr的值向零舍入到最接近的整数。例如,“trunc(-1​​.5)”是“-1.0”。
while(cond, expr) Evaluate expression expr while the expression cond is non-zero, and returns the value of the last expr evaluation, or NAN if cond was always false. 当表达式cond非零时计算表达式expr,并返回最后一次expr评估的值,如果cond始终为假,则返回NAN 。

3.2 constants 常数

The following constants are available: 以下常量可用:
PI area of the unit disc, approximately 3.14 圆周率
E exp(1) (Euler’s number), approximately 2.718 自然常数 欧拉数
PHI golden ratio (1+sqrt(5))/2, approximately 1.618 黄金比例
假设如果表达式具有非零值,则该表达式被视为“真”,请注意:
* 像 AND 一样工作
+ 像 OR 一样工作
例如构造: if (A AND B) then C  相当于: if(A*B, C)
在您的 C 代码中,您可以扩展一元和二元函数的列表,并定义可识别的常量,以便它们可用于您的表达式。
评估器还识别国际系统单位前缀。如果在前缀后附加“i”,则使用二进制前缀,其基于 1024 的幂而不是 1000 的幂。“B”后缀将值乘以 8,并且可以附加在单位前缀之后或单独使用. 这允许使用例如“KB”、“MiB”、“G”和“B”作为数字后缀。

3.3 International System prefixes 国际系统前缀

可用的国际系统前缀列表如下,并指示了 10 和 2 的相应幂。
y 10^-24 / 2^-80
z 10^-21 / 2^-70
a 10^-18 / 2^-60
f 10^-15 / 2^-50
p 10^-12 / 2^-40
n 10^-9 / 2^-30
u 10^-6 / 2^-20
m 10^-3 / 2^-10
c 10^-2
d 10^-1
h 10^2
k 10^3 / 2^10
K 10^3 / 2^10
M 10^6 / 2^20
G 10^9 / 2^30
T 10^12 / 2^40
P 10^15 / 2^40
E 10^18 / 2^50
Z 10^21 / 2^60
Y 10^24 / 2^70

Diode

导航 (返回顶部) 1. Diode 1.1 Diode 概述 1.2 肖克利二极管方程 1.3 缩写 Abbreviations 2. 主要功能 2.1 单向电流 (Unidirectional current flow) 2.2 阈值电压 (Threshold...