FFmpeg 5.1.6
Functions
Option getting functions

Those functions get a value of the option with the given name from an object. More...

Functions

int av_opt_get (void *obj, const char *name, int search_flags, uint8_t **out_val)
 
int av_opt_get_int (void *obj, const char *name, int search_flags, int64_t *out_val)
 
int av_opt_get_double (void *obj, const char *name, int search_flags, double *out_val)
 
int av_opt_get_q (void *obj, const char *name, int search_flags, AVRational *out_val)
 
int av_opt_get_image_size (void *obj, const char *name, int search_flags, int *w_out, int *h_out)
 
int av_opt_get_pixel_fmt (void *obj, const char *name, int search_flags, enum AVPixelFormat *out_fmt)
 
int av_opt_get_sample_fmt (void *obj, const char *name, int search_flags, enum AVSampleFormat *out_fmt)
 
int av_opt_get_video_rate (void *obj, const char *name, int search_flags, AVRational *out_val)
 
attribute_deprecated int av_opt_get_channel_layout (void *obj, const char *name, int search_flags, int64_t *ch_layout)
 
int av_opt_get_chlayout (void *obj, const char *name, int search_flags, AVChannelLayout *layout)
 
int av_opt_get_dict_val (void *obj, const char *name, int search_flags, AVDictionary **out_val)
 

Detailed Description

Those functions get a value of the option with the given name from an object.

Parameters
[in]obja struct whose first element is a pointer to an AVClass.
[in]namename of the option to get.
[in]search_flagsflags passed to av_opt_find2. I.e. if AV_OPT_SEARCH_CHILDREN is passed here, then the option may be found in a child of obj.
[out]out_valvalue of the option will be written here
Returns
>=0 on success, a negative error code otherwise

Function Documentation

◆ av_opt_get()

int av_opt_get ( void *  obj,
const char *  name,
int  search_flags,
uint8_t **  out_val 
)
Note
the returned string will be av_malloc()ed and must be av_free()ed by the caller
if AV_OPT_ALLOW_NULL is set in search_flags in av_opt_get, and the option is of type AV_OPT_TYPE_STRING, AV_OPT_TYPE_BINARY or AV_OPT_TYPE_DICT and is set to NULL, *out_val will be set to NULL instead of an allocated empty string.
Examples
http_multiclient.c.

Referenced by process_client().

◆ av_opt_get_int()

int av_opt_get_int ( void *  obj,
const char *  name,
int  search_flags,
int64_t *  out_val 
)

◆ av_opt_get_double()

int av_opt_get_double ( void *  obj,
const char *  name,
int  search_flags,
double *  out_val 
)

◆ av_opt_get_q()

int av_opt_get_q ( void *  obj,
const char *  name,
int  search_flags,
AVRational out_val 
)

◆ av_opt_get_image_size()

int av_opt_get_image_size ( void *  obj,
const char *  name,
int  search_flags,
int *  w_out,
int *  h_out 
)

◆ av_opt_get_pixel_fmt()

int av_opt_get_pixel_fmt ( void *  obj,
const char *  name,
int  search_flags,
enum AVPixelFormat out_fmt 
)

◆ av_opt_get_sample_fmt()

int av_opt_get_sample_fmt ( void *  obj,
const char *  name,
int  search_flags,
enum AVSampleFormat out_fmt 
)

◆ av_opt_get_video_rate()

int av_opt_get_video_rate ( void *  obj,
const char *  name,
int  search_flags,
AVRational out_val 
)

◆ av_opt_get_channel_layout()

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

◆ av_opt_get_chlayout()

int av_opt_get_chlayout ( void *  obj,
const char *  name,
int  search_flags,
AVChannelLayout layout 
)

◆ av_opt_get_dict_val()

int av_opt_get_dict_val ( void *  obj,
const char *  name,
int  search_flags,
AVDictionary **  out_val 
)
Parameters
[out]out_valThe returned dictionary is a copy of the actual value and must be freed with av_dict_free() by the caller