avformat_alloc_output_context2源码

2020-04-20  本文已影响0人  Sivin
/**
 * 为输出格式分配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_namefilename参数来创建生成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中。

上一篇下一篇

猜你喜欢

热点阅读