Update Scene Objects

You are viewing an old version of the documentation. You can switch to the documentation of the latest version by clicking the top-right corner of the page.

Function

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

Usage Scenario

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

Parameter Description

General Parameters of Non-Move Steps

Skip Execution

None

Default setting. Do not skip the current Step.

Simulation only

Skip the current Step during simulation. The exit port is specified by Out Port When Skip.

Always

Skip the current Step when the project is simulating or running. The exit port is specified by Out Port When Skip.

Instruction

When Simulation only or Always is selected, the current Step will be skipped and the subsequent Step will be executed when running the project. If this parameter is set to None in “Check DI” Step in the project, and there is no external input signal during simulation, the project will be stopped when executing to this Step. In this case, setting the parameter to Simulation only or Always enables the simulation to continue.

Out Port When Skip

This parameter will take effect when Skip Execution is set to Simulation only or Always. It specifies the exit port when skipping a Step.

Update Info Source

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

Config Value

update scene object para

+: 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 dimensions 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 in X, Y, and Z-directions in meters.

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

Vision Service

Vision Name

Select the Mech-Vision project that provides the vision service. The Mech-Vision project must be a registered one.

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 Set data type output to external communication, and the Procedure Out Setting Assistant window will pop up.

  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.

update scene object config
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.

Example

In a scenario where a sensor door is used, this Step is used to update the model of the door, thus collisions in different processes can be avoided. Config Value is used to update the scene object in this example.

update scene object

We Value Your Privacy

We use cookies to provide you with the best possible experience on our website. By continuing to use the site, you acknowledge that you agree to the use of cookies. If you decline, a single cookie will be used to ensure you're not tracked or remembered when you visit this website.