《FFmpeg开发实战:从零基础到短视频上线》一书的"7.1.1 添加图片标志"介绍了如何给视频添加图片标志,比如给视频画面添加一张二维码图像。不过前提条件是存在二维码图片,因为FFmpeg本身不支持根据文本生成二维码图像。幸而从FFmpeg 7.0开始,通过第三方的libqrencode和libquirc库实现了二维码的读写功能,这样处理视频中的二维码图像就方便多了。
接下来以微软的视窗系统为例,介绍如何在Windows环境给FFmpeg集成二维码的编解码器libqrencode和libquirc,具体的操作步骤说明如下:
一、配置libqrencode
libqrencode是一个快速紧凑的二维码编码库,支持将文本、URL、电话号码等信息转换为二维码图像。libqrencode的源码托管页面在https://github.com/fukuchi/libqrencode,最新版为2020年9月推出的libqrencode-4.1.1,下载地址是https://codeload.github.com/fukuchi/libqrencode/tar.gz/refs/tags/v4.1.1。
先下载最新的qrencode源码,再把qrencode源码包复制到MSYS环境的/usr/local/src目录下。接着在MSYS控制台执行下面命令解压源码包:
tar zxvf libqrencode-4.1.1.tar.gz
cd libqrencode-4.1.1
然后执行下面命令配置qrencode:
mkdir build
cd build
cmake -DBUILD_SHARED_LIBS=1 ..
配置完毕,会在build目录下找到QRencode.sln,这就是qrencode的Visual Studio项目工程文件。
二、编译libqrencode
打开Visual Studio 2022,在欢迎页面单击右侧的"打开项目或解决方案",在弹出的文件对话框中选择libqrencode-4.1.1\build目录下的QRencode.sln。
打开qrencode工程后,依次选择顶部菜单:生成→配置管理器,在打开的配置管理器窗口上,找到左上角的"活动解决方案配置"下拉框,把Debug模式改为Release模式,再单击窗口右下角的关闭按钮。
依次选择顶部菜单:生成→Build ALL_BUILD,Visual Studio就开始编译qrencode模块。编译过程可在Visual Studio界面下方观察,直到编译完成如下图所示。
此时可在libqrencode-4.1.1\Release目录下找到qrencode.lib和qrencode.dll,这两个文件就是编译生成的libqrencode库文件。
三、安装libqrencode
确保Windows系统已经按照《FFmpeg开发实战:从零基础到短视频上线》第一章"1.3 Windows系统安装FFmpeg"的说明安装配置了MSYS,再按照以下步骤在MSYS环境安装libqrencode。
1、在msys64的/usr/local目录下新建libqrencode目录,并在该目录下创建lib子目录;
2、把qrencode工程中Release目录下的qrencode.lib和qrencode.dll两个文件复制到第一步创建的lib目录;
3、在lib目录下创建pkgconfig子目录,并把qrencode工程的build\libqrencode.pc复制到pkgconfig目录;然后打开libqrencode.pc,把开头四行改成下面这样。
prefix=/usr/local/libqrencode
exec_prefix=${prefix}
libdir=${exec_prefix}/lib
includedir=${prefix}/include
4、在msys64的/usr/local/libqrencode目录下创建include目录,然后把qrencode工程的qrencode.h文件复制到刚才创建的include目录;
经过以上步骤操作后的libqrencode目录结构如下所示。
/usr/local/libqrencode
|--------------- lib
| |----- qrencode.lib
| |----- qrencode.dll
| |----- pkgconfig
| |----- libqrencode.pc
|--------------- include
| |----- qrencode.h
四、编译libquirc
libquirc是一个从图像中提取并解析二维码的开源库,它的源码托管页面在https://github.com/dlbeer/quirc,最新版为2023年5月推出的quirc-1.2,下载地址是https://codeload.github.com/dlbeer/quirc/tar.gz/refs/tags/v1.2。
先下载最新的quirc源码,再把quirc源码包复制到MSYS环境的/usr/local/src目录下。接着在MSYS控制台执行下面命令解压源码包:
tar zxvf quirc-1.2.tar.gz
cd quirc-1.2
接着打开quirc源码目录下的Makefile,找到下面这行:
all: libquirc.so qrtest
在其后补充下面两行用于编译Windows环境需要的dll文件和lib文件:
lib: $(LIB_OBJ)
$(CC) -shared -o quirc.dll $(LIB_OBJ) $(LDFLAGS) -lm -Wl,--out-implib,quirc.lib
保存Makefile文件后执行以下命令编译quirc:
make lib
编译完毕会在quirc源码目录下生成quirc.dll和quirc.lib两个文件。
五、安装libquirc
确保Windows系统已经按照《FFmpeg开发实战:从零基础到短视频上线》第一章"1.3 Windows系统安装FFmpeg"的说明安装配置了MSYS,再按照以下步骤在MSYS环境安装libquirc。
1、在msys64的/usr/local目录下新建libquirc目录,并在该目录下创建lib子目录;
2、把quirc源码目录下的quirc.lib和quirc.dll两个文件复制到第一步创建的lib目录;
3、在lib目录下创建pkgconfig子目录,并在pkgconfig目录下新建文件libquirc.pc,给该pc文件填入以下的配置内容。
prefix=/usr/local/libquirc
exec_prefix=${prefix}
libdir=${exec_prefix}/lib
includedir=${prefix}/include
Name: libquirc
Description: A QR Code extracting and decoding library
Version: 1.2
Libs: -L${libdir} -lquirc
Libs.private:
Cflags: -I${includedir}
4、在msys64的/usr/local/libquirc目录下创建include目录,然后把quirc源码目录的lib\quirc.h文件复制到刚才创建的include目录;
经过以上步骤操作后的libquirc目录结构如下所示。
/usr/local/libquirc
|--------------- lib
| |----- quirc.lib
| |----- quirc.dll
| |----- pkgconfig
| |----- libquirc.pc
|--------------- include
| |----- quirc.h
六、编译安装FFmpeg
先下载最新的FFmpeg源码(版本号需大于等于7.0),再把FFmpeg源码包复制到MSYS环境的/usr/local/src目录下。接着在MSYS控制台执行下面命令解压源码包:
cd /usr/local/src
unzip ffmpeg-n7.1.1.zip
确保MSYS环境已经按照《FFmpeg开发实战:从零基础到短视频上线》该书第八章的"8.1.1 给FFmpeg集成x264"和"8.1.5 给FFmpeg集成x265"安装了H.264的编码器libx264和H.265的编码器libx265,也按照该书第十章的"10.1.1 FFmpeg集成SDL"安装了Windows系统的SDL2库,并且按照之前的文章安装了H.266的编码器libvvenc,然后执行下面命令配置FFmpeg的编译环境:
cd ffmpeg-n7.1.1
export PKG_CONFIG_PATH=/usr/local/libqrencode/lib/pkgconfig:$PKG_CONFIG_PATH
./configure --prefix=/usr/local/ffmpeg --arch=x86_64 --enable-shared --disable-static --disable-doc --enable-libx264 --enable-libx265 --enable-libvvenc --enable-liblc3 --enable-librist --enable-libdav1d --enable-libaom --enable-libsvtav1 --enable-libxevd --enable-libxeve --enable-libqrencode --enable-libquirc --enable-sdl2 --enable-gpl --enable-nonfree --enable-iconv --enable-zlib --extra-cflags='-I/usr/local/libquirc/include' --extra-ldflags='-L/usr/local/libquirc/lib' --cross-prefix=x86_64-w64-mingw32- --target-os=mingw32
配置完毕执行下面命令编译和安装FFmpeg,编译完成的ffmpeg库将会安装到configure指定的/usr/local/ffmpeg目录。
make
make install
cp /usr/local/libqrencode/lib/qrencode.dll /usr/local/ffmpeg/bin
cp /usr/local/libquirc/lib/quirc.dll /usr/local/ffmpeg/bin
七、查看FFmpeg的安装结果
运行下面命令查看FFmpeg的安装版本:
ffmpeg -version
上面命令返回的FFmpeg版本信息如下:
ffmpeg version 7.1.1 Copyright (c) 2000-2025 the FFmpeg developers
built with gcc 12.2.0 (Rev10, Built by MSYS2 project)
configuration: --prefix=/usr/local/ffmpeg --arch=x86_64 --enable-shared --disable-static --disable-doc --enable-libx264 --enable-libx265 --enable-libvvenc --enable-liblc3 --enable-librist --enable-libdav1d --enable-libaom --enable-libsvtav1 --enable-libxevd --enable-libxeve --enable-libqrencode --enable-libquirc --enable-sdl2 --enable-gpl --enable-nonfree --enable-iconv --enable-zlib --extra-cflags=-I/usr/local/libquirc/include --extra-ldflags=-L/usr/local/libquirc/lib --cross-prefix=x86_64-w64-mingw32- --target-os=mingw32
libavutil 59. 39.100 / 59. 39.100
libavcodec 61. 19.101 / 61. 19.101
libavformat 61. 7.100 / 61. 7.100
libavdevice 61. 3.100 / 61. 3.100
libavfilter 10. 4.100 / 10. 4.100
libswscale 8. 3.100 / 8. 3.100
libswresample 5. 3.100 / 5. 3.100
libpostproc 58. 3.100 / 58. 3.100
根据以上返回的版本信息,可知已安装的FFmpeg版本号为7.1.1,同时configuration这行找到"--enable-libqrencode --enable-libquirc",说明FFmpeg已经启用了二维码的编解码器libqrencode和libquirc。
更多详细的FFmpeg开发知识参见《FFmpeg开发实战:从零基础到短视频上线》一书。