# Mesh Tools (Pro) {% hint style="info" %} This feature was added in realvirtual **6.3.3** (Professional) {% endhint %} **Mesh Tools** is a tabbed editor window that combines mesh-related utilities for working with imported CAD models. It provides two tools: **Auto Correct Pivots** for fixing off-center mesh origins, and **Mesh Separator** for splitting combined meshes into individual parts. ## Accessing Mesh Tools **Editor Window:** `Tools > realvirtual > Mesh Tools (Pro)` **Context Menu (quick access for Mesh Separator):** * Right-click a GameObject > `realvirtual > Separate Mesh` * Right-click a GameObject > `realvirtual > Merge Child Meshes` *** ## Tab 1: Auto Correct Pivots

Correct Pivots tab showing analysis results for a conveyor system — all 12 meshes passed with zero offset

### Overview CAD models frequently arrive with mesh pivots (transform origins) far away from the actual geometry. A small bracket might have its origin at the machine's global zero point, hundreds of millimeters away. This causes poor rotation behavior, difficulty placing objects, and issues with Drive axes. Auto Correct Pivots fixes this by recentering the mesh vertices around the local origin and compensating the transform so the geometry stays in exactly the same world position. ### How It Works For each mesh in the selected hierarchy, the tool: 1. Calculates how far the mesh center is from the local origin 2. Clones the mesh and offsets all vertices so the center becomes the origin 3. Moves the transform to compensate, keeping the mesh visually in place 4. Preserves all child positions so nothing in the hierarchy shifts 5. Updates any MeshCollider referencing the original mesh 6. Saves the corrected mesh as an asset in `Assets/CorrectedPivots/` ### Settings * **Root Object** -- The root GameObject to scan. All MeshFilters in the hierarchy below this object are analyzed. Defaults to the current selection. * **Min Offset (mm)** -- Only meshes whose pivot is further than this distance from the mesh center are corrected. Default: `1.0` mm. Increase this to skip meshes with minor offsets. ### Workflow 1. Select the root object of your imported CAD model 2. Open `Tools > realvirtual > Mesh Tools (Pro)` 3. The **Auto Correct Pivots** tab is shown by default 4. Set the root object and adjust the threshold if needed 5. Click **Analyze** to scan the hierarchy -- the results list shows each mesh with its offset distance 6. Review the results -- click any item to ping/select it in the Hierarchy 7. Click **Apply All Corrections** to batch-correct all meshes above the threshold 8. Use **Ctrl+Z** to undo the entire operation if needed ### What Gets Skipped * Meshes with offset below the threshold * GameObjects with a SkinnedMeshRenderer (bone-based skinning would break) * MeshFilters with no mesh assigned or with zero vertices ### Notes * Corrected meshes are saved as `.asset` files in `Assets/CorrectedPivots/`. You can safely delete this folder to reclaim disk space -- the meshes are referenced by the scene. * If multiple GameObjects share the same source mesh, each receives its own corrected copy. * The operation works correctly on rotated and scaled objects, including objects deep in nested hierarchies. *** ## Tab 2: Mesh Separator

Mesh Separator with color-coded island preview in the Scene view — 18 islands detected on a machine assembly

### Overview CAD imports and mesh-baking tools often produce a single mesh containing multiple disconnected parts. The Mesh Separator detects these disconnected islands using a Union-Find algorithm with configurable vertex welding and lets you split them into individual GameObjects. You can also reverse the process by merging multiple child meshes into one combined mesh. ### Key Features * **Island Detection** -- Automatically finds disconnected mesh regions using vertex connectivity analysis * **Color-Coded Preview** -- Each island is highlighted with a unique color overlay and wireframe in the Scene view * **Selective Separation** -- Choose which islands to separate using per-island toggles * **Mesh Merging** -- Combine multiple child MeshRenderers into a single mesh on the parent * **Vertex Attribute Preservation** -- Normals, tangents, UVs (all channels), vertex colors, and bone weights are preserved * **Sub-Mesh & Material Support** -- Material assignments and sub-mesh structure are maintained during separation ### Settings * **Weld Threshold** -- Vertices closer than this distance (in meters) are treated as the same point for connectivity detection. Default: `0.0001`. Increase this value if islands that should be connected are being split apart. * **Delete Original Mesh** -- When enabled, the original MeshFilter and MeshRenderer are removed after separation. When disabled (default), the original renderer is simply disabled. * **Auto Preview** -- Automatically updates the island preview whenever you select a new object. ### Islands Shows the detected islands with color swatches and vertex/triangle counts. Use the checkboxes to select which islands to separate. The **All** and **None** buttons quickly toggle all islands. ### Actions * **Separate All** -- Separates every detected island into its own child GameObject * **Separate Selected** -- Separates only the checked islands * **Merge Child Meshes** -- Combines all child MeshRenderers into one mesh on the selected parent object ### Workflow 1. Select a GameObject with a combined mesh in your scene 2. Open `Tools > realvirtual > Mesh Tools (Pro)` and switch to the **Mesh Separator** tab 3. The preview activates automatically, coloring each island in the Scene view 4. Toggle individual islands on/off using the checkboxes 5. Click **Separate All** or **Separate Selected** 6. The separated parts appear as child GameObjects with individual meshes ### Common Use Cases * **CAD Assembly Splitting** -- Break apart imported CAD models that were exported as a single combined mesh into individual parts for animation or interaction * **Drive Assignment** -- Separate a combined mesh so each part can be assigned to its own Drive component for independent motion * **Selective Export** -- Split a mesh to isolate specific parts for GLB export or WebViewer usage * **Performance Optimization** -- Merge previously separated parts back into one mesh to reduce draw calls * **Sensor Preparation** -- Create individual colliders per part by separating the mesh first *** ## See Also * [Duplicate Finder (Pro)](/basics/user-interface/duplicate-finder.md) * [Mesh Optimizer (Pro)](/components-and-scripts/performance-tools/mesh-optimizer-pro.md) * [Combine Meshes (Pro)](/components-and-scripts/performance-tools/combine-meshes-pro.md) --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://doc.realvirtual.io/basics/user-interface/mesh-tools.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.