In den nachfolgenden Abschnitten werden einige konkrete Anwendungsszenarien detailliert erläutert. Einige der Konfigurationen sind dabei kundenspezifisch und damit unter Umständen nicht ohne Anpassungen auf die Gesamtheit als Goobi workflow-Installationen übertragbar.

Installation des 3D-Export Plugins für Goobi

Für den Export von 3D-Objekten mit Hilfsdateien (mtl, Oberflächenbilder, ...) muss der Export mit folgendem Goobi-Export-Plugin durchgeführt werden:

plugin_intranda_export_object3d.jar

Das Plugin muss im Export-Schritt als Plugin für Arbeitsschritt eingetragen sein.

Konfiguration der METS-Dateigruppen

Damit auch 3D-Objekte beim Export mit dem 3D-Export Plugin in die METS-Datei geschrieben werden, muss in der Projektkonfiguration eine zusätzliche METS-Dateigruppe angelegt werden mit folgenden Eigenschaften:

Der Wert in Suffix muss dabei immer genau der Dateiendung der zu exportierenden 3D-Objekte entsprechen.

Anstelle von zweidimensionalen Bildern können im images Ordner auch 3D-Objekte gespeichert und in der Goobi-Oberfläche angezeigt werden. Grundsätzlich kann Goobi folgende 3D-Formate anzeigen:

Volle Unterstützung für Texturen existiert jedoch nur für die Formate .obj, .gltf und .glb. Daher sollte nach Möglichkeit eines dieser Formate verwendet werden. Für das .gltf und .glb Format wird eine DRACO-Kompression unterstützt.

Zusätzliche Ressourcen

Oft benötigt ein 3D-Objekt zusätzliche Ressourcen-Dateien um korrekt angezeigt zu werden. Dies sind üblicherweise Bilddateien für Oberflächentexturen sowie .mtl Dateien mit Materialdefinitionen für .obj Dateien. Diese Dateien sollten immer in einem eigenen Dateiordner neben der Objektdatei gespeichert werden, der genauso heißt wie die Objektdatei ohne Dateiendung. .mtl Dateien können beliebig benannt werden, während die Benennung der Bilddateien durch die 3D-Objektdatei oder die .mtl Datei vorgegeben ist.

Bekannte Probleme

• Sehr große 3D-Objekte mit über einer Millionen Kanten können von Browsern oft nicht oder nur sehr schleppend dargestellt werden. Es ist ratsam, nur kleinere Dateien in Goobi zu verwenden.

• Bei Verwendung einer .mtl Datei wird manchmal kein Bild angezeigt. Dies kann am Inhalt der .mtl Datei selbst liegen, wenn diese folgende Zeile enthält: Tr 1.0 oder d 0.0 Dies setzt die Transparenz des Objektes auf 100%, wodurch es überhaupt nicht dargestellt wird. Stattdessen muss die Zeile lauten: Tr 0.0 oder d 1.0

• Die Darstellung des Objektes kann außerdem beeinflusst werden durch folgende Zeile: illum 1 beziehungsweise illum 2 Die Option illum 1 unterdrückt spiegelnde Reflektionen am Objekt, illum 2 ermöglicht sie. Spiegelnde Reflektionen können ein Objekt überbelichtet erscheinen lassen, andererseits aber auch die dreidimensionale Gestalt hervorheben.

\

Seit einiger Zeit gibt es die Möglichkeit, in Goobi workflow Vorgangsordnern einen thumbs/ Ordner anzulegen. In diesem Ordner können thumbnails für die Bilder in den Ordnern im images/ Ordner hinterlegt werden. Dabei ist eine Namenskonvention zu beachten, die von Goobi workflow ausgewertet und zur effizienten Anzeige von Bildern genutzt wird.

Der thumbs Ordner

Ein Ordner unterhalb des thumbs/-Ordners darf nur jpg-Bilder enthalten und muss folgendem Namensschema folgen, damit er verwendet wird:

Wenn man nun zum Beispiel folgenden Ordner im images/-Ordner hat:

Müsste man für thumbnails mit der maximalen Seitenlänge von 1000 Pixeln folgenden Ordner im thumbs/ Ordner erstellen und mit passenden Bildern befüllen:

Beispiel-Konfiguration

Die Ordner und Bilder darin können mithilfe eines Script-Schrittes in Goobi workflow erzeugt werden. In dem Script-Schritt können auch mehrere Aufrufe stattfinden, um Thumbnails in mehreren Größen zu erstellen. Die folgenden Scripte erstellen thumbnails für die master-images in den Größen 800, 1600 und 3200 Pixel:

Für die Derivate erfolgen die Aufrufe analog:

Das hier genutzte Script gm-convert.sh kann hier heruntergeladen und sollte in den Ordner /opt/digiverso/goobi/scripts/ gelegt werden: