> ## Documentation Index
> Fetch the complete documentation index at: https://dripart-comfy-docs-comfyapi-search.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`