Document toolboxDocument toolbox

Unity 3D Model Viewer

The Model Viewer Pro is a Unity Based application which has been designed to seamlessly import and display a wide range of 3D model formats, and supports both 2D and 3D projection. This is a licensed piece of software requiring a Cryptlex license to run.

Installing & Starting The Model Viewer

Download from here, and run the installer.

Formats

The model viewer supports the below formats:

Please note these haven’t been extensively tested yet. There is also a work in progress USD(Z) importer.

How to load a model

To load a model in you simply click the “Load Model from File” button at the top on the server display. After which you will shown a file browser to navigate to the desired location.

image-20240503-101436.png

Features

Load Model from File - Loads the desired 3D model from a location on the server.

Save Placement - Saves the rotation and scale of an object. (Will automatically load if the object is loaded back into the scene)

Load Skybox from File - Load a HDRI file as the skybox.

Object Scale - Change the scale of the object uniformly (x,y,z)

0.1x - Scale factors of 0.1-1.

10x - Scale factors of 1-10.

100x - Scale factors of 10-100.

Rotate - Quick rotate buttons.

X - Spin the object in the X axis 90 degrees.

Y - Spin the object in the Y axis 90 degrees.

Z - Spin the object in the Z axis 90 degrees.

Start Streaming - Allows for the Model Viewer to be controller from ICE Control Panel with a mouse and keyboard and same controls. This will need to be setup as an app in ICE Control Panel as a custom browser in custom_browers.json:

    "ModelViewerPro": {       "name": "Model Viewer Pro",       "url": "$remoteIP/receiver/index.html",       "https": false,       "icon": "$ai/image.png",       "description": "Model Viewer Pro"     }

And in the config.json:

    "apps": [       "matterport",       "streetview",       "warping",       "default",       "modelViewer",       "openStageControl",       "blockade",       "ModelViewerPro"     ],

A web server will start automatically when you press start streaming which is located here:

C:\Program Files\Igloo Vision\Model Viewer Pro\Model Viewer Pro_Data\Managed\webserver.exe

Watch Folder

A watch folder can be setup in “C:\Program Files\Igloo Vision\Model Viewer Pro” so that any model of an accepted format automatically gets loaded in once it has been copied into that folder. Simply create a new folder and call it “WatchFolder”.

Command Line Arguments

You can add command line arguments to the .exe for the model viewer to specify loading a model as soon as the application is opened. To do this simply add the “-loadModel” argument, followed by the path of the model you want to open. e.g:
-loadModel "C:\ModelViewer\ModelViewer-0.22\Igloo3DModels\Architecture\hintze_hall\scene.gltf"

Templates

Templates can be used to set specific rotation, scale or translation values to an object whenever it is imported. To select a template simply use the drop down box and select from a existing one (not tested). To create you own, navigate to the StreamingAssets folder, and open an existing template, alter the values as necessary, and save it under a new template name. The template must be save with “config_” first. e.g: “config_[Your_Template_name].json”. The drop down box in Model Viewer Pro will auto populate with any files saved this way.

{   "scale": {"x": 1, "y": 1, "z": 1},   "rotation": {"x": 0, "y": 90, "z": 0},   "translation": {"x": 0, "y": 0, "z": 0} }

Controls

Movement - As is with every other Igloo application.

Right click / B button - Change movement mode. Pressing it once will update the cursor to correlate to the mode. Pressing it will swap to the next mode and loop back to the start when no more modes are available.

Standard - Aim where you want to go.

Wrap - Change the wrap position by pointing left or right.

Orbit - Move round the object in an orbit mode.

Need any help?

Contact the support desk or jon@igloovision.com

 

(c) Igloo Vision Ltd. 2023