glTF GLB Importer

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 three 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

Imports GLB files and manages scale conversion during import.

File

Selects the GLB file to import.

Pick

Opens a file browser and allows a GLB file to be selected.

Scene / GLB Units

Displays the current scene unit configuration.

Scene Units

Displays the active display units used by the scene.

System Units

Displays the active system units used by 3ds Max.

Default GLB Scale

Displays the stored default scale used when importing GLB files.

Import Settings

Controls how imported assets are scaled and processed.

Scale %

Sets the scale multiplier applied during import.

Use this control when imported assets are too large or too small for the current scene.

Default Import Scale

Displays the currently saved default import scale percentage.

Material

Selects the material conversion method.

Auto Detect Renderer

Automatically creates materials suitable for the active renderer.

Renderer

Displays the renderer currently assigned to the scene.

Current Renderer

Reports the renderer detected by the importer.

Import GLB

Imports the selected GLB file using the current settings.

Imported Model Size

Displays the dimensions of the most recently imported asset.

Width

Displays the imported model width.

Depth

Displays the imported model depth.

Height

Displays the imported model height.

Uniform Scale %

Applies a scale multiplier used when calculating a new default import scale.

Set/Update Default Scale

Stores the current scale configuration as the new default import scale.

Use this after finding the correct import scale for a particular asset library. Future imports will automatically use the saved scale value.

Typical Workflows

Import a GLB Asset

1. Open the glTF/GLB Importer.
2. Click Pick and select a GLB file.
3. Verify the Scene Units and System Units.
4. Adjust Scale % if required.
5. Confirm the detected renderer.
6. Click Import GLB.
7. Review the Imported Model Size values.

Create a New Default Scale

1. Import a GLB asset.
2. Adjust the Scale % value until the model imports at the correct size.
3. Enter a Uniform Scale % value if required.
4. Click Set/Update Default Scale.
5. Future imports will use the saved scale value automatically.

Troubleshooting

My model imports at the wrong size

Check the Scene Units and System Units displayed by the importer. Adjust the Scale % value and save a new default scale if required.

Materials do not match my renderer

Ensure the correct renderer is active before importing. The importer uses the active renderer when creating materials.

Imported dimensions appear incorrect

Verify that the original GLB asset was exported using real-world units. Different applications may export GLB files using different scale conventions.

The Import button does nothing

Confirm that a valid GLB file has been selected and that your SiNi licence is active through the Desipher Licence Manager.