1.11.3 Konfiguration der Bildanzeige

Für die Bildanzeige kommt OpenSeadragon basierend auf der IIIF Image API zum Einsatz. Für die Anzeige existiert ein eigener Konfigurationsblock, im Abschnitt <viewer>

Goobi viewer Installationen, die das Crowdsourcing-Modul nutzen, können die Bildanzeige dort unter <zoomCrowdsourcingView> separat konfigurieren, sofern gewünscht.

Der Konfigurationsblock hat folgende Form:

config_viewer.xml

<viewer>
    <zoomImageView type="default" tileImage="true" footerHeight="50">
        <scale>300</scale>
        <scale>900</scale>
        <scale>1800</scale>
        <scale>3200</scale>
        <useFor>
            <!--view>fullscreen</view-->
            <!--mimeType>image/png</mimeType-->
        </useFor>
        <tileSize>
            <scaleFactors>4</scaleFactors>
            <size>1024</size>
        </tileSize>
        <navigator enabled="false" />
        <thumbnailGallery enabled="false" />
        <doublePageNavigation enabled="true" default="false" />
    </zoomImageView>
</viewer>

Die Parameter sind in der folgenden Tabelle im einzelnen erklärt:

Option	Beschreibung
@type	Gibt an welcher Typ die Bildanzeige haben soll. Mögliche Optionen sind default und sequence. Die Standardbildanzeige ist default während der Wert sequence eine Navigation durch die Bilder ohne Neuladen der Seite ermöglicht. Dabei kann zwischen den Bildern im Bildcontainer mit scrollen nach oben und unten navigiert werden. Standardwert ist default.
@tileImage	Legt fest, ob das Bild als ganzes oder gekachelt angezeigt werden soll.
@footerHeight	Die absolute Höhe des Footers in Pixeln. Um den Footer ganz auszuschalten, kann man hier einen Wert von "0" eingeben.
/scale	Diese Konfiguration wird nur für tileImage="false" berücksichtigt. Dann gibt sie die Breite des angezeigten Bildes in Pixeln an. Dies ist nicht die Breite der Bildanzeige, die im HTML Code festgelegt wird, sondern die Größe des Bildes, das zur Anzeige geladen wird.Diese Konfiguration ist beliebig wiederholbar, um das Bild in verschiedenen Auflösungen anzuzeigen. Größere Versionen des Bildes beim Zoomen der Bildanzeige werden nachgeladen.
/tileSize	Diese Konfiguration wird nur für tileImage="true" berücksichtigt. Sie besteht aus zwei Teilkonfigurationen: scaleFactors und size.
/navigator/@enabled	Sofern aktiv, steht innerhalb der Bildanzeige eine kleine Vorschau zur Verfügung, die anzeigt wo man sich im Gesamtbild gerade befindet. Standardwert ist false.
/thumbnailGallery/@enabled	Sofern aktiv, steht innerhalb der Bildanzeige eine Thumbnailnavigation zur Verfügung. Diese Einstellung ergibt nur mit dem type="sequence" Sinn. Standardwert ist false.
/doublePageNavigation/@enabled	Wenn ein Werk mehr als ein Bild besitzt kann es in einer Doppelseitenansicht angezeigt werden. Die Unterstützung dafür kann mit dem enabled-Attribut global ein- und ausgeschaltet werden. Standardwert ist true.
/doublePageNavigation/@default	Mit dem default-Attribut kann gesteuert werden, ob die Doppelseitenansicht auch standardmäßig beim Öffnen eines Werkes aktiv ist. Standardwert ist false.

scaleFactors ist eine Komma-separierte Liste von Skalierungsfaktoren, um die die Kacheln für die Anzeige verkleinert werden. Werden zum Beispiel die Faktoren 1 und 32 angegeben, werden erst Kacheln angezeigt, die das Bild in der Verkleinerung 1/32 anzeigen. Beim Heranzoomen werden diese Kacheln ersetzt durch solche, die das Bild in voller Auflösung zeigen. Es ist üblich, aber nicht zwingend erforderlich, in Zweierpotenzen zu skalieren. Diese Werte sind jedoch nur Richtlinien für die zugrunde liegende OpenSeadragon Implementierung, die in der Regel mehrere Vergrößerungen zwischen den angegebenen Werten verwendet.

size bestimmt die Größe der einzelnen Kacheln in Pixeln. Welchen Ausschnitt des tatsächlichen Bildes sie dabei abbilden, hängt von dem verwendeten scaleFactor ab. Bei einem scaleFactor von 4 und einer size von 512, wird ein 2048 mal 2048 Pixel großer Ausschnitt des Originalbildes pro Kachel angezeigt.

Diese Konfiguration ist beliebig wiederholbar, wenn man verschiedene Kachelgrößen verwenden möchte.

Standardmäßig werden für eine konsistente Anzeige die Bilder immer auf die Breite des Bildcontainers skaliert. Allerdings führt das zu Problemen, wenn zum Beispiel ein Buchrücken oder ein innen liegendes Leporello digitalisiert werden. Dann sind die angezeigten Bilder entweder riesig groß und lang, oder extrem schmal und breit.

Um diesem Effekt entgegenzuwirken beschränkt der Goobi viewer die Bildanzeige nun auf eine Höhe von 1200px sobald bestimmte Schwellwerte überschritten werden. Der Schwellenwert wird berechnet, in dem die Bildbreite durch die Bildhöhe geteilt wird. Er wird mit dem folgenden Konfigurationselement gesetzt:

config_viewer.xml

<viewer>
    <limitImageHeight lowerRatioThreshold="0.3" 
                      upperRatioThreshold="3.0">true</limitImageHeight>
</viewer>