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

# Load3D - ComfyUI Built-in Node Documentation

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

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

모든 출력 미리보기:

<img src="https://mintcdn.com/dripart/r1WgNOrRhVXUBgky/images/built-in-nodes/Load3D/load3d_outputs.webp?fit=max&auto=format&n=r1WgNOrRhVXUBgky&q=85&s=9f5a50adc39a7614a8f83ee709f1fbda" alt="보기 작업 데모" width="2594" height="1272" data-path="images/built-in-nodes/Load3D/load3d_outputs.webp" />

## 캔버스 영역 설명

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

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

<img src="https://mintcdn.com/dripart/r1WgNOrRhVXUBgky/images/built-in-nodes/Load3D/load3d_ui.jpg?fit=max&auto=format&n=r1WgNOrRhVXUBgky&q=85&s=ee504a68a45a19e68bf27635cf5d1436" alt="Load 3D 노드 UI" width="2025" height="1696" data-path="images/built-in-nodes/Load3D/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. 왼쪽 메뉴 기능

<img src="https://mintcdn.com/dripart/r1WgNOrRhVXUBgky/images/built-in-nodes/Load3D/menu.webp?fit=max&auto=format&n=r1WgNOrRhVXUBgky&q=85&s=8d906a62632bc4a4eae4e76aada77862" alt="메뉴" width="1184" height="1582" data-path="images/built-in-nodes/Load3D/menu.webp" />

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

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

#### 장면

<img src="https://mintcdn.com/dripart/r1WgNOrRhVXUBgky/images/built-in-nodes/Load3D/menu_scene.webp?fit=max&auto=format&n=r1WgNOrRhVXUBgky&q=85&s=ecbfa96b458f8a1799d447557a49bd6e" alt="장면 메뉴" width="1671" height="1106" data-path="images/built-in-nodes/Load3D/menu_scene.webp" />

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

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

#### 모델

<img src="https://mintcdn.com/dripart/r1WgNOrRhVXUBgky/images/built-in-nodes/Load3D/menu_model.webp?fit=max&auto=format&n=r1WgNOrRhVXUBgky&q=85&s=755a3f4e1aec5042b9893b37c6d987e8" alt="메뉴_장면" width="3605" height="1911" data-path="images/built-in-nodes/Load3D/menu_model.webp" />

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

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

#### 카메라

<img src="https://mintcdn.com/dripart/r1WgNOrRhVXUBgky/images/built-in-nodes/Load3D/menu_camera.webp?fit=max&auto=format&n=r1WgNOrRhVXUBgky&q=85&s=575bff41361272230d0928595da65d16" alt="메뉴_모델메뉴_카메라" width="1729" height="1434" data-path="images/built-in-nodes/Load3D/menu_camera.webp" />

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

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

#### 조명

<img src="https://mintcdn.com/dripart/r1WgNOrRhVXUBgky/images/built-in-nodes/Load3D/menu_light.webp?fit=max&auto=format&n=r1WgNOrRhVXUBgky&q=85&s=d242f04c2061d2458ffc8a5906d7747b" alt="메뉴_모델메뉴_카메라" width="1729" height="740" data-path="images/built-in-nodes/Load3D/menu_light.webp" />

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

#### 내보내기

<img src="https://mintcdn.com/dripart/r1WgNOrRhVXUBgky/images/built-in-nodes/Load3D/menu_export.webp?fit=max&auto=format&n=r1WgNOrRhVXUBgky&q=85&s=a6df9da61ff0168f4d403ff20f087c7e" alt="메뉴_내보내기" width="1729" height="740" data-path="images/built-in-nodes/Load3D/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)