Simple Model Viewer

The Simple Model Viewer is a user-friendly 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.

Supported File Types

GLTF / GLB: Vastly preferred and most compatible.

Untested, future support planned:

OBJ: Optionally with associated MTL files.

IFC: Supported but might require additional settings.
STL: Compatible with standard configurations.

Usage Instructions

Loading the Model

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

Using SketchFab as a Resource for 3D Models

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

Downloading Models from SketchFab:

Find a Model: Browse through SketchFab's extensive library and select a model that is compatible with the Simple Model Viewer's supported file types.
Download: If the model is available for download (free or purchased), click the 'Download' button on the model's page.
Choose a Format: Most models on Sketchfab are available to download using the GLTF format, where available use this.
Extract if Necessary: Some models may download in a compressed file format. Extract the files using a program like WinRAR or 7-Zip.

Adding a Downloaded Model to Simple Model Viewer:

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):

{
  "modelViewer": {
    "name": "Model Viewer",
    "url": "$remoteIP:800/model-viewer/control/",
    "icon": "cube_map",
    "description": "Simple 3D Model Viewer"
  }
}

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:

"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/orbitview: Render a single frame orbit view, particularly the 'front' camera of the cubemap.
model-viewer/iglooview/: A dedicated cubemap viewer for Igloo Environment.