编码与格式 / 系统课时
绘制动态文字
绘制动态文字
本课解决在视频中绘制会随时间变化的文字。你将使用 drawtext 设置字体、字号、颜色、描边和背景框,并通过 t、pts 与 enable 表达式控制文字内容、移动位置和显示时段。
学习目标
- 配置
drawtext的字体、样式与画面坐标 - 使用时间变量生成动态内容和移动效果
- 定位字体路径、转义字符和滤镜缺失问题
动态文字的组成
drawtext 同时处理三类信息:文字内容决定显示什么,样式参数决定如何显示,表达式决定何时显示以及显示在哪里。动态效果不是逐帧手工修改,而是由 FFmpeg 在每一帧重新计算表达式。

字体与滤镜前置检查
示例使用 Linux 常见的 DejaVu Sans 字体。Windows 可改为类似 C\:/Windows/Fonts/arial.ttf 的路径,macOS 可选择系统中实际存在的 .ttf 或 .otf 文件。字体路径错误时,drawtext 通常会直接终止处理。
还要确认当前 FFmpeg 构建包含 drawtext。若出现 No such filter: drawtext,说明该构建没有启用所需的字体渲染支持,应更换包含该滤镜的发行包。
主示例:时间文字横向移动
下面的 Bash 示例先检查字体文件,再在前 10 秒显示播放时间。文字每秒向右移动 40 像素,始终位于距底部 30 像素的位置,并使用描边和半透明背景提高可读性。
FONT_FILE="/usr/share/fonts/truetype/dejavu/DejaVuSans.ttf"
test -f "$FONT_FILE" || { echo "Font not found: $FONT_FILE"; exit 1; }
ffmpeg -hide_banner -loglevel error -y -i input.mp4 -vf "drawtext=fontfile='${FONT_FILE}':text='Time %{pts\:hms}':fontcolor=white:fontsize=42:borderw=2:bordercolor=black@0.8:box=1:boxcolor=black@0.35:boxborderw=12:x='20+40*t':y='h-th-30':enable='between(t,0,10)'" -c:v libx264 -crf 20 -preset medium -pix_fmt yuv420p -c:a aac -b:a 128k -movflags +faststart output-dynamic-text.mp4 && echo "Created output-dynamic-text.mp4"预期输出
Created output-dynamic-text.mp4输出视频的前 10 秒会显示类似 Time 00:00:03.400 的文字,具体小数位由 FFmpeg 版本决定。超过 10 秒后文字消失,视频和音频继续播放。
理解时间与坐标表达式
t 表示当前帧对应的秒数,因此 20+40*t 会持续增大横坐标。w、h 是视频宽高,tw、th 是当前文字区域宽高,所以 h-th-30 能让文字底部与画面底部保持 30 像素距离。
%{pts\:hms} 会把当前时间戳格式化为时、分、秒。冒号属于 drawtext 参数分隔符,因此必须转义;命令还经过 Shell 解析,示例在冒号前使用反斜杠,最终将转义后的冒号传给滤镜。
若文字可能移出右侧,可把横坐标改为 x='mod(20+80*t,w-tw)',使它到达边缘后从左侧重新开始。若只需要固定字幕,则删除时间表达式并把 x、y 写成常量即可。
样式、内容与显示时段
常用样式参数包括 fontcolor、fontsize、borderw、bordercolor、box、boxcolor 和 boxborderw。描边适合复杂画面,背景框适合高对比度要求,两者同时使用时应避免过粗,否则会遮挡主体内容。
需要分段显示不同文字时,可以串联多个 drawtext,并分别设置 enable='between(t,start,end)'。文字较长或频繁修改时,优先使用 textfile 读取 UTF-8 文本,减少引号、冒号和反斜杠的多层转义。
验证与故障定位
先播放输出文件,确认 0~10 秒内文字存在、内容持续变化且位置向右移动。再检查文件是否包含视频流和可选音频流:
ffprobe -v error -show_entries stream=index,codec_type,codec_name -of csv=p=0 output-dynamic-text.mp4预期输出
0,h264,video
1,aac,audio没有音频的源文件只会输出视频行。若出现乱码或方框,原因通常是字体不包含对应字符;若文字位置异常,检查表达式中的 w、h、tw、th 是否使用正确;若滤镜解析失败,优先检查冒号、单引号和反斜杠是否被 Shell 提前处理。