Update Scene Objects

Function

Update the pose and size of the specified scene object via the vision service or parameter settings.

Usage Scenario

When running a Mech-Viz project, the position and size of the scene object should be adjusted in order to avoid collisions in different situations.

Parameter Description

Basic Non-Move

Please refer to General Parameters of Non-Move Steps for detailed information.

Update Info Source

This parameter specifies the information source to update the scene object’s pose and size. The two supported information sources are Config Value and Vision Service.

Config Value

../../../../_images/update_scene_object_para.png

  • +: Add a new scene object.

  • -: Delete the selected scene object.

You can add or delete a scene object according to the actual requirement. The pose and size of the scene object at the top of the Scene Object list will be updated first. For each item in the Scene Object list, you can select the scene object in the corresponding drop-down list and then specify the Target Pose and Target Size. The format of target pose should be XYZ (m) plus quaternions and the target size is the dimensions on 3 directions in meters.

For example, a target pose can be 1.04,0.91,1.00,0.00,0.00,0.00,0.00, a target size of a cuboid can be 1.00,1.00,2.00 (length, width, height), and a target size of a vertical cylinder can be 1.00, 1.00, 0.00 (radius, height, 0).

Vision Service

Vision Name

Select the registered Mech-Vision project that provides the vision service.

Once you selected a Mech-Vision project, please follow the steps below to configure the Procedure Out Step in the Mech-Vision project.

  1. Go to the Step Parameters panel, and set the Port Type to Custom.

  2. Click the button next to Customized Ports Name to open the Procedure Out Setting Assistant.

  3. Click Insert to create 3 customized keys.

  4. Double-click the customized keys to rename them to sceneObjectNames, sceneObjectSizes, and sceneObjectPoses.

  5. Click OK to save the changes.

  6. Connect the input port of Procedure Out with corresponding output ports respectively.

../../../../_images/update_scene_object_config.png

Customized Keys

Description

sceneObjectNames

The name should be consistent with that of the scene object in Mech-Viz

sceneObjectSizes

Object dimensions in meters, (length, width, height) for cuboids and (radius, height, 0) for cylinders

sceneObjectPoses

XYZ (m) plus quaternions