FFmpeg表达式(Expression Evaluation)

参考

• Expression Evaluation

简介

FFmpeg可以对算术表达式求值，大多结合filter过滤进行使用，如控制显示时间，通过libavutil/eval.h实现。

两个表达式expr1、expr2可以通过分号组合成为一个新的表达式"expr1;expr2"，新的表达式将会分别对expr1，expr2求值，并将expr2的结果作为新表达式的结果返回。

一元表达式
一元表达式的操作符包括：+, -

二元表达式
二元表达式的操作符包括：+, -, *, /, ^

函数
函数表达式包括：

abs(x)

求绝对值

acos(x)

求反余弦

asin(x)

求反正弦

atan(x)

求反正切

between(x, min, max)

若x的值在min和max的闭区间内，则返回1；否则返回0

bitand(x, y)

bitor(x, y)

按为计算x、y的与/或操作。在做求值操作前，传入的参数将被转换为整形。但是不论是传参转换为整形，还是求值结果重新转换为浮点数，都有可能损失一些精度。当计算大数(大于 2^53的数)时，要注意出现未知错误。

ceil(expr)

求表达式expr的结果，并对结果向上取整，作为返回值返回。

clip(x, min, max)

返回x在min，max范围内的部分的值

cos(x)

求x的余弦

cosh(x)

求x的双曲线余弦

eq(x, y)

如果x、y相等则返回1，否则返回0

exp(x)

求x的指数，底为e

floor(expr)

对表达式expr的结果向下求整

gauss(x)

求高斯函数的值，x为输入。等价于求表达式exp(-xx/2) / sqrt(2PI)的指

gcd(x, y)

求x、y的最大公约数。如果x、y均为0或者x、y中任意一个为负数，则结果未定义

gt(x, y)

若x大于y，则返回1；否则返回0

gte(x, y)

若x大于或等于y，则返回1；否则返回0

hypot(x, y)

求x、y的平方和的平方根，即sqrt(xx + yy)；例如求直角边为x、y的直角三角形的斜边长度，或者二维坐标系中点(x,y)到原点的距离

if(x, y)

若x的值不为0，则返回y的值，否则返回0

if(x, y, z)

若x的值不为0，则返回y的值，否则返回z的值

isinf(x)

若x为正/负无穷，则返回1.0,；否则返回0.0

isnan(x)

若x为非数值，则返回1.0，否则返回0.0

st(var, expr)

保存expr的值到内部变量中，var指定保存的索引，var只能取值在0-9范围。这个函数返回存入内部变量的值。(注：目前表达式之间的的内部变量是不共享的)

ld(var)

根据var取出存在内部变量中的值(即使用st函数保存的)

log(x)

求x的自然对数

lt(x, y)

如果x小于y，则返回1；否则返回0

lte(x,y)

如果x小于或等于y，则返回1,；否则返回0

max(x, y)

返回x、y中较大的那个

min(x,y)

返回x、y中较小的那个

mod(x,y)

用x对y求模，即x%y

not(expr)

若expt等于0则返回1.0，否则返回0.0

pow(x,y)

求x的y次方，即x^y

print(t)

print(t, l)

以l指定的日志等级打印t的值，若l未指定，则使用默认的日志等级。返回打印的值

random(x)

返回一个0.0到1.0之间的伪随机数。x作为内部变量的索引，指定一个位置用于保存随机数种子/状态

root(expr, max)

以ld(0)的返回值为参数，计算expr的值，若结果为0,则将参数作为反回值返回。待测试的值依次存放在内部变量的索引在0-max范围的位置处。表达式必须为可复用的，否则结果将不可预期

sin(x)

求x的正弦

sinh(x)

求x的双曲线正弦

sqrt(expr)

求expt的值得平方根

squish(x)

求表达式1/(1 + exp(4*x))的值

tan(x)

求x的正切

tanh(x)

求x的双曲线正切

taylor(expr, x)

taylor(expr, x, id)

求x的泰勒级数

time(0)

返回当前的墙上时间

trunc(expr)

对expr的值向0取整。例如trunc(-1.5) = -1.0

while(cond, expr)

当表达式cond的值不为0是，则循环求expr的值，将最后依次expr的值作为最终结果返回。若cond总为false，则返回NAN

常量表达式
常量表达式包括：

PI

圆周率，大约3.14

E

exp(1) 欧拉常量，自然常量；大约2.718

PHI

黄金比例 (1+sqrt(5))/2，大约1.618

其他
若一个表达式的值为非0的值且用于表示“true”，那么表示AND(和运算)，+表示OR(或运算)。例如if (A AND B) then C 可用if(AB, C)表示

示例
指定时间段（5-10秒）显示滚定文字：

ffplay -i test2.mp4 -vf drawtext="fontfile=Songti.ttc:text='指定时间段内才能看见':x='if((gte(t\,5) * (lte(t\,10)))\,w-t*50\,NAN)':fontcolor=darkorange:fontsize=30"