FFmpeg
Macros | Functions
Option setting functions

Those functions set the field of obj with the given name to value. More...

Macros

#define av_opt_set_int_list(obj, name, val, term, flags)
 Set a binary option to an integer list. More...
 

Functions

int av_opt_set (void *obj, const char *name, const char *val, int search_flags)
 
int av_opt_set_int (void *obj, const char *name, int64_t val, int search_flags)
 
int av_opt_set_double (void *obj, const char *name, double val, int search_flags)
 
int av_opt_set_q (void *obj, const char *name, AVRational val, int search_flags)
 
int av_opt_set_bin (void *obj, const char *name, const uint8_t *val, int size, int search_flags)
 
int av_opt_set_image_size (void *obj, const char *name, int w, int h, int search_flags)
 
int av_opt_set_pixel_fmt (void *obj, const char *name, enum AVPixelFormat fmt, int search_flags)
 
int av_opt_set_sample_fmt (void *obj, const char *name, enum AVSampleFormat fmt, int search_flags)
 
int av_opt_set_video_rate (void *obj, const char *name, AVRational val, int search_flags)
 
int av_opt_set_channel_layout (void *obj, const char *name, int64_t ch_layout, int search_flags)
 
int av_opt_set_dict_val (void *obj, const char *name, const AVDictionary *val, int search_flags)
 

Detailed Description

Those functions set the field of obj with the given name to value.

Parameters
[in]objA struct whose first element is a pointer to an AVClass.
[in]namethe name of the field to set
[in]valThe value to set. In case of av_opt_set() if the field is not of a string type, then the given string is parsed. SI postfixes and some named scalars are supported. If the field is of a numeric type, it has to be a numeric or named scalar. Behavior with more than one scalar and +- infix operators is undefined. If the field is of a flags type, it has to be a sequence of numeric scalars or named flags separated by '+' or '-'. Prefixing a flag with '+' causes it to be set without affecting the other flags; similarly, '-' unsets a flag.
search_flagsflags passed to av_opt_find2. I.e. if AV_OPT_SEARCH_CHILDREN is passed here, then the option may be set on a child of obj.
Returns
0 if the value has been set, or an AVERROR code in case of error: AVERROR_OPTION_NOT_FOUND if no matching option exists AVERROR(ERANGE) if the value is out of range AVERROR(EINVAL) if the value is not valid

Macro Definition Documentation

#define av_opt_set_int_list (   obj,
  name,
  val,
  term,
  flags 
)
Value:
(av_int_list_length(val, term) > INT_MAX / sizeof(*(val)) ? \
AVERROR(EINVAL) : \
av_opt_set_bin(obj, name, (const uint8_t *)(val), \
av_int_list_length(val, term) * sizeof(*(val)), flags))
const char const char void * val
Definition: avisynth_c.h:863
int av_opt_set_bin(void *obj, const char *name, const uint8_t *val, int size, int search_flags)
Definition: opt.c:583
uint8_t
#define flags(name, subs,...)
Definition: cbs_av1.c:561
#define av_int_list_length(list, term)
Compute the length of an integer list.
Definition: avutil.h:331
Filter the word “frame” indicates either a video frame or a group of audio as stored in an AVFrame structure Format for each input and each output the list of supported formats For video that means pixel format For audio that means channel sample they are references to shared objects When the negotiation mechanism computes the intersection of the formats supported at each end of a all references to both lists are replaced with a reference to the intersection And when a single format is eventually chosen for a link amongst the remaining all references to the list are updated That means that if a filter requires that its input and output have the same format amongst a supported all it has to do is use a reference to the same list of formats query_formats can leave some formats unset and return AVERROR(EAGAIN) to cause the negotiation mechanism toagain later.That can be used by filters with complex requirements to use the format negotiated on one link to set the formats supported on another.Frame references ownership and permissions
const char * name
Definition: opengl_enc.c:102

Set a binary option to an integer list.

Parameters
objAVClass object to set options on
namename of the binary option
valpointer to an integer list (must have the correct type with regard to the contents of the list)
termlist terminator (usually 0 or -1)
flagssearch flags
Examples:
filtering_audio.c, and filtering_video.c.

Definition at line 709 of file opt.h.

Referenced by asink_init(), get_video_frame(), init_filters(), lavfi_read_header(), and vsink_init().

Function Documentation

int av_opt_set ( void obj,
const char *  name,
const char *  val,
int  search_flags 
)
int av_opt_set_int ( void obj,
const char *  name,
int64_t  val,
int  search_flags 
)
int av_opt_set_double ( void obj,
const char *  name,
double  val,
int  search_flags 
)

Definition at line 573 of file opt.c.

int av_opt_set_q ( void obj,
const char *  name,
AVRational  val,
int  search_flags 
)

Definition at line 578 of file opt.c.

Referenced by init_filter_graph().

int av_opt_set_bin ( void obj,
const char *  name,
const uint8_t val,
int  size,
int  search_flags 
)

Definition at line 583 of file opt.c.

Referenced by init_filter(), rtmp_calc_swfhash(), rtmp_http_open(), and rtmp_http_send_cmd().

int av_opt_set_image_size ( void obj,
const char *  name,
int  w,
int  h,
int  search_flags 
)

Definition at line 613 of file opt.c.

int av_opt_set_pixel_fmt ( void obj,
const char *  name,
enum AVPixelFormat  fmt,
int  search_flags 
)

Definition at line 681 of file opt.c.

int av_opt_set_sample_fmt ( void obj,
const char *  name,
enum AVSampleFormat  fmt,
int  search_flags 
)

Definition at line 686 of file opt.c.

Referenced by config_audio_output(), main(), and open_audio().

int av_opt_set_video_rate ( void obj,
const char *  name,
AVRational  val,
int  search_flags 
)

Definition at line 635 of file opt.c.

int av_opt_set_channel_layout ( void obj,
const char *  name,
int64_t  ch_layout,
int  search_flags 
)

Definition at line 691 of file opt.c.

int av_opt_set_dict_val ( void obj,
const char *  name,
const AVDictionary val,
int  search_flags 
)
Note
Any old dictionary present is discarded and replaced with a copy of the new one. The caller still owns val is and responsible for freeing it.

Definition at line 707 of file opt.c.

Referenced by read_frame_internal().