内置节点参考
CreateCameraInfo - ComfyUI Built-in Node Documentation
Complete documentation for the CreateCameraInfo node in ComfyUI. Learn its inputs, outputs, parameters and usage.
创建相机信息节点用于构建3D渲染所需的相机信息结构。它支持三种相机定义模式：轨道模式（围绕目标点的偏航/俯仰/距离）、注视模式（显式世界坐标）和四元数模式（位置加旋转）。坐标系采用右手坐标系，Y轴为向上轴。
输入
| 参数 | 描述 | 数据类型 | 必填 | 范围 |
|---|---|---|---|---|
模式 |
定义相机的方式：轨道角度、显式位置或位置+四元数 | COMBO | 是 | "orbit" |
"look_at" "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" "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 上编辑
Source fingerprint (SHA-256): 577c114130f72b753d5f15775fe05b3e1e734f5865cca32c576d042583f8e873
官方原文
本页来自 Comfy-Org 官方中文文档的固定版本，并转换为 xueai 静态页面。内容以官方持续更新的页面为准。