# 카메라 정보 생성

카메라 정보 생성 노드는 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`