LayerUtility: TextImage

输入参数

参数名称说明
size_as用于适配输出尺寸的参考图像,优先于 width 和 height。

输出参数

参数名称说明
mask黑白掩码图,白色为文字所在区域。
image渲染后的 RGBA 图像,包含背景、文字与透明通道。

控件参数

参数名称说明
text要绘制的文本内容,支持多行输入(\n换行)。
font_file字体文件,从系统/内置字体中选择。
spacing字符间距(像素),影响每个字符水平或垂直的间隔。取值范围大,支持负值(字符重叠)、正值(稀疏布局)。建议初始为 0。
leading行距(像素),行与行之间的间隔。对多行排布影响较大,适用于上下行分隔。
horizontal_border顶部边距百分比,控制文字距图像顶部的距离。通常设为 5~10% 用于垂直居中对齐。
vertical_border左右边距百分比,横排表示左边距,竖排为右边距。控制文本在图像中的左右留白,推荐值 5~10。
scale文本整体缩放比,影响字体大小相对于画布的比例。建议设置为 80~120,可动态缩放整体文本块大小。
variation_range字体大小与位置的扰动范围(百分比),用于模拟随机排版效果。建议设置为 0(无扰动)到 30(轻微扰动)用于艺术效果。
variation_seed控制扰动随机性的种子值。设置相同种子可复现排版风格,适用于样式一致的图层生成。
layout排版方式,支持: • horizontal 横排; • vertical 竖排。
width输出图像的宽度,单位为像素。推荐根据文字内容预估宽度。512 是常用起始尺寸。
height输出图像的高度,单位为像素。根据排版行数决定,过小会导致文字被裁剪。
text_color文本颜色,十六进制格式(如 #FFA000)。
background_color背景颜色,十六进制格式(如 #FFFFFF)。
敬请期待