2 * Copyright (c) 2002-2006 Michael Niedermayer <michaelni@gmx.at>
3 * Copyright (c) 2006 Oded Shimon <ods15@ods15.dyndns.org>
5 * This file is part of FFmpeg.
7 * FFmpeg is free software; you can redistribute it and/or
8 * modify it under the terms of the GNU Lesser General Public
9 * License as published by the Free Software Foundation; either
10 * version 2.1 of the License, or (at your option) any later version.
12 * FFmpeg is distributed in the hope that it will be useful,
13 * but WITHOUT ANY WARRANTY; without even the implied warranty of
14 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
15 * Lesser General Public License for more details.
17 * You should have received a copy of the GNU Lesser General Public
18 * License along with FFmpeg; if not, write to the Free Software
19 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
24 * simple arithmetic expression evaluator.
26 * see http://joe.hotchkiss.com/programming/eval/eval.html
30 #include "attributes.h"
35 #include "mathematics.h"
40 typedef struct Parser {
44 const double *const_values;
45 const char * const *const_names; // NULL terminated
46 double (* const *funcs1)(void *, double a); // NULL terminated
47 const char * const *func1_names; // NULL terminated
48 double (* const *funcs2)(void *, double a, double b); // NULL terminated
49 const char * const *func2_names; // NULL terminated
57 static const AVClass eval_class = { "Eval", av_default_item_name, NULL, LIBAVUTIL_VERSION_INT, offsetof(Parser,log_offset), offsetof(Parser,log_ctx) };
59 static const int8_t si_prefixes['z' - 'E' + 1] = {
91 double av_strtod(const char *numstr, char **tail)
95 if(numstr[0]=='0' && (numstr[1]|0x20)=='x') {
96 d = strtoul(numstr, &next, 16);
98 d = strtod(numstr, &next);
99 /* if parsing succeeded, check for and interpret postfixes */
101 if (next[0] == 'd' && next[1] == 'B') {
102 /* treat dB as decibels instead of decibytes */
105 } else if (*next >= 'E' && *next <= 'z') {
106 int e= si_prefixes[*next - 'E'];
108 if (next[1] == 'i') {
123 /* if requested, fill in tail with the position after the last parsed
130 #define IS_IDENTIFIER_CHAR(c) ((c) - '0' <= 9U || (c) - 'a' <= 25U || (c) - 'A' <= 25U || (c) == '_')
132 static int strmatch(const char *s, const char *prefix)
135 for (i=0; prefix[i]; i++) {
136 if (prefix[i] != s[i]) return 0;
138 /* return 1 only if the s identifier is terminated */
139 return !IS_IDENTIFIER_CHAR(s[i]);
144 e_value, e_const, e_func0, e_func1, e_func2,
145 e_squish, e_gauss, e_ld, e_isnan, e_isinf,
146 e_mod, e_max, e_min, e_eq, e_gt, e_gte, e_lte, e_lt,
147 e_pow, e_mul, e_div, e_add,
148 e_last, e_st, e_while, e_taylor, e_root, e_floor, e_ceil, e_trunc,
149 e_sqrt, e_not, e_random, e_hypot, e_gcd,
150 e_if, e_ifnot, e_print, e_bitand, e_bitor, e_between,
152 double value; // is sign in other types
155 double (*func0)(double);
156 double (*func1)(void *, double);
157 double (*func2)(void *, double, double);
159 struct AVExpr *param[3];
163 static double etime(double v)
165 return av_gettime() * 0.000001;
168 static double eval_expr(Parser *p, AVExpr *e)
171 case e_value: return e->value;
172 case e_const: return e->value * p->const_values[e->a.const_index];
173 case e_func0: return e->value * e->a.func0(eval_expr(p, e->param[0]));
174 case e_func1: return e->value * e->a.func1(p->opaque, eval_expr(p, e->param[0]));
175 case e_func2: return e->value * e->a.func2(p->opaque, eval_expr(p, e->param[0]), eval_expr(p, e->param[1]));
176 case e_squish: return 1/(1+exp(4*eval_expr(p, e->param[0])));
177 case e_gauss: { double d = eval_expr(p, e->param[0]); return exp(-d*d/2)/sqrt(2*M_PI); }
178 case e_ld: return e->value * p->var[av_clip(eval_expr(p, e->param[0]), 0, VARS-1)];
179 case e_isnan: return e->value * !!isnan(eval_expr(p, e->param[0]));
180 case e_isinf: return e->value * !!isinf(eval_expr(p, e->param[0]));
181 case e_floor: return e->value * floor(eval_expr(p, e->param[0]));
182 case e_ceil : return e->value * ceil (eval_expr(p, e->param[0]));
183 case e_trunc: return e->value * trunc(eval_expr(p, e->param[0]));
184 case e_sqrt: return e->value * sqrt (eval_expr(p, e->param[0]));
185 case e_not: return e->value * (eval_expr(p, e->param[0]) == 0);
186 case e_if: return e->value * (eval_expr(p, e->param[0]) ? eval_expr(p, e->param[1]) :
187 e->param[2] ? eval_expr(p, e->param[2]) : 0);
188 case e_ifnot: return e->value * (!eval_expr(p, e->param[0]) ? eval_expr(p, e->param[1]) :
189 e->param[2] ? eval_expr(p, e->param[2]) : 0);
191 double d = eval_expr(p, e->param[0]);
192 return e->value * (d >= eval_expr(p, e->param[1]) &&
193 d <= eval_expr(p, e->param[2]));
196 double x = eval_expr(p, e->param[0]);
197 int level = e->param[1] ? av_clip(eval_expr(p, e->param[1]), INT_MIN, INT_MAX) : AV_LOG_INFO;
198 av_log(p, level, "%f\n", x);
202 int idx= av_clip(eval_expr(p, e->param[0]), 0, VARS-1);
203 uint64_t r= isnan(p->var[idx]) ? 0 : p->var[idx];
204 r= r*1664525+1013904223;
206 return e->value * (r * (1.0/UINT64_MAX));
210 while (eval_expr(p, e->param[0]))
211 d=eval_expr(p, e->param[1]);
215 double t = 1, d = 0, v;
216 double x = eval_expr(p, e->param[1]);
217 int id = e->param[2] ? av_clip(eval_expr(p, e->param[2]), 0, VARS-1) : 0;
219 double var0 = p->var[id];
220 for(i=0; i<1000; i++) {
223 v = eval_expr(p, e->param[0]);
234 double low = -1, high = -1, v, low_v = -DBL_MAX, high_v = DBL_MAX;
235 double var0 = p->var[0];
236 double x_max = eval_expr(p, e->param[1]);
237 for(i=-1; i<1024; i++) {
239 p->var[0] = av_reverse[i&255]*x_max/255;
241 p->var[0] = x_max*pow(0.9, i-255);
242 if (i&1) p->var[0] *= -1;
243 if (i&2) p->var[0] += low;
244 else p->var[0] += high;
246 v = eval_expr(p, e->param[0]);
247 if (v<=0 && v>low_v) {
251 if (v>=0 && v<high_v) {
255 if (low>=0 && high>=0){
256 for (j=0; j<1000; j++) {
257 p->var[0] = (low+high)*0.5;
258 if (low == p->var[0] || high == p->var[0])
260 v = eval_expr(p, e->param[0]);
261 if (v<=0) low = p->var[0];
262 if (v>=0) high= p->var[0];
272 return -low_v<high_v ? low : high;
275 double d = eval_expr(p, e->param[0]);
276 double d2 = eval_expr(p, e->param[1]);
278 case e_mod: return e->value * (d - floor((!CONFIG_FTRAPV || d2) ? d / d2 : d * INFINITY) * d2);
279 case e_gcd: return e->value * av_gcd(d,d2);
280 case e_max: return e->value * (d > d2 ? d : d2);
281 case e_min: return e->value * (d < d2 ? d : d2);
282 case e_eq: return e->value * (d == d2 ? 1.0 : 0.0);
283 case e_gt: return e->value * (d > d2 ? 1.0 : 0.0);
284 case e_gte: return e->value * (d >= d2 ? 1.0 : 0.0);
285 case e_lt: return e->value * (d < d2 ? 1.0 : 0.0);
286 case e_lte: return e->value * (d <= d2 ? 1.0 : 0.0);
287 case e_pow: return e->value * pow(d, d2);
288 case e_mul: return e->value * (d * d2);
289 case e_div: return e->value * ((!CONFIG_FTRAPV || d2 ) ? (d / d2) : d * INFINITY);
290 case e_add: return e->value * (d + d2);
291 case e_last:return e->value * d2;
292 case e_st : return e->value * (p->var[av_clip(d, 0, VARS-1)]= d2);
293 case e_hypot:return e->value * (sqrt(d*d + d2*d2));
294 case e_bitand: return isnan(d) || isnan(d2) ? NAN : e->value * ((long int)d & (long int)d2);
295 case e_bitor: return isnan(d) || isnan(d2) ? NAN : e->value * ((long int)d | (long int)d2);
302 static int parse_expr(AVExpr **e, Parser *p);
304 void av_expr_free(AVExpr *e)
307 av_expr_free(e->param[0]);
308 av_expr_free(e->param[1]);
309 av_expr_free(e->param[2]);
314 static int parse_primary(AVExpr **e, Parser *p)
316 AVExpr *d = av_mallocz(sizeof(AVExpr));
317 char *next = p->s, *s0 = p->s;
321 return AVERROR(ENOMEM);
324 d->value = av_strtod(p->s, &next);
333 /* named constants */
334 for (i=0; p->const_names && p->const_names[i]; i++) {
335 if (strmatch(p->s, p->const_names[i])) {
336 p->s+= strlen(p->const_names[i]);
338 d->a.const_index = i;
343 for (i = 0; i < FF_ARRAY_ELEMS(constants); i++) {
344 if (strmatch(p->s, constants[i].name)) {
345 p->s += strlen(constants[i].name);
347 d->value = constants[i].value;
353 p->s= strchr(p->s, '(');
355 av_log(p, AV_LOG_ERROR, "Undefined constant or missing '(' in '%s'\n", s0);
358 return AVERROR(EINVAL);
361 if (*next == '(') { // special case do-nothing
363 if ((ret = parse_expr(&d, p)) < 0)
365 if (p->s[0] != ')') {
366 av_log(p, AV_LOG_ERROR, "Missing ')' in '%s'\n", s0);
368 return AVERROR(EINVAL);
374 if ((ret = parse_expr(&(d->param[0]), p)) < 0) {
380 parse_expr(&d->param[1], p);
384 parse_expr(&d->param[2], p);
386 if (p->s[0] != ')') {
387 av_log(p, AV_LOG_ERROR, "Missing ')' or too many args in '%s'\n", s0);
389 return AVERROR(EINVAL);
394 if (strmatch(next, "sinh" )) d->a.func0 = sinh;
395 else if (strmatch(next, "cosh" )) d->a.func0 = cosh;
396 else if (strmatch(next, "tanh" )) d->a.func0 = tanh;
397 else if (strmatch(next, "sin" )) d->a.func0 = sin;
398 else if (strmatch(next, "cos" )) d->a.func0 = cos;
399 else if (strmatch(next, "tan" )) d->a.func0 = tan;
400 else if (strmatch(next, "atan" )) d->a.func0 = atan;
401 else if (strmatch(next, "asin" )) d->a.func0 = asin;
402 else if (strmatch(next, "acos" )) d->a.func0 = acos;
403 else if (strmatch(next, "exp" )) d->a.func0 = exp;
404 else if (strmatch(next, "log" )) d->a.func0 = log;
405 else if (strmatch(next, "abs" )) d->a.func0 = fabs;
406 else if (strmatch(next, "time" )) d->a.func0 = etime;
407 else if (strmatch(next, "squish")) d->type = e_squish;
408 else if (strmatch(next, "gauss" )) d->type = e_gauss;
409 else if (strmatch(next, "mod" )) d->type = e_mod;
410 else if (strmatch(next, "max" )) d->type = e_max;
411 else if (strmatch(next, "min" )) d->type = e_min;
412 else if (strmatch(next, "eq" )) d->type = e_eq;
413 else if (strmatch(next, "gte" )) d->type = e_gte;
414 else if (strmatch(next, "gt" )) d->type = e_gt;
415 else if (strmatch(next, "lte" )) d->type = e_lte;
416 else if (strmatch(next, "lt" )) d->type = e_lt;
417 else if (strmatch(next, "ld" )) d->type = e_ld;
418 else if (strmatch(next, "isnan" )) d->type = e_isnan;
419 else if (strmatch(next, "isinf" )) d->type = e_isinf;
420 else if (strmatch(next, "st" )) d->type = e_st;
421 else if (strmatch(next, "while" )) d->type = e_while;
422 else if (strmatch(next, "taylor")) d->type = e_taylor;
423 else if (strmatch(next, "root" )) d->type = e_root;
424 else if (strmatch(next, "floor" )) d->type = e_floor;
425 else if (strmatch(next, "ceil" )) d->type = e_ceil;
426 else if (strmatch(next, "trunc" )) d->type = e_trunc;
427 else if (strmatch(next, "sqrt" )) d->type = e_sqrt;
428 else if (strmatch(next, "not" )) d->type = e_not;
429 else if (strmatch(next, "pow" )) d->type = e_pow;
430 else if (strmatch(next, "print" )) d->type = e_print;
431 else if (strmatch(next, "random")) d->type = e_random;
432 else if (strmatch(next, "hypot" )) d->type = e_hypot;
433 else if (strmatch(next, "gcd" )) d->type = e_gcd;
434 else if (strmatch(next, "if" )) d->type = e_if;
435 else if (strmatch(next, "ifnot" )) d->type = e_ifnot;
436 else if (strmatch(next, "bitand")) d->type = e_bitand;
437 else if (strmatch(next, "bitor" )) d->type = e_bitor;
438 else if (strmatch(next, "between"))d->type = e_between;
440 for (i=0; p->func1_names && p->func1_names[i]; i++) {
441 if (strmatch(next, p->func1_names[i])) {
442 d->a.func1 = p->funcs1[i];
449 for (i=0; p->func2_names && p->func2_names[i]; i++) {
450 if (strmatch(next, p->func2_names[i])) {
451 d->a.func2 = p->funcs2[i];
458 av_log(p, AV_LOG_ERROR, "Unknown function in '%s'\n", s0);
460 return AVERROR(EINVAL);
467 static AVExpr *make_eval_expr(int type, int value, AVExpr *p0, AVExpr *p1)
469 AVExpr *e = av_mallocz(sizeof(AVExpr));
479 static int parse_pow(AVExpr **e, Parser *p, int *sign)
481 *sign= (*p->s == '+') - (*p->s == '-');
483 return parse_primary(e, p);
486 static int parse_dB(AVExpr **e, Parser *p, int *sign)
488 /* do not filter out the negative sign when parsing a dB value.
489 for example, -3dB is not the same as -(3dB) */
492 double av_unused ignored = strtod(p->s, &next);
493 if (next != p->s && next[0] == 'd' && next[1] == 'B') {
495 return parse_primary(e, p);
498 return parse_pow(e, p, sign);
501 static int parse_factor(AVExpr **e, Parser *p)
503 int sign, sign2, ret;
504 AVExpr *e0, *e1, *e2;
505 if ((ret = parse_dB(&e0, p, &sign)) < 0)
510 if ((ret = parse_dB(&e2, p, &sign2)) < 0) {
514 e0 = make_eval_expr(e_pow, 1, e1, e2);
518 return AVERROR(ENOMEM);
520 if (e0->param[1]) e0->param[1]->value *= (sign2|1);
522 if (e0) e0->value *= (sign|1);
528 static int parse_term(AVExpr **e, Parser *p)
531 AVExpr *e0, *e1, *e2;
532 if ((ret = parse_factor(&e0, p)) < 0)
534 while (p->s[0]=='*' || p->s[0]=='/') {
537 if ((ret = parse_factor(&e2, p)) < 0) {
541 e0 = make_eval_expr(c == '*' ? e_mul : e_div, 1, e1, e2);
545 return AVERROR(ENOMEM);
552 static int parse_subexpr(AVExpr **e, Parser *p)
555 AVExpr *e0, *e1, *e2;
556 if ((ret = parse_term(&e0, p)) < 0)
558 while (*p->s == '+' || *p->s == '-') {
560 if ((ret = parse_term(&e2, p)) < 0) {
564 e0 = make_eval_expr(e_add, 1, e1, e2);
568 return AVERROR(ENOMEM);
576 static int parse_expr(AVExpr **e, Parser *p)
579 AVExpr *e0, *e1, *e2;
580 if (p->stack_index <= 0) //protect against stack overflows
581 return AVERROR(EINVAL);
584 if ((ret = parse_subexpr(&e0, p)) < 0)
586 while (*p->s == ';') {
589 if ((ret = parse_subexpr(&e2, p)) < 0) {
593 e0 = make_eval_expr(e_last, 1, e1, e2);
597 return AVERROR(ENOMEM);
606 static int verify_expr(AVExpr *e)
611 case e_const: return 1;
625 return verify_expr(e->param[0]) && !e->param[1];
627 return verify_expr(e->param[0])
628 && (!e->param[1] || verify_expr(e->param[1]));
632 return verify_expr(e->param[0]) && verify_expr(e->param[1])
633 && (!e->param[2] || verify_expr(e->param[2]));
635 return verify_expr(e->param[0]) &&
636 verify_expr(e->param[1]) &&
637 verify_expr(e->param[2]);
638 default: return verify_expr(e->param[0]) && verify_expr(e->param[1]) && !e->param[2];
642 int av_expr_parse(AVExpr **expr, const char *s,
643 const char * const *const_names,
644 const char * const *func1_names, double (* const *funcs1)(void *, double),
645 const char * const *func2_names, double (* const *funcs2)(void *, double, double),
646 int log_offset, void *log_ctx)
650 char *w = av_malloc(strlen(s) + 1);
656 return AVERROR(ENOMEM);
659 if (!av_isspace(*s++)) *wp++ = s[-1];
662 p.class = &eval_class;
665 p.const_names = const_names;
667 p.func1_names = func1_names;
669 p.func2_names = func2_names;
670 p.log_offset = log_offset;
673 if ((ret = parse_expr(&e, &p)) < 0)
677 av_log(&p, AV_LOG_ERROR, "Invalid chars '%s' at the end of expression '%s'\n", p.s, s0);
678 ret = AVERROR(EINVAL);
681 if (!verify_expr(e)) {
683 ret = AVERROR(EINVAL);
686 e->var= av_mallocz(sizeof(double) *VARS);
693 double av_expr_eval(AVExpr *e, const double *const_values, void *opaque)
698 p.const_values = const_values;
700 return eval_expr(&p, e);
703 int av_expr_parse_and_eval(double *d, const char *s,
704 const char * const *const_names, const double *const_values,
705 const char * const *func1_names, double (* const *funcs1)(void *, double),
706 const char * const *func2_names, double (* const *funcs2)(void *, double, double),
707 void *opaque, int log_offset, void *log_ctx)
710 int ret = av_expr_parse(&e, s, const_names, func1_names, funcs1, func2_names, funcs2, log_offset, log_ctx);
716 *d = av_expr_eval(e, const_values, opaque);
718 return isnan(*d) ? AVERROR(EINVAL) : 0;
724 static const double const_values[] = {
730 static const char *const const_names[] = {
736 int main(int argc, char **argv)
740 const char *const *expr;
741 static const char *const exprs[] = {
747 "1+(5-2)^(3-1)+1/2+sin(PI)-max(-2.2,-3.1)",
768 "bar + PI + E + 100f*2 + foo",
769 "13k + 12f - foo(1, 2)",
782 /* compute 1+2+...+N */
783 "st(0, 1); while(lte(ld(0), 100), st(1, ld(1)+ld(0));st(0, ld(0)+1)); ld(1)",
785 "st(1, 1); st(2, 2); st(0, 1); while(lte(ld(0),10), st(3, ld(1)+ld(2)); st(1, ld(2)); st(2, ld(3)); st(0, ld(0)+1)); ld(3)",
787 "st(0, 1); while(lte(ld(0),100), st(1, ld(1)+ld(0)); st(0, ld(0)+1))",
816 "ifnot(1, NaN) + if(0, 1)",
820 "taylor(eq(mod(ld(1),4),1)-eq(mod(ld(1),4),3), PI/2, 1)",
821 "root(sin(ld(0))-1, 2)",
822 "root(sin(ld(0))+6+sin(ld(0)/12)-log(ld(0)), 100)",
823 "7000000B*random(0)",
827 "gcd(30,55)*print(min(9,1))",
831 "between(10, -3, 10)",
832 "between(-4, -2, -1)",
837 for (expr = exprs; *expr; expr++) {
838 printf("Evaluating '%s'\n", *expr);
839 av_expr_parse_and_eval(&d, *expr,
840 const_names, const_values,
841 NULL, NULL, NULL, NULL, NULL, 0, NULL);
843 printf("'%s' -> nan\n\n", *expr);
845 printf("'%s' -> %f\n\n", *expr, d);
848 av_expr_parse_and_eval(&d, "1+(5-2)^(3-1)+1/2+sin(PI)-max(-2.2,-3.1)",
849 const_names, const_values,
850 NULL, NULL, NULL, NULL, NULL, 0, NULL);
851 printf("%f == 12.7\n", d);
852 av_expr_parse_and_eval(&d, "80G/80Gi",
853 const_names, const_values,
854 NULL, NULL, NULL, NULL, NULL, 0, NULL);
855 printf("%f == 0.931322575\n", d);
857 if (argc > 1 && !strcmp(argv[1], "-t")) {
858 for (i = 0; i < 1050; i++) {
860 av_expr_parse_and_eval(&d, "1+(5-2)^(3-1)+1/2+sin(PI)-max(-2.2,-3.1)",
861 const_names, const_values,
862 NULL, NULL, NULL, NULL, NULL, 0, NULL);
863 STOP_TIMER("av_expr_parse_and_eval");