Description

Break Apart separates large attached mesh objects into smaller chunks using one or more staged processing passes.
The tool is designed for heavy architectural visualisation scenes where large masterplan meshes can become difficult to manage.

On massive scenes, such as a city 3d model, use Break Apart to split the model into chunks and then do a final Element Explode on these smaller chunks using the SiNi Sculpt – Explode Elements tool.

Technical Requirements

Licence Requirements

This tool requires an active SiNi user account and a valid licence.

Supported Licences

• All Access Subscription
• IgNite Subscription
• Forensic (Free) Licence

The script will not function unless you are logged into the SiNi Desipher Licence Manager within 3ds Max.
If a valid licence cannot be found, functionality will be disabled until a licence is activated.

Activating Your Licence

1. Create a SiNi account at SiNiSoftware.com.
2. Download the latest SiNi installer.
3. Install SiNi into your version of 3ds Max.
4. This installs the SiNi Desipher Licence Manager.
5. Launch 3ds Max.
6. Open the Desipher Licence Manager.
7. Sign in using your SiNi account credentials.
8. Once your licence has been validated, the script will become available for use.

Installation

ZIP Package Contents

• MacroScript Version
• Documentation

Installing the MacroScript Version

1. Extract the ZIP file.
2. There are two options to install MacroScript .MZP files.
   – Drag and Drop the MacroScript .MZP file into a 3ds Max viewport.
   – Run the Script from the Command Panel; Utilities/MAXScript/Run Script.
3. Open Customise → Customise User Interface.
4. Select the Sinilab_Scripts category.
5. Drag the tool onto a toolbar, quad menu or menu.

Rollout Reference

Configures staged geometry chunking and output generation.

Passes
Defines how many chunking stages are applied to the selected geometry.

Pass 1–5
Selects the chunk count for each processing pass:

• 2 Chunks
• 4 Chunks
• 8 Chunks

Add Pass (+)
Adds an additional chunking stage.

Remove Pass (-)
Removes the selected chunking stage.

Analyse
Inspects the selected object and reports element information before processing.

Prefix
Defines the naming prefix used for generated output objects.

Center Pivots
Moves generated object pivots to the centre of each output object’s bounding box.

Break Apart
Processes the selected geometry using the configured pass structure.

Typical Workflows

Split a Large Masterplan

1. Select the attached masterplan object.
2. Click Analyse to review the geometry.
3. Configure one or more chunking passes.
4. Set an output prefix.
5. Enable Center Pivots if required.
6. Click Break Apart.
7. Review each checkpoint and continue until processing is complete.

Create Progressive Chunk Stages

1. Select a large attached mesh.
2. Add multiple passes.
3. Use 4 or 8 chunk passes for large datasets.
4. Review each stage using the checkpoint dialogues.
5. Choose whether to preserve the previous pass geometry.
6. Continue until the desired chunk size is reached.

Troubleshooting

The Break Apart button is disabled.
Verify that a valid SiNi licence is active in the Desipher Licence Manager.

No geometry is created.
Ensure an object is selected and contains valid mesh elements.

The operation is slow on very large scenes.
Use additional chunking passes to reduce the amount of geometry processed per stage.