FFmpeg库常用函数介绍（三）

1 av_opt_set_bin

作用：将二进制数据作为值设置给对象。

函数原型：

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

obj：要设置选项的对象；

name：选项名称；

val：要设置的值；

size：值的大小；

search_flags：搜索选项的方式。例如，AV_OPT_SEARCH_CHILDREN指的是首先搜索给定对象的子对象。

返回值：负值表示失败。

2 av_opt_set_int_list

作用：将整数数组作为选项值设置给对象。

函数原型：

#define av_opt_set_int_list(obj, name, val, term, flags) \
(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))

obj：要设置选项的对象；

name：选项名称；

val：要设置的值，整型数组；

term：val所代表数组中的最后一个元素，其值通常为0或者-1；假设val数组为enum AVPixelFormat val[] = {AV_PIX_FMT_YUV420P, AV_PIX_FMT_YUYV422, AV_PIX_FMT_NONE}，那么term的值就是AV_PIX_FMT_NONE，AV_PIX_FMT_NONE值为-1；

flags：搜索选项的方式。例如，AV_OPT_SEARCH_CHILDREN指的是首先搜索给定对象的子对象。

宏定义运行的结果：负值表示失败。

注意：从函数原型上可以看出，该宏定义其实就是调用的av_opt_set_bin。

3 av_get_default_channel_layout

作用：根据通道数返回默认的声道布局。

函数原型：

int64_t av_get_default_channel_layout(int nb_channels);

nb_channels：通道数；

返回值：声道布局。

4 av_get_sample_fmt_name

作用：根据采样格式返回采样格式的名称。

函数原型：

const char *av_get_sample_fmt_name(AVSampleFormat sample_fmt);

sample_fmt：采样格式；

返回值：成功返回采样格式的名称，失败返回NULL。

5 av_strdup

作用：拷贝一个字符串。

函数原型：

char *av_strdup(const c