LayerUtility: SimpleTextImage

输入参数

参数名称说明
size_as参考图像尺寸,替代手动指定宽高。

输出参数

参数名称说明
image输出的 RGBA 图像,包含透明背景与渲染文字。
mask文本区域掩码,白色为文本区域。

控件参数

参数名称说明
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输出图像高度(像素)。
敬请期待