Versions Compared

Old Version 1

changes.mady.by.user Harry Halliday

Saved on

compared with

New Version 2

changes.mady.by.user Harvey Buchan

Saved on

Key

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

(draft documentation)

Supported filetypes:

  • gltf / glb (vastly preferred)

  • obj (optionally with mtl)

  • ifc

  • stl

Endpoints

model-viewer/loader - control panel interface

model-viewer/orbit - single frame orbit view (renders ‘front’ camera of cubemap)

model-viewer/viewer - cubemap viewer (for ICE)

Usage

Drag a model onto the loader page, then click it in the sidebar. Will be loaded on all other pages. Use loader page functions to interact with model - these are reflected on other endpoints. WASD/QE move around and up/downThe Simple Model Viewer is a user-friendly ICE 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.

  • OBJ: Optionally with associated MTL files.

  • IFC: Supported but might require additional settings.

  • STL: Compatible with standard configurations.

Usage Instructions

Loading the Model

  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 sidebar to select it. The selected model will be loaded across all other pages.

Interacting with the Model

  • Control Panel: Utilise the functions available on the loader page to interact with the model.

  • Real-time Reflection: Changes made through the loader page will be reflected across other endpoints.

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 to find a wide variety of 3D models. You can browse, purchase, or download free models that suit your needs.

Downloading Models from SketchFab:

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

  2. Download: If the model is available for download (free or purchased), click the 'Download' button on the model's page.

  3. Choose a Format: Most models on Sketchfab are available to download using the GLTF format, where available use this.

  4. 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:

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

  2. Drag & Drop: Drag the downloaded model file onto the loader page.

  3. Select & View: Click on the model in the sidebar to select and view it in the Igloo Environment.

Advanced Configuration

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/orbit: Render a single frame orbit view, particularly the 'front' camera of the cubemap.

  • model-viewer/iglooview/: A dedicated cubemap viewer for Igloo Environment.