Skip to content

set_scene_3d_instance_poseSetScene3dInstancePoseSetScene3dInstancePoseset_scene_3d_instance_poseT_set_scene_3d_instance_pose🔗

Short description🔗

set_scene_3d_instance_poseSetScene3dInstancePoseSetScene3dInstancePoseset_scene_3d_instance_poseT_set_scene_3d_instance_pose — Set the pose of an instance in a 3D scene.

Signature🔗

set_scene_3d_instance_pose( scene_3d Scene3D, integer InstanceIndex, pose Pose )void SetScene3dInstancePose( const HTuple& Scene3D, const HTuple& InstanceIndex, const HTuple& Pose )static void HOperatorSet.SetScene3dInstancePose( HTuple scene3D, HTuple instanceIndex, HTuple pose )def set_scene_3d_instance_pose( scene_3d: HHandle, instance_index: MaybeSequence[int], pose: MaybeSequence[Union[float, int]] ) -> None

Herror T_set_scene_3d_instance_pose( const Htuple Scene3D, const Htuple InstanceIndex, const Htuple Pose )

void HScene3D::SetScene3dInstancePose( const HTuple& InstanceIndex, const HPoseArray& Pose ) const

void HScene3D::SetScene3dInstancePose( Hlong InstanceIndex, const HPose& Pose ) const

void HScene3D.SetScene3dInstancePose( HTuple instanceIndex, HPose[] pose )

void HScene3D.SetScene3dInstancePose( int instanceIndex, HPose pose )

Description🔗

set_scene_3d_instance_poseSetScene3dInstancePose sets the pose of the instance InstanceIndexinstanceIndexinstance_index in the 3D scene Scene3Dscene3Dscene_3d to Poseposepose. It’s possible to set one pose for multiple instances or one pose for each instance.

See the documentation of create_scene_3dCreateScene3d for more details on the coordinate systems used in 3D scenes.

Execution information🔗

Execution information

  • Multithreading type: reentrant (runs in parallel with non-exclusive operators).

  • Multithreading scope: global (may be called from any thread).

  • Processed without parallelization.

Parameters🔗

Scene3Dscene3Dscene_3d (input_control) scene_3d → (handle)HTuple (HHandle)HScene3D, HTuple (IntPtr)HHandleHtuple (handle)

Handle of the 3D scene.

InstanceIndexinstanceIndexinstance_index (input_control) integer(-array) → (integer)HTuple (Hlong)HTuple (int / long)MaybeSequence[int]Htuple (Hlong)

Index of the instance.

Poseposepose (input_control) pose(-array) → (real / integer)HTuple (double / Hlong)HPose, HTuple (double / int / long)MaybeSequence[Union[float, int]]Htuple (double / Hlong)

New pose of the instance.

Result🔗

set_scene_3d_instance_poseSetScene3dInstancePose returns 2 (H_MSG_TRUE) if all parameters are correct. If necessary, an exception is raised.

Combinations with other operators🔗

Combinations

Possible predecessors

add_scene_3d_instanceAddScene3dInstance

See also

set_scene_3d_to_world_poseSetScene3dToWorldPose, set_scene_3d_camera_poseSetScene3dCameraPose

Module🔗

3D Metrology