---

背景痛点

在视频处理中，添加水印是常见的需求，主要用于版权保护、渠道追踪等场景。然而，使用原生FFmpeg命令行工具在批量处理视频时，往往会遇到以下问题：

• 性能瓶颈：处理大量视频时，单线程处理速度慢，无法充分利用多核CPU的性能。
• 参数维护难题：复杂的命令行参数难以维护，尤其是需要动态调整水印位置、透明度等参数时。
• 字体渲染问题：跨平台字体路径兼容性差，容易出现字体加载失败或渲染异常的情况。

技术对比

FFmpeg提供了两种主要的水印添加方式：drawtext滤镜和overlay滤镜。

• drawtext滤镜：适用于添加文字水印，支持动态调整字体、大小、颜色、位置等参数，但依赖libfreetype进行字体渲染。
• overlay滤镜：适用于添加图片水印，支持透明度调整和动态位置，但不适用于文字水印的直接添加。

使用drawtext滤镜时，需注意以下事项：

1. 字体文件路径需正确指定，跨平台时需处理路径分隔符差异。
2. 字体渲染可能因平台不同而出现锯齿，需启用抗锯齿功能。
3. 动态位置计算需考虑视频分辨率变化。

核心实现

命令行实现

以下是一个带alpha通道的文字水印命令示例：

ffmpeg -i input.mp4 -vf "drawtext=text='Sample':fontfile=/path/to/font.ttf:fontsize=24:fontcolor=white@0.5:x=(w-tw)/2:y=(h-th)/2" output.mp4

• text='Sample'：水印文字内容。
• fontfile=/path/to/font.ttf：字体文件路径。
• fontsize=24：字体大小。
• fontcolor=white@0.5：字体颜色及透明度（0.0完全透明，1.0完全不透明）。
• x=(w-tw)/2:y=(h-th)/2：水印位置居中（w和h为视频宽高，tw和th为文字宽高）。

C++ SDK集成示例

以下是一个使用AVFilterGraph构建处理管道的示例代码：

#include <libavfilter/avfilter.h>
#include <libavfilter/buffersrc.h>
#include <libavfilter/buffersink.h>

// 初始化AVFilterGraph
AVFilterGraph *graph = avfilter_graph_alloc();

// 创建输入过滤器
AVFilterContext *src_ctx;
avfilter_graph_create_filter(&src_ctx, avfilter_get_by_name("buffer"), "in", "video_size=1280x720:pix_fmt=0:time_base=1/25", NULL, graph);

// 创建drawtext过滤器
AVFilterContext *drawtext_ctx;
const char *filter_args = "text='Sample':fontfile=/path/to/font.ttf:fontsize=24:fontcolor=white@0.5:x=(w-tw)/2:y=(h-th)/2";
avfilter_graph_create_filter(&drawtext_ctx, avfilter_get_by_name("drawtext"), "drawtext", filter_args, NULL, graph);

// 创建输出过滤器
AVFilterContext *sink_ctx;
avfilter_graph_create_filter(&sink_ctx, avfilter_get_by_name("buffersink"), "out", NULL, NULL, graph);

// 连接过滤器
avfilter_link(src_ctx, 0, drawtext_ctx, 0);
avfilter_link(drawtext_ctx, 0, sink_ctx, 0);

// 配置graph
avfilter_graph_config(graph, NULL);

性能优化

多线程处理

通过设置threads参数启用多线程处理：

ffmpeg -threads 4 -i input.mp4 -vf "drawtext=..." output.mp4

硬件加速

使用VAAPI或NVENC进行硬件加速：

ffmpeg -hwaccel vaapi -i input.mp4 -vf "drawtext=..." -c:v h264_vaapi output.mp4

内存池优化

避免重复分配内存，使用内存池技术：

AVBufferPool *pool = av_buffer_pool_init(1024 * 1024, av_buffer_alloc);

避坑指南

1. 字体路径跨平台兼容：使用QDir或Path库处理路径分隔符。
2. 时间戳同步问题：检查输入输出的时间基（time_base）是否一致。
3. 水印抗锯齿处理：在drawtext滤镜中添加antialias=1参数。

验证环节

使用ffprobe检查水印元数据：

ffprobe -show_frames -select_streams v output.mp4 | grep "side_data"

开放问题

1. 如何实现动态水印的DRM保护方案？
2. 在水印中添加时间戳或动态信息时，如何确保性能不受影响？
3. 多语言水印的字体渲染如何优化？

希望这篇实战指南能帮助你在视频处理中高效添加水印，欢迎在评论区分享你的经验和问题！