# 建立相機資訊

建立相機資訊節點用於構建 3D 渲染所需的相機資訊結構。它支援三種定義相機的模式：軌道（圍繞目標的偏航/俯仰/距離）、注視（明確的世界位置）和四元數（位置加旋轉）。座標系統為右手座標系，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 |

**注意：** 當 `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/zh-TW.md)

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