ComfyPilotComfyPilot
文档 / 节点说明 / 创建相机信息

创建相机信息

创建相机信息节点用于构建3D渲染所需的相机信息结构。它支持三种相机定义模式:轨道模式(围绕目标点的偏航/俯仰/距离)、注视模式(显式世界坐标)和四元数模式(位置加旋转)。

节点说明 CreateCameraInfo 更新于 2026-11-12

查看官方原文

创建相机信息 - ComfyUI Built-in Node Documentation

创建相机信息节点用于构建3D渲染所需的相机信息结构。它支持三种相机定义模式:轨道模式(围绕目标点的偏航/俯仰/距离)、注视模式(显式世界坐标)和四元数模式(位置加旋转)。

创建相机信息节点用于构建3D渲染所需的相机信息结构。它支持三种相机定义模式:轨道模式(围绕目标点的偏航/俯仰/距离)、注视模式(显式世界坐标)和四元数模式(位置加旋转)。坐标系采用右手坐标系,Y轴为向上轴。

输入

参数描述数据类型必填范围
模式定义相机的方式:轨道角度、显式位置或位置+四元数DYNAMIC\_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): 5a9703e8e01ad2cd92a97da8d892c278765a9cef8bcd38e3336d1f73717d9895