AI 助理
备案控制台
开发者社区 视觉智能 视频分割 正文

FFmpeg开发笔记（十七）Windows环境给FFmpeg集成字幕库libass

2024-05-11 162
版权
版权声明：
本文内容由阿里云实名注册用户自发贡献，版权归原作者所有，阿里云开发者社区不拥有其著作权，亦不承担相应法律责任。具体规则请查看《 阿里云开发者社区用户服务协议》和 《阿里云开发者社区知识产权保护指引》。如果您发现本社区中有涉嫌抄袭的内容，填写 侵权投诉表单进行举报，一经查实，本社区将立刻删除涉嫌侵权内容。
本文涉及的产品
视觉智能开放平台，视频资源包5000点
视觉智能开放平台，图像资源包5000点
视觉智能开放平台，分割抠图1万点
简介： 在Windows环境下为FFmpeg集成字幕渲染库libass涉及多个步骤，包括安装freetype、libxml2、gperf、fontconfig、fribidi、harfbuzz和libass。每个库的安装都需要下载源码、配置、编译和安装，并更新PKG_CONFIG_PATH环境变量。最后，重新配置并编译FFmpeg以启用libass及相关依赖。完成上述步骤后，通过`ffmpeg -version`确认libass已成功集成。

​libass是一个适用于ASS和SSA格式（Advanced Substation Alpha/Substation Alpha）的字幕渲染器，支持的字幕类型包括srt、ass等，凡是涉及到给视频画面添加字幕，均需事先集成libass。

《FFmpeg开发实战：从零基础到短视频上线》一书的“7.3.1 Linux环境安装libass”介绍了如何在Linux环境给FFmpeg集成libass，其实在Windows环境也能给FFmpeg集成libass，具体的集成步骤说明如下。注意：下列的所有命令均需在MSYS窗口中执行。

1、安装freetype

fontconfig、fribidi、harfbuzz、libass都依赖于freetype库，所以要先安装该库。freetype的安装步骤说明如下。
（1）freetype的下载页面是 https://download.savannah.gnu.org/releases/freetype/ ，比如2023年8月发布的freetype-2.13.2，该版本的源码下载地址是 https://download.savannah.gnu.org/releases/freetype/freetype-2.13.2.tar.gz 。

tar zxvf freetype-2.13.2.tar.gz
cd freetype-2.13.2

（2）进入解压后的freetype目录，运行下面命令配置freetype。

./configure --prefix=/usr/local/freetype

（3）运行下面命令编译freetype。

make

（4）编译完成后，运行下面命令安装freetype。

make install

（5）给环境变量PKG_CONFIG_PATH添加freetype的pkgconfig路径，也就是在/etc/profile文件末尾添加如下一行内容：

export PKG_CONFIG_PATH=/usr/local/freetype/lib/pkgconfig:$PKG_CONFIG_PATH

然后执行下面命令重新加载环境变量：

source /etc/profile

执行下面命令查看当前的环境变量，发现PKG_CONFIG_PATH的修改已经奏效。

env | grep PKG_CONFIG_PATH

2、安装libxml2

由于字体配置库fontconfig依赖于libxml2库，因此要先安装该库。libxml2的安装步骤说明如下。
（1）libxml2的下载页面是 http://xmlsoft.org/sources/ ，比如2010年11月发布的libxml2-2.7.8，该版本的源码下载地址是 http://xmlsoft.org/sources/libxml2-2.7.8.tar.gz 。执行下面命令解压下载好的压缩包：

tar zxvf libxml2-2.7.8.tar.gz
cd libxml2-2.7.8

（2）修改include/libxml/xmlexports.h，在文件开头增加下面一行：

#define LIBXML_STATIC

（3）进入解压后的libxml2目录，运行下面命令配置libxml2。

./configure --prefix=/usr/local/libxml2

（4）运行下面命令编译libxml2。

make

（5）编译完成后，运行下面命令安装libxml2。

make install

（6）给环境变量PKG_CONFIG_PATH添加libxml2的pkgconfig路径，也就是在/etc/profile文件末尾添加如下一行内容：

export PKG_CONFIG_PATH=/usr/local/libxml2/lib/pkgconfig:$PKG_CONFIG_PATH

然后执行下面命令重新加载环境变量：

source /etc/profile

执行下面命令查看当前的环境变量，发现PKG_CONFIG_PATH的修改已经奏效。

env | grep PKG_CONFIG_PATH

3、安装gperf

由于字体配置库fontconfig依赖于gperf，因此要先安装该工具。Windows环境运行下面命令安装gperf：

pacman -S gperf

4、安装fontconfig

fontconfig是一款字体配置工具，它能够自动检测字库，以及管理和配置字库。fontconfig的安装步骤说明如下。
（1）fontconfig的下载页面是 https://www.freedesktop.org/software/fontconfig/release/ ，比如2023年1月发布的fontconfig-2.14.2，该版本的源码下载地址是 https://www.freedesktop.org/software/fontconfig/release/fontconfig-2.14.2.tar.gz 。执行下面命令解压下载好的压缩包：

tar zxvf fontconfig-2.14.2.tar.gz
cd fontconfig-2.14.2

（2）进入解压后的fontconfig目录，运行下面命令配置fontconfig。

./configure --prefix=/usr/local/fontconfig --enable-libxml2 --disable-docs

注意：如果没安装libxml2，运行configure就会报错“* expat is required. or try to use --enable-libxml2”。
（3）运行下面命令编译fontconfig。

make

（4）编译完成后，运行下面命令安装fontconfig。

make install

（5）给环境变量PKG_CONFIG_PATH添加fontconfig的pkgconfig路径，也就是在/etc/profile文件末尾添加如下一行内容：

export PKG_CONFIG_PATH=/usr/local/fontconfig/lib/pkgconfig:$PKG_CONFIG_PATH

然后执行下面命令重新加载环境变量：

source /etc/profile

执行下面命令查看当前的环境变量，发现PKG_CONFIG_PATH的修改已经奏效。

env | grep PKG_CONFIG_PATH

5、安装fribidi

fribidi是个中东字体增强库，它实现了Unicode字符集的双向算法，以便处理阿拉伯语、希伯来语这些中东语言。fribidi的安装步骤说明如下。
（1）fribidi的下载页面是 https://github.com/fribidi/fribidi/releases ，比如2023年5月发布的fribidi-1.0.13，该版本的源码下载地址是 https://github.com/fribidi/fribidi/releases/download/v1.0.13/fribidi-1.0.13.tar.xz 。注意要下载扩展名是tar.xz的压缩包，不能下载扩展名是tar.gz的压缩包，因为tar.gz里面没有configure文件。执行下面命令解压下载好的压缩包：

tar xvf fribidi-1.0.13.tar.xz
cd fribidi-1.0.13

（2）进入解压后的fribidi目录，运行下面命令配置fribidi。

./configure --prefix=/usr/local/fribidi

（3）运行下面命令编译fribidi。

make

（4）编译完成后，运行下面命令安装fribidi。

make install

（5）给环境变量PKG_CONFIG_PATH添加fribidi的pkgconfig路径，也就是在/etc/profile文件末尾添加如下一行内容：

export PKG_CONFIG_PATH=/usr/local/fribidi/lib/pkgconfig:$PKG_CONFIG_PATH

然后执行下面命令重新加载环境变量：

source /etc/profile

执行下面命令查看当前的环境变量，发现PKG_CONFIG_PATH的修改已经奏效。

env | grep PKG_CONFIG_PATH

6、安装harfbuzz

harfbuzz是一个文本塑形引擎，它能够将Unicode字符转换为格式正确的字形输出，可用于调试和预览字体效果。harfbuzz的安装步骤说明如下。
（1）harfbuzz的最新源码在 https://github.com/harfbuzz/harfbuzz ，但是高版本harfbuzz容易编译失败，实际应用采取1.2.7版本就够了。各版本harfbuzz的下载页面是 https://www.freedesktop.org/software/harfbuzz/release/ ，比如1.2.7版本的源码下载地址是 https://www.freedesktop.org/software/harfbuzz/release/harfbuzz-1.2.7.tar.bz2 。执行下面命令解压下载好的压缩包：

tar xvf harfbuzz-1.2.7.tar.bz2
cd harfbuzz-1.2.7

（2）进入解压后的harfbuzz目录，运行下面命令配置harfbuzz。

./configure --prefix=/usr/local/harfbuzz --disable-gtk-doc

（3）运行下面命令编译harfbuzz。

make

（4）编译完成后，运行下面命令安装harfbuzz。

make install

（5）给环境变量PKG_CONFIG_PATH添加harfbuzz的pkgconfig路径，也就是在/etc/profile文件末尾添加如下一行内容：

export PKG_CONFIG_PATH=/usr/local/harfbuzz/lib/pkgconfig:$PKG_CONFIG_PATH

然后执行下面命令重新加载环境变量：

source /etc/profile

执行下面命令查看当前的环境变量，发现PKG_CONFIG_PATH的修改已经奏效。

env | grep PKG_CONFIG_PATH

7、安装libass

确认以上的freetype、libxml2、gperf、fontconfig、fribidi、harfbuzz等库全都正确安装之后，再来安装字幕渲染器libass。libass的安装步骤说明如下。
（1）libass的源码页面是 https://github.com/libass/libass ，下载页面是 https://github.com/libass/libass/releases ，比如2023年2月发布的libass-0.17.1，该版本的源码下载地址是 https://github.com/libass/libass/releases/download/0.17.1/libass-0.17.1.tar.gz 。执行下面命令解压下载好的压缩包：

tar zxvf libass-0.17.1.tar.gz
cd libass-0.17.1

（2）进入解压后的libass目录，运行下面命令配置libass。

./configure --prefix=/usr/local/libass

（3）运行下面命令编译libass。

make

（4）编译完成后，运行下面命令安装libass。

make install

（5）给环境变量PKG_CONFIG_PATH添加libass的pkgconfig路径，也就是在/etc/profile文件末尾添加如下一行内容：

export PKG_CONFIG_PATH=/usr/local/libass/lib/pkgconfig:$PKG_CONFIG_PATH

然后执行下面命令重新加载环境变量：

source /etc/profile

执行下面命令查看当前的环境变量，发现PKG_CONFIG_PATH的修改已经奏效。

env | grep PKG_CONFIG_PATH

8、启用libass

由于FFmpeg默认未启用libass，因此需要重新配置FFmpeg，标明启用libass，然后重新编译安装FFmpeg。FFmpeg的Windows环境完整编译过程参见《FFmpeg开发实战：从零基础到短视频上线》一书的“8.1 Windows环境编译FFmpeg”，详细的启用步骤说明如下。
（1）确保下列路径均已加载至环境变量PKG_CONFIG_PATH

export PKG_CONFIG_PATH=/usr/local/freetype/lib/pkgconfig:$PKG_CONFIG_PATH
export PKG_CONFIG_PATH=/usr/local/libxml2/lib/pkgconfig:$PKG_CONFIG_PATH
export PKG_CONFIG_PATH=/usr/local/fontconfig/lib/pkgconfig:$PKG_CONFIG_PATH
export PKG_CONFIG_PATH=/usr/local/fribidi/lib/pkgconfig:$PKG_CONFIG_PATH
export PKG_CONFIG_PATH=/usr/local/harfbuzz/lib/pkgconfig:$PKG_CONFIG_PATH
export PKG_CONFIG_PATH=/usr/local/libass/lib/pkgconfig:$PKG_CONFIG_PATH

（2）执行以下命令，在libxml2的安装路径下补充一个xmlversion.h，因为配置FFmpeg的时候会检查。

mkdir -p /usr/local/libxml2/include/libxml2/libxml2/libxml
cp /usr/local/libxml2/include/libxml2/libxml/xmlversion.h /usr/local/libxml2/include/libxml2/libxml2/libxml/xmlversion.h

（3）回到FFmpeg源码的目录，执行以下命令重新配置FFmpeg，主要增加启用libass。（增加了选项--enable-libass --enable-libfribidi --enable-libxml2 --enable-fontconfig）

./configure  --prefix=/usr/local/ffmpeg --arch=x86_64 --enable-shared --disable-static --disable-doc --enable-libx264 --enable-libx265 --enable-libxavs2 --enable-libdavs2 --enable-libmp3lame --enable-gpl --enable-nonfree --enable-libfreetype --enable-sdl2 --enable-libvorbis --enable-libopencore-amrnb --enable-libopencore-amrwb --enable-version3 --enable-libopus --enable-libvpx --enable-libass --enable-libfribidi --enable-libxml2 --enable-fontconfig --enable-openssl --enable-iconv --enable-zlib --extra-cflags='-I/usr/local/lame/include -I/usr/local/libogg/include -I/usr/local/amr/include' --extra-ldflags='-L/usr/local/lame/lib -L/usr/local/libogg/lib -L/usr/local/amr/lib' --cross-prefix=x86_64-w64-mingw32- --target-os=mingw32

（4）运行下面命令编译FFmpeg。

make clean
make -j4

（5）执行下面命令安装FFmpeg。

make install
mv /usr/local/ffmpeg/bin/*.lib /usr/local/ffmpeg/lib/
cp /usr/local/libxml2/bin/*.dll /usr/local/ffmpeg/bin
cp /usr/local/freetype/bin/*.dll /usr/local/ffmpeg/bin
cp /usr/local/fontconfig/bin/*.dll /usr/local/ffmpeg/bin
cp /usr/local/fribidi/bin/*.dll /usr/local/ffmpeg/bin
cp /usr/local/harfbuzz/bin/*.dll /usr/local/ffmpeg/bin
cp /usr/local/libass/bin/*.dll /usr/local/ffmpeg/bin

（6）运行以下命令查看FFmpeg的版本信息。

ffmpeg -version

查看控制台回显的FFmpeg版本信息，找到“--enable-libass”，说明FFmpeg正确启用了字幕渲染器libass。

文章标签：
视觉智能开放平台
Windows
Linux
算法
关键词：
Windows环境
环境集成
集成开发
ffmpeg开发笔记
ffmpeg开发
aqi00
目录
相关文章
zzy的aly
|
2月前
|
监控 Ubuntu Linux
视频监控笔记(五):Ubuntu和windows时区同步问题-your clock is behind
这篇文章介绍了如何在Ubuntu和Windows系统中通过设置相同的时区并使用ntp服务来解决时间同步问题。
zzy的aly
76 4
视频监控笔记(五):Ubuntu和windows时区同步问题-your clock is behind
想飞的雪糕
|
2月前
|
人工智能 JavaScript 网络安全
ToB项目身份认证AD集成（三完）：利用ldap.js实现与windows AD对接实现用户搜索、认证、密码修改等功能 - 以及针对中文转义问题的补丁方法
本文详细介绍了如何使用 `ldapjs` 库在 Node.js 中实现与 Windows AD 的交互，包括用户搜索、身份验证、密码修改和重置等功能。通过创建 `LdapService` 类，提供了与 AD 服务器通信的完整解决方案，同时解决了中文字段在 LDAP 操作中被转义的问题。
想飞的雪糕
59 1
aqi00
|
2月前
|
Linux API 开发工具
FFmpeg开发笔记（五十九）Linux编译ijkplayer的Android平台so库
ijkplayer是由B站研发的移动端播放器，基于FFmpeg 3.4，支持Android和iOS。其源码托管于GitHub，截至2024年9月15日，获得了3.24万星标和0.81万分支，尽管已停止更新6年。本文档介绍了如何在Linux环境下编译ijkplayer的so库，以便在较新的开发环境中使用。首先需安装编译工具并调整/tmp分区大小，接着下载并安装Android SDK和NDK，最后下载ijkplayer源码并编译。详细步骤包括环境准备、工具安装及库编译等。更多FFmpeg开发知识可参考相关书籍。
aqi00
108 0
FFmpeg开发笔记（五十九）Linux编译ijkplayer的Android平台so库
aqi00
|
5月前
|
Linux Apache C++
FFmpeg开发笔记（三十五）Windows环境给FFmpeg集成libsrt
该文介绍了如何在Windows环境下为FFmpeg集成SRT协议支持库libsrt。首先，需要安装Perl和Nasm，然后编译OpenSSL。接着，下载libsrt源码并使用CMake配置，生成VS工程并编译生成srt.dll和srt.lib。最后，将编译出的库文件和头文件按照特定目录结构放置，并更新环境变量，重新配置启用libsrt的FFmpeg并进行编译安装。该过程有助于优化直播推流的性能，减少卡顿问题。
aqi00
136 2
FFmpeg开发笔记（三十五）Windows环境给FFmpeg集成libsrt
aqi00
|
5月前
|
应用服务中间件 Linux nginx
FFmpeg开发笔记（四十）Nginx集成rtmp模块实现RTMP推拉流
《FFmpeg开发实战》书中介绍了如何使用FFmpeg向网络推流，简单流媒体服务器MediaMTX不适用于复杂业务。nginx-rtmp是Nginx的RTMP模块，提供基本流媒体服务。要在Linux上集成rtmp，需从官方下载nginx和nginx-rtmp-module源码，解压后在nginx目录配置并添加rtmp模块，编译安装。配置nginx.conf启用RTMP服务，监听1935端口。使用ffmpeg推流测试，如能通过VLC播放，表明nginx-rtmp运行正常。更多详情见书本。
aqi00
137 0
FFmpeg开发笔记（四十）Nginx集成rtmp模块实现RTMP推拉流
香甜可口草莓蛋糕
|
5月前
|
存储 安全 数据安全/隐私保护
Windows 32 汇编笔记（一）：基础知识
Windows 32 汇编笔记（一）：基础知识
香甜可口草莓蛋糕
85 7
aqi00
|
5月前
|
C++ Windows
FFmpeg开发笔记（三十九）给Visual Studio的C++工程集成FFmpeg
在Windows上使用Visual Studio 2022进行FFmpeg和SDL2集成开发，首先安装FFmpeg至E:\msys64\usr\local\ffmpeg，然后新建C++控制台项目。在项目属性中，添加FFmpeg和SDL2的头文件及库文件目录。接着配置链接器的附加依赖项，包括多个FFmpeg及SDL2的lib文件。在代码中引入FFmpeg的`av_log`函数输出"Hello World"，编译并运行，若看到"Hello World"，即表示集成成功。详细步骤可参考《FFmpeg开发实战：从零基础到短视频上线》。
aqi00
212 0
FFmpeg开发笔记（三十九）给Visual Studio的C++工程集成FFmpeg
香甜可口草莓蛋糕
|
4月前
|
存储 编译器 Linux
Windows 32 汇编笔记（二）：使用 MASM
Windows 32 汇编笔记（二）：使用 MASM
香甜可口草莓蛋糕
97 0
aqi00
|
2月前
|
Linux 开发工具 Android开发
FFmpeg开发笔记（六十）使用国产的ijkplayer播放器观看网络视频
ijkplayer是由Bilibili基于FFmpeg3.4研发并开源的播放器，适用于Android和iOS，支持本地视频及网络流媒体播放。本文详细介绍如何在新版Android Studio中导入并使用ijkplayer库，包括Gradle版本及配置更新、导入编译好的so文件以及添加直播链接播放代码等步骤，帮助开发者顺利进行App调试与开发。更多FFmpeg开发知识可参考《FFmpeg开发实战：从零基础到短视频上线》。
aqi00
156 2
FFmpeg开发笔记（六十）使用国产的ijkplayer播放器观看网络视频
aqi00
|
2月前
|
编解码 语音技术 内存技术
FFmpeg开发笔记（五十八）把32位采样的MP3转换为16位的PCM音频
《FFmpeg开发实战：从零基础到短视频上线》一书中的“5.1.2 把音频流保存为PCM文件”章节介绍了将媒体文件中的音频流转换为原始PCM音频的方法。示例代码直接保存解码后的PCM数据，保留了原始音频的采样频率、声道数量和采样位数。但在实际应用中，有时需要特定规格的PCM音频。例如，某些语音识别引擎仅接受16位PCM数据，而标准MP3音频通常采用32位采样，因此需将32位MP3音频转换为16位PCM音频。
aqi00
76 0
FFmpeg开发笔记（五十八）把32位采样的MP3转换为16位的PCM音频
视觉智能

视频分割

热门文章

最新文章

  • 1
    FFmpeg开发笔记（六十）使用国产的ijkplayer播放器观看网络视频
  • 2
    FFmpeg开发笔记（三十九）给Visual Studio的C++工程集成FFmpeg
  • 3
    FFmpeg开发笔记（十五）详解MediaMTX的推拉流
  • 4
    FFmpeg开发笔记（四十三）使用SRS开启SRT协议的视频直播服务
  • 5
    FFmpeg开发笔记（二十六）Linux环境安装ZLMediaKit实现视频推流
  • 6
    FFmpeg开发笔记（四十一）结合OBS与MediaMTX实现SRT直播推流
  • 7
    FFmpeg开发笔记（四十七）寒冬下安卓程序员的几个技术转型发展方向
  • 8
    FFmpeg开发笔记（五十六）使用Media3的Exoplayer播放网络视频
  • 9
    FFmpeg开发笔记（十）Linux环境给FFmpeg集成vorbis和amr
  • 10
    FFmpeg开发笔记（二十四）Linux环境给FFmpeg集成AV1的编解码器
  • 1
    FFmpeg开发笔记（六十）使用国产的ijkplayer播放器观看网络视频
    156
  • 2
    FFmpeg开发笔记（五十九）Linux编译ijkplayer的Android平台so库
    108
  • 3
    FFmpeg开发笔记（五十八）把32位采样的MP3转换为16位的PCM音频
    76
  • 4
    FFmpeg开发笔记（五十七）使用Media3的Transformer加工视频文件
    58
  • 5
    FFmpeg开发笔记（五十六）使用Media3的Exoplayer播放网络视频
    165
  • 6
    FFmpeg开发笔记（五十五）寒冬里的安卓程序员可进阶修炼的几种姿势
    81
  • 7
    FFmpeg开发笔记（五十四）使用EasyPusher实现移动端的RTSP直播
    66
  • 8
    FFmpeg开发笔记（五十三）移动端的国产直播录制工具EasyPusher
    65
  • 9
    FFmpeg开发笔记（五十二）移动端的国产视频播放器GSYVideoPlayer
    114
  • 10
    FFmpeg开发笔记（五十一）适合学习研究的几个音视频开源框架
    104

    • 相关课程

    更多
  • 事件总线EventBridge生态集成课程
  • 消息队列 RocketMQ 消息集成
  • Linux 文本管理入门
  • 【视觉与图像】Python+OpenCV教程入门篇
  • 【视觉与图像】Python+OpenCV教程基础篇
  • Cloud Toolkit 开发部署效率提升神器

    • 相关电子书

    更多
  • 阿里邮箱—安全高效集成
  • 集成智能接入网关APP：优化企业级移动办公网络
  • 云效助力企业集成安全到DevOps中

    • 相关实验场景

    更多
  • Gazebo环境下基于ROS和OpenCV的阿克曼小车多车跟随
  • Gazebo环境下基于ROS和OpenCV的阿克曼小车综合实验
  • 云端Python及基本操作
  • 快速配置Windows云服务器
  • 手动搭建FTP站点（Windows）
  • 基于Anolis OS 3快速搭建LNMP环境制作KodBox
    • 下一篇
    阿里云对象存储OSS收费标准：存储、流量和请求等多个计费项详解