# 创建相机信息

创建相机信息节点用于构建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.md)

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