Auflösung

Die tatsächliche Auflösung eines Endgeräts kann via Browser nur unzuverlässig ermittelt werden. Insbesondere bei mehreren angeschlossenen Monitoren liefern die Komponenten Betriebssystem, Browser und Java im Zusammenspiel teilweise falsche Informationen. Die Größe eines im Viewer angezeigten Dokuments entspricht dann nicht der Größe desselben Dokuments in ausgedruckter Form. Beispielsweise besitzt ein PDF Dokument der Größe DIN A4 bei einer falsch erkannten Auflösung auf dem Monitor nicht die Größe eines DIN A4 Papierblatts.

Um dem jadice web toolkit die korrekte Auflösung des Monitors bekannt zu machen, kann der Benutzer diese über ein Widget kalibrieren. Hierfür muss die im Widget angezeigte Skalierungslinie vom Benutzer mittels eines Lineals oder eines physischen Blatts Papier auf die zugehörige Länge eingestellt werden. Damit kann die korrekte Auflösung des zugehörigen Monitors berechnet werden. Das Widget bietet außerdem die Möglichkeit, die individuell eingestellte Auflösung über einen Button sessionübergreifend zu persistieren und damit bei jedem Start der Anwendung zu setzen. Zusätzlich bietet das Widget die Möglichkeit, eine bereits gesetzte individuelle Auflösung wieder zu entfernen. Falls eine individuelle Auflösung existiert, wird diese verwendet.

Weiterhin kann im Integrationscode über die Methode setGlobalDeviceResolution der Klasse ViewerBuilder eine globale Auflösung für alle Benutzer gesetzt werden. Dies kann insbesondere dann sinnvoll sein, wenn alle Benutzer die gleichen Monitore und damit die gleiche Auflösung verwenden. Falls keine individuelle Auflösung für einen Benutzer existiert, wird die globale Auflösung verwendet.

Falls weder eine individuelle Auflösung, noch eine globale Auflösung existiert, kann über die Methode setAutoDetectResolution der Klasse ViewerBuilder eine Schätzung für die Auflösung konfiguriert werden. Hierfür wird ein unsichtbares div-Element auf dem Bildschirm platziert und anschließend dessen Größe gemessen. Da die Größe des div-Elements vom Browser geliefert wird und dieser unter Umständen vom Betriebssystem falsche Informationen erhält, kann die Schätzung von der tatsächlichen Auflösung abweichen.

Falls die Schätzung der Auflösung nicht durchgeführt werden kann, wird eine Default Auflösung von 72 DPI analog zur jadice document platform 5 verwendet.

Details zur Integration und die zugehörigen Codebeispiele finden sich in den Showcases unter "Calibrating the Resolution" und "Defining the Resolution globally".

Hinweis

Aktuell kann pro Client genau eine Auflösung gesetzt werden. Falls an einen Client mehrere Monitore angeschlossen sind, wird über das oben beschriebene Widget genau einer dieser Monitore kalibriert. Analog dazu ist eine global konfigurierte Auflösung für alle angeschlossenen Monitore gültig. Da in vielen Anwendungsfällen mit mehreren Monitoren lediglich einer davon für die Dokumentanzeige verwendet wird, sollte die Konfiguration der Auflösung für dieses eine Gerät ausreichend sein.