Use Model Editor to Create OBJ Models

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.

The steps to convert STL models, STP models, STEP models, and ineligible OBJ models to OBJ models that are composed entirely of convex hulls are as follows.

model editor workflow

1. Import Reference Model

Supported file formats of imported reference models include STL, STP, STEP, and OBJ.

Follow either of these steps to import the reference model.

  • Click File  Import  Reference Model and select the reference model file in the file selection window.

  • Drag and drop the reference model file to the interface of the Model Editor.

Select the unit according to the actual dimensions of the model in the pop-up window, and click OK.

If an error message “Failed to load the model” pops up, please refer to Determine Whether the STEP/STP File Is Eligible to check the model file.

2. Set Frame (Optional)

The end tool models with different poses in the Model Editor are illustrated in the table below, including the default pose that is assigned when the tool is initially added via the Tool Configuration window.

Pose of end tool model in the Model Editor

Default tool pose when added via Tool Configuration

alt

alt

alt

alt

From the above table, we can see that if the installation position of the tool model on the robot’s end effector flange does not coincide with the “reference frame origin of the Model Editor’s world reference frame,” you should adjust the position or size of the end tool model when adding the end tool. To avoid the need for adjusting the model’s position every time it is used, please refer to the content in Adjust the Reference Frame of the Model to adjust the reference frame of the model.

alt

A: The world reference frame origin of the Model Editor; B: The reference frame origin of the model installed location

3. Create Convex Hulls

The collision models of tools used in Mech-Viz should be OBJ models that are composed entirely of convex hulls, and a convex hull should be created based on the reference model. The final model should be composed entirely of convex hulls and reflect the shape of the original reference model.

alt

There are two ways to create convex hulls, please select the one suitable for the actual model.

  • Use the selection tool to select vertices and create a convex hull based on the vertices.

  • Create a box or cylinder directly.

Before proceeding to read the following content, please read Selection Tool Usage Guide and Create a Cuboid or Cylinder to learn about how to use the relative tools.

Do not use the 3D selection tool to cover the whole model to create a convex hull. It is recommended to segment the model into multiple parts according to its structure, and use the 3D selection tool to select each part and create convex hulls separately. For example, the model in the figure below can be segmented into 9 parts.

create convex hull

The steps are as follows:

  1. Select the model name in the “Reference Model” panel, and click Selection Tool (Cuboid Selection, Cylinder Selection, or Elliptic Cylinder Selection).

  2. Adjust the selection tool to cover the vertices on the part to be processed, and click Create Convex Hull.

  3. Repeat step 2 until all 9 parts of the model are covered by convex hulls.

  4. Click icon_display_transform on the left of the reference model name to hide the reference model and view the convex model.

  • Since the convex hull or center point are generated based on the vertices of the model, please ensure that the vertices on the part to be processed are within the selection tool.

  • For parts that cannot be accurately selected by a selection tool to create convex hulls, you can create a box or cylinder.

4. Save the Project File

To facilitate re-editing of the model, you can follow these steps to save the model to an M3D file.

  1. Click File  Save.

  2. Specify a save path and enter a file name.

  3. Click Save.

5. Export the Model after Editing

Follow these steps to save the edited model to an OBJ file.

  1. Click File  Export  Reference Model.

  2. Specify a save path and enter a file name.

  3. Save as type obj(*.obj).

  4. Click Save.

    Only the models set to visible in the Assemblies panel in the Model Editor will be saved, while the hidden ones will not be exported.

Once the model is exported successfully, you can add the model to Model library in Project resource tree. Then you can set the corresponding collision model of end tools in Tools.

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.