Overview
IIIF 3D Editor is a web-based application for viewing and annotating 3D models using the IIIF (International Image Interoperability Framework) standard. This tool allows you to load 3D models, create annotations, link textual data, and manage resources in an integrated environment.
Key Features
1. 3D Model Viewing
- Load 3D models via IIIF Manifest URLs
- Interactive rotation, zoom, and pan controls
- Support for various 3D file formats through IIIF manifests
- Toggle between sprite and polygon annotation modes
2. Annotation System
- Sprite Annotations: Click on the 3D model to create point-based annotations
- Polygon Annotations: Draw custom polygons with arbitrary points by clicking multiple times (double-click or press Enter to finish)
- Edit annotation titles and descriptions using a rich text editor
- Toggle annotation visibility with the eye icon
- Switch between annotation modes using the toggle button
3. TEI/XML Text Editor
- Upload TEI/XML files to display textual content alongside 3D models
- Diplomatic View: Shows abbreviated text in uppercase (e.g., "D M")
- Transcription View: Shows full expansions with parentheses (e.g., "D(is) M(anibus)")
- Clickable line markers (🔗) for linking text lines to 3D annotations
- Only displays content from edition sections
4. Resource Management
Access via the Resources tab:
- Add images and videos related to annotations
- Upload resource data via CSV files
- View resources in a grid layout
- Click on images to view full-size versions
- Support for YouTube video embeds
5. Linked Data
Access via the Linked Data tab:
- Link annotations to Wikidata entities
- Connect to GeoNames for geographic data
- Upload authority data via CSV files
- View Wikipedia articles and external URIs
- Display geographic locations on maps
6. Bibliographic References
Access via the References tab:
- Add bibliographic citations to annotations
- Include author, year, title, and page information
- Link to web pages and PDF files
- Upload bibliography data via CSV files
7. Data Export
- RDF Export: Click the RDF logo to export annotation data as RDF/Turtle format
- IIIF Manifest: Click the IIIF logo to view the current manifest
- JSON Download: Download annotation data as JSON files
How to Use
Getting Started
- Load a 3D Model: Enter a IIIF Manifest URL in the input field at the top and press Enter or click outside the field
- Create Annotations: Click on the 3D model to create annotations (sprite mode) or use the toggle to switch to polygon mode
- Edit Annotation Details: Click on an annotation marker to view and edit its details in the right panel
- Upload TEI Text: After loading a 3D model, use the upload button in the Text Viewer to add textual content
Working with Polygon Annotations
- Toggle to polygon mode using the switch button in the top-right controls
- Click multiple points on the 3D model to draw a polygon outline
- Visual feedback shows lines connecting your points
- Double-click or press Enter to complete the polygon
- The polygon will have transparency to show underlying surfaces
Managing Resources and Data
- Use the tabs (Resources, Linked Data, References) to switch between different data types
- Click the "+" button to add new entries manually
- Click the upload button to import data via CSV files
- Click the delete button (🗑️) to remove entries
Authentication
Sign in with your Google account to save and manage annotations. All data is stored in Firebase and associated with your account.
Tips and Best Practices
- Use descriptive titles for annotations to make them easy to identify
- Link TEI text lines to annotations for better documentation
- Add Wikidata links to provide context and additional information
- Include bibliographic references to cite sources
- Export your data regularly using the RDF or JSON download features
- Use polygon annotations for complex areas that require precise boundaries
Technical Information
- Framework: Built with Next.js and React
- 3D Rendering: Three.js for WebGL-based 3D visualization
- TEI Processing: CETEIcean for TEI/XML rendering
- Database: Firebase Firestore for data storage
- Standards: Compliant with IIIF Presentation API 3.0
Need Help?
For questions, bug reports, or feature requests, please contact the development team or consult the project documentation.