.\" -*- coding: UTF-8 -*- .\"******************************************************************* .\" .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* .TH sane\-test 5 "14. Juli 2008" "" "SANE Scanner Access Now Easy" .IX sane\-test .SH BEZEICHNUNG sane\-test \- SANE\-Backend zum Testen von Frontends .SH BESCHREIBUNG Die Bibliothek \fBsane\-test\fP implementiert ein SANE\-(Scanner Access Now Easy) Backend, das das Testen von SANE\-Installationen und SANE\-Oberflächen erlaubt. Es stellt einen Zugriff auf eine (fast) unbegrenzte Anzahl an virtuellen Geräten bereit. Es gibt keinerlei Unterstützung für echte Scanner oder Kameras. Allerdings simuliert das Backend das Scannen und Setzen von Optionen. .PP Die Idee besteht darin, nicht nur Fehler in Oberflächen zu finden, sondern auch alle Möglichkeiten von SANE zu zeigen. Daher implementiert \fBsane\-test\fP Funktionen und Optionen, die nicht (oder selten) in anderen Backends gefunden werden können. .PP Das Backend ist in \fI/etc/sane.d/dll.conf\fP auskommentiert, so dass entweder das Kommentarzeichen entfernt oder das Backend explizit aufgerufen werden muss. Z.B. \fIscanimage \-d test\fP oder \fIxscanimage test\fP. .SH SCAN\-MODUS\-OPTIONEN Die Option \fBmode\fP wählt den Scan\-Modus (Gray oder Color) aus. .PP Die Option \fBdepth\fP bestimmt die Anzahl der Bits pro Probe (1, 8 oder 16). Denken Sie daran, dass sich dieser Wert auf die Probe bezieht, nicht den Bildpunkt. Daher führt »depth=16« im Farbmodus zu 48 bit pro Bildpunkt. Die gebräuchlichsten Kombinationen sind »mode=Gray, depth=1« für den Lineart\-, »mode=Gray, depth=8« für den Graustufen\- und »mode=Color, depth=8« für den Farbmodus. Die Kombination von Farbe und 1\-bit\-Modus ist recht unbedeutend (8 Farben), aber vom SANE\-Standard erlaubt. Allerdings ist die Bedeutung von Bits nicht definiert. Derzeit wird 1 = Hohe Intensität und 0 = Niedrige Intensität verwendet. .PP Setzen der Option \fBhand\-scanner\fP führt dazu, dass sich das Test\-Backend wie ein Hand\-Scanner verhält. Handscanner kennen die Bildhöhe vorab nicht. Stattdessen liefern sie eine Höhe von \-1. Durch Setzen dieser Option kann geprüft werden, ob eine Oberfläche damit korrekt umgeht. Diese Option aktiviert auch eine feste Breite von 11 cm. .PP Setzen der Option \fBthree\-pass\fP simuliert einen Scanner mit drei Durchläufen. Ältere Farbscanner mussten das Bild jeweils einmal pro Farbe scannen (rot/grün/blau), um das komplette Bild zu erhalten. Daher werden in diesem Modus drei einzelne Teilbilder im Farbmodus übertragen. .PP Die Option \fBthree\-pass\-order\fP stellt eine Unterstützung zum Ändern der Reihenfolge der drei Teilbilder dar (siehe obige Option »three\-pass«). Eine Oberfläche sollte alle Reihenfolgen unterstützen. .PP Die Option \fBresolution\fP setzt die Auflösung des Bildes in Punkte pro Zoll. .PP .PP Die Option \fBsource\fP kann zum Simulieren eines Automatischen Dokumenteneinzugs (ADF) verwendet werden. Nach 10 Scans wird der ADF »leer« sein. .PP .SH "BESONDERE OPTIONEN" Die Option \fBtest\-picture\fP ermöglicht das Setzen des Bildes, das der Oberfläche zurückgeliefert wird. Die Optionen »Solid white« (vollständig weiß) und »Solid black« (vollständig schwarz) sind relativ offensichtlich, die weiteren Optionen benötigen zusätzliche Erklärungen. Farbmuster werden dazu verwendet, zu bestimmen, ob alle Modi und ihre Farben durch die Oberfläche korrekt dargestellt werden. Das Gitter sollte in jedem Modus und jeder Auflösung gleich aussehen. Eine Tabelle aller Testbilder kann unter \fIhttp://www.meier\-geinitz.de/sane/test\-backend/test\-pictures.html\fP gefunden werden. .PP Falls die Option \fBinvert\-endianness\fP gesetzt ist, werden die oberen und unteren Bytes der Bilddaten in 16\-bit\-Modi ausgetauscht. Diese Option kann zum Testen der 16\-bit\-Modi von Oberflächen verwendet werden, z.B. ob die Oberfläche die korrekte Bytereihenfolge (engl. endianness) verwendet. .PP Falls die Option \fBread\-limit\fP gesetzt ist, wird die maximal mit jedem Aufruf von \fBsane_read\fP() übertragene Datenmenge begrenzt. .PP Die Option \fBread\-limit\-size\fP setzt die Begrenzung für die Option »read\-limit«. Eine untere Begrenzung verlangsamt das Scannen. Es kann zum Erkennen von Fehlern in Oberflächen verwendet werden, die aufgrund falscher Annahmen über die Größe des Puffers oder Problemen mit den Zeitvorgaben auftreten. .PP Die Option \fBread\-delay\fP ermöglicht das Verzögern der Weiterleitung von Daten an die Oberfläche. .PP Die Option \fBread\-delay\-duration\fP wählt die Anzahl an Mikrosekunden aus, die das Backend nach jeder Übertragung an einen Puffer wartet. Diese Option ist nützlich, um Probleme mit den Zeitvorgaben zu finden, insbesondere falls es über das Netzwerk verwendet wird. .PP Falls die Option \fBread\-return\-value\fP von »Default« (Vorgabe) verschieden ist, wird der ausgewählte Status bei jedem Aufruf von \fBsane_read\fP() zurückgeliefert. Dies ist nützlich, um die Handhabung der SANE\-Zustände durch die Oberfläche zu testen. .PP Falls die Option \fBppl\-loss\fP von 0 verschieden ist, bestimmt sie die Anzahl der Pixel, die am Ende jeder Zeile »verloren« gehen. Das bedeutet, die Zeilen sind mit nicht benutzten Daten aufgefüllt. .PP Die Option \fBfuzzy\-parameters\fP wählt aus, das unscharfe (ungenaue) Parameter zurückgeliefert werden, solange der Scan noch nicht begonnen wurde. Diese Option kann dazu verwandt werden, zu testen, ob die Oberfläche die erhaltenen Parameter verwendet, bevor der Scan beginnt (was sie nicht sollte). .PP Die Option \fBnon\-blocking\fP ermittelt, ob für \fBsane_read\fP() nicht blockierendes E/A verwendet werden sollte, falls die Oberfläche dies unterstützt. .PP Falls die Option \fBselect\-fd\fP gesetzt ist, bietet das Backend einen Auswahl\-Dateideskriptor an, um zu erkennen, ob \fBsane_read()\fP Daten zurückliefert. .PP Falls die Option \fBenable\-test\-options\fP gesetzt ist, wird eine recht lange Liste an Optionen zum Testen der verschiedenen SANE\-Optionstypen aktiviert. .PP Die Option \fBprint\-options\fP kann zur Ausgabe aller Optionen auf die Standardfehlerausgabe verwandt werden. .PP .SH GEOMETRIEOPTIONEN Die Option \fBtl\-x\fP bestimmt die obere linke X\-Position des Scan\-Bereichs. .PP Die Option \fBtl\-y\fP bestimmt die obere linke Y\-Position des Scan\-Bereichs. .PP Die Option \fBbr\-x\fP bestimmt die untere rechte X\-Position des Scan\-Bereichs. .PP Die Option \fBbr\-y\fP bestimmt die untere rechte Y\-Position des Scan\-Bereichs. .PP .SH "LOGISCHE TESTOPTIONEN" Es gibt insgesamt 6 logische Testoptionen. Jede Option hat eine Zahl. (3/6) bedeutet: dies ist die Option 3 von 6. Das Zählschema ist zur einfacheren Erkennung von Optionen, die von der Oberfläche nicht angezeigt werden (aufgrund fehlender Unterstützung oder Fehlern), gedacht. .PP Die Option \fBbool\-soft\-select\-soft\-detect\fP (1/6) ist eine logische Testoption, die eine sanfte Auswahl und sanfte Erkennung (und fortgeschrittene) Fähigkeiten hat. Sie ist nur eine einfache logische Option. .PP Die Option \fBbool\-hard\-select\-soft\-detect\fP (2/6) ist eine logische Testoption, die eine harte Auswahl und sanfte Erkennung (und fortgeschrittene) Fähigkeiten hat. Das bedeutet, die Option kann nicht durch die Oberfläche, sondern nur durch den Benutzer (z.B. durch Drücken eines Knopfs auf dem Gerät) gesetzt werden. .PP Die Option \fBbool\-hard\-select\fP (3/6) ist eine logische Testoption, die eine harte Auswahl (und fortgeschrittene) Fähigkeiten hat. Das bedeutet, die Option kann nicht durch die Oberfläche, sondern nur durch den Benutzer (z.B. durch Drücken eines Knopfs auf dem Gerät) gesetzt und nicht durch die Oberfläche ausgelesen werden. .PP Die Option \fBbool\-soft\-detect\fP (4/6) ist eine logische Testoption, die eine weiche Auswahl (und fortgeschrittene) Fähigkeiten hat. Das bedeutet, die Option kann nur ausgelesen werden. .PP Die Option \fBbool\-soft\-select\-soft\-detect\-emulated\fP (5/6) ist eine logische Testoption, die eine weiche Auswahl, weiche Erkennung und emulierte (und fortgeschrittene) Fähigkeiten hat. .PP Die Option \fBbool\-soft\-select\-soft\-detect\-auto\fP (6/6) ist eine logische Testoption, die eine weiche Auswahl, weiche Erkennung und automatische (und fortgeschrittene) Fähigkeiten hat. Diese Option kann durch das Backend automatisch gesetzt werden. .PP .SH GANZZAHL\-TESTOPTIONEN Es gibt insgesamt 7 Ganzzahl\-Testoptionen. .PP Die Option \fBint\fP (1/7) ist eine Ganzzahl\-Testoption ohne gesetzte Einheit und Begrenzung. .PP Die Option \fBint\-constraint\-range\fP (2/7) ist eine Ganzzahl\-Testoption mit der Einheit Pixel und einem gesetzten Begrenzungsbereich. Minimum ist 4, Maximum ist 192 und Quant ist 2. .PP Die Option \fBint\-constraint\-word\-list\fP (3/7) ist eine Ganzzahl\-Testoption mit der Einheit Bit und einer gesetzten begrenzten Wortliste. .PP Die Option \fBint\-constraint\-array\fP (4/7) ist eine Ganzzahl\-Testoption mit der Einheit mm und der Verwendung eines Feldes ohne Begrenzung. .PP Die Option \fBint\-constraint\-array\-constraint\-range\fP (5/7) ist eine Ganzzahl\-Testoption mit der Einheit mm und der Verwendung eines Feldes mit einer Bereichsbegrenzung. Minimum ist 4, Maximum ist 192 und Quant ist 2. .PP Die Option \fBint\-constraint\-array\-constraint\-word\-list\fP (6/7) ist eine Ganzzahl\-Testoption mit der Einheit Prozent und der Verwendung eines Feldes mit einer Wortlistenbegrenzung. .PP Die Option \fBint\-inexact\fP (7/7) ist eine Ganzzahl\-Testoption, die den erbetenen Wert erhöht und den Schalter SANE_INFO_INEXACT zurückliefert. .SH "FESTE TESTOPTIONEN" Es gibt insgesamt 3 feste Testoptionen. .PP Die Option \fBfixed\fP (1/3) ist eine feste Testoption ohne gesetzte Einheit und Begrenzung. .PP Die Option \fBfixed\-constraint\-range\fP (2/3) ist eine feste Testoption mit der Einheit Mikrosekunden und gesetztem Begrenzungsbereich. Minimum ist \-42.17, Maximum 32767.9999 und Quant ist 2.0. .PP Die Option \fBfixed\-constraint\-word\-list\fP (3/3) ist eine feste Testoption ohne gesetzte Einheit und gesetzter Wortlistenbegrenzung. .PP .SH ZEICHENKETTENTESTOPTIONEN Es gibt insgesamt 3 Zeichenkettentestoptionen. .PP Die Option \fBstring\fP (1/3) ist eine Zeichenkettentestoption ohne Begrenzung. .PP Die Option \fBstring\-constraint\-string\-list\fP (2/3) ist eine Zeichenkettentestoption mit Zeichenkettenlistenbeschränkung. .PP Die Option \fBstring\-constraint\-long\-string\-list\fP (3/3) ist eine Zeichenkettentestoption mit Zeichenkettenlistenbeschränkung. Enthält einige weitere Einträge … .PP .SH KNOPFTESTOPTIONEN Die Option \fBbutton\fP (1/1) ist eine Knopftestoption. Gibt Text aus … .PP .SH DATEIEN .TP \fI/etc/sane.d/test.conf\fP Die Backendkonfigurationsdatei (siehe auch die nachfolgende Beschreibung von \fBSANE_CONFIG_DIR\fP). Die anfänglichen Werte der meisten grundlegenden SANE\-Optionen können in dieser Datei konfiguriert werden. Eine Vorlage, die alle Vorgabewerte enthält, wird mit diesem Backend zusammen bereitgestellt. Einer der interessanteren Werte könnte \fBnumber_of_devices\fP sein. Dies kann dazu verwendet werden, die Möglichkeiten der Oberfläche zu testen, eine lange Liste an Geräten anzuzeigen. Die Konfigurationswerte bezüglich Auflösung und Geometrie können zum Testen des Umgangs mit großen Dateien verwendet werden. .TP \fI/usr/lib/x86_64\-linux\-gnu/sane/libsane\-test.a\fP Die statische Bibliothek, die dieses Backend implementiert. .TP \fI/usr/lib/x86_64\-linux\-gnu/sane/libsane\-test.so\fP Die dynamische Bibliothek, die dieses Backend implementiert (auf Systemen verfügbar, die dynamisches Laden unterstützen). .SH UMGEBUNGSVARIABLEN .TP \fBSANE_CONFIG_DIR\fP Diese Umgebungsvariable gibt eine Liste von Verzeichnissen an, die die Konfigurationsdatei enthalten können. Auf *NIX\-Systemen sind die Verzeichnisse durch Doppelpunkte (:) getrennt, unter OS/2 durch Semikola (;). Falls diese Variable nicht gesetzt ist, wird in zwei Standardverzeichnissen nach der Konfigurationsdatei gesucht: zuerst im aktuellen Arbeitsverzeichnis (.) und dann in \fI/etc/sane.d\fP. Falls der Wert der Umgebungsvariable mit dem Verzeichnis\-Trennzeichen endet, dann werden die Standardverzeichnisse nach den explizit angegebenen Verzeichnissen durchsucht. Wenn Sie beispielsweise \fBSANE_CONFIG_DIR\fP auf »/tmp/config:« setzen, wird in den Verzeichnissen »tmp/config«, ».« und »/etc/sane.d« gesucht (in dieser Reihenfolge). .TP \fBSANE_DEBUG_TEST\fP Falls die Bibliothek mit Debug\-Unterstützung kompiliert wurde, steuert diese Umgebungsvariable die Debug\-Stufe für dieses Backend. Größere Werte erhöhen die Ausführlichkeit der Ausgabe. Beispiel: export SANE_DEBUG_TEST=4 .SH "SIEHE AUCH" \fBsane\fP(7), \fBscanimage\fP(1), \fBxscanimage\fP(1) .br \fIhttp://www.meier\-geinitz.de/sane/test\-backend/\fP .SH AUTOR Henning Meier\-Geinitz <\fIhenning@meier\-geinitz.de\fP> .SH FEHLER \- Konfigurationsdateiwerte werden nicht auf Korrektheit geprüft .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 .