Is this page helpful?

[isaacsim.util.merge_mesh] Isaac Sim Merge Mesh#

Warning

Deprecation: Extension deprecated since ISaac Sim 6.0.0. Replaced with the Scene Optimizer

Version: 2.0.18

Overview#

Deprecated since version 6.0.0: This extension has been deprecated and replaced by the Scene Optimizer.

The isaacsim.util.merge_mesh extension provided tools for combining multiple meshes into a single USD prim. It supported resetting mesh origins to the world origin and consolidating materials with matching characteristics into a unified material list.

Key Components#

MeshMerger#

The MeshMerger class provided utility functions for merging multiple USD meshes into a single mesh. It handled the merging of mesh geometry, materials, geometry subsets, and texture coordinates from multiple source meshes into a single output mesh with comprehensive control over merge behavior.

Key capabilities included:

  • Combining mesh geometry and material data from multiple sources

  • Handling geometry subsets and texture coordinate merging

  • Supporting configurable material consolidation options

  • Managing mesh transform and origin settings

MergeMeshesCommand#

The MergeMeshesCommand class provided a command interface for merging selected meshes and all children of given prims into a single mesh. It offered options to control merge behavior including transform handling, source deactivation, and material consolidation.

Configuration options included:

  • Clear Parent Transform: Set mesh origin at world origin or preserve first element origin

  • Deactivate source assets: Set source prims to inactive after merge operation

  • Combine Materials: Redirect materials to a single folder and share materials with matching names

Functionality#

The extension was accessible from the Tools > Robotics > Asset Editors menu.

Preview

Enable Extension#

The extension can be enabled (if not already) in one of the following ways:

Define the next entry as an application argument from a terminal.

APP_SCRIPT.(sh|bat) --enable isaacsim.util.merge_mesh

Define the next entry under [dependencies] in an experience (.kit) file or an extension configuration (extension.toml) file.

[dependencies]
"isaacsim.util.merge_mesh" = {}

Open the Window > Extensions menu in a running application instance and search for isaacsim.util.merge_mesh. Then, toggle the enable control button if it is not already active.