Skip to main content

3D Models

Exhibit supports interactive 3D models, so you can present physical artefacts, sculptures, and architectural heritage alongside high-resolution 2D images, audio, and video.

In the editor and the standalone viewer (/view), you can freely rotate, pan, and zoom around 3D objects. In published exhibits, camera controls are locked to the views you frame so visitors can scroll or step through your story without accidentally shifting the model.

Supported format: Binary glTF (.glb)

Exhibit supports 3D objects in glTF Binary (.glb) format. A .glb file packages the 3D mesh geometry, materials, textures, and lighting information into a single file for fast web delivery.

You can source or export .glb models from:

  • Museum and cultural portals: Smithsonian 3D, Europeana, and the British Museum.
  • 3D communities: Sketchfab, where many cultural heritage scans are available under Creative Commons licences.
  • 3D scanning and modelling tools: Photogrammetry and 3D software such as Polycam, RealityCapture, Metashape, or Blender.

Adding 3D models to an exhibit

Importing via a IIIF 3.0 manifest

Exhibit supports 3D canvases defined within IIIF Presentation API 3.0 manifests, where a canvas paints a Model body with format model/gltf-binary:

{
  "id": "https://example.org/iiif/3d-canvas/1",
  "type": "Canvas",
  "width": 1000,
  "height": 1000,
  "items": [
    {
      "id": "https://example.org/iiif/3d-annotation/1",
      "type": "AnnotationPage",
      "items": [
        {
          "id": "https://example.org/iiif/3d-content/1",
          "type": "Annotation",
          "motivation": "painting",
          "body": {
            "id": "https://example.org/models/amphora.glb",
            "type": "Model",
            "format": "model/gltf-binary"
          },
          "target": "https://example.org/iiif/3d-canvas/1"
        }
      ]
    }
  ]
}

Paste the manifest URL into the Items drawer at the bottom of the editor and select Import (see Adding Items), or upload .glb files directly if you are using a self-hosted instance.

Moving around a 3D model

Exhibit uses Google's <model-viewer> for hardware-accelerated 3D rendering.

In the editor and standalone viewer (/view)

Full camera controls are active while you are editing an exhibit or inspecting an item in /view:

ActionMouse and trackpadTouchscreen
Rotate / orbitLeft-click and dragOne-finger drag
PanRight-click and drag (or Shift + drag)Two-finger drag
ZoomScroll wheel or pinchTwo-finger pinch
Reset viewSelect the Home icon in the viewer (or double-click the background)Double-tap the background

In published exhibits

Across all templates (Kiosk, Scroll, Slides, and Quiz), manual camera orbit, pan, and zoom are locked during presentation so that:

  • scrolling with a mouse wheel or trackpad moves smoothly through the story without getting trapped inside the 3D canvas
  • the model stays aligned with the exact camera angle you framed for each step
  • quiz pinpoints stay anchored to the right spot on the surface of the object

Adding descriptions to a 3D model

Framing views on a 3D object works the same way as Adding Item Descriptions for 2D images:

  1. Select the 3D model in the Items drawer at the bottom of the editor so it loads in the viewer on the right.
  2. In the left-hand column, select the + (Add New) button to create a new step.
  3. Orbit, pan, and zoom the 3D model in the viewer until you have framed the angle, inscription, or surface detail you want to show.
  4. Type your commentary in the Comment tab (or add a question and 3D surface pinpoints if you are using the Quiz template).
  5. Select the green checkmark (✓) to save the step.

Figure 1: Orbiting a 3D model in the viewer and writing a step description

Exhibit records the exact camera orbit, target coordinates, and field of view. As visitors move from one step to the next, the camera animates smoothly between your saved perspectives.

Animated 3D models and time scrubbing

When a .glb model contains animation clips (such as moving mechanical components, opening lids, or anatomical movements), Exhibit detects the animations automatically and displays animation controls directly inside the viewer:

  • Play / Pause button: Start or pause animation playback in the editor.
  • Animation clip selector: If your model includes multiple animation tracks (for example, Idle, Open Lid, or Exploded View), a dropdown menu lets you choose which sequence to play.
  • Time scrubber slider: Drag the scrubber along the timeline to pinpoint an exact frame or pose. The live timestamp indicator displays your current position alongside total duration (for example, 5.50s / 14.58s).

Capturing animated poses in story steps

When you save a story step while viewing an animated model, Exhibit captures both the camera angle and the exact animated state:

  1. Scrub the timeline to the desired moment in the animation.
  2. Frame your camera angle using orbit, pan, and zoom.
  3. Save the step.

Exhibit saves the animation name (anim=) and timestamp (t=) into the step's framing target. When visitors view or scroll into that step, Exhibit seeks the 3D model directly to that timestamp, freezing or playing the animation at that exact pose.

3D surface pinpoints

In the Quiz template, you can challenge visitors to identify specific details directly on the surface of a 3D object using interactive pinpoints (hotspots):

  1. Switch to the Quiz template or open the Quiz tab in the step editor.
  2. Double-click anywhere on the surface of the 3D model to drop a pinpoint.
  3. Exhibit calculates the precise 3D surface coordinates (data-position) and surface normal orientation (data-normal), anchoring the hotspot badge so it rotates and scales naturally with the model.
  4. Drag existing pinpoints across the 3D surface in the editor to fine-tune their placement.

Examples

  • Dionysus (Quiz) — Explore an Attic black-figure neck amphora with 3D surface pinpoints and guided camera orbits.
  • Dionysus (Slides) — A slide presentation combining a 3D vessel with deep-zoom paintings, video, and audio.