FFmpeg
Functions
eval.h File Reference
#include "avutil.h"

Go to the source code of this file.

Functions

int av_expr_parse_and_eval (double *res, const char *s, const char *const *const_names, const double *const_values, const char *const *func1_names, double(*const *funcs1)(void *, double), const char *const *func2_names, double(*const *funcs2)(void *, double, double), void *opaque, int log_offset, void *log_ctx)
 Parse and evaluate an expression. More...
 
int av_expr_parse (AVExpr **expr, const char *s, const char *const *const_names, const char *const *func1_names, double(*const *funcs1)(void *, double), const char *const *func2_names, double(*const *funcs2)(void *, double, double), int log_offset, void *log_ctx)
 Parse an expression. More...
 
double av_expr_eval (AVExpr *e, const double *const_values, void *opaque)
 Evaluate a previously parsed expression. More...
 
int av_expr_count_vars (AVExpr *e, unsigned *counter, int size)
 Track the presence of variables and their number of occurrences in a parsed expression. More...
 
int av_expr_count_func (AVExpr *e, unsigned *counter, int size, int arg)
 Track the presence of user provided functions and their number of occurrences in a parsed expression. More...
 
void av_expr_free (AVExpr *e)
 Free a parsed expression previously created with av_expr_parse(). More...
 
double av_strtod (const char *numstr, char **tail)
 Parse the string in numstr and return its value as a double. More...
 

Detailed Description

simple arithmetic expression evaluator

Definition in file eval.h.

Function Documentation

◆ av_expr_parse_and_eval()

int av_expr_parse_and_eval ( double *  res,
const char *  s,
const char *const *  const_names,
const double *  const_values,
const char *const *  func1_names,
double(**)(void *, double)  funcs1,
const char *const *  func2_names,
double(**)(void *, double, double)  funcs2,
void *  opaque,
int  log_offset,
void *  log_ctx 
)

Parse and evaluate an expression.

Note, this is significantly slower than av_expr_eval().

Parameters
resa pointer to a double where is put the result value of the expression, or NAN in case of error
sexpression as a zero terminated string, for example "1+2^3+5*5+sin(2/3)"
const_namesNULL terminated array of zero terminated strings of constant identifiers, for example {"PI", "E", 0}
const_valuesa zero terminated array of values for the identifiers from const_names
func1_namesNULL terminated array of zero terminated strings of funcs1 identifiers
funcs1NULL terminated array of function pointers for functions which take 1 argument
func2_namesNULL terminated array of zero terminated strings of funcs2 identifiers
funcs2NULL terminated array of function pointers for functions which take 2 arguments
opaquea pointer which will be passed to all functions from funcs1 and funcs2
log_ctxparent logging context
Returns
>= 0 in case of success, a negative value corresponding to an AVERROR code otherwise

Definition at line 776 of file eval.c.

Referenced by activate(), av_parse_ratio(), calc_persp_luts(), config_input(), config_output_props(), config_props(), ff_scale_eval_dimensions(), filter_frame(), func_eval_expr(), func_eval_expr_int_format(), generate_kernel(), get_aspect_ratio(), main(), pad_opencl_config_output(), qsvscale_config_props(), and set_string_number().

◆ av_expr_parse()

int av_expr_parse ( AVExpr **  expr,
const char *  s,
const char *const *  const_names,
const char *const *  func1_names,
double(**)(void *, double)  funcs1,
const char *const *  func2_names,
double(**)(void *, double, double)  funcs2,
int  log_offset,
void *  log_ctx 
)

Parse an expression.

Parameters
expra pointer where is put an AVExpr containing the parsed value in case of successful parsing, or NULL otherwise. The pointed to AVExpr must be freed with av_expr_free() by the user when it is not needed anymore.
sexpression as a zero terminated string, for example "1+2^3+5*5+sin(2/3)"
const_namesNULL terminated array of zero terminated strings of constant identifiers, for example {"PI", "E", 0}
func1_namesNULL terminated array of zero terminated strings of funcs1 identifiers
funcs1NULL terminated array of function pointers for functions which take 1 argument
func2_namesNULL terminated array of zero terminated strings of funcs2 identifiers
funcs2NULL terminated array of function pointers for functions which take 2 arguments
log_ctxparent logging context
Returns
>= 0 in case of success, a negative value corresponding to an AVERROR code otherwise

Definition at line 685 of file eval.c.

Referenced by addroi_init(), av_expr_parse_and_eval(), config_input(), config_output(), config_props(), ff_rate_control_init(), generate_kernel(), geq_init(), init(), init_axis_color(), init_cqt(), init_output_stream_encode(), init_volume(), initialize(), modplug_read_header(), parse_fontsize(), process_command(), scale_parse_expr(), set_enable_expr(), and set_expr().

◆ av_expr_eval()

double av_expr_eval ( AVExpr e,
const double *  const_values,
void *  opaque 
)

Evaluate a previously parsed expression.

Parameters
const_valuesa zero terminated array of values for the identifiers from av_expr_parse() const_names
opaquea pointer which will be passed to all functions from funcs1 and funcs2
Returns
the value of the expression

Definition at line 766 of file eval.c.

Referenced by addroi_config_input(), av_expr_parse_and_eval(), config_input(), config_output(), config_props(), do_eval(), do_video_out(), draw_text(), eval_expr(), eval_pts(), ff_inlink_evaluate_timeline_at_frame(), filter_frame(), generate_kernel(), get_qscale(), init(), init_axis_color(), init_cqt(), init_volume(), modplug_read_packet(), output_single_frame(), parse_expr(), request_frame(), scale_eval_dimensions(), select_frame(), set_brightness(), set_contrast(), set_gamma(), set_saturation(), set_volume(), slice_geq_filter(), update_alpha(), update_context(), and update_fontsize().

◆ av_expr_count_vars()

int av_expr_count_vars ( AVExpr e,
unsigned *  counter,
int  size 
)

Track the presence of variables and their number of occurrences in a parsed expression.

Parameters
countera zero-initialized array where the count of each variable will be stored
sizesize of array
Returns
0 on success, a negative value indicates that no expression or array was passed or size was zero

Definition at line 756 of file eval.c.

Referenced by check_exprs(), and scale_frame().

◆ av_expr_count_func()

int av_expr_count_func ( AVExpr e,
unsigned *  counter,
int  size,
int  arg 
)

Track the presence of user provided functions and their number of occurrences in a parsed expression.

Parameters
countera zero-initialized array where the count of each function will be stored if you passed 5 functions with 2 arguments to av_expr_parse() then for arg=2 this will use upto 5 entries.
sizesize of array
argnumber of arguments the counted functions have
Returns
0 on success, a negative value indicates that no expression or array was passed or size was zero

Definition at line 761 of file eval.c.

Referenced by geq_init().

◆ av_expr_free()

void av_expr_free ( AVExpr e)

◆ av_strtod()

double av_strtod ( const char *  numstr,
char **  tail 
)

Parse the string in numstr and return its value as a double.

If the string is empty, contains only whitespaces, or does not contain an initial substring that has the expected syntax for a floating-point number, no conversion is performed. In this case, returns a value of zero and the value returned in tail is the value of numstr.

Parameters
numstra string representing a number, may contain one of the International System number postfixes, for example 'K', 'M', 'G'. If 'i' is appended after the postfix, powers of 2 are used instead of powers of 10. The 'B' postfix multiplies the value by 8, and can be appended after another postfix or used alone. This allows using for example 'KB', 'MiB', 'G' and 'B' as postfix.
tailif non-NULL puts here the pointer to the char next after the last parsed character

Definition at line 106 of file eval.c.

Referenced by ff_parse_sample_rate(), open_output_file(), parse_number_or_die(), parse_points_str(), parse_primary(), parse_string(), parse_weights(), set_param(), and var_read_float().