40 lines
2.0 KiB
Markdown
40 lines
2.0 KiB
Markdown
# Multi Mask Math Ops - 遮罩二值运算
|
|
|
|
**节点功能：** `Mask Math Ops` 在多个遮罩之间执行逐像素二值化运算：`or`、`and`、`subtract (a-b)`、`subtract (b-a)`、`xor`。支持动态输入端口 `mask_1..mask_N`、批次广播与统一尺寸对齐。
|
|
|
|
## 输入
|
|
|
|
| 参数名称 | 入端选择 | 数据类型 | 默认值 | 取值范围 | 描述 |
|
|
| -------- | -------- | -------- | ------ | -------- | ---- |
|
|
| `mask_1` | - | MASK | - | - | 第一遮罩批次 |
|
|
| `mask_2..mask_N` | - | MASK | - | - | 动态遮罩输入；UI 尾部自动追加空槽以便继续连接 |
|
|
| `operation` | - | COMBO | `or` | `or` / `and` / `subtract (a-b)` / `subtract (b-a)` / `xor` | 运算类型 |
|
|
|
|
## 输出
|
|
|
|
| 输出名称 | 数据类型 | 描述 |
|
|
|---------|----------|------|
|
|
| `mask` | MASK | 运算后的遮罩批次 |
|
|
|
|
## 功能说明
|
|
|
|
- 动态端口：以 `mask_` 开头的输入端口支持自动扩展，始于 `mask_1、mask_2`，连接尾端空槽时自动追加，仅保留一个尾部空槽。
|
|
- 批次广播：当各输入批次大小不一致时，按索引取模进行对齐与计算。
|
|
- 尺寸统一：将所有输入遮罩统一到 `mask_1` 的尺寸，使用 Lanczos 重采样对齐。
|
|
- 运算规则：
|
|
- `and`：对所有遮罩逐像素取最小值（折叠）。
|
|
- `or`：对所有遮罩逐像素取最大值（折叠）。
|
|
- `subtract (a-b)`：从 `mask_1` 开始依次减去后续遮罩，结果钳制到 `[0,1]`。
|
|
- `subtract (b-a)`：若存在 `mask_2`，初始为 `clip(mask_2 - mask_1, 0, 1)`，随后依序减去其余遮罩；仅一个输入时返回 `mask_1`。
|
|
- `xor`：顺序绝对差折叠，强调输入遮罩间差异区域。
|
|
|
|
## 典型用法
|
|
|
|
- 遮罩组合：区域并/交以构建复合选区。
|
|
- 区域裁除：相互减法以精细化选区边界。
|
|
- 差异强调：`xor` 用于突显两遮罩的差异区域。
|
|
|
|
## 注意与建议
|
|
|
|
- 输入内部作为 `[0,1]` 浮点数组处理；单通道遮罩按逐像素运算。
|
|
- 在合并前确保遮罩强度语义一致（白=选中），避免语义冲突。 |