.\" -*- coding: UTF-8 -*- .\"******************************************************************* .\" .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* .TH sane\-sharp 5 "11. Juli 2008" "" "SANE Scanner Access Now Easy" .IX sane\-sharp .SH BEZEICHNUNG sane\-sharp \- SANE\-Backend für Scanner von SHARP .SH BESCHREIBUNG Die Bibliothek \fBsane\-sharp\fP implementiert ein SANE\-(Scanner Access Now Easy) Backend zum Zugriff auf Sharp\-SCSI\-Scanner. Dieses Backend sollte als Software im \fBBeta\-Stadium\fP betrachtet werden! Im aktuellen Zustand arbeitet sie mit JX\-610\- und JX\-250\-Scannern zusammen. Sie ist für die Verwendung mit den Scannern der JX\-330\-Serie vorbereitet, was wir aber nicht testen konnten. .PP Mit anderen SHARP\-Scannern kann es funktionieren oder auch nicht. .PP Gegenwärtig sollten die folgenden Scanner mit diesem Backend funktionieren: .RS .PP .nf \f(CRAnbieter Produktkennung: \-\-\-\-\- \-\-\-\-\-\-\-\-\-\-\- Sharp JX\-610 Sharp JX\-250 Sharp JX\-320 Sharp JX\-330 Sharp JX\-350\fR .fi .RE .PP Die folgenden Scanner wurden vom Backend erkannt, sind aber nicht getestet: .PP .RS .nf \f(CRAnbieter Produktkennung: \-\-\-\-\- \-\-\-\-\-\-\-\-\-\-\- Sharp JX\-325\fR .fi .RE .SH GERÄTENAMEN Dieses Backend erwartet Gerätenamen der folgenden Form: .PP .RS \fISpezialdatei\fP .RE .PP Die angegebene \fISpezialdatei\fP ist der Pfadname eines Spezialgeräts, das einem SCSI\-Scanner entspricht. Der Name des Spezialgeräts muss ein generisches SCSI\-Gerät oder ein symbolischer Link zu so einem Gerät sein. Unter Linux könnte ein solcher Gerätename beispielsweise \fI/dev/sga\fP oder \fI/dev/sge\fP sein. Siehe \fBsane\-scsi\fP(5) für Details. .SH SCAN\-OPTIONEN .TP \fB\-\-mode\fP Scan\-Modus. Mögliche Einstellungen sind: \fILineart\fP (1 bit schwarz\-und\-weiß\-Scans), \fIGray\fP (8 bit Graustufenscans), \fILineart Color\fP (zweistufige Farbscans) und \fIColor\fP (8 bit RGB\-Scans). Der Vorgabewert ist \fIColor\fP. .TP \fB\-\-halftone\-pattern\fP Rastermuster. Nur für die Scanner der JX\-330\-Serie verfügbar. Mögliche Einstellungen sind: \fInone\fP, \fIDither Bayer\fP, \fIDither Spiral\fP, \fIDither Dispersed\fP und \fIError Diffusion\fP. Der Vorgabewert ist \fInone\fP. .TP \fB\-\-source\fP Papierquelle. Diese Option ist nur verfügbar, falls ein automatischer Dokumenteneinzug oder ein Transparenz\-Adapter installiert ist. Mögliche Einstellungen sind: \fIFlatbed\fP, \fIAutomatic Document Feeder\fP und \fITransparency Adapter\fP. Falls ein ADF oder ein Transparenz\-Adapter installiert ist, ist deren Verwendung die Vorgabe. .TP \fB\-\-custom\-gamma\fP Angepasstes Gamma. Diese Option bestimmt, ob eine eingebaute oder eine angepasste Gammatabelle verwendet wird. Mögliche Einstellungen sind: \fIyes\fP (aktiviert angepasste Gamma\-Tabellen) oder \fIno\fP (aktiviert eine eingebaute Gamma\-Tabelle). .TP \fB\-\-gamma\fP Gamma. Diese Option ist nur verfügbar, falls \fBCustom Gamma\fP auf \fIno\fP gesetzt ist. Mögliche Werte sind: \fI1.0\fP oder \fI2.2\fP. Der Vorgabewert ist \fI2.2\fP. (Die JX\-250 und JX\-350 haben keine eingebaute Gammakorrektur; für diese Scanner wird eine Gamma\-Tabelle vom Backend zum Scanner heruntergeladen.) .TP \fB\-\-gamma\-table\fP Gamma\-Tabelle. Erlaubte Werte: 0…255. 256 Zahlen müssen definiert werden. Die Vorgabewerte sind 0, 1, 2, … 255 (d.h. Gamma == 1). Diese Tabelle wird nur für Graustufen\-Scans verwendet. .TP \fB\-\-red\-gamma\-table\fP Rote Gamma\-Tabelle. Erlaubte Werte: 0…255. 256 Zahlen müssen definiert werden. Die Vorgabewerte sind 0, 1, 2, … 255 (d.h. Gamma == 1). .TP \fB\-\-green\-gamma\-table\fP Grüne Gamma\-Tabelle. Erlaubte Werte: 0…255. 256 Zahlen müssen definiert werden. Die Vorgabewerte sind 0, 1, 2, … 255 (d.h. Gamma == 1). .TP \fB\-\-blue\-gamma\-table\fP Blaue Gamma\-Tabelle. Erlaubte Werte: 0…255. 256 Zahlen müssen definiert werden. Die Vorgabewerte sind 0, 1, 2, … 255 (d.h. Gamma == 1). .TP \fB\-\-resolution\fP wählt die Auflösung des gescannten Bildes. Erlaubte Werte: \fI30…600\fP (JX\-330, JX\-350 und JX\-610) und \fI30…400\fP (JX\-250). Der Vorgabewert ist 150. .TP \fB\-l\fP, \fB\-t\fP, \fB\-x\fP, \fB\-y\fP Scan\-Fenster. Obere linke x\-Position des Scanbereichs (\fB\-l\fP), obere linke y\-Position des Scanbereichs (\fB\-t\fP), untere rechte Position des Scanbereichs (\fB\-x\fP) und untere rechte Position (\fB\-y\fP) des Scanbereichs. Die möglichen Einstellungen hängen vom Scannermodell und, für den JX\-250 und den JX\-350, auch vom Einsatz des automatischen Dokumenteneinzugs bzw. des Transparenz\-Adapters ab. Bitte schauen Sie sich die erlaubten Werte in \fBxscanimage\fP(1) oder \fBxsane\fP(1) an. Bei \fBscanimage\fP(1) geben Sie einen der folgenden Befehle ein, um die erlaubten Parameterwerte für das Scan\-Fenster zu sehen: .RS scanimage \-d sharp \-\-source "Automatic Document Feeder" \-\-help scanimage \-d sharp \-\-source Flatbed \-\-help scanimage \-d sharp \-\-source "Transparency Adapter" \-\-help .RE .TP \fB\-\-edge emphasis\fP Randbetonung. Diese Option ist für den JX\-250 und den JX\-350 nicht verfügbar. Mögliche Einstellungen: \fINone\fP, \fIMiddle\fP, \fIStrong\fP und \fIBlur\fP. Die Vorgabe ist \fINone\fP. .TP \fB\-\-threshold\fP setzt den Schwellwert für schwarze und weiße Pixel im Modus Lineart. Mögliche Werte sind 1…255. Der Vorgabewert ist 128. Diese Option ist nur im Scanmodus \fIlineart\fP verfügbar. .TP \fB\-\-threshold\-red\fP setzt den Schwellwert für die rote Komponente eines Pixels im Lineart\-Farbscan\-Modus. Mögliche Werte sind 1…255. Der Vorgabewert ist 128. Diese Option ist nur im Farb\-Scanmodus \fIlineart\fP verfügbar. .TP \fB\-\-threshold\-green\fP setzt den Schwellwert für die grüne Komponente eines Pixels im Lineart\-Farbscan\-Modus. Mögliche Werte sind 1…255. Der Vorgabewert ist 128. Diese Option ist nur im Farb\-Scanmodus \fIlineart\fP verfügbar. .TP \fB\-\-threshold\-blue\fP setzt den Schwellwert für die blaue Komponente eines Pixels im Lineart\-Farbscan\-Modus. Mögliche Werte sind 1…255. Der Vorgabewert ist 128. Diese Option ist nur im Farb\-Scanmodus \fIlineart\fP verfügbar. .TP \fB\-\-lightcolor\fP setzt die Farbe der Lichtquelle. Mögliche Werte sind \fIwhite\fP, \fIred\fP, \fIgreen\fP und \fIblue\fP. Der Vorgabewert ist \fIwhite\fP. Diese Option ist nur in den Scanmodi \fIlineart color\fP und \fIcolor\fP verfügbar. .SH ADF\-VERWENDUNG Falls ein Papierstau auftritt, \fImuss\fP der Wartungsdeckel geöffnet und geschlossen werden, selbst wenn das verstopfte Papier ohne Öffnen der Wartungsklappe entfernt werden kann. Andernfalls wird der Fehlerzustand nicht zurückgesetzt. .SH KONFIGURATION Der Inhalt der Datei \fIsharp.conf\fP ist eine Liste von Optionen und Gerätenamen, die Sharp\-Scannern entsprechen. Leere Zeilen und Zeilen, die mit einer Raute (#) beginnen, werden ignoriert. Siehe \fBsane\-scsi\fP(5) für Details über Gerätenamen. .PP Zeilen, die eine Option setzen, beginnen mit dem Schlüsselwort \fBoption\fP, gefolgt vom Optionsnamen und dessen Wert. Derzeit sind drei Optionen definiert: \fBbuffers\fP, \fBbuffersize\fP und \fBreadqueue\fP. .PP Optionen am Anfang von \fIsharp.conf\fP gelten für alle Geräte; Optionen, die nach Gerätenamen definiert sind, gelten für dieses Gerät. .PP Die Optionen \fBbuffers\fP und \fBreadqueue\fP sind nur von Bedeutung, falls das Backend so kompiliert wurde, dass jeder Scan einen zweiten, mit Fork gestarteten Prozess auslöst (Schalter \fBUSE_FORK\fP in \fIsharp.c\fP). Dieser Prozess liest die Scandaten aus dem Scanner und schreibt diese Daten in einen Block gemeinsam benutzten Speichers. Der Elternprozess liest die Daten aus diesem Speicherblock und liefert sie an die Oberfläche aus. Die Optionen steuern die Größe und die Verwendung dieses gemeinsamen Speicherblocks. .PP \fBoption buffers\fP definiert die Anzahl der verwendeten Puffer. Die kleinste erlaubte Zahl ist 2. .PP \fBoption buffersize\fP definiert die Größe eines Puffers. Da jeder Puffer mit einem einzelnen Lesebefehl, der an den Scanner gesendet wird, gefüllt wird, wird seine Größe automatisch auf die durch das Betriebssystem oder durch die SANE\-SCSI\-Bibliothek für SCSI\-Lesebefehle erlaubte Größe begrenzt. Für Scan\-Auflösungen von 300 DPI oder höher wird eine Puffergröße von 128 kB oder 256 kB empfohlen. .PP \fBoption readqueue\fP definiert, wie viele Lesebefehle, die an den Scanner gesandt werden sollen, in die Warteschlange sollen. Derzeit unterstützt die SANE\-SCSI\-Bibliothek Warteschlangen für Lese\-Befehle nur unter Linux. Für andere Betriebssysteme sollte \fBoption readqueue\fP auf 0 gesetzt werden. Für Linux sollte \fBoption readqueue\fP auf 2 gesetzt werden. Größere Werte als 2 für \fBoption readqueue\fP sind in den meisten Fällen nicht vernünftig. \fBoption buffers\fP sollte größer als \fBoption readqueue\fP sein. .SH Leistungsbetrachtungen Dieser Abschnitt fokussiert sich auf das Problem des Anhaltens des Schlittens des Scanners während eines Scans. Schlittenstops passieren hauptsächlich bei dem JX\-250. Dieser Scanner hat offensichtlich nur einen kleinen internen Puffer verglichen zu seiner Geschwindigkeit. Das bedeutet, dass das Backend die Daten so schnell wie möglich vom Scanner lesen muss, um die Schlittenstopps zu vermeiden. .PP Selbst der JX\-250 benötigt nur weniger als 10 Sekunden für einen A4\-Graustufenscan in 400 DPI, was zu einer Datenübertragungsrate von mehr als 1,6 MB pro Sekunde führt. Das bedeutet, dass die vom Scanner erstellten Daten recht schnell verarbeitet werden müssen. Aufgrund des kleinen internen Puffers des JX\-250 muss das Backend Leseanforderungen für den nächsten Datenblock nach dem Lesen eines Datenblock so früh wie möglich ausgeben, um Schlittenstopps zu vermeiden. .PP Der Schlitten kann aus folgenden Gründen stehen bleiben: .PP .RS \- zu viel »Verkehr« auf dem SCSI\-Bus .br \- langsame Antworten des Backends an den Scanner .br \- ein Programm, das die vom Backend erlangten Daten verarbeitet, ist zu langsam .PP .RE Zu viel »Verkehr« auf dem SCSI\-Bus: Dies passiert beispielsweise, falls Festplatten an den gleichen SCSI\-Bus wie der Scanner angeschlossen sind und wenn der Datentransfer von/zu diesen Festplatten einen beträchtlichen Teil der SCSI\-Bandbreite während eines Scans benötigt. Falls dies der Fall ist, sollten Sie in Betracht ziehen, den Scanner an einen separaten SCSI\-Adapter anzuschließen. .PP Langsame Antworten durch das Backend an den Scanner: Unglücklicherweise haben im Allgemeinen UNIX\-artige Betriebssysteme keine Echtzeitfähigkeiten. Daher gibt es keine Garantie, dass das Backend unter allen Bedingungen in der Lage ist, mit dem Scanner so schnell wie möglich zu kommunizieren. Um das Problem zu minimieren, sollte das Backend so kompiliert werden, dass ein separater Leseprozess mit Fork gestartet wird: Stellen Sie sicher, dass \fBUSE_FORK\fP definiert ist, wenn Sie \fIsharp.c\fP kompilieren. Falls weiterhin das Problem der langsamen Antworten durch das Backend bleibt, könnten Sie versuchen, die Systemlast zu reduzieren. Selbst obwohl das Backend und der Leseprozess nur einen geringen Anteil der Prozessorzeit benötigen, können andere laufende Prozesse zu einer Erhöhung der Zeitverzögerung zwischen zwei Zeitfenstern, die dem Leseprozess zugeteilt werden, führen. Auf langsameren Systemen kann solch eine Verzögerung groß genug sein, um einen Schlittenstopp bei dem JX\-250 auszulösen. Für Linux wird die Verwendung des SG\-Treibers Version 2.1.36 oder neuer empfohlen, da er im Zusammenspiel mit der SCSI\-Bibliothek von Sane Version 1.0.2 das Einreihen von Befehlen im Kernel unterstützt. Diese Implementierung, kombiniert mit einer Puffergröße von mindestens 128 kB, sollte die meisten Schlittenstopps vermeiden. .PP Langsame Verarbeitung der Scan\-Daten: Ein Beispiel für diese Situation ist der Zugriff auf den Scanner über eine 10\-MBit\-Ethernet\-Verbindung, die definitiv für die Übertragung der Scandaten in der Geschwindigkeit, in der sie der Scanner erstellt, zu langsam ist. Falls Sie über genug Arbeitsspeicher verfügen, können Sie \fBoption buffers\fP erhöhen, so dass das gesamte Bild in diesen Puffern gespeichert werden kann. .PP Um herauszufinden, ob das Backend oder die weitere Verarbeitung der Daten zu langsam ist, setzen Sie die Umgebungsvariable \fBSANE_DEBUG_SHARP\fP auf 1. Wenn ein Scan abgeschlossen ist, schreibt das Backend die Zeile »buffer full conditions: \fInn\fP« auf die Standardfehlerausgabe. Falls \fInn\fP null ist, werden Schlittenstopps durch zu langsame Verarbeitung des Backends oder durch zu viel »Verkehr« auf dem SCSI\-Bus ausgelöst. Falls \fInn\fP größer als null ist, musste das Backend \fInn\fP mal warten, bis ein Puffer durch die Oberfläche verarbeitet wurde. (Bitte beachten Sie, dass \fBoption buffers\fP größer als \fBoption readqueue\fP sein muss, um nützliche Ausgaben für die »Puffer\-Voll\-Bedingung« zu erhalten.) .SH DATEIEN .TP \fI/etc/sane.d/sharp.conf\fP Die Backend\-Konfigurationsdatei. .TP \fI/usr/lib/x86_64\-linux\-gnu/sane/libsane\-sharp.a\fP Die statische Bibliothek, die dieses Backend implementiert. .TP \fI/usr/lib/x86_64\-linux\-gnu/sane/libsane\-sharp.so\fP Die dynamische Bibliothek, die dieses Backend implementiert (auf Systemen verfügbar, die dynamisches Laden unterstützen). .SH UMGEBUNGSVARIABLEN .TP \fBSANE_DEBUG_SHARP\fP Falls die Bibliothek mit Debug\-Unterstützung kompiliert wurde, steuert diese Umgebungsvariable die Debug\-Stufe für dieses Backend. Beispielsweise bewirkt ein Wert von 128 die Anzeige sämtlicher Debug\-Ausgaben. Kleinere Werte reduzieren die Ausführlichkeit. .SH "BEKANNTE PROBLEME" 1. ADF\-Modus .RS Nach verschiedenen Scans aus der automatischen Dokumentenzuführung fährt der Scanner den Schlitten in die ADF\-Ruheposition zurück, bevor ein Scanvorgang beginnt. Wir wissen nicht, ob dies am Scanner liegt oder ein Fehler im Backend ist. Momentan ist es nötig, den Scanner aus\- und wieder einzuschalten, um dieses ärgerliche Verhalten zu beheben. .RE 2. Höhe des Schwellwertes funktioniert nicht (nur JX\-610). .PP 3. Die maximale Auflösung ist auf 600 DPI (JX\-610\-Unterstützung bis zu 1200 DPI) bzw. 400 DPI (JX\-250) begrenzt. .PP 4. Falls der JX250 mit einem ADF verwendet wurde, kann folgende Situation auftreten: Nach mehreren Scans und dem Laden eines neues Blatts bewegt der Scanner den Schlitten zu der Leerlaufposition und zurück zur Position für ADF\-Scans. Dies passiert für \fIjeden\fP Scan, im Gegensatz zur Kalibrierung, die nach 10 Scans erfolgt. (Für die Kalibrierung wird der Schlitten auch zur Leerlaufposition gefahren.) Wir wissen nicht, ob das Verhalten durch das Backend ausgelöst wird oder ob es ein Fehler in der Firmware des Scanners ist. .PP 5. Die Verwendung der Transparenzeinheit (Film\-Scan\-Einheit) wird unterstützt, wurde aber nicht getestet. .SH "SIEHE AUCH" \fBsane\fP(7), \fBsane\-scsi\fP(5) .SH AUTOREN Kazuya Fukuda, Abel Deuring .SH DANKSAGUNGEN Das Sharp\-Backend basiert auf dem von Helmut Koeberle geschriebenen Canon\-Backend. .PP Teile dieser Handbuchseite sind eine direkte Kopie von \fBsane\-mustek\fP(5) von David Mosberger\-Tang, Andreas Czechanowski und Andreas Bolsch. .PP .SH ÜBERSETZUNG Die deutsche Übersetzung dieser Handbuchseite wurde von Mario Blättermann und Helge Kreutzmann erstellt. .PP Diese Übersetzung ist Freie Dokumentation; lesen Sie die .UR https://www.gnu.org/licenses/gpl-3.0.html GNU General Public License Version 3 .UE oder neuer bezüglich der Copyright-Bedingungen. Es wird KEINE HAFTUNG übernommen. .PP Wenn Sie Fehler in der Übersetzung dieser Handbuchseite finden, schicken Sie bitte eine E-Mail an die .MT debian-l10n-german@lists.debian.org Mailingliste der Übersetzer .ME .