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.
Load Model
Selecting this will expand the “Load Model” menu:
From here there are six preset models that you can load to get a feel for how to use the software.
If instead you would like to load your own custom model, simply click the “Load model” button at the bottom to load in your own model. If you would like to use this model consistently, you can use the “Save model” button to save and overwrite one of the existing preset models.
Once you have loaded a model, the buttons that are greyed out will become active.
Save Viewpoint
This will save the current orientation and scale of the model, meaning the next time you load it in, you will not have to apply the effects again.
Load Background
Here there are some preset backgrounds that you can select from. Alternatively, if you would like to upload your own equirectangular images (.png, .jpg, or .hdri) then you can click the “Load background” button to select a custom image to use.
It is recommended to use as high quality images as possible.
Remove Background
This button will simply remove any custom background you have loaded in and will return to the grey background.
Transform Model
The transform model tab will allow you to transform the model’s scale and rotation.
The buttons at the top (0.1x, 10x and 100x) will change the slider values from 0.1-1, 1-10, and 10-100 allowing you full control over the scale of the object.
The rotation buttons will allow you to quickly rotate an object in any of the axis by 90 degrees.
The reset button will reset all rotation and scale values back to the default.
Camera Movement
Camera movement will allow you to control the position of the igloo viewer from within a pop out menu. Simple press in the direction you would like to go and the camera will move in that direction until you press a different button, or press the same button again.
Jump to centre of the model will jump you to the centre most point of the model.
Viewing Mode
Viewing mode will allow you to change how you view the object.
Flythrough - standard ghost mode where you can fly in any direction wherever you cursor is facing.
Wrap - this will change the wrap within the space of the model, for example if you wanted to move the object onto a different wall.
Orbit - This will give you orbit controls so you can move relative to the centre of the object. Simple click and drag to orbit around an object.
Room Generation (Work in progress, but mostly working)
Room generation will allow you to create a room for your space given you have the exact room dimensions. Put in the values for the width, depth and height and you can generate a room with the correct perspective.
Materials of the walls and floor can be changed by clicking the corresponding buttons.
You can also generate artwork for the room to give the feel of a virtual gallery. Simply put an image in the streamingassets folder names CustomArtwork1, CustomArtwork2 or CustomArtwork3 and they will appear in frames on the walls.
To do: Add additional parameters so image names can be extracted and shown on nameplates beneath the photo.
Render Streaming
Stream - Allows for the Model Viewer to be controlled 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"
Additional command line arguments
-presetModel [0-5] - Will automatically load the preset model from the specific slot. Example: “-presetModel 2” will load the skeleton model.
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
0 Comments