# Preview3D 노드

Preview3D 노드는 주로 3D 모델 출력을 미리 보는 데 사용됩니다. 이 노드는 두 가지 입력을 받습니다. 하나는 Load3D 노드의 `camera_info`이고, 다른 하나는 3D 모델 파일의 경로입니다. 모델 파일 경로는 `ComfyUI/output` 폴더에 위치해야 합니다.

**지원되는 형식**
현재 이 노드는 `.gltf`, `.glb`, `.obj`, `.fbx`, `.stl`을 포함한 여러 3D 파일 형식을 지원합니다.

**3D 노드 환경 설정**
3D 노드에 대한 일부 관련 환경 설정은 ComfyUI의 설정 메뉴에서 구성할 수 있습니다. 해당 설정에 대해서는 다음 문서를 참조하십시오:
[설정 메뉴](https://docs.comfy.org/interface/settings/3d)

## 입력

| 매개변수 이름 | 설명 | 유형 |
| --- | --- | --- |
| camera_info | 카메라 정보 | LOAD3D_CAMERA |
| model_file | `ComfyUI/output/` 아래의 모델 파일 경로 | LOAD3D_CAMERA |

## 캔버스 영역 설명

현재 ComfyUI 프론트엔드의 3D 관련 노드는 동일한 캔버스 구성 요소를 공유하므로, 일부 기능적 차이를 제외하면 기본적인 조작 방식은 대부분 일치합니다.

> 다음 내용과 인터페이스는 주로 Load3D 노드를 기준으로 합니다. 구체적인 기능은 실제 노드 인터페이스를 참조하십시오.

캔버스 영역에는 다양한 뷰 조작 기능이 포함되어 있습니다:

- 미리보기 뷰 설정(그리드, 배경색, 미리보기 뷰)
- 카메라 제어: FOV, 카메라 유형
- 전역 조명 강도: 조명 조정
- 모델 내보내기: `GLB`, `OBJ`, `STL` 형식 지원
- 등

![Load 3D Node UI](./asset/preview3d_canvas.jpg)

1. Load 3D 노드의 여러 메뉴 및 숨겨진 메뉴 포함
2. 3D 뷰 조작 축

### 1. 뷰 조작

<video controls width="640" height="360">
  <source src="https://raw.githubusercontent.com/Comfy-Org/embedded-docs/refs/heads/main/comfyui_embedded_docs/docs/Load3D/asset/view_operations.mp4" type="video/mp4">
  귀하의 브라우저는 동영상 재생을 지원하지 않습니다.
</video>

뷰 제어 조작:

- 왼쪽 클릭 + 드래그: 뷰 회전
- 오른쪽 클릭 + 드래그: 뷰 이동
- 가운데 휠 스크롤 또는 가운데 클릭 + 드래그: 확대/축소
- 좌표축: 뷰 전환

### 2. 왼쪽 메뉴 기능

![Menu](https://raw.githubusercontent.com/Comfy-Org/embedded-docs/refs/heads/main/comfyui_embedded_docs/docs/Load3d/asset/menu.webp)

미리보기 영역에는 일부 뷰 조작 메뉴가 메뉴 안에 숨겨져 있습니다. 메뉴 버튼을 클릭하여 다양한 메뉴를 펼칠 수 있습니다.

- 1. 장면: 미리보기 창 그리드, 배경색, 썸네일 설정 포함
- 2. 모델: 모델 렌더링 모드, 텍스처 재질, 위쪽 방향 설정
- 3. 카메라: 직교 뷰와 원근 뷰 전환, 원근 각도 설정
- 4. 조명: 장면 전역 조명 강도
- 5. 내보내기: 모델을 다른 형식으로 내보내기 (GLB, OBJ, STL)

#### 장면

![scene menu](https://raw.githubusercontent.com/Comfy-Org/embedded-docs/refs/heads/main/comfyui_embedded_docs/docs/Load3d/asset/menu_scene.webp)

장면 메뉴는 몇 가지 기본 장면 설정 기능을 제공합니다:

1. 그리드 표시/숨기기
2. 배경색 설정
3. 클릭하여 배경 이미지 업로드
4. 미리보기 썸네일 숨기기

#### 모델

![Menu_Scene](https://raw.githubusercontent.com/Comfy-Org/embedded-docs/refs/heads/main/comfyui_embedded_docs/docs/Load3d/asset/menu_model.webp)

모델 메뉴는 몇 가지 모델 관련 기능을 제공합니다:

1. **위쪽 방향**: 모델의 위쪽 방향이 될 축 결정
2. **재질 모드**: 모델 렌더링 모드 전환 - 원본, 법선, 와이어프레임, 라인아트

#### 카메라

![menu_modelmenu_camera](https://raw.githubusercontent.com/Comfy-Org/embedded-docs/refs/heads/main/comfyui_embedded_docs/docs/Load3d/asset/menu_camera.webp)

이 메뉴는 직교 뷰와 원근 뷰 간 전환 및 원근 각도 크기 설정을 제공합니다:

1. **카메라**: 직교 뷰와 원근 뷰 간 빠른 전환
2. **FOV**: FOV 각도 조정

#### 조명

![menu_modelmenu_camera](https://raw.githubusercontent.com/Comfy-Org/embedded-docs/refs/heads/main/comfyui_embedded_docs/docs/Load3d/asset/menu_light.webp)

이 메뉴를 통해 장면의 전역 조명 강도를 빠르게 조정할 수 있습니다

#### 내보내기

![menu_export](https://raw.githubusercontent.com/Comfy-Org/embedded-docs/refs/heads/main/comfyui_embedded_docs/docs/Load3d/asset/menu_export.webp)

이 메뉴는 모델 형식을 빠르게 변환하고 내보내는 기능을 제공합니다

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