title-card-image 用于渲染居中对齐文本的 PNG,适合作为封面或片尾卡,之后再配合 video-still-animator 制作动画片段。
主要能力:在纯色背景上输出标题与可选副标题,支持自动换行(CJK 约每行 10 字符)、指定字体大小与颜色、自定义宽高(默认 720x1280,9:16)。输出为不含 alpha 的 RGB PNG,文件约 30-80 KB,并在 stdout 打印绝对路径。
参数(with):text 必填,标题文本;output 必填,输出 .png 路径;subtitle 默认空字符串,标题下方的小字;background 默认 #101018,十六进制颜色;text_color 默认 #ffffff;font_size 默认 96;subtitle_size 默认 36;width 默认 720;height 默认 1280;font 可选,.ttf/.otf/.ttc 路径,须包含所需 CJK 字形。
字体回退顺序:--font、OPENSQUILLA_MEDIA_FONTS_DIR 指定的托管媒体目录、用户字体目录,再到平台默认字体(Windows:Microsoft YaHei/SimHei/DengXian;macOS:PingFang/Hiragino Sans GB/STHeiti/Songti;Linux:Noto CJK/Source Han/WenQuanYi)。支持 .ttc/.otc 字体集合。绘制前会比对所需非 ASCII 字形与字体的缺字特征,会产生豆腐块的字体将被跳过;若无可用的可缩放字体,步骤会给出针对 CJK 的 --font/OPENSQUILLA_MEDIA_FONTS_DIR 相关错误提示,不会静默输出小方块。纯 ASCII 卡片在仅安装 Pillow 内置字体的精简系统上仍可生成。
限制:无透明度;不支持斜体、阴影、渐变等富文本样式,需要更丰富的卡片可改用 nano-banana-pro 生成真实图片。标题换行对 CJK 按字符数、对 ASCII 按空白处理,混合字符串按 CJK 字符数断行。