> ## 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.

# Preview3DAdvanced - ComfyUI Built-in Node Documentation

> 이 노드는 모델 파일을 ComfyUI 출력 디렉터리에 저장하지 않고 UI에 3D 모델 미리보기를 표시합니다. 모델을 임시 파일로 저장하며, 이후 다운스트림 처리를 위해 모델 데이터, 모델 정보, 카메라 정보, 미리보기 크기를 그대로 전달합니다.

이 노드는 모델 파일을 ComfyUI 출력 디렉터리에 저장하지 않고 UI에 3D 모델 미리보기를 표시합니다. 모델을 임시 파일로 저장하며, 이후 다운스트림 처리를 위해 모델 데이터, 모델 정보, 카메라 정보, 미리보기 크기를 그대로 전달합니다.

## 입력

| 매개변수             | 설명                                                         | 데이터 유형          | 필수  | 범위                                                         |
| ---------------- | ---------------------------------------------------------- | --------------- | --- | ---------------------------------------------------------- |
| `model_3d`       | 업스트림 3D 노드에서 가져온 3D 모델 파일입니다.                              | FILE3D          | 예   | GLB, GLTF, FBX, OBJ, STL, USDZ, or any supported 3D format |
| `model_3d_info`  | 씬에서 각 모델의 배치(위치, 회전, 크기, Y-up 월드 공간)입니다. 선택 사항이며 고급 옵션입니다. | LOAD3DMODELINFO | 아니요 | -                                                          |
| `viewport_state` | 카메라 및 모델 정보를 포함하는 현재 뷰포트 상태입니다.                            | LOAD3D          | 예   | -                                                          |
| `camera_info`    | 뷰포트 카메라 정보(위치, 시선 대상, 줌, 유형)입니다. 선택 사항이며 고급 옵션입니다.         | LOAD3DCAMERA    | 아니요 | -                                                          |
| `width`          | 뷰포트의 렌더링 너비(픽셀)입니다. 기본값: 1024.                             | INT             | 예   | 1\~4096                                                    |
| `height`         | 뷰포트의 렌더링 높이(픽셀)입니다. 기본값: 1024.                             | INT             | 예   | 1\~4096                                                    |

참고: `camera_info` 또는 `model_3d_info`가 연결되지 않은 경우, 사용 가능한 `viewport_state`에서 값을 가져옵니다. `viewport_state`에 카메라 정보가 없으면 `camera_info`는 None입니다. `viewport_state`에 모델 정보가 없으면 `model_3d_info`는 빈 목록으로 기본 설정됩니다. `viewport_state`가 딕셔너리가 아니면 빈 값으로 처리됩니다.

## 출력

| 출력 이름           | 설명                                                                                              | 데이터 유형          |
| --------------- | ----------------------------------------------------------------------------------------------- | --------------- |
| `model_file`    | 업스트림 3D 노드에서 가져온 3D 모델 파일(glb/obj/stl 등)이며, 변경 없이 통과됩니다.                                        | FILE3D          |
| `camera_info`   | 씬에서 각 모델의 배치(위치, 회전, 크기, Y-up 월드 공간)입니다. 입력 값을 사용하며, 입력 값이 없으면 `viewport_state`에 저장된 값으로 폴백합니다. | LOAD3DMODELINFO |
| `model_3d_info` | 뷰포트 카메라 정보(위치, 시선 대상, 줌, 유형)입니다. 입력 값을 사용하며, 입력 값이 없으면 `viewport_state`에 저장된 값으로 폴백합니다.         | LOAD3DCAMERA    |
| `width`         | 뷰포트의 렌더링 너비(픽셀)입니다.                                                                             | INT             |
| `height`        | 뷰포트의 렌더링 높이(픽셀)입니다.                                                                             | INT             |

> 이 문서는 AI에 의해 생성되었습니다. 오류를 발견하거나 개선 제안이 있으시면 기여해 주세요! [GitHub에서 편집](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/Preview3DAdvanced/ko.md)

***

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