text | 要绘制的文本内容,支持换行和多行文本。 |
font_file | 使用的字体文件,系统或内置字体列表。 |
align | 文本对齐方式。可选:
• left:左对齐
• center:居中对齐
• right:右对齐
推荐 center 用于标题、left 用于正文、right 用于标注等。 |
char_per_line | 每行最多字符数,超过自动换行。设定自动断行宽度。推荐与图片宽度和字体大小成比例设置。 |
leading | 行距(即行与行之间的垂直像素间距)。设置为字体高度的 1/8~1/4 为宜。可微调文本排布紧凑度。 |
font_size | 字体像素高度。常用值为 32~128,建议按图像分辨率缩放设置。 |
text_color | 文本颜色,HTML 格式,如 #FFFFFF。支持任意十六进制颜色。推荐使用对比明显的颜色以提高可读性。 |
stroke_width | 描边宽度(像素),设为 0 则无描边。较高值用于强调标题,0~5 通常效果良好。 |
stroke_color | 描边颜色,HTML 格式。描边建议使用对比色以增强边缘识别度。 |
x_offset | 水平偏移量,影响文本起始位置。在 left 对齐下用于定义起点偏移,right 下为边缘留白。 |
y_offset | 垂直偏移量,决定文本距顶端起始位置。建议设置为字体高度,以留出适当空间。 |
width | 输出图像宽度(像素)。 |
height | 输出图像高度(像素)。 |