2.1 KiB
2.1 KiB
Image Add Label - 图像添加标签
节点功能： Image Add Label节点用于在图像上添加文本标签，支持自定义字体、颜色、位置等属性，支持动态引用输入值，常用于图像标注和说明。
输入
| 参数名称 | 入端选择 | 数据类型 | 默认值 | 取值范围 | 描述 |
|---|---|---|---|---|---|
image |
必选 | IMAGE | - | - | 要添加标签的图像 |
height_pad |
- | INT | 24 | 1-1024 | 标签区域的上下边距总和，最终高度会根据文本实际渲染高度自动计算 |
font_size |
- | INT | 36 | 1-256 | 字体大小 |
invert_color |
- | BOOLEAN | True | True/False | 是否反转颜色，True为黑字白底，False为白字黑底 |
font |
- | COMBO[STRING] | Alibaba-PuHuiTi-Regular.otf | 字体文件列表 | 字体选择，支持多种字体文件 |
text |
- | STRING | "" | 多行文本 | 标签文本内容，支持变量占位符和数学运算，支持 -- 分隔符功能 |
direction |
- | COMBO[STRING] | top | top, bottom, left, right | 标签位置：top(顶部)、bottom(底部)、left(左侧)、right(右侧) |
input1 |
可选 | STRING | "" | - | 动态输入值1，可在文本中使用 {input1} 引用 |
input2 |
可选 | STRING | "" | - | 动态输入值2，可在文本中使用 {input2} 引用 |
输出
| 输出名称 | 数据类型 | 描述 |
|---|---|---|
image |
IMAGE | 添加标签后的图像 |
功能说明
文本处理
- 多行支持：支持多行文本，使用换行符分隔
- 批量处理：多行文本时每行对应一张图像
- 文本循环：当图像数量多于文本行数时，文本会循环使用
- 连字符分隔：当存在只包含连字符的行时，-- 之间的内容作为完整标签，其他分割方式失效
变量支持
- {index}：批次索引，从0开始计数 (0, 1, 2...)
- {idx}：批次索引别名，从0开始计数 (0, 1, 2...)
- {range}：批次索引，从0开始计数，自动补零格式 (00, 01, 02...)
- {input1}：自定义输入值1
- {input2}：自定义输入值2