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

# 개요

이 노드는 추적된 객체의 비디오 미리보기를 생성하며, 각 추적된 객체를 고유한 색상 오버레이와 숫자 레이블로 표시합니다. 이미지나 비디오 텐서를 출력하지 않는 대신, 결과 미리보기 비디오를 임시 파일에 직접 저장합니다.

# 입력

| 매개변수         | 설명                                                    | 데이터 타입      | 필수 여부 | 범위                     |
| ------------ | ----------------------------------------------------- | ----------- | ----- | ---------------------- |
| `track_data` | SAM3 추적 노드에서 생성된 패킹된 마스크와 객체 정보가 포함된 추적 데이터입니다.       | TRACK\_DATA | 예     | -                      |
| `images`     | 미리보기의 배경으로 사용할 선택적 입력 이미지입니다. 제공되지 않으면 검은색 배경이 사용됩니다. | IMAGE       | 아니요   | -                      |
| `opacity`    | 추적된 객체에 적용되는 색상 오버레이의 불투명도입니다 (기본값: 0.5).             | FLOAT       | 아니요   | 0.0 \~ 1.0 (단계: 0.05)  |
| `fps`        | 출력 비디오의 프레임 속도입니다 (기본값: 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/ko.md)

***

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