# カメラ情報の作成

Create Camera Infoノードは、3Dレンダリング用のカメラ情報構造体を構築します。カメラの定義には、オービット（ターゲット周りのヨー/ピッチ/距離）、look_at（明示的なワールド位置）、クォータニオン（位置＋回転）の3つのモードをサポートしています。座標系は右手系で、Y軸が上方向となります。

## 入力

| パラメータ | 説明 | データ型 | 必須 | 範囲 |
|-----------|-------------|-----------|----------|-------|
| `モード` | カメラの定義方法：オービット角度、明示的な位置、または位置＋クォータニオン | COMBO | はい | `"orbit"`<br>`"look_at"`<br>`"quaternion"` |
| `ターゲットX` | 注視点（オービットの支点/照準）。オービットモードでは、これを移動することでカメラ全体をパン/移動します。クォータニオンモードでは無視されます。デフォルトは原点です。（デフォルト：0.0） | FLOAT | いいえ | -1000.0 ～ 1000.0 |
| `ターゲットY` | ターゲット点のY成分。（デフォルト：0.0） | FLOAT | いいえ | -1000.0 ～ 1000.0 |
| `ターゲットZ` | ターゲット点のZ成分。（デフォルト：0.0） | FLOAT | いいえ | -1000.0 ～ 1000.0 |
| `ロール` | 視軸周りのカメラのロール（度単位）。（デフォルト：0.0） | FLOAT | いいえ | -180.0 ～ 180.0 |
| `視野角` | 垂直視野角（度単位）。（デフォルト：35.0） | FLOAT | いいえ | 1.0 ～ 120.0 |
| `ズーム` | デジタルズーム（焦点距離倍率）。1より大きい値はカメラを移動せずにズームインします。（デフォルト：1.0） | FLOAT | いいえ | 0.01 ～ 100.0 |
| `カメラタイプ` | 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 |

**注意：** `target_x`、`target_y`、`target_z`パラメータは、`mode`が`"quaternion"`に設定されている場合は無視されます。`"orbit"`モードでは、これらのターゲットパラメータがカメラが周回する支点を定義します。

## 出力

| 出力名 | 説明 | データ型 |
|-------------|-------------|-----------|
| `camera_info` | 3Dレンダリング用の位置、回転、視野角、ズーム、投影法を含むカメラ情報構造体。 | LOAD3DCAMERA |

> このドキュメントは AI によって生成されました。エラーを見つけた場合や改善のご提案がある場合は、ぜひ貢献してください！ [GitHub で編集](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/CreateCameraInfo/ja.md)

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