# Load3D 노드

Load3D 노드는 3D 모델 파일을 불러오고 처리하는 핵심 노드입니다. 노드를 불러오면 `ComfyUI/input/3d/`에서 사용 가능한 3D 리소스를 자동으로 검색합니다. 또한 업로드 기능을 사용하여 지원되는 3D 파일을 업로드하여 미리 볼 수 있습니다.

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

**3D 노드 환경설정**
3D 노드와 관련된 일부 환경설정은 ComfyUI의 설정 메뉴에서 구성할 수 있습니다. 해당 설정에 대한 자세한 내용은 다음 문서를 참조하십시오:

[설정 메뉴](https://docs.comfy.org/interface/settings/3d)

일반적인 노드 출력 외에도 Load3D는 캔버스 메뉴에 다양한 3D 보기 관련 설정을 제공합니다.

## 입력

| 매개변수 이름 | 설명 | 유형 | 기본값 | 범위 |
| --- | --- | --- | --- | --- |
| `모델 파일` | 3D 모델 파일 경로, 업로드 지원, 기본적으로 `ComfyUI/input/3d/`에서 모델 파일 읽기 | 파일 선택 | - | 지원 형식 |
| `너비` | 캔버스 렌더링 너비 | INT | 1024 | 1-4096 |
| `높이` | 캔버스 렌더링 높이 | INT | 1024 | 1-4096 |

## 출력

| 매개변수 이름 | 설명 | 데이터 유형 |
| --- | --- | --- |
| `mask` | 캔버스 렌더링 이미지 | IMAGE |
| `mesh_path` | 현재 모델 위치를 포함하는 마스크 | MASK |
| `normal` | 모델 파일 경로 | STRING |
| `camera_info` | 법선 맵 | IMAGE |
| `recording_video` | 라인 아트 이미지 출력, 해당 `edge_threshold`는 캔버스 모델 메뉴에서 조정 가능 | IMAGE |
| `model_3d` | 카메라 정보 | LOAD3D_CAMERA |
| `model_3d_info` | 녹화된 비디오(녹화가 있는 경우에만) | VIDEO |

모든 출력 미리보기:
![보기 작업 데모](./asset/load3d_outputs.webp)

## 캔버스 영역 설명

Load3D 노드의 캔버스 영역에는 다음과 같은 다양한 보기 작업이 포함되어 있습니다:

- 미리보기 보기 설정(그리드, 배경색, 미리보기 보기)
- 카메라 제어: FOV, 카메라 유형 제어
- 전역 조명 강도: 조명 강도 조정
- 비디오 녹화: 비디오 녹화 및 내보내기
- 모델 내보내기: `GLB`, `OBJ`, `STL` 형식 지원
- 그 외 다양한 기능

![Load 3D 노드 UI](./asset/load3d_ui.jpg)

1. Load 3D 노드의 여러 메뉴 및 숨겨진 메뉴 포함
2. `미리보기 창 크기 조정` 및 `캔버스 비디오 녹화` 메뉴
3. 3D 보기 작업 축
4. 미리보기 썸네일
5. 미리보기 크기 설정, 치수 설정 후 창 크기 조정으로 미리보기 보기 배율 조정

### 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. 왼쪽 메뉴 기능

![메뉴](./asset/menu.webp)

캔버스에서 일부 설정은 메뉴에 숨겨져 있습니다. 메뉴 버튼을 클릭하여 다양한 메뉴를 펼칠 수 있습니다

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

#### 장면

![장면 메뉴](./asset/menu_scene.webp)

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

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

#### 모델

![메뉴_장면](./asset/menu_model.webp)

모델 메뉴는 모델 관련 기능을 제공합니다

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

#### 카메라

![메뉴_모델메뉴_카메라](./asset/menu_camera.webp)

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

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

#### 조명

![메뉴_모델메뉴_카메라](./asset/menu_light.webp)

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

#### 내보내기

![메뉴_내보내기](./asset/menu_export.webp)

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

### 3. 오른쪽 메뉴 기능

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

오른쪽 메뉴에는 두 가지 주요 기능이 있습니다:

1. **보기 비율 재설정**: 버튼 클릭 후 보기가 설정된 너비와 높이에 따라 캔버스 렌더링 영역 비율을 조정합니다
2. **비디오 녹화**: 현재 3D 보기 작업을 비디오로 녹화할 수 있으며, 가져오기를 허용하고 `recording_video`로 후속 노드에 출력할 수 있습니다

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