add_scene_3d_instanceT_add_scene_3d_instanceAddScene3dInstanceAddScene3dInstanceadd_scene_3d_instance添加场景三维实例（算子）

名称

add_scene_3d_instanceT_add_scene_3d_instanceAddScene3dInstanceAddScene3dInstanceadd_scene_3d_instance — 将三维对象模型的实例添加到三维场景中。

签名

add_scene_3d_instance( : : Scene3D, ObjectModel3D, Pose : InstanceIndex)

描述

add_scene_3d_instanceadd_scene_3d_instanceAddScene3dInstanceAddScene3dInstanceAddScene3dInstanceadd_scene_3d_instance 将 3D 模型对象 ObjectModel3DObjectModel3DObjectModel3DObjectModel3DobjectModel3Dobject_model_3d 的实例添加到 3D 场景 Scene3DScene3DScene3DScene3Dscene3Dscene_3d 中，并通过 InstanceIndexInstanceIndexInstanceIndexInstanceIndexinstanceIndexinstance_index 返回其索引。若提供多个 3D 对象模型，可为所有实例设置统一姿态，或为每个实例单独设置姿态。

场景坐标系中对象实例的姿态必须通过 PosePosePosePoseposepose 参数指定。可使用 set_scene_3d_instance_poseset_scene_3d_instance_poseSetScene3dInstancePoseSetScene3dInstancePoseSetScene3dInstancePoseset_scene_3d_instance_pose 算子修改该姿态。只要未通过 set_scene_3d_to_world_poseset_scene_3d_to_world_poseSetScene3dToWorldPoseSetScene3dToWorldPoseSetScene3dToWorldPoseset_scene_3d_to_world_pose 设置全局场景姿态，该姿态即相对于世界坐标系进行评估。

实例的参数（如颜色）通过 set_scene_3d_instance_paramset_scene_3d_instance_paramSetScene3dInstanceParamSetScene3dInstanceParamSetScene3dInstanceParamset_scene_3d_instance_param 算子进行设置。

执行信息

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

参数

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

3D 场景的句柄。

ObjectModel3DObjectModel3DObjectModel3DObjectModel3DobjectModel3Dobject_model_3d (输入控制) object_model_3d(-array) → (handle)

3D 对象模型的句柄。

PosePosePosePoseposepose (输入控制) pose(-array) → (real / integer)

3D 对象模型的姿态。

元素数量： 7

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

3D 场景中新建实例的索引。

结果

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

可能的前趋

create_scene_3dcreate_scene_3dCreateScene3dCreateScene3dCreateScene3dcreate_scene_3d

可能的后继

set_scene_3d_instance_paramset_scene_3d_instance_paramSetScene3dInstanceParamSetScene3dInstanceParamSetScene3dInstanceParamset_scene_3d_instance_param, set_scene_3d_instance_poseset_scene_3d_instance_poseSetScene3dInstancePoseSetScene3dInstancePoseSetScene3dInstancePoseset_scene_3d_instance_pose

另见

remove_scene_3d_instanceremove_scene_3d_instanceRemoveScene3dInstanceRemoveScene3dInstanceRemoveScene3dInstanceremove_scene_3d_instance

模块

三维计量

算子