> ## Documentation Index
> Fetch the complete documentation index at: https://dripart-matt-router-pricing-pika-and-guard.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# SCAIL2ColoredMask - ComfyUI Built-in Node Documentation

> 此节点将 SAM3 跟踪数据渲染为彩色遮罩，供 WanSCAILToVideo 节点使用。

此节点将 SAM3 跟踪数据渲染为彩色遮罩，供 WanSCAILToVideo 节点使用。它处理来自驱动姿态视频的跟踪数据，并可选择处理参考图像，为两个输出中的每个被跟踪人物分配一致的颜色。

## 输入

| 参数 | 描述 | 数据类型 | 必需 | 范围 |
| - | - | - | - | - |
| `驱动轨迹数据` | 驱动姿态视频的 SAM3 跟踪数据。将被渲染到 `pose_video_mask` 输出中。 | SAM3\_TRACK\_DATA | 是 | - |
| `参考轨迹数据` | 参考图像的 SAM3 跟踪数据（每个对象一个身份，按批次顺序着色），或参考主体的普通 MASK（渲染为单个身份）。 | SAM3\_TRACK\_DATA or MASK | 否 | - |
| `对象索引` | 要包含的人物索引的逗号分隔列表（例如 '0,2,3'）。应用于参考遮罩和姿态视频遮罩。空 = 全部。（默认值：""） | STRING | 是 | - |
| `排序方式` | 将调色板颜色分配给被跟踪对象的顺序（应用于参考和姿态视频，以便每个身份保持相同颜色）。出现在较早帧中的对象始终排在前面；在同一帧内，left\_to\_right = 最左侧对象（按首次出现时的质心）获得第一种颜色，area = 最大对象（按首次出现时的遮罩面积）获得第一种颜色；none = 保持 SAM3 的顺序。（默认值："left\_to\_right"） | COMBO | 是 | `"none"`<br />`"left_to_right"`<br />`"area"` |
| `替换模式` | False = 动画模式（`pose_video_mask` 具有黑色背景，`reference_image_mask` 具有白色背景）。True = 替换模式（`pose_video_mask` 具有白色背景，`reference_image_mask` 具有黑色背景）。（默认值：False） | BOOLEAN | 是 | False<br />True |

注意：`object_indices` 仅接受逗号分隔的数字；非数字条目和超出范围的索引将被忽略。当未提供 `ref_track_data` 时，`reference_image_mask` 输出为使用参考背景色的纯色填充（动画模式中为白色，替换模式中为黑色）。

## 输出

| 输出名称 | 描述 | 数据类型 |
| - | - | - |
| `pose_video_mask` | 从驱动姿态视频跟踪数据渲染的彩色遮罩。背景颜色遵循 `replacement_mode` 设置。 | IMAGE |
| `reference_image_mask` | 从参考图像跟踪数据渲染的彩色遮罩。在替换模式中背景为黑色，在动画模式中为白色。如果未提供参考数据，则返回与参考背景色匹配的纯色填充。 | IMAGE |

> 本文档由 AI 生成。如果您发现任何错误或有改进建议，欢迎贡献！ [在 GitHub 上编辑](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/SCAIL2ColoredMask/zh.md)

***

**Source fingerprint (SHA-256):** `ce0669ad0ed3c76cc18ef0ee7b620f5aa6eaa1e5b96c189941c0a5b744c3351f`


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.