FFmpeg 框架简读—Bit Stream Filter

//旧版，deprecated
typedef struct AVBitStreamFilterContext {
    other members...
    AVCodecParserContext *parser;
    struct AVBitStreamFilterContext *next; 
    other members...
} AVBitStreamFilterContext;
//新版
typedef struct AVBSFContext {
    other members...
    //使用av_bsf_alloc函数时，该Ctx仅有一个filter，使用该成员变量
    const struct AVBitStreamFilter *filter;
    //BSF内部数据，存储av_bsf_send_packet输入的AVPacket数据
    AVBSFInternal *internal;
    //使用av_bsf_list_parse_str函数，传入以逗号为分隔符的一系列filter名的字符串时
    //该变量会在内部强转为BSFListContext，即一系列filter的链表
    void *priv_data;
    other members...
} AVBSFContext;

//1.通过filter.name传入名称寻找filter
const AVBitStreamFilter *av_bsf_get_by_name(const char *name);

//2.根据filter分配一个Context
int av_bsf_alloc(const AVBitStreamFilter *filter, AVBSFContext **ctx);

//2.5.(可选)拷贝AVCodecParameters参数给Filter
avcodec_parameters_copy( AVBSFContext->par_in, AVCodecParameters );

//3.init bsf ctx
int av_bsf_init(AVBSFContext *ctx);

//定义
typedef struct AVBitStreamFilter {
    const char *name;
    const enum AVCodecID *codec_ids;

    const AVClass *priv_class;
    int priv_data_size;

    int (*init)(AVBSFContext *ctx);
    int (*filter)(AVBSFContext *ctx, AVPacket *pkt);
    void (*close)(AVBSFContext *ctx);
    void (*flush)(AVBSFContext *ctx);
} AVBitStreamFilter;

//具体实例(作为全局常量存在)
const AVBitStreamFilter ff_h264_mp4toannexb_bsf = {
    .name           = "h264_mp4toannexb",
    .priv_data_size = sizeof(H264BSFContext),
    .init           = h264_mp4toannexb_init,
    .filter         = h264_mp4toannexb_filter,
    .flush          = h264_mp4toannexb_flush,
    .codec_ids      = {AV_CODEC_ID_H264, AV_CODEC_ID_NONE,},
};

static const AVBitStreamFilter * const bitstream_filters[] = {
    &ff_aac_adtstoasc_bsf,
    &ff_h264_mp4toannexb_bsf,
    中间内容略...
    &ff_vp9_superframe_split_bsf,
    NULL };

● 申请AVBSFContext与AVBSFInternal
● 申请AVBSFContext的记录输入输出参数配置的AVCodecParameters
● 申请AVBSFInternal中的AVPacket缓存，作为BSF的输入缓存
● 按需申请某些Filter的私有内容

● 确认输入流的codec是否在filter支持的序列内，如果不支持则初始化失败直接返回
● 出入参、出入time_base拷贝
● 调用filter的init函数

//旧版同步接口
attribute_deprecated
int av_bitstream_filter_filter(AVBitStreamFilterContext *bsfc,
                               AVCodecContext *avctx, const char *args,
                               uint8_t **poutbuf, int *poutbuf_size,
                               const uint8_t *buf, int buf_size, int keyframe);
//新版异步接口
int av_bsf_send_packet(AVBSFContext *ctx, AVPacket *pkt);


int av_bsf_receive_packet(AVBSFContext *ctx, AVPacket *pkt);

#define DECLARE_MEDIACODEC_VDEC(short_name, full_name, codec_id, bsf)                          \
DECLARE_MEDIACODEC_VCLASS(short_name)                                                          \
AVCodec ff_##short_name##_mediacodec_decoder = {                                               \
    .name           = #short_name "_mediacodec",                                               \
    略...
    .bsfs           = bsf,                                                                     \
    略...
};                                                                                             \

#if CONFIG_H264_MEDIACODEC_DECODER
DECLARE_MEDIACODEC_VDEC(h264, "H.264", AV_CODEC_ID_H264, "h264_mp4toannexb")
#endif

#if CONFIG_HEVC_MEDIACODEC_DECODER
DECLARE_MEDIACODEC_VDEC(hevc, "H.265", AV_CODEC_ID_HEVC, "hevc_mp4toannexb")
#endif

#if CONFIG_MPEG4_MEDIACODEC_DECODER
DECLARE_MEDIACODEC_VDEC(mpeg4, "MPEG-4", AV_CODEC_ID_MPEG4, NULL)
#endif

#if CONFIG_VP9_MEDIACODEC_DECODER
DECLARE_MEDIACODEC_VDEC(vp9, "VP9", AV_CODEC_ID_VP9, NULL)
#endif

● 若场景只需要1个filter，在av_bsf_list_finalize的尾处理中，会直接将AVBSFList的头节点作为该AVBSFContext并返回，无需包装一个链表。
● 若无需filter或需要多个filter，他们的模式是一样的：返回一个“内部承载了一个FilterList”的AVBSFContext。当这种类型的上下文被下达“filter”指令进行数据过滤，其会利用内部的priv_data字段，强转成(BSFListContext*)类型的指针，而BSFListContext内部的AVBSFContext节点内记载着真正的filter。
  ○ 若无需filter，即AVCodec中的.bsfs字符串为NULL，内部会经过av_bsf_get_null_filter返回filter数为0的BSFListContext类型空链表。
  ○ 需要多个filter，则会根据字符串解析，通过int av_bsf_list_append(AVBSFList *lst, AVBSFContext *bsf);接口，将每个filter添加到AVBSFList中。在最后的尾处理函数以BSFListContext记录（承载）该链表。

//相关公开接口（用户可直接调用），位于libavcodec/bsf.h
int av_bsf_list_append(AVBSFList *lst, AVBSFContext *bsf);
int av_bsf_list_append2(AVBSFList *lst, const char * bsf_name, AVDictionary **options);
int av_bsf_list_finalize(AVBSFList **lst, AVBSFContext **bsf);//上面提到的"尾处理"
int av_bsf_list_parse_str(const char *str, AVBSFContext **bsf);