# 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