> ## Documentation Index
> Fetch the complete documentation index at: https://dripart-docs-custom-nodes-sdk-v2-frontend.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# MoGeInference - ComfyUI Built-in Node Documentation

> 단일 이미지에 MoGe를 실행하여 깊이와 지오메트리를 추정합니다. 이 노드는 입력 이미지를 MoGe 모델로 처리하여 3D 포인트 클라우드, 깊이 맵, 카메라 내부 파라미터, 마스크 및 표면 법선을 생성합니다.

단일 이미지에 MoGe를 실행하여 깊이와 지오메트리를 추정합니다. 이 노드는 입력 이미지를 MoGe 모델로 처리하여 3D 포인트 클라우드, 깊이 맵, 카메라 내부 파라미터, 마스크 및 표면 법선을 생성합니다.

## 입력

| 매개변수               | 설명                                                                                                                                        | 데이터 타입      | 필수 | 범위           |
| ------------------ | ----------------------------------------------------------------------------------------------------------------------------------------- | ----------- | -- | ------------ |
| `moge_model`       | 추론에 사용할 MoGe 모델입니다.                                                                                                                       | MOGE\_MODEL | 예  | N/A          |
| `image`            | 깊이 및 지오메트리 추정을 위한 입력 이미지입니다. 처음 세 개의 색상 채널(RGB)만 사용됩니다.                                                                                   | IMAGE       | 예  | N/A          |
| `resolution_level` | 처리 해상도를 제어합니다. 0이 가장 빠르고, 9가 가장 상세합니다. (기본값: 9)                                                                                           | INT         | 예  | 0 \~ 9       |
| `fov_x_degrees`    | (고급) 소스 카메라의 수평 화각(도)입니다. 깊이 맵을 3D로 역투영하는 데 사용되는 초점 거리를 설정합니다. 0.0으로 설정하면 예측된 점에서 화각을 자동으로 복원합니다. (기본값: 0.0)                              | FLOAT       | 예  | 0.0 \~ 170.0 |
| `batch_size`       | 추론 호출당 이미지 수입니다. 긴 비디오 또는 이미지 세트에서 메모리가 부족한 경우 이 값을 낮추십시오. (기본값: 4)                                                                       | INT         | 예  | 1 \~ 64      |
| `force_projection` | (고급) 예측된 점의 투영을 강제합니다. (기본값: True)                                                                                                        | BOOLEAN     | 예  | True/False   |
| `apply_mask`       | (고급) 마스킹된(하늘 또는 유효하지 않은) 픽셀을 점 및 깊이 출력에서 무한대로 설정하여 메시 생성 도구가 무시할 수 있게 합니다. 비활성화하면 원시 예측 지오메트리를 모든 곳에 유지하며, 마스크는 별도로 계속 반환됩니다. (기본값: True) | BOOLEAN     | 예  | True/False   |

참고: 입력 `image`에 `batch_size`보다 많은 프레임이 포함된 경우, 노드는 여러 번의 추론 호출로 처리하고 결과를 단일 출력 지오메트리로 결합합니다.

## 출력

| 출력 이름           | 설명                                                                                                                                                                    | 데이터 타입         |
| --------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------- |
| `moge_geometry` | 추정된 지오메트리를 포함하는 딕셔너리입니다. 원본 `image`를 포함하며, `points`(3D 포인트 클라우드), `depth`(깊이 맵), `intrinsics`(카메라 내부 파라미터 행렬), `mask`(유효한 픽셀을 식별하는 마스크), `normal`(표면 법선)을 포함할 수 있습니다. | MOGE\_GEOMETRY |

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

***

**Source fingerprint (SHA-256):** `59f6b8b1ab65147a47f5dc7ebee7b965a5ab37c6a0843a2c80d50c767ad98db4`