Installation¶

Voraussetzung ist eine funktionsfähige Java^[1]-Installation, getestet mit openjdk-7 (auf Ubuntu 14.04) bzw. openjdk-8 (auf Ubuntu 16.04). Das Programm selbst ist nicht in den offiziellen Ubuntu-Quellen vorhanden, ein .deb-Paket ist auf der Downloadseite verfügbar, das installiert^[2] werden muss. Dabei werden als Abhängigkeiten die Pakete default-jre und default-jre-headless installiert, die auf die standardmäßig verwendete Java-Installation verweisen.

Alternative kann auch die Java-Datei ohne Installation verwendet werden, dazu die .zip-Datei herunterladen, entpacken^[3] und im entsprechenden Verzeichnis^[4] mit

java -jar swingsane-0.2.jar 

das Programm aufrufen.

Außerdem muss zur Nutzung - auch auf einem Einzelrechner! - eine funktionsfähige SANE-Daemon-Konfiguration vorhanden sein, da SwingSane nur über das Netzwerk auf Scanner zugreifen kann. Ein Einzelrechner muss also sowohl als Server als auch als Client eingerichtet werden.

Netzwerkscanner finden¶

Nach dem Start^[5] müssen zunächst vorhandene Netzwerkscanner gesucht werden.

Konfiguration¶

Theoretisch können dann die gefundene Scanner direkt verwendet werden, indem man sie auswählt und dann die "Scan"-Schaltfläche betätigt. Im Reiter "Settings" sind allerdings meist nur wenige Optionen direkt auswählbar, etliche sind "ausgegraut" (abhängig vom verwendeten Backend).

Meist empfiehlt es sich daher, die Option "Use custom settings" (benutzerdefinierte Einstellungen verwenden) zu aktivieren, und dann mit der Schaltfläche "Custom settings..." ein Fenster mit allen verfügbaren Optionen zu öffnen. Mit "Check options" werden die tatsächlich vom Scanner unterstützten Optionen angezeigt; nicht alle von einem Backend bereitgestellten Optionen sind jedem Scanner tatsächlich verwendbar. Die als "Activ" (zweite Spalte "Status") gekennzeichneten Option lassen sich meist auch verwenden. In der "Modify"-Spalte lassen sich die Optionen aktivieren, oder ihnen bestimmte Werte zuweisen. Wenn der Mauszeiger über einem Eintrag steht, wird ein Tooltip mit Informationen zu der jeweiligen Option eingeblendet.

Bedienung¶

Mit "Scan" wird der Scanprozess entsprechend der Einstellungen gestartet, in der "Client Console" erscheinen dann kurze Hinweise. Die Scans werden unter dem in den "Settings" eingegebenem Namen (Standard ist "scan_TIMESTAMP_PAGENUMBER_PAGECOUNT", also etwas wie "scan_20160521154823_1_2") temporär abgelegt. Im Reiter "Preview" werden sie im rechten Fenster aufgelistet, und können nachbearbeitet werden, Drehung ("Rotate Left/Rotate Right") und Zuschnitt ("Crop") direkt im Hauptfenster. Es besteht außerdem die Möglichkeit, die Anzeigegröße über das Dropdown-Menü oder das Mausrad zu verändern, leider nicht stufenlos.

Die Zuschnittfunktion scheint allerdings nicht ganz ausgereift zu sein. Das sich öffnende Fenster nimmt standardmäßig die gesamte Bildschirmbreite ein. Querformate werden so meist vollständig angezeigt, bei Hochformaten ist aber nur ein Ausschnitt in der Mitte des Scans sichtbar. Eigentlich lässt sich der Zuschnitt über ein Positionieren des Mauscursors an der gewünschten oberen linken Ecke und Ziehen bei gedrückter realisieren. Da in dem Modus keine direkte Änderung der Darstellungsgröße möglich ist, kann nur der sichtbare Teil mit der Maus ausgewählt werden, und der zudem auch noch "blind", da auch die Auswahl ggf. nicht sichtbar wird. Theoretisch kann auch über die Angabe der oberen linken Ecke ("X/Y"-Werte) und die Breite und Höhe ("Width/Height") in Pixeln der Zuschnitt bestimmt werden, was aber ebenfalls nur "blind" erfolgen kann, und wer weiß schon, wie viele Pixel nötig sind. Erst wenn man das gesamte Fenster auch in eine "Hochformat" bringt, und dabei das Fenster so schmal wie möglich macht, lässt sich ein Zuschnitt per Maus einigermaßen bewerkstelligen, allerdings bleiben ggf. Randbereiche weiterhin unsichtbar. Im Querformat funktioniert ein Aufziehen des gewünschten Bereiches mit der Maus hingegen besser. Die mit der Maus getroffene Auswahl wird dann auch in transparentem Blau angezeigt, und kann über die unteren Einstellungen ggf. noch korrigiert werden.

Für die X/Y-Koordinaten lassen leider auch negative Werte angeben, die das Programm zwar zunächst zulässt, dann aber mit einer Fehlermeldung quittiert. Zudem ist die Verwendung von Werten, die die tatsächliche Breite/Höhe überschreiten, möglich, ohne dass auf diesen Fehler hingewiesen wird. Eine einmal erstellt Auswahl kann mit gedrückter auch verschoben werden, allerdings gilt auch hier, dass die Auswahl aus dem tatsächlich möglichen Bereich herausgeschoben werden kann.

Über die Schaltfläche "Transform..." sind die Optionen "Deskew" (Geradeziehen), "Binarize" (in S/W umformen), sowie "Crop" und "Rotate" nochmals zu finden. Die Bedienung ist etwas mühsam, da die jeweilige Option zunächst im Dropdown-Menü markiert und mit "Add Transformation" ausgewählt werden muss. Daraufhin kann, nachdem sie im Auswahlfenster oben markiert worden ist, dazu im dann unten erscheinendem Optionenfeld eine Angabe gemacht werden. Für "Deskew" ist das die Gradzahl, ab der eine Schräglage korrigiert werden soll, bei "Binarize" kann ein Schwellwert angegeben werden, ab der ein Pixel Schwarz oder Weiß dargestellt wird, bei "Rotate" kann im Dropdown-Menü eine Drehung im Uhrzeigersinn ("CW") von 90, 180 oder 270 Grad angegeben werden. Für "Crop" steht nur die Angabe der X/Y-Koordinaten, sowie der Breite und Höhe in Pixeln zur Verfügung, das Aufziehen des Bereiches mit der Maus ist nicht möglich. Über "Transform" können dann alle markierten Scans in einem Rutsch mit den gleichen Parametern bearbeitet werden, die Auswahl der Scans muss allerdings vor Aufruf des Transformations-Menüs erfolgen.

Ein Rückgängigmachen dieser Änderungen (bis auf die Drehungen) ist nicht möglich.

Abgespeichert werden können die Ergebnisse im .png- oder .pdf-Format, letzteres auch als mehrseitiges PDF (Dropdown-Menü unterhalb der Scan-Liste). Eine Korrektur der Reihenfolge der Scans ist leider nicht möglich.

Mit "Save" werden die Ergebnisse gespeichert, eine Standardpfad ist nicht angebbar, was dazu führt, dass die Scans zunächst in dem Verzeichnis abgelegt werden sollen, in dem sich die .jar-Datei der Software befindet. Bei Installation über das .deb-Paket also in /usr/bin, was allerdings dem Standardbenutzer wg. mangelnder Rechte nicht möglich ist. Ein Abbruch des Speichervorgang führt erstaunlicherweise ebenfalls zu einer Fehlermeldung, "Failure Saving: java.io.FileNotFoundException: /usr/bin/null/null (Datei oder Verzeichnis nicht gefunden)".

Probleme und Lösungen¶

Wenn in den Einstellungen kein Name für die Temporärdateien ("Batch Prefix") eingetragen ist/werden kann, scannt der Scanner dieselbe Seite solange, bis er manuell gestoppt wird ("Cancel"). Die Scans haben dann keinen Namen, im "Preview"-Reiter sind sie in der Liste zunächst nicht zu erkennen, eine "Markierung" erscheint erst, wenn man mit der Maus in die Liste geht. Eine Lösung besteht darin, zunächst einen anderen Scanner aufzurufen, und dann zum ersten zurückzukehren, dann kann meist ein Name eingegeben werden. Ggf. hilft auch eine Neustart des Programms.

Die Option "preview" (Vorschau) führt (zumindest im beim genesys-Backend) zu einem Aufhängen, das Scannen scheint nicht beendet werden zu können. Es muss dann abgebrochen werden, ggf. ist sogar ein Rechnerneustart nötig, um wieder auf den Scanner zugreifen zu können.

Alternativen¶

• XSane - weiterhin die umfassenste Scanner-Software unter Linux

• pct-scanner-script - hochkonfigurierbare Kommandozeilen-Lösung zum Scannen und Erstellen von PDF/DjVu-Dateien

• gscan2pdf - Programm mit relativ gutem Zugriff auf Sane-Backend-Optionen

Links¶

• Projektseite

• Tutorial auf Youtube mit Erläuterungen zum Hintergrund der Entwicklung

• Sourceforge-Seite