在ffmpeg中添加编解码器

本文基于ffmpeg-2.2，添加基于QSV(Intel Media SDK / Quick Sync Video)的系列编解码器qsvavc_enc、qsvavc_dec、qsvmpeg2_dec、 qsvvc1_dec，通过一个命令行参数--enable-qsv打开和关闭。

1. 在libavcodec目录添加相应的代码实现

 

可参考hevc.c, libx265.c。如qsvdec.c，qsvenc.c。

文件名可以随意起，实现中注意下面红字标出的地方需注意。

ff_qsvavc_decoder/ff_qsvavc_encoder是全局变量，在libavcodec/allcodecs.c中调用REGISTER_ENCDEC宏注册编解码器时会引用此全局变量，因此要保值一致。

.name项影响到ffmpeg命令行参数-vcodec的名称。

AVCodec ff_ qsvavc_decoder = {

    .name           = " qsvavc",

    .long_name      = NULL_IF_CONFIG_SMALL("H.264 / AVC Decoder via Intel Media SDK / Quick Sync Video (QSV)"),

    .type           = AVMEDIA_TYPE_VIDEO,

    .id             = AV_CODEC_ID_H264,

    .priv_data_size = sizeof(qsvContext),

    .init           = qsv_decode_init_avc,

    .close          = qsv_decode_close,

    .decode         = qsv_decode_frame,

    .flush          = qsv_decode_flush,

    .capabilities   = CODEC_CAP_DR1 | CODEC_CAP_DELAY | CODEC_CAP_TRUNCATED,

};

2. 在libavcodec/allcodecs.c中添加编解码器的注册

REGISTER_ENCODER(QSVAVC,            qsvavc);

REGISTER_DECODER(QSVAVC,            qsvavc);

REGISTER_DECODER(QSVMPEG2,          qsvmpeg2);

REGISTER_DECODER(QSVVC1,            qsvvc1);

allcodecs.c定义了REGISTER_ENCDEC，REGISTER_DECODER，REGISTER_ENCODER三个宏，用于注册编码解码器，仅编码器，仅解码器。

查看REGISTER_DECODER的宏定义可以看到，先引用全局的ff_xxx_decoder变量，然后调用avcodec_register()函数添加到解码器列表中。

#define REGISTER_DECODER(X, x)                                          \

    {                                                                   \

        extern AVCodec  ff_##x##_decoder;                                \

        if ( CONFIG_##X##_DECODER)                                       \

            avcodec_register(&ff_##x##_decoder);                        \

    }

3. 在libavcodec/Makefile中添加目标文件

将.c文件名替换为.o

OBJS-$(CONFIG_ QSV)              += qsvdec.o

OBJS-$(CONFIG_ QSV)              += qsvenc.o

或

OBJS-$(CONFIG_ QSVAVC_DECODER)              += qsvdec.o

OBJS-$(CONFIG_ QSVAVC_ENCODER)              += qsvenc.o

$(CONFIG_XXX)在./configure时生成的config.mak中定义。

4. 修改configure文件，使编解码器可以在./configure时禁用和启用

这个步骤是网上一些文章中没有的。

搜索show_help()函数，添加./configure --help时的帮助显示，非必须。

--enable-qsv           enable codecs via Intel Media SDK

在EXTERNAL_LIBRARY_LIST变量中添加qsv，否则./configure --enable-qsv会提示没有这个选项。另外，./configure会根据此生成config.h的#define CONFIG_QSV 1和config.mak的CONFIG_QSV=yes。

添加依赖关系，将qsvavc_decoder/qsvavc_encoder和--enable- qsv的配置项关联起来。

可以搜索“libx264_encoder_deps”，在后面添加。

qsvavc_decoder_deps="qsv"

qsvavc_encoder_deps="qsv"

qsvmpeg2_decoder_deps="qsv"

qsvvc1_decoder_deps="qsv"

添加依赖库的检查。可以搜索“enabled libx264”在后面添加。

enabled qsv             && { check_lib mfxvideo.h MFXInit -lmfxhw64 -lva -lva-drm ||

                               die "ERROR: Intel Media SDK not found"; }

5. configure时相关宏定义和环境变量的生成

config.h

#define CONFIG_QSV 1

#define CONFIG_QSVAVC_DECODER 1

#define CONFIG_QSVMPEG2_DECODER 1

#define CONFIG_QSVVC1_DECODER 1

#define CONFIG_BINTEXT_DECODER 1

config.mak

CONFIG_QSV=yes

CONFIG_QSVAVC_DECODER=yes

CONFIG_QSVMPEG2_DECODER=yes

CONFIG_QSVVC1_DECODER=yes

CONFIG_BINTEXT_DECODER=yes

$ALL_COMPONENTS -> $DECODER_LIST -> find_things() 通过sed提取allcodecs.c中的编码解码器，添加到$ALL_COMPONENTS列表中。

configure -> check_deps() $ALL_COMPONENTS 默认为yes -> do_check_deps()根据qsvavc_decoder_deps的依赖关系检测，disable不符合依赖关系的。如qsvavc_decoder的依赖设置为qsvavc_decoder_deps="qsv"，configure时不添加--enable-qsv参数，qsvavc_decoder的值先设置为yes，do_check_deps()时检测不满足依赖关系，将qsvavc_decoder的值改为no。

configure -> print_config() 读取$ALL_COMPONENTS每项 的值，在config.h或config.mak中生成相应的宏定义或环境变量。如qsvavc_decoder项的值为no，生成#define CONFIG_QSVAVC_DECODER 0，config.mak中的CONFIG_QSVAVC_DECODER=yes被注掉。

map 'eval echo "$v \ ${$v:-no}"' "$@"

如果qsvavc_decoder_deps="qsv"没有被正确添加，会生成#define CONFIG_QSVAVC_DECODER 1和CONFIG_QSVAVC_DECODER=yes，而导致相应模块被误编译，但关联库和头文件的搜索路径未添加，从而会导致编译错误。