.\" -*- coding: UTF-8 -*- .\"******************************************************************* .\" .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* .TH scanimage 1 "10. Juli 2008" "" "SANE Scanner Access Now Easy" .IX scanimage .SH BEZEICHNUNG scanimage \- ein Bild scannen .SH ÜBERSICHT \fBscanimage\fP [\fB\-d\fP|\fB\-\-device\-name\fP \fIGerät\fP] [\fB\-\-format\fP \fIFormat\fP] [\fB\-i\fP|\fB\-\-icc\-profile\fP \fIProfil\fP] [\fB\-L\fP|\fB\-\-list\-devices\fP] [\fB\-f\fP|\fB\-\-formatted\-device\-list\fP \fIFormat\fP] [\fB\-b\fP|\fB\-\-batch\fP [\fIFormat\fP]] [\fB\-\-batch\-start\fP \fIstart\fP] [\fB\-\-batch\-count\fP \fIAnzahl\fP] [\fB\-\-batch\-increment\fP \fIErhöhung\fP] [\fB\-\-batch\-double\fP] [\fB\-\-accept\-md5\-only\fP] [\fB\-p\fP|\fB\-\-progress\fP] [\fB\-o\fP|\fB\-\-output\-file\fP \fIPfad\fP] [\fB\-n\fP|\fB\-\-dont\-scan\fP] [\fB\-T\fP|\fB\-\-test\fP] [\fB\-A\fP|\fB\-\-all\-options\fP] [\fB\-h\fP|\fB\-\-help\fP] [\fB\-v\fP|\fB\-\-verbose\fP] [\fB\-B\fP|\fB\-\-buffer\-size\fP [=\fIGröße\fP]] [\fB\-V\fP|\fB\-\-version\fP] [\fIgerätespezifische\-Optionen\fP] .SH BESCHREIBUNG \fBscanimage\fP ist eine Befehlszeilenschnittstelle zur Steuerung bildgebender Geräte wie Flachbettscanner oder Kameras. Das Gerät wird dabei über Befehlszeilenoptionen gesteuert. Nach dem Verarbeiten der Befehlszeile beginnt \fBscanimage\fP normalerweise mit der Bilderstellung. Die Bilddaten werden in einem der PNM\-(portable aNyMaP)Formate (PBM für Schwarzweißbilder, PGM für Bilder in Graustufen und PPM für Farbbilder), dem TIFF\-Format (Schwarzweiß, Graustufen oder Farbe), dem PNG\-Format oder dem JPEG\-Format (Kompressionsstufe 75) in die Standardausgabe geschrieben. \fBscanimage\fP greift auf bildgebende Geräte über die \fBSANE\fP\-Schnittstelle (Scanner Access Now Easy) zu und kann daher jedes Gerät unterstützen, für das ein \fBSANE\fP\-Backend existiert (mit \fBapropos\fP \fIsane\-\fP erhalten Sie eine Liste der verfügbaren Backends). .SH BEISPIELE Eine Liste der Geräte anzeigen lassen: scanimage \-L Mit den Standardeinstellungen in die Datei Bild.pnm scannen: scanimage >bild.pnm Einen 100x100 mm großen Bereich scannen und in die Datei Bild.tiff schreiben (\-x und \-y könnten nicht bei allen Geräten verfügbar sein): scanimage \-x 100 \-y 100 \-\-format=tiff >bild.tiff Alle verfügbaren Optionen ausgeben: scanimage \-h .SH OPTIONEN Es gibt zwei Arten von Optionen, die bei der Ausführung von \fBscanimage\fP verfügbar sind. .PP Die von \fBscanimage\fP selbst bereitgestellten Optionen sind nachfolgend aufgelistet. Zusätzlich hat jedes Backend seine eigenen Optionen, die Sie ebenfalls angeben können. Beachten Sie, dass die für das Backend verfügbaren Optionen vom ausgewählten Scan\-Gerät abhängig sind. .PP Oft sind Optionen, die ähnliche Funktionen anbieten, in den Backends unterschiedlich implementiert. Ein Beispiel für einen solchen Unterschied sind die Optionen \fI\-\-mode Gray\fP und \fI\-\-mode Grayscale\fP. Dies könnte an unterschiedlichen Vorlieben der Backend\-Autoren liegen. In anderen Fällen werden Optionen vom Scan\-Gerät selbst definiert und können vom Backend\-Code nicht beeinflusst werden. .PP Parameter werden durch ein Leerzeichen von einbuchstabigen Optionen (zum Beispiel \fB\-d\fP \fIepson\fP) und durch »=« von mehrbuchstabigen Optionen (zum Beispiel \fB\-\-device\-name\fP=\fIepson\fP) getrennt. .TP \fB\-d\fP\fI Gerät\fP, \fB\-\-device\-name\fP=\fIGerät\fP gibt das Gerät an, auf das zugegriffen werden soll, wobei darauf ein SANE\-Gerätename wie \fIepson:/dev/sg0\fP oder \fIhp:/dev/usbscanner0\fP folgen muss. Eine (unvollständige) Liste der verfügbaren Geräte erhalten Sie mit der Option \fB\-\-list\-devices\fP (siehe nachfolgend). Falls kein Gerätename angegeben ist, liest \fBscanimage\fP einen Gerätenamen aus der Umgebungsvariable \fBSANE_DEFAULT_DEVICE\fP. Ist diese Variable nicht gesetzt, versucht \fBscanimage\fP, das erste verfügbare Gerät zu öffnen. .TP \fB\-\-format\fP=\fIFormat\fP legt fest, in welchem Format die Bilddaten in die Standardausgabe oder die mit der Option \fB\-output\-file\fP angegebene Datei geschrieben werden sollen. Das \fIFormat\fP kann \fBpnm\fP, \fBtiff\fP, \fBpng\fP oder \fBjpeg\fP sein. Falls \fB\-\-format\fP nicht angegeben ist, wird standardmäßig PNM verwendet. .TP \fB\-i\fP\fI Profil\fP, \fB\-\-icc\-profile\fP=\fIProfil\fP wird dazu verwendet, ein ICC\-Profil in eine TIFF\-Datei einzubetten. .TP \fB\-L\fP, \fB\-\-list\-devices\fP bewirkt, dass eine (partielle) Liste der verfügbaren Geräte ausgegeben wird. Diese Liste könnte unvollständig sein, da einige Geräte zwar verfügbar sein könnten, aber in keiner der Konfigurationsdateien ausgeführt sind (welche typischerweise im Verzeichnis \fI/etc/sane.d\fP gespeichert sind). Dies ist insbesondere der Fall, wenn der Zugriff auf Scanner über das Netzwerk erfolgt. Falls ein Gerät nicht in der Konfigurationsdatei aufgeführt ist, ist die Angabe des vollständigen Gerätenamens die einzige Zugriffsmöglichkeit. Kontaktieren Sie Ihren Systemadministrator, um die Namen solcher Geräte herauszufinden. .TP \fB\-f\fP\fI Format\fP, \fB\-\-formatted\-device\-list\fP=\fIFormat\fP funktioniert ähnlich wie \fB\-\-list\-devices\fP, erfordert aber eine Formatzeichenkette. \fBscanimage\fP ersetzt die Platzhalter \fB%d %v %m %t %i %n\fP durch den Gerätenamen, den Herstellernamen, den Modellnamen, den Scannertyp, eine Indexnummer beziehungsweise einen Zeilenumbruch. Der Befehl .LP .RS \fBscanimage \-f\fP \fI\*(lq Scanner Nummer %i, Gerät %d ist ein %t, Model %m, hergestellt von %v \*(rq\fP .LP erzeugt in etwa Folgendes: .PP .RS Scanner Nummer 0, Gerät sharp:/dev/sg1 ist ein Flachbebettscanner, Modell JX250 SCSI, hergestellt von SHARP .RE .RE .PP Die \fB\-\-batch*\fP\-Optionen stellen Funktionen zum Scannen von Dokumenten über automatische Dokumenteneinzüge bereit. .RS .TP \fB\-b\fP [\fIFormat\fP], \fB\-\-batch\fP=[\fIFormat\fP] gibt das Format des Dateinamens an, unter dem jede Seite gespeichert werden soll. Jede Seite wird in eine einzelne Datei geschrieben. Falls kein \fIFormat\fP angegeben ist, wird \fIout%d.pnm\fP als Vorgabe verwendet (oder \fIout%d.tif\fP für \fB\-\-format tiff\fP, \fIout%d.png\fP für \fB\-\-format png\fP oder \fIout%d.jpg\fP für \fB\-\-format jpeg\fP). Diese Option ist zu der Option \fB\-\-output\-path\fP inkompatibel. Das \fIFormat\fP wird als Zeichenkette im Printf\-Stil mit einem ganzzahligen Parameter angegeben. .TP \fB\-\-batch\-start\fP=\fINummer\fP wählt die Seitennummer, mit der die Dateibenennung gestartet werden soll. Falls diese Option nicht angegeben ist, beginnt der Zähler bei 1. .TP \fB\-\-batch\-count\fP=\fIAnzahl\fP gibt die Anzahl der Seiten an, die zu scannen versucht werden sollen. Falls dies nicht angegeben ist, wird das Scannen fortgesetzt, bis der Scanner nicht mehr den Status »OK« zurückgibt. Nicht alle Scanner, die mit einem automatischen Dokumenteneinzug ausgestattet sind, signalisieren, wenn dieser leer ist. Verwenden Sie diese Option, um dies zu umgehen. .TP \fB\-\-batch\-increment\fP=\fISchrittweite\fP gibt die Schrittweite an, um die die Zahl im Dateinamen erhöht werden soll. Im Allgemeinen wird dies verwendet, wenn Sie doppelseitige Dokumente in einem einseitig arbeitenden Dokumenteneinzug scannen. Für diesen Fall ist auch die spezifische Option \fB\-\-batch\-double\fP verfügbar. .TP \fB\-\-batch\-double\fP setzt die Schrittweite automatisch auf 2. Dies ist gleichbedeutend mit \fB\-\-batch\-increment\fP=2. .TP \fB\-\-batch\-prompt\fP erfordert das Drücken der Eingabetaste vor dem Scannen einer Seite. Hiermit können Sie mehrere Seiten scannen, wenn der Scanner nicht über einen automatischen Dokumenteneinzug verfügt. .RE .TP \fB\-\-accept\-md5\-only\fP akzeptiert nur Benutzer\-Autorisierungsanfragen, die MD5\-Sicherheit unterstützen. Der \fBSANE\fP\-Netzwerkdaemon (\fBsaned\fP(8)) kann solche Anfragen ausgeben. .TP \fB\-p\fP, \fB\-\-progress\fP bewirkt, dass \fBscanimage\fP eine Fortschrittsanzeige ausgibt. Es wird angezeigt, wie viele der Daten des aktuellen Bildes bereits empfangen wurden (in Prozent). .TP \fB\-o\fP\fI Pfad\fP, \fB\-\-output\-file\fP=\fIPfad\fP veranlasst \fBscanimage\fP, die Ausgabe des Scanvorgangs im angegebenen Pfad zu speichern. Diese Option ist zur Option \fB\-\-batch\fP inkompatibel. Das Programm versucht, das Format (\fB\-\-format\fP) aus dem Dateinamen zu ermitteln. Falls das nicht möglich ist, wird eine Fehlermeldung ausgegeben und das Programm beendet. .TP \fB\-n\fP, \fB\-\-dont\-scan\fP bewirkt, dass \fBscanimage\fP nur die vom Benutzer angegebenen Optionen setzt, aber nicht tatsächlich einen Scanvorgang ausführt. Diese Option kann beispielsweise dazu verwendet werden, die Lampe des Scanners auszuschalten (sofern dies vom Backend unterstützt wird). .TP \fB\-T\fP, \fB\-\-test\fP bewirkt, dass \fBscanimage\fP einige Plausibilitätsprüfungen ausführt, um sicherzustellen, dass das Backend wie in der \fBSANE\fP\-API definiert funktioniert (insbesondere wird in diesem Test die Funktion \fBsane_read\fP() überprüft). .TP \fB\-A\fP, \fB\-\-all\-options\fP listet alle Optionen auf, die das Backend anbietet, einschließlich der Optionen für Geräteknöpfe. Die Informationen werden in die Standardausgabe geschrieben und es wird kein Scanvorgang ausgeführt. .TP \fB\-h\fP, \fB\-\-help\fP fordert Hilfeinformationen an. Die Informationen werden in die Standardausgabe geschrieben und kein Scanvorgang ausgeführt. .TP \fB\-v\fP, \fB\-\-verbose\fP erhöht die Ausführlichkeitsstufe der Ausgaben von \fBscanimage\fP. Diese Option kann mehrfach angegeben werden, wobei die Ausführlichkeitsstufe jedes Mal weiter erhöht wird. .TP \fB\-B\fP [\fIGröße\fP], \fB\-\-buffer\-size\fP=[\fIGröße\fP] ändert die Größe des Eingabepuffers von den vorgegebenen 32 kB auf die angegebene \fIGröße\fP. Falls keine \fIGröße\fP angegeben ist, wird die Größe des Puffers auf 1 MB gesetzt. .TP \fB\-V\fP, \fB\-\-version\fP bewirkt, dass \fBscanimage\fP den Namen des Programms und Pakets, die Versionsnummer der \fBSANE\fP\-Veröffentlichung und die Version des Backends, das es lädt, ausgibt. Falls weitere Informationen zu den Versionsnummern der Backends nötig sind, kann die \fBDEBUG\fP\-Variable für die \fIdll\fP\-Ebene verwendet werden. Beispiel: \fISANE_DEBUG_DLL=3 scanimage \-L .\fP .PP Wie Sie sich vorstellen können, ergibt sich vieles der Leistungsfähigkeit von \fBscanimage\fP daraus, dass es jedes \fBSANE\fP\-Backend steuern kann. Daher sind die jeweils verfügbaren Befehlszeilenoptionen von den Fähigkeiten des ausgewählten Geräts abhängig. Wenn Sie \fBscanimage\fP in der Befehlszeile in der folgenden Form aufrufen, werden die Optionen für das gewählte \fIGerät\fP angezeigt: .PP .RS scanimage \-\-help \-\-device\-name \fIGerät\fP .RE .PP Die mit der Option \fB\-\-help\fP ausgegebenen gerätespezifischen Optionen lassen sich am besten anhand einiger Beispiele erklären: \fB\-l 0..218mm [0]\fP .RS Obere linke x\-Position des Scanbereichs. .PP Die vorstehende Beschreibung zeigt, dass die Option \fB\-l\fP einen Optionswert von 0 bis einschließlich 218 mm erwartet. Der Wert in eckigen Klammern zeigt an, dass der aktuelle Optionswert 0 mm ist. Die meisten Backends stellen ähnliche Geometrieoptionen für die obere linke y\-Position (\fB\-t\fP), die Breite (\fB\-x\fP) und die Höhe (\fB\-y\fP) des Scanbereichs bereit. .RE \fB\-\-brightness \-100..100% [0]\fP .RS Steuert die Helligkeit des gescannten Bildes. .PP Die vorstehende Beschreibung zeigt, dass die Option \fB\-\-brightness\fP einen Optionswert von \-100 bis einschließlich 100 Prozent erwartet. Der Wert in eckigen Klammern zeigt an, dass der aktuelle Optionswert 0 Prozent ist. .RE \fB\-\-default\-enhancements\fP .RS Legt Standardwerte für die Steuerung der Bildverbesserung fest. .PP Die vorstehende Beschreibung zeigt, dass die Option \fB\-\-default\-enhancements\fP keinen Optionswert hat. Sie wirkt sich unmittelbar an der Stelle der Befehlszeile aus, an der sie sich befindet. Beispielsweise setzt diese Option die Option \fB\-\-brightness\fP auf die Vorgabe zurück. Folglich ergibt das Optionspaar \fB\-\-brightness 50 \-\-default\-enhancements\fP keinen Sinn. .RE \fB\-\-mode Lineart|Gray|Color [Gray]\fP .RS Wählt den Scanmodus (z.B. lineart oder color). .PP Die vorstehende Beschreibung zeigt, dass die Option \fB\-\-mode\fP ein Argument akzeptiert, das eine der Zeichenketten \fBLineart\fP, \fBGray\fP oder \fBColor\fP sein muss. Der Wert in eckigen Klammern gibt an, dass die Option gegenwärtig auf \fBGray\fP gesetzt ist. Zwecks Bequemlichkeit ist es in Ordnung, die Zeichenketten abzukürzen, wobei sie aber eindeutig bleiben müssen. Weiterhin spielt die Groß\- oder Kleinschreibung keine Rolle. Beispielsweise ist die Option \fB\-\-mode col\fP identisch mit \fB\-\-mode Color\fP. .RE \fB\-\-custom\-gamma[=(yes|no)] [inaktiv]\fP .RS Gibt an, ob die eingebaute oder eine benutzerdefinierte Gammatabelle verwendet werden soll. .PP Die vorstehende Beschreibung zeigt, dass die Option \fB\-\-custom\-gamma\fP entweder gar keinen Optionswert oder eine der Zeichenketten »yes« oder »no« erwartet. Die Angabe der Option ohne Wert entspricht der Angabe von »yes«. Der Wert in eckigen Klammern bedeutet, dass die Option gegenwärtig nicht aktiv ist. Das bedeutet, dass ein Versuch, die Option zu setzen, zu einer Fehlermeldung führt. Die verfügbaren Optionen sind typischerweise von anderen gesetzten Optionen abhängig. Beispielsweise könnte die Option \fB\-\-custom\-gamma\fP nur dann aktiv sein, wenn im Graustufen\- oder Farbmodus gescannt wird. Beachten Sie, dass die Option \fB\-\-help\fP erst verarbeitet wird, nachdem alle anderen Optionen verarbeitet wurden. Dadurch ist es möglich, die Optionseinstellungen für einen bestimmten Modus anzeigen zu lassen, indem Sie die entsprechenden Modus\-Optionen zusammen mit der Option \fB\-\-help\fP angeben. Zum Beispiel würde die Befehlszeile .PP \fBscanimage \-\-help \-\-mode\fP \fIFarbe\fP .PP die Optionseinstellungen ausgeben, die wirksam sind, wenn der Farbmodus ausgewählt ist. .RE \fB\-\-gamma\-table 0 … 255, …\fP .RS gibt die Gammakorrekturtabelle an. Im Farbmodus beeinflusst diese Option die Rot\-, Grün\- und Blau\-Kanäle gleichermaßen (was bedeutet, dass es eine Intensitäts\-Gammakorrekturtabelle ist). .PP Die vorstehende Beschreibung zeigt, dass die Option \fB\-\-gamma\-table\fP null oder mehrere Werte von 0 bis 255 erwartet. Ein zulässiger Wert für diese Option wäre beispielsweise »3,4,5,6,7,8,9,10,11,12«. Da die Angabe langer Vektoren in dieser Form etwas unhandlich ist, können Sie dies auch in der Kurzform »[0]3\-[9]12« ausdrücken. Das bedeutet, dass das erste Vektorelement auf 3 und das neunte auf 12 gesetzt ist und die Zwischenwerte linear interpoliert werden. Natürlich ist es möglich, mehrere solcher linearen Segmente anzugeben. Beispielsweise ist »[0]3\-[2]3\-[6]7,[7]10\-[9]6« gleichbedeutend mit »3,3,3,4,5,6,7,10,8,6«. Mit dem Programm \fBgamma4scanimage\fP können Sie solche Gammatabellen erzeugen (siehe \fBgamma4scanimage\fP(1) für Details). .RE \fB\-\-filename [/tmp/Eingabe.ppm]\fP .RS Der Dateiname des zu ladenden Bildes. .PP Die vorstehende Beschreibung ist ein Beispiel für eine Option, die einen beliebigen Zeichenkettenwert (hier einen Dateinamen) akzeptiert. Der Wert in Klammern zeigt wieder, dass die Option gegenwärtig auf den Dateinamen \fI/tmp/Eingabe.ppm\fP gesetzt ist. .RE .SH UMGEBUNGSVARIABLEN .TP \fBSANE_DEFAULT_DEVICE\fP Der Standard\-Gerätename. .SH DATEIEN .TP \fI/etc/sane.d\fP Dieses Verzeichnis enthält verschiedene Konfigurationsdateien. Details hierzu finden Sie in den nachfolgend aufgelisteten Handbuchseiten. .TP \fI~/.sane/pass\fP Diese Datei enthält Zeilen der Form .PP .RS Benutzer:Passwort:Ressource .PP \fBscanimage\fP verwendet diese Information, um Autorisierungsanfragen von Benutzern automatisch zu beantworten. Die Datei muss die Zugriffsrechte 0600 oder strikter haben. Sie sollten diese Datei zusammen mit der Option \fB\-\-accept\-md5\-only\fP verwenden, um serverseitige Angriffe zu verhindern. die Ressource kann beliebige Zeichen enthalten, aber nur bis zu 127 Zeichen insgesamt. .SH "SIEHE AUCH" \fBsane\fP(7), \fBgamma4scanimage\fP(1), \fBxscanimage\fP(1), \fBxcam\fP(1)\fB,\fP \fBxsane\fP(1)\fB,\fP \fBscanadf\fP(1), \fBsane\-dll\fP(5), \fBsane\-net\fP(5), \fBsane\-"backendname"\fP(5) .SH AUTOR David Mosberger, Andreas Beck, Gordon Matzigkeit, Caskey Dickson und viele andere. Für Fragen und Kommentare schreiben Sie an die »sane\-devel«\-Mailingliste (siehe \fIhttp://www.sane\-project.org/mailing\-lists.html\fP). .SH FEHLER Bei Vektoroptionen gibt die Hilfeausgabe derzeit keinen Hinweis darauf, wie viele Elemente ein Vektorwert haben sollte. .PP .SH ÜBERSETZUNG Die deutsche Übersetzung dieser Handbuchseite wurde von Mario Blättermann 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 .