> ## Documentation Index
> Fetch the complete documentation index at: https://dripart-matt-router-pricing-pika-and-guard.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# ComfyUI 3D 설정

> ComfyUI 3D 설정 옵션에 대한 상세 설명

<Info>
  이 페이지에 설명된 설정은 **ComfyUI 인앱 설정 메뉴**에 있습니다. **설정**(톱니바퀴 아이콘)으로 이동하거나 `Ctrl + ,` 키보드 단축키를 사용하여 해당 메뉴를 열고, 해당 카테고리를 선택하면 이러한 옵션을 확인하고 구성할 수 있습니다.
</Info>

이 설정 섹션은 주로 ComfyUI의 3D 관련 구성 요소, 예를 들어 카메라, 조명, 장면 등의 초기화 설정을 제어하는 데 사용됩니다. 새로운 3D 구성 요소를 생성할 때는 이 설정에 따라 초기화됩니다. 생성된 후에도 각 구성 요소별로 개별적으로 설정을 조정할 수 있습니다.

## 카메라

### 초기 카메라 유형

* **옵션**:
  * `perspective`
  * `orthographic`
* **기능**: 새 3D 구성 요소를 생성할 때 기본 카메라가 원근법인지 직교법인지를 제어합니다. 이 기본 설정은 생성된 후에도 각 구성 요소별로 개별적으로 전환할 수 있습니다.

<img src="https://mintcdn.com/dripart-matt-router-pricing-pika-and-guard/rF4bo0v6tzYynnbV/images/interface/setting/3d/camera_type.jpg?fit=max&auto=format&n=rF4bo0v6tzYynnbV&q=85&s=e702f58ebcc02a3a954d8166e29e44d4" alt="카메라 유형" width="794" height="648" data-path="images/interface/setting/3d/camera_type.jpg" />

## 라이트

이 섹션의 라이트 설정은 3D 구성 요소의 기본 조명 설정을 지정하는 데 사용됩니다. ComfyUI의 3D 설정에서 해당 설정을 수정할 수도 있습니다.

<img src="https://mintcdn.com/dripart-matt-router-pricing-pika-and-guard/rF4bo0v6tzYynnbV/images/interface/setting/3d/light.jpg?fit=max&auto=format&n=rF4bo0v6tzYynnbV&q=85&s=aa2c5e8d6a851e595ad4e70b958a3273" alt="라이트" width="2090" height="1138" data-path="images/interface/setting/3d/light.jpg" />

### 라이트 조정 증분

* **기본값**: 0.5
* **기능**: 3D 장면에서 라이트 강도를 조정할 때 단계 크기를 제어합니다. 작은 값은 더 세밀한 라이트 조정을 가능하게 하고, 큰 값은 각 조정이 더 두드러지게 나타납니다.

### 라이트 강도 최소값

* **기본값**: 1
* **기능**: 3D 장면에서 허용되는 최소 라이트 강도 값을 설정합니다. 이는 어떤 3D 컨트롤의 조명을 조정할 때 설정할 수 있는 가장 낮은 밝기를 정의합니다.

### 라이트 강도 최대값

* **기본값**: 10
* **기능**: 3D 장면에서 허용되는 최대 라이트 강도 값을 설정합니다. 이는 어떤 3D 컨트롤의 조명을 조정할 때 설정할 수 있는 가장 높은 밝기를 정의합니다.

### 초기 라이트 강도

* **기본값**: 3
* **기능**: 3D 장면에서 라이트의 기본 밝기 수준을 설정합니다. 이 값은 새 3D 컨트롤을 생성할 때 라이트가 객체를 비추는 강도를 결정하지만, 생성된 후에는 각 컨트롤별로 개별적으로 조정할 수 있습니다.

## 장면

### 초기 배경색

* **기능**: 3D 장면의 기본 배경색을 제어합니다. 이 설정은 새 3D 구성 요소를 생성할 때 배경의 모습을 결정하지만, 생성된 후에는 각 구성 요소별로 개별적으로 조정할 수 있습니다.
* **기본값**: `282828` (진회색)

배경색을 변경하면 캔버스에서도 조정할 수 있습니다.

<img src="https://mintcdn.com/dripart-matt-router-pricing-pika-and-guard/rF4bo0v6tzYynnbV/images/interface/setting/3d/background_color.jpg?fit=max&auto=format&n=rF4bo0v6tzYynnbV&q=85&s=f71c4a267dd43361a23a5c04241401ef" alt="초기 배경색 vs 수정된 배경색" width="1769" height="992" data-path="images/interface/setting/3d/background_color.jpg" />

### 초기 미리보기 표시 여부

* **기능**: 새 3D 구성 요소를 생성할 때 기본적으로 미리보기 화면이 표시되는지 여부를 제어합니다. 생성된 후에도 각 구성 요소별로 개별적으로 이 기본 설정을 전환할 수 있습니다.
* **기본값**: true (활성화)

<img src="https://mintcdn.com/dripart-matt-router-pricing-pika-and-guard/rF4bo0v6tzYynnbV/images/interface/setting/3d/hide_preview.jpg?fit=max&auto=format&n=rF4bo0v6tzYynnbV&q=85&s=130e5f91372d49ef922e233889eda6e9" alt="미리보기 vs 미리보기 숨김" width="1769" height="992" data-path="images/interface/setting/3d/hide_preview.jpg" />

### 초기 그리드 표시 여부

* **기능**: 새 3D 구성 요소를 생성할 때 기본적으로 그리드가 표시되는지 여부를 제어합니다. 생성된 후에도 각 구성 요소별로 개별적으로 이 기본 설정을 전환할 수 있습니다.
* **기본값**: true (활성화)

초기화 시 그리드를 표시하거나 숨기기

<img src="https://mintcdn.com/dripart-matt-router-pricing-pika-and-guard/rF4bo0v6tzYynnbV/images/interface/setting/3d/hide_grid.jpg?fit=max&auto=format&n=rF4bo0v6tzYynnbV&q=85&s=cf60a6e7f15f176fbeacff04e98e9430" alt="그리드 표시 vs 그리드 숨김" width="794" height="648" data-path="images/interface/setting/3d/hide_grid.jpg" />

## 3D 뷰어 (베타)

3D 뷰어(베타)는 노드 안의 미리보기와 별개로 3D 모델을 전체 크기 창에서 엽니다. 모델을 확인하고 배치를 조정하며 내보낼 때 사용합니다.

캔버스에서 Load 3D 노드를 하나 선택한 뒤 선택 도구 상자의 뷰어 버튼을 클릭하세요. 버튼을 클릭하면 **3D 뷰어 (베타)** 창이 열리며 최대화할 수 있습니다.

### 3D 뷰어 활성화 (베타)

* **옵션**:
  * enabled (활성화)
  * disabled (비활성화)
* **기본값**: enabled (활성화)
* **기능**: Load 3D 노드를 하나 선택했을 때 선택 도구 상자에 뷰어 버튼을 표시할지 여부를 제어합니다. 비활성화하면 버튼이 나타나지 않습니다. 이 설정은 설정 목록에서 베타 표시가 붙습니다.

### 뷰어 패널

뷰어에는 장면, 카메라, 라이트, 모델, Gizmo, 애니메이션, 내보내기용 패널이 따로 있습니다.

* **장면**: 배경색, 그리드 표시, 타일 또는 파노라마로 렌더링되는 배경 이미지
* **카메라**: 카메라 유형과 화각
* **라이트**: 라이트 강도
* **모델**: 위쪽 방향과 재질 모드
* **Gizmo**: 뷰포트에서 모델 이동, 회전, 크기 조절
* **애니메이션**: 파일에 포함된 애니메이션 클립을 재생하고 속도와 재생 위치를 조정
* **내보내기**: 불러온 모델을 저장합니다. 메시 파일은 GLB, OBJ, STL, FBX로 내보낼 수 있고, 포인트 클라우드와 가우시안 스플랫 파일은 원래 형식으로 유지됩니다

뷰어를 닫으면 변경한 내용이 노드에 다시 기록됩니다. **취소**를 선택하면 노드를 변경하지 않고 뷰어를 닫습니다.

## 포인트 클라우드

### PLY 엔진

* **옵션**:
  * `threejs`
  * `fastply`
* **기본값**: `threejs`
* **기능**: 포인트 클라우드 PLY 파일을 불러오는 엔진을 선택합니다. `threejs`는 네이티브 Three.js PLYLoader를 사용하며 바이너리와 ASCII 파일을 모두 읽고 메시도 지원합니다. `fastply`는 ASCII PLY 파일에 최적화된 파서를 사용합니다. 3D 가우시안 스플랫 파일은 자동으로 인식되며, 여기서 선택한 엔진과 관계없이 가우시안 스플랫 렌더러로 그려집니다.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.