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

# CreateCameraInfo - ComfyUI Built-in Node Documentation

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

# 카메라 정보 생성

카메라 정보 생성 노드는 3D 렌더링을 위한 카메라 정보 구조를 구축합니다. 카메라 정의를 위해 세 가지 모드를 지원합니다: 궤도(대상 주위의 요/피치/거리), 시점(명시적 월드 위치), 쿼터니언(위치 및 회전). 좌표계는 Y축이 위쪽 방향인 오른손 좌표계입니다.

## 입력

| 매개변수          | 설명                                                                                              | 데이터 타입 | 필수  | 범위                                             |
| ------------- | ----------------------------------------------------------------------------------------------- | ------ | --- | ---------------------------------------------- |
| `mode`        | 카메라 정의 방식: 궤도 각도, 명시적 위치, 또는 위치+쿼터니언                                                            | COMBO  | 예   | `"orbit"`<br />`"look_at"`<br />`"quaternion"` |
| `target_x`    | 시점 대상(궤도 회전 중심/조준점). 궤도 모드에서는 이를 이동하여 전체 카메라를 팬/이동합니다. 쿼터니언 모드에서는 무시됩니다. 기본값은 원점입니다. (기본값: 0.0) | FLOAT  | 아니요 | -1000.0 \~ 1000.0                              |
| `target_y`    | 대상 지점의 Y 구성 요소입니다. (기본값: 0.0)                                                                   | FLOAT  | 아니요 | -1000.0 \~ 1000.0                              |
| `target_z`    | 대상 지점의 Z 구성 요소입니다. (기본값: 0.0)                                                                   | FLOAT  | 아니요 | -1000.0 \~ 1000.0                              |
| `roll`        | 시선 축에 대한 카메라 롤(도 단위)입니다. (기본값: 0.0)                                                             | FLOAT  | 아니요 | -180.0 \~ 180.0                                |
| `fov`         | 수직 시야각(도 단위)입니다. (기본값: 35.0)                                                                    | FLOAT  | 아니요 | 1.0 \~ 120.0                                   |
| `zoom`        | 디지털 줌(초점 거리 배율)입니다. 1보다 큰 값은 카메라를 이동하지 않고 확대합니다. (기본값: 1.0)                                     | FLOAT  | 아니요 | 0.01 \~ 100.0                                  |
| `camera_type` | Render Splat에서 사용하는 투영 방식: 원근(원근 단축) 또는 직교(평행)입니다. (기본값: "perspective")                         | COMBO  | 아니요 | `"perspective"`<br />`"orthographic"`          |

### 모드별 매개변수

`mode`가 `"orbit"`으로 설정된 경우 다음 매개변수를 사용할 수 있습니다:

| 매개변수       | 설명                              | 데이터 타입 | 필수 | 범위              |
| ---------- | ------------------------------- | ------ | -- | --------------- |
| `yaw`      | 대상 주위의 수평 회전 각도입니다. (기본값: 35.0) | FLOAT  | 예  | -360.0 \~ 360.0 |
| `pitch`    | 대상 주위의 수직 회전 각도입니다. (기본값: 30.0) | FLOAT  | 예  | -89.0 \~ 89.0   |
| `distance` | 대상으로부터의 카메라 거리입니다. (기본값: 4.0)   | FLOAT  | 예  | 0.01 \~ 1000.0  |

`mode`가 `"look_at"`으로 설정된 경우 다음 매개변수를 사용할 수 있습니다:

| 매개변수         | 설명                                             | 데이터 타입 | 필수 | 범위                |
| ------------ | ---------------------------------------------- | ------ | -- | ----------------- |
| `position_x` | 월드 공간에서의 카메라 위치(오른손 좌표계, Y축 위쪽)입니다. (기본값: 4.0) | FLOAT  | 예  | -1000.0 \~ 1000.0 |
| `position_y` | 카메라 위치의 Y 구성 요소입니다. (기본값: 4.0)                 | FLOAT  | 예  | -1000.0 \~ 1000.0 |
| `position_z` | 카메라 위치의 Z 구성 요소입니다. (기본값: 4.0)                 | FLOAT  | 예  | -1000.0 \~ 1000.0 |

`mode`가 `"quaternion"`으로 설정된 경우 다음 매개변수를 사용할 수 있습니다:

| 매개변수         | 설명                                                                  | 데이터 타입 | 필수 | 범위                |
| ------------ | ------------------------------------------------------------------- | ------ | -- | ----------------- |
| `position_x` | 월드 공간에서의 카메라 위치(오른손 좌표계, Y축 위쪽)입니다. (기본값: 4.0)                      | FLOAT  | 예  | -1000.0 \~ 1000.0 |
| `position_y` | 카메라 위치의 Y 구성 요소입니다. (기본값: 4.0)                                      | FLOAT  | 예  | -1000.0 \~ 1000.0 |
| `position_z` | 카메라 위치의 Z 구성 요소입니다. (기본값: 4.0)                                      | FLOAT  | 예  | -1000.0 \~ 1000.0 |
| `quat_x`     | 카메라 월드 회전 쿼터니언의 X 구성 요소입니다. (기본값: 0.0)                              | FLOAT  | 예  | -1.0 \~ 1.0       |
| `quat_y`     | 카메라 월드 회전 쿼터니언의 Y 구성 요소입니다. (기본값: 0.0)                              | FLOAT  | 예  | -1.0 \~ 1.0       |
| `quat_z`     | 카메라 월드 회전 쿼터니언의 Z 구성 요소입니다. (기본값: 0.0)                              | FLOAT  | 예  | -1.0 \~ 1.0       |
| `quat_w`     | 카메라 월드 회전 쿼터니언(three.js: 로컬 -Z 방향을 바라봄)입니다. 자동으로 정규화됩니다. (기본값: 1.0) | FLOAT  | 예  | -1.0 \~ 1.0       |

**참고:** `mode`가 `"quaternion"`으로 설정된 경우 `target_x`, `target_y`, `target_z` 매개변수는 무시됩니다. `"orbit"` 모드에서는 이러한 대상 매개변수가 카메라가 궤도 운동하는 회전 중심점을 정의합니다.

## 출력

| 출력 이름         | 설명                                                    | 데이터 타입       |
| ------------- | ----------------------------------------------------- | ------------ |
| `camera_info` | 3D 렌더링을 위한 위치, 회전, 시야각, 줌 및 투영 유형을 포함하는 카메라 정보 구조입니다. | LOAD3DCAMERA |

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

***

**Source fingerprint (SHA-256):** `577c114130f72b753d5f15775fe05b3e1e734f5865cca32c576d042583f8e873`
