Scene Objects

You are currently viewing the documentation for the latest version (2.1.0). To access a different version, click the "Switch version" button located in the upper-right corner of the page.

■ If you are not sure which version of the product you are currently using, please feel free to contact Mech-Mind Technical Support.

This section introduces the scene objects and corresponding configurations.

Introduction

Scene objects, usually including the safety fence, picking bin, tray, camera, and camera stand, refer to objects in the real scenarios where the robot performs various tasks.

Scene Object Model

Adding scene object models makes the scene in the software closer to the real scenario, which facilitates the collision detection and path planning.

You can create models of a cuboid, bin, or cylinder. You can also use a custom model imported from outside the software. The supported format of the visualization model and collision model are shown in the table below.

Format

STL

OBJ

DAE

Binvox

Visualization Model

×

Collision model

×

×

The Parent-Child Relationship of the Scene Objects

You can establish a parent-child relationship between scene objects. Once the relationship is established, the child model will be moved as well if the parent model is moved, and the child model will be deleted as well if the parent model is deleted. However, the parent model will not be affected if you move or delete the child model individually.

Configure the Scene Object

You can add, modify, or delete the scene objects in the project resource tree.

Add a Scene Object

Please follow the steps below to add a scene object model of the Cuboid, Cylinder, or Bin type.

  1. Go to Project resource tree  Scene objects, and click + to open the Scene Object Configuration window.

  2. In the Object Settings tab, select the Scene model type in the drop-down list.

    • Set the X, Y, Z (length, width, height) for a Cuboid model.

    • Set the Radius and Height for a Cylinder model.

    • Set the X, Y, Z (length, width, height), and Thickness for a Bin model.

  3. Enter a custom name for the scene object model in the Object name text box.

  4. By default, the newly added scene object is located at the origin of the robot base reference frame. You can click the Object Pose tab in the Scene Object Configuration window to switch the configuration interface, and modify the parameters to adjust the pose of the scene object model.

  5. Click OK.

Please follow the steps below to add a Custom model.

  1. Click the + next to Project resource tree  Model library, and select the collision model and visualization model in the pop-up window, and then click Open.

  2. Go to Project resource tree  Scene objects, and click + to open the Scene Object Configuration window.

  3. In the Object Settings tab, select Custom model as the Scene model.

  4. Set the scene object model used for the collision detection as the Collision model.

  5. Set the scene object model used for visualization in the 3D simulation area as the Visualization model.

  6. Enter a custom name for the scene object model in the Object name text box.

  7. By default, the newly added scene object is located at the origin of the robot base reference frame. You can click the Object Pose tab in the Scene Object Configuration window to switch the configuration interface, and modify the parameters to adjust the pose of the scene object model.

  8. Click OK.

If you need to add more scene object models, please repeat the above steps.

  • When the scene model is a Custom model, you can select Import new model in the drop-down menu of the Collision model and Visualization model parameters to add models.

  • For child models, you can enable Show scene object pose in world frame in the Object Pose interface to view the pose of the scene object in the world reference frame in the Object pose section. This option is disabled by default, i.e., the pose of the child model displayed in the Object pose section is the pose relative to its parent model. Once the Scene Object Configuration window is closed, this option will revert to its default setting.

  • If you select an added model in the project resource tree and then click +, a child model of the current model will be added, and the default pose of the child model will be the same as that of the parent model.

  • You can drag the scene object in the project resource tree to change it into a child model or individual model.

Delete the Scene Object

Follow either of the following steps to delete a scene object.

  • Select the scene model in the 3D simulation area or the model name under Project resource tree  Scene objects and press the Delete key.

  • Right-click the scene object in the 3D simulation area or the model name under Project resource tree  Scene objects and select Delete in the context menu.

Modify the Scene Object

  1. Follow either of the following steps to open the Scene Object Configuration window.

    • Double-click the object model in the 3D simulation area.

    • Go to Project resource tree  Scene objects and double-click the scene object name.

    • Right-click the name of the scene object under Project resource tree  Scene objects and select Scene Object Configuration in the context menu.

  2. Modify the parameters according to the actual requirement.

  3. Click OK.

You can also select the scene object in the 3D simulation area, and adjust the model pose with the manipulator.

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.