Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

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.

...

  1. Drag & Drop: Drag the desired 3D model file from the supported file types onto the loader page.

  2. 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 and E keys.

...

SketchFab is an online platform to find with a wide variety of 3D models. You can browse, purchase, or download free models that suit your needs.

...

  1. Navigate to Loader Page: Open the Simple Model Viewer and navigate to the loader page.

  2. 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.

  3. 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
languagejson
{
  "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
languagejson
"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.