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