The Simple Model Viewer is a user-friendly ICE Igloo Control Panel application designed for viewing simple 3D models within an immersive Igloo Environment. With an easy drag-and-drop setup, it allows users to navigate through 3D models from different angles.
...
GLTF / GLB: Vastly preferred and most compatible.
...
Untested, future support planned:
OBJ: Optionally with associated MTL files.
...
Drag & Drop: Drag the desired 3D model file from the supported file types onto the loader page.
Select: Click on the model in the left sidebar to select it. The selected model will be loaded across all other pageswithin the Igloo environment as well.
...
Interacting with the Model
Control Panel
...
Utilise the functions available on the loader page to interact with the model, allowing you to manipulate and view the model in various ways.
Real-time
...
Updates
Changes made through the loader page will be reflected
...
within the Igloo environment in real-time.
Available Settings
The available settings for the model are located on the right panel of the loader page.
Auto Save: Enables automatic saving of any changes made to the model.
Background:
Transparent Toggle: Enable or disable a transparent background.
Background Colour: Select a custom background colour from a colour picker.
Select Image Button: Opens a file picker, allowing you to select a 360° equirectangular image as the background.
Lighting
Intensity: Adjust the lighting intensity on the model.
Radius: Modify the lighting radius to control the spread of light.
...
Navigation Controls
Move Around: Use the
W
,A
,S
,D
keys.Move Up & Down: Use the
Q
andE
keys.
...
Navigate to Loader Page: Open the Simple Model Viewer and navigate to the loader page.
Drag & Drop: Drag the entire folder containing the downloaded model file onto the loader page. The Simple Model Viewer will access the necessary files within the folder to load the model.
Select & View: Click on the model in the left sidebar to select and view it in the Igloo Environment.
Advanced Configuration
Adding the Simple Model Viewer to Igloo Control Panel
To incorporate the Simple Model Viewer into the Apps section of the Igloo Control Panel, follow these steps and then restart Igloo Control Panel:
Update the custom_browsers.json
File:
Copy the configuration below (remember to add as a comma-separated item if there are other browsers in the file):
Code Block | ||
---|---|---|
| ||
{
"modelViewer": {
"name": "Model Viewer",
"url": "$remoteIP:800/model-viewer/control/",
"icon": "cube_map",
"description": "Simple 3D Model Viewer"
}
} |
Info |
---|
For more details on custom browser configuration, please refer to the Igloo Control Panel browsers documentation. |
Update the config.json
File:
Add to the Apps Section: Locate the apps
section of the config.json
file, and add "modelViewer"
to the list of apps. For example:
Code Block | ||
---|---|---|
| ||
"controlPanel": {
"tabs": [
"default"
],
"apps": [
"matterport",
"streetview",
"warping",
"modelViewer",
"default"
],
"_defaultOverrides": {}
}, |
Endpoints
Interact with the Simple Model Viewer through the following endpoints:
model-viewer/control/
: Access the control panel interface for in-depth customization.model-viewer/orbitorbitview
: Render a single frame orbit view, particularly the 'front' camera of the cubemap.model-viewer/iglooview/
: A dedicated cubemap viewer for Igloo Environment.