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

# SAM3_TrackPreview - ComfyUI Built-in Node Documentation

> Complete documentation for the SAM3_TrackPreview node in ComfyUI. Learn its inputs, outputs, parameters and usage.

## 概述

此节点创建跟踪对象的视频预览，为每个跟踪对象绘制不同颜色的叠加层和数字标签。它不输出任何图像或视频张量，而是将生成的预览视频直接保存到临时文件中。

## 输入

| 参数     | 描述                             | 数据类型        | 是否必填 | 范围                  |
| ------ | ------------------------------ | ----------- | ---- | ------------------- |
| `跟踪数据` | 包含来自 SAM3 跟踪节点的打包遮罩和对象信息的跟踪数据。 | TRACK\_DATA | 是    | -                   |
| `图像`   | 可选输入图像，用作预览的背景。如果未提供，则使用黑色背景。  | IMAGE       | 否    | -                   |
| `不透明度` | 应用于跟踪对象的颜色叠加层的不透明度（默认值：0.5）。   | FLOAT       | 否    | 0.0 至 1.0（步长：0.05）  |
| `帧率`   | 输出视频的帧率（默认值：24.0）。             | FLOAT       | 否    | 1.0 至 120.0（步长：1.0） |

## 输出

| 输出名称 | 描述                          | 数据类型           |
| ---- | --------------------------- | -------------- |
| `ui` | 显示生成的预览视频的 UI 元素。不返回任何张量数据。 | PREVIEW\_VIDEO |

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

***

**Source fingerprint (SHA-256):** `8300d4fa89c7bbc481ac9a59868ede0e3c9413faa63d56c16a4f603ef878e877`