Tools

Tools sind Erweiterungen der PageView, die über den ToolManager verwaltet werden. Die Tools werden grundsätzlich analog der jadice document platform 5 verwendet (siehe Abschnitt "Tools").

Einschränkungen/Unterschiede:

• Die Tool-Klassen des jadice web toolkit stellen eigenständige Implementierungen dar und sind deshalb in einem anderen Package (com.levigo.jadice.web.client.tools) abgelegt.

• Anstelle des Graphics2d wird ein Webgraphics/HTML5Canvas verwendet.

AnnotationTool

Die Erstellung und Bearbeitung von Annotationen wird über das AnnotationTool gesteuert.

Standardmäßig erlaubt das Tool, mehrere Annotationen gleichzeitig zu selektieren. Falls keine Mehrfachselektion gewünscht ist, kann das Tool über die Methode setSingleSelectionMode(true) in den Modus für einfache Selektion versetzt werden.

Details zur Integration und die zugehörigen Codebeispiele finden sich in den Showcases unter "Annotations".

DoubleTapZoomTool

Mit Hilfe des DoubleTapZoomTool kann durch schnelles zweifaches Tippen auf den Bildschirm auf Seitenbreite gezoomt werden.

GridTool

Um ein dem aktuellen Dokument vorab hinzugefügtes Grid zu visualisieren, kann das GridTool verwendet werden. Linienfarbe und -stärke sind dabei über das Tool konfigurierbar.

Details zur Integration und die zugehörigen Codebeispiele finden sich in den Showcases unter "Annotations -> Grid Positioning".

KeyboardNavigationTool

Das KeyboardNavigationTool dient zur Navigation im Dokument. Über die Pfeiltasten lässt sich im aktuell dargestellten Dokument intuitiv ein kleines bisschen nach oben, unten, rechts, links navigieren.

HoverLensTool

Um einzelne Stellen eines Dokuments zu vergrößern, ohne dabei den Überblick zu verlieren, kann mittels des HoverLensTools eine Lupe auf der aktuellen Seite eingeblendet werden. Mit Linksklicks wird der Zoomfaktor innerhalb der Lupe erhöht, mit Rechtsklicks wird der Zoomfaktor verringert.

Form, Größe und initialer Zoomfaktor der Lupe sind dabei über das Tool konfigurierbar, genauso wie die Größe der schrittweisen Zoomfaktor-Veränderung bei Rechts- und Linksklicks. Zusätzlich kann die Lupe mit der Kombination Strg + Linksklick auf der aktuellen Position fixiert werden.

Details zur Integration und die zugehörigen Codebeispiele finden sich in den Showcases unter "Tools -> HoverLensTool Examples".

PanForceTools

Mit Hilfe der PanForceTools kann durch das Dokument gescrollt werden. Das Tool ist in zwei Ausprägungen vorhanden. Für das Scrollen mit der Maus muss das PanForceMouseTool in den ToolManager eingehängt werden; zum Scrollen über Touch-Eingaben das PanForceTouchTool. Natürlich können auch beide Tools gleichzeitig eingesetzt werden.

SelectPageTool

Das SelectPageTool ermöglicht die Mehrfachauswahl von Seiten über die ThumbnailView. Es wird sowohl für das Markieren einzelner Seiten, als auch für das Verschieben von Seiten via Drag&Drop in der ThumbnailView verwendet. Das Tool kann ausschließlich in Kombination mit der ThumbnailView und nicht mit der Standard-PageView verwendet werden. Aus diesem Grund wird es - im Unterschied zu diversen anderen Tools - folgendermaßen am ToolManager der ThumbnailView registriert: ThumbnailPageView.getToolManager().register(SelectPageTool.class, true);

TextSelectionTools

Für die Textselekion gibt es wie bei den Scroll-Tools zwei Ausprägungen. Wird das TextSelectionTool in den ToolManager einghängt, so kann über Mauseingaben Text selektiert werden. Um über Touch-Eingaben Text zu selektieren, wird das TextSelectionTouchTool benötigt. Für den Betrieb dieses Tools ist es nötig, dass das HighlightTool im ToolManager registriert ist.

TwoFingerGestureTool

Das TwoFingerGestureTool bietet verschiedene Funktionalitäten für Zwei-Finger-Touch-Gesten. Wird das Tool einkonfiguriert, kann über Zwei-Finger-Gesten gedreht, gescrollt und gezoomt werden. Das Tool bietet zusätzlich über die Methoden disableZoom(), disableScroll(), disableRotate() die Möglichkeit, einzelne Funktionalitäten zu deaktivieren.

VisibleBoundsTool

Das VisibleBoundsTool hebt den aktuell sichtbaren Bereich einer Seite in der Thumbnail-Ansicht hervor. Die Farbe dieses Tools können über eine GSS-Datei konfiguriert werden.

@def PAGE_BOUNDS_BORDER_WIDTH 2; // Breite des Seitenrandes @def VISUAL_BOUNDS_BORDER_WIDTH 1; // Breite des Randes um den sichtbaren Bereich @def PAGE_BOUNDS_BORDER_COLOR #666565; // Farbe des Seitenrandes @def PAGE_VISUAL_BOUNDS_INTERSECTION_FILL_COLOR rgba(102,101,101,0.5); // Farbe des Bereiches zwischen Seitenrand und sichtbarem Bereichsrand @def VISUAL_BOUNDS_FILL_COLOR rgba(0,0,0,0); // Farbe des sichtbaren Bereiches @def VISUAL_BOUNDS_BORDER_COLOR #666565; // Farbe des Randes um den sichtbaren Bereich

AreaSelectionTool

Das AreaSelectionTool ermöglicht die Auswahl eines Bereiches. Nach der Selektion des Bereichs erscheint eine Toolbar mit registrierten Funktionen, die auf den Bereich angewendet werden können. Alternativ kann eine Standard-Aktion direkt ausgeführt werden

Als ersten Anwendungsfall für dieses Tool wurde das OCR-Addon für das Webtoolkit implementiert. Mehr Informationen zum Einsatz des Tools sind auch in der Dokumentation des OCR Addons zu finden.