add_scene_3d_cameraT_add_scene_3d_cameraAddScene3dCameraAddScene3dCameraadd_scene_3d_camera添加场景三维相机（算子）

名称

add_scene_3d_cameraT_add_scene_3d_cameraAddScene3dCameraAddScene3dCameraadd_scene_3d_camera — 将相机添加到三维场景中。

签名

add_scene_3d_camera( : : Scene3D, CameraParam : CameraIndex)

描述

add_scene_3d_cameraadd_scene_3d_cameraAddScene3dCameraAddScene3dCameraAddScene3dCameraadd_scene_3d_camera 向 3D 场景 Scene3DScene3DScene3DScene3Dscene3Dscene_3d 中添加一个新相机，并将该相机在 CameraIndexCameraIndexCameraIndexCameraIndexcameraIndexcamera_index 中的索引返回。相机的参数必须通过 CameraParamCameraParamCameraParamCameraParamcameraParamcamera_param 提供。默认情况下，新相机位于世界坐标系的原点。相机 CameraIndexCameraIndexCameraIndexCameraIndexcameraIndexcamera_index 的姿态可通过 set_scene_3d_camera_poseset_scene_3d_camera_poseSetScene3dCameraPoseSetScene3dCameraPoseSetScene3dCameraPoseset_scene_3d_camera_pose 设置。

注意

不支持配备超中心镜头的相机。在 CameraParamCameraParamCameraParamCameraParamcameraParamcamera_param 中显示具有非零畸变的大型面（或基元）时，请注意畸变仅作用于模型的点。在投影过程中，这些点随后会被直线连接。为获得畸变线的良好近似效果，请使用具有足够小三角形的三角测量。

执行信息

多线程类型：可重入（与非独占算子并行运行）。
多线程作用域：全局（可从任何线程调用）。
未采用并行化处理。

参数

Scene3DScene3DScene3DScene3Dscene3Dscene_3d (输入控制) scene_3d → (handle)

3D 场景的句柄。

CameraParamCameraParamCameraParamCameraParamcameraParamcamera_param (输入控制) campar → (real / integer / string)

新相机的参数。

CameraIndexCameraIndexCameraIndexCameraIndexcameraIndexcamera_index (输出控制) integer → (integer)

新相机在 3D 场景中的索引。

结果

add_scene_3d_cameraadd_scene_3d_cameraAddScene3dCameraAddScene3dCameraAddScene3dCameraadd_scene_3d_camera 在所有参数正确时返回 2 ( H_MSG_TRUE )。如有必要，则抛出异常。

可能的前趋

create_scene_3dcreate_scene_3dCreateScene3dCreateScene3dCreateScene3dcreate_scene_3d

可能的后继

set_scene_3d_camera_poseset_scene_3d_camera_poseSetScene3dCameraPoseSetScene3dCameraPoseSetScene3dCameraPoseset_scene_3d_camera_pose, display_scene_3ddisplay_scene_3dDisplayScene3dDisplayScene3dDisplayScene3ddisplay_scene_3d

模块

三维计量

算子