编码与格式 / 系统课时

绘制动态文字

绘制动态文字

本课解决在视频中绘制会随时间变化的文字。你将使用 drawtext 设置字体、字号、颜色、描边和背景框,并通过 t、pts 与 enable 表达式控制文字内容、移动位置和显示时段。

学习目标

  • 配置 drawtext 的字体、样式与画面坐标
  • 使用时间变量生成动态内容和移动效果
  • 定位字体路径、转义字符和滤镜缺失问题

动态文字的组成

drawtext 同时处理三类信息:文字内容决定显示什么,样式参数决定如何显示,表达式决定何时显示以及显示在哪里。动态效果不是逐帧手工修改,而是由 FFmpeg 在每一帧重新计算表达式。

drawtext 时间表达式与画面坐标

字体与滤镜前置检查

示例使用 Linux 常见的 DejaVu Sans 字体。Windows 可改为类似 C\:/Windows/Fonts/arial.ttf 的路径,macOS 可选择系统中实际存在的 .ttf 或 .otf 文件。字体路径错误时,drawtext 通常会直接终止处理。

还要确认当前 FFmpeg 构建包含 drawtext。若出现 No such filter: drawtext,说明该构建没有启用所需的字体渲染支持,应更换包含该滤镜的发行包。

主示例:时间文字横向移动

下面的 Bash 示例先检查字体文件,再在前 10 秒显示播放时间。文字每秒向右移动 40 像素,始终位于距底部 30 像素的位置,并使用描边和半透明背景提高可读性。

bash
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"

预期输出

text
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 秒内文字存在、内容持续变化且位置向右移动。再检查文件是否包含视频流和可选音频流:

bash
ffprobe -v error -show_entries stream=index,codec_type,codec_name -of csv=p=0 output-dynamic-text.mp4

预期输出

text
0,h264,video
1,aac,audio

没有音频的源文件只会输出视频行。若出现乱码或方框,原因通常是字体不包含对应字符;若文字位置异常,检查表达式中的 w、h、tw、th 是否使用正确;若滤镜解析失败,优先检查冒号、单引号和反斜杠是否被 Shell 提前处理。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

绘制动态文字

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通