Shot Cleanup Pro Documentation

Technical Requirements

Licence Requirements

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

Supported Licences

• All Access Subscription
• IgNite Subscription

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

1. Camera Setup

Selects the camera and defines how visibility analysis is performed.

Use Active View

Uses the active viewport camera.

Pick Camera

Selects a scene camera for analysis.

Camera

Displays the currently assigned camera.

Camera Mode

Selects the camera analysis mode:

• Still Camera — Analyses the current frame only.
• Moving Camera — Samples the camera over a timeline range.

Timeline Sampling

Defines the frame range and sampling interval used when analysing animated cameras.

Start

Defines the first frame to analyse.

End

Defines the last frame to analyse.

Step

Defines the frame interval used during analysis.

2. Object Filters

Filters which scene objects are included during analysis.

Geometry Only

Analyses geometry objects only.

Ignore Hidden

Skips hidden objects.

Ignore Frozen

Skips frozen objects.

Ignore Shapes

Skips shape objects when Geometry Only is disabled.

Ignore Helpers

Skips helper objects when Geometry Only is disabled.

Ignore Lights

Skips light objects when Geometry Only is disabled.

Ignore Cameras

Skips camera objects when Geometry Only is disabled.

Exclude Selected

Excludes the current selection from analysis.

Skip Group Heads

Skips group containers during analysis.

3. Analysis Settings

Controls how visibility calculations are evaluated.

Edge Safety %

Adjusts the camera-frustum safety margin.

Higher values preserve more objects around the edge of the camera view.

Lower or negative values produce a tighter cleanup result.

Analyse Scene

Runs the visibility analysis using the current settings.

4. Results and Cleanup

Displays analysis results and provides cleanup actions.

Results Counters

Displays object totals for:

• Inside
• Partial
• Outside
• Skipped

Preview Camera Visibility

Temporarily colours objects based on visibility status.

• Green = Inside / Partial
• Red = Outside

Running the command again restores original wire colours.

Select Inside Cam

Selects all objects classified as Inside.

Select Outside Cam

Selects all objects classified as Outside.

Add Inside

Adds Inside objects to the current selection.

Add Outside

Adds Outside objects to the current selection.

Refine Viewport Frame

Updates the viewport framing to better match the analysed camera region.

Delete Outside

Deletes all Outside objects.

The tool automatically creates a temporary backup before deletion.

Hide Outside

Temporarily hides all Outside objects.

Running the command again restores visibility.

Clear Results

Clears the current analysis results.

Reset Tool

Restores default settings and clears temporary states.

Save Scene As

Creates a cleaned copy of the scene as a new MAX file.

Typical Workflows

Clean a Still Camera Scene

1. Open Shot Cleanup Pro.
2. Click Use Active View or Pick Camera.
3. Set Camera Mode to Still Camera.
4. Adjust Edge Safety % if required.
5. Click Analyse Scene.
6. Review the Inside, Partial and Outside counts.
7. Use Preview Camera Visibility to inspect the result.
8. Hide or delete Outside objects.
9. Save the cleaned scene.

Clean an Animated Camera

1. Select the animated camera.
2. Set Camera Mode to Moving Camera.
3. Review the Start, End and Step values.
4. Click Analyse Scene.
5. Allow the tool to sample the camera path.
6. Review the visibility results.
7. Use Preview mode to validate the analysis.
8. Hide or delete Outside objects.
9. Save a cleaned version of the scene.

Troubleshooting

Why are objects near the edge of the frame classified as Outside?

Increase the Edge Safety % value and run the analysis again.

Why does animated camera analysis take longer?

Moving Camera mode evaluates multiple frames across the timeline rather than a single frame.

Why are some objects skipped?

Skipped objects are excluded by the active filter settings.

Can I restore deleted objects?

Delete Outside creates a temporary backup before deletion, allowing restoration during the current cleanup workflow.

Why are objects coloured red and green?

Preview Camera Visibility temporarily colours objects to visualise the analysis results. Running the command again restores the original wire colours.