Exercise

Here we are going to practically show a modification of a 3D IIIF manifest and how it can be viewed in multiple viewers. This will require a GitHub account, so please make one if you have not already.

We will use the manifest https://raw.githubusercontent.com/IIIF/3d/main/manifests/4_transform_and_position/model_transform_translate_scale_position.json for this exercise.

1. Copy the model URL to your clipboard. Go to IIIF 3D Manifest URL Tester and paste the model into the field there. This will give you links to view the manifest in different viewers. Look at how the manifest is displayed in one or more viewers.
2. Now open the manifest JSON directly in your browser and examine its structure.
3. Next, we will modify the manifest - not by editing the JSON directly, though! We will load it in a demo IIIF-enabled version of Smithsonian's Voyager scene editor for editing 3D scenes on the web: Scene Editor
4. In the Scene Editor, try moving one of the two astronauts relative to the other.
5. Once you are happy with your changes, click the download button to save a new IIIF manifest with your changes included.
6. To get your new manifest a URL, we are going to create a new GitHub Gist. Go to https://gist.github.com/ and paste your new manifest JSON into the text area. Give it a name like "My Modified 3D Manifest" and click "Create public gist". Then click the "Raw" button and copy into your clipboard the URL of the page it takes you to. This is a URL for your manifest JSON that you can load into a variety of viewers.
7. Now go back to the IIIF 3D Manifest URL Tester and paste your new manifest URL into the field. This will give you links to view your modified manifest in different viewers. Try out your new manifest in one or more viewers.
8. Finally, open the manifest JSON directly and examine its structure. Compare to the original manifest to see what changed!

Additional Resources

We've put together a Google Doc with a wide array of other resources. Below, you'll also find a sub-section of those resources most appropriate to the exercise above.

• Additional resources document

3D Manifests

All of the 3D TSG manifests can be found here, but we list specific useful manifests and some manifests outside the 3D TSG collection below.

• Single Model in Scene: https://raw.githubusercontent.com/IIIF/3d/main/manifests/1_basic_model_in_scene/model_origin.json
• Stanford Handaxe: https://veholder.org/iiif3d/stanford-axe2.json

Easily Combine Manifest with Viewer URL

Paste a manifest URL in this tool and it will give you links to all the viewers loading that manifest.

• IIIF 3D Manifest URL Tester: https://veholder.org/iiif3d/test.php

Interactive Web Scene Editor Demo with IIIF Input/Output

The Smithsonian has put together a demo version of their web scene editor that can take in IIIF manifests as input data and download IIIF manifests of modified scenes. You can use this to import a 3D scene from a IIIF manifest, change things around, and save the modified scene as a new IIIF manifest document.

• New Empty Scene: https://si-iiif-demo.glitch.me/
• To Import Custom Manifest URL: https://si-iiif-demo.glitch.me/?document=

Viewers

These links won't load any content, they need manifests supplied!

• MorphoSource Aleph + UV: https://www.morphosource.org/uv/uv.html#?manifest=
• Smithsonian Voyager: https://smithsonian.github.io/dpo-voyager/docs/iiif_demo?document=
• UV + Google Model Viewer: https://uv-v4.netlify.app/#?manifest=a
• X3D: https://spri-open-resources.s3.us-east-2.amazonaws.com/iiif3dtsg/manifest/index.html#?manifest=
• Kompakkt: https://blacklodge.hki.uni-koeln.de/viewer/?locale=en&standalone=true&manifest=