avformat_alloc_output_context2源码
/**
* 为输出格式分配AVFormatContext,使用avformat_free_context()释放
* @param *ctx 输出参数,创建好的 AVFormatContext*对象将会由该参数传递出来
* 如果分配失败,则NULL
* 后面的三个参数,按着优先级,决定着*ctx的创建,如果oformat是null,则
* format_name和filename起作用,如果foramt_name是空,则由filename起作用
*/
int avformat_alloc_output_context2(AVFormatContext **ctx,
AVOutputFormat *oformat,
const char *format_name,
const char *filename);
API使用场景
AVFormatContext *ofmt_ctx = NULL;
avformat_alloc_output_context2(&ofmt_ctx, NULL, NULL, out_filename);
//或
avformat_alloc_output_context2(&ofmt_ctx, NULL, "mpeg", out_filename);
这个函数主要作用就是根据后面的三个参数,来创建ofmt_ctx对象。
内部实现
如果让我们来实现这个逻辑该如何做?既然ctx是一个传出参数,因此完成这个过程,总体上应该分为步骤。1. 为AVFormatContext分配内存空间。2. 初始化AVFormatContext 成员属性。
1. 分配内存空间
AVFormatContext *s = avformat_alloc_context();
2. 初始化成员
这里需要弄清楚两个问题,a. 具体哪些成员需要初始化?b. 依据什么初始化?
想要解决第一个问题,我们需要知道使用这个API的场景是什么,一般,我们调用这个api的目的是为了将音视频流封装成媒体容器格式文件。而AVFormatContext
则存放着该封装格式的具体信息。因此我们需要初始化的第一个成员变量就是AVOutputFormat *oformat
。
初始化AVOutputForamt成员
根据avformat_alloc_output_context2
的API描述,oformat
这个对象的值可以以参数的形式由外部传入,如果第二个参数为NULL
,则我们可以依据format_name
和filename
参数来创建生成oformat
。
if(!oformat){
if(format_name){
oformat = av_guess_format(format, NULL, NULL);
}else{
oformat = av_guess_format(NULL, filename, NULL);
}
}
s->oformat = oformat;
为了能更清晰的表述总体设计思想,上面并没有异常容错机制,例如av_guess_format
可能会出现调用失败的情况。
初始化priv_data成员
if (s->oformat->priv_data_size > 0) {
//分配内存空间
s->priv_data = av_mallocz(s->oformat->priv_data_size);
if (!s->priv_data)
goto nomem;
if (s->oformat->priv_class) {
/*
priv_data指向了一片内存空间,这片内存空间又被解释成多个片段。
第一个片段存放的则是AVClass *的指针对象。而这个AVClass *指针指向
的数据域被赋值为:s->oformat->priv_class所指向的数据域。
*/
*(const AVClass**)s->priv_data= s->oformat->priv_class;
//为priv_data设置默认初始值
av_opt_set_defaults(s->priv_data);
}
}
priv_data
这个成员在AVFormatContext
代表什么? 有很多处理音视频的开源库,而FFmpeg的优秀之处在于其框架的统一性和的灵活的可扩展性,FFmpeg将多种媒体类型的广义数据的共同部分抽象成Context结构,而将广义数据的不同部分抽象成各种具体的context,然后用priv_data字段的指针关联起来。例如在本篇中,我们的目的是将编码数据封装成媒体容器格式,因此AVFormatContext
对象会描述所有的输出格式上下文信息,其内部使用iformat/oformat
来表示该对象是输入上下文还是输出上下文,但是即使是这样,iforamt
或者oformat
也依然无法完全表示一个具体媒体格式的全部信息,准确的说iformat/oformat
这个对象主要定义了怎样实现输入或者输出功能。不同的媒体格式有不同的参数控制信息,FFMpeg将这些信息关联到iforamt/oformat
对象的priv_class
字段中,这是一个AVClass
的结构体指针,它内部指向到一个预制参数静态数组(options),而priv_data
的作用就是将这个静态结构数组里的各个选项的值,解析并存储到priv_data
中。