Man page - sane-test(5)

Packages contains this manual

Available languages:

en ro de

Manual

sane-test

BEZEICHNUNG
BESCHREIBUNG
SCAN-MODUS-OPTIONEN
BESONDERE OPTIONEN
GEOMETRIEOPTIONEN
LOGISCHE TESTOPTIONEN
GANZZAHL-TESTOPTIONEN
FESTE TESTOPTIONEN
ZEICHENKETTENTESTOPTIONEN
KNOPFTESTOPTIONEN
DATEIEN
UMGEBUNGSVARIABLEN
SIEHE AUCH
AUTOR
FEHLER
ÜBERSETZUNG

BEZEICHNUNG

sane-test - SANE-Backend zum Testen von Frontends

BESCHREIBUNG

Die Bibliothek sane-test 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.

Die Idee besteht darin, nicht nur Fehler in OberflÀchen zu finden, sondern auch alle Möglichkeiten von SANE zu zeigen. Daher implementiert sane-test Funktionen und Optionen, die nicht (oder selten) in anderen Backends gefunden werden können.

Das Backend ist in /etc/sane.d/dll.conf auskommentiert, so dass entweder das Kommentarzeichen entfernt oder das Backend explizit aufgerufen werden muss. Z.B. scanimage -d test oder xscanimage test .

SCAN-MODUS-OPTIONEN

Die Option mode wÀhlt den Scan-Modus (Gray oder Color) aus.

Die Option depth 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.

Setzen der Option hand-scanner 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.

Setzen der Option three-pass 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.

Die Option three-pass-order 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.

Die Option resolution setzt die Auflösung des Bildes in Punkte pro Zoll.

Die Option source kann zum Simulieren eines Automatischen Dokumenteneinzugs (ADF) verwendet werden. Nach 10 Scans wird der ADF »leer« sein.

BESONDERE OPTIONEN

Die Option test-picture 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 http://www.meier-geinitz.de/sane/test-backend/test-pictures.html gefunden werden.

Falls die Option invert-endianness 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.

Falls die Option read-limit gesetzt ist, wird die maximal mit jedem Aufruf von sane_read () ĂŒbertragene Datenmenge begrenzt.

Die Option read-limit-size 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.

Die Option read-delay ermöglicht das Verzögern der Weiterleitung von Daten an die OberflÀche.

Die Option read-delay-duration 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.

Falls die Option read-return-value von »Default« (Vorgabe) verschieden ist, wird der ausgewĂ€hlte Status bei jedem Aufruf von sane_read () zurĂŒckgeliefert. Dies ist nĂŒtzlich, um die Handhabung der SANE-ZustĂ€nde durch die OberflĂ€che zu testen.

Falls die Option ppl-loss 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.

Die Option fuzzy-parameters 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).

Die Option non-blocking ermittelt, ob fĂŒr sane_read () nicht blockierendes E/A verwendet werden sollte, falls die OberflĂ€che dies unterstĂŒtzt.

Falls die Option select-fd gesetzt ist, bietet das Backend einen Auswahl-Dateideskriptor an, um zu erkennen, ob sane_read() Daten zurĂŒckliefert.

Falls die Option enable-test-options gesetzt ist, wird eine recht lange Liste an Optionen zum Testen der verschiedenen SANE-Optionstypen aktiviert.

Die Option print-options kann zur Ausgabe aller Optionen auf die Standardfehlerausgabe verwandt werden.

GEOMETRIEOPTIONEN

Die Option tl-x bestimmt die obere linke X-Position des Scan-Bereichs.

Die Option tl-y bestimmt die obere linke Y-Position des Scan-Bereichs.

Die Option br-x bestimmt die untere rechte X-Position des Scan-Bereichs.

Die Option br-y bestimmt die untere rechte Y-Position des Scan-Bereichs.

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.

Die Option bool-soft-select-soft-detect (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.

Die Option bool-hard-select-soft-detect (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.

Die Option bool-hard-select (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.

Die Option bool-soft-detect (4/6) ist eine logische Testoption, die eine weiche Auswahl (und fortgeschrittene) FĂ€higkeiten hat. Das bedeutet, die Option kann nur ausgelesen werden.

Die Option bool-soft-select-soft-detect-emulated (5/6) ist eine logische Testoption, die eine weiche Auswahl, weiche Erkennung und emulierte (und fortgeschrittene) FĂ€higkeiten hat.

Die Option bool-soft-select-soft-detect-auto (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.

GANZZAHL-TESTOPTIONEN

Es gibt insgesamt 7 Ganzzahl-Testoptionen.

Die Option int (1/7) ist eine Ganzzahl-Testoption ohne gesetzte Einheit und Begrenzung.

Die Option int-constraint-range (2/7) ist eine Ganzzahl-Testoption mit der Einheit Pixel und einem gesetzten Begrenzungsbereich. Minimum ist 4, Maximum ist 192 und Quant ist 2.

Die Option int-constraint-word-list (3/7) ist eine Ganzzahl-Testoption mit der Einheit Bit und einer gesetzten begrenzten Wortliste.

Die Option int-constraint-array (4/7) ist eine Ganzzahl-Testoption mit der Einheit mm und der Verwendung eines Feldes ohne Begrenzung.

Die Option int-constraint-array-constraint-range (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.

Die Option int-constraint-array-constraint-word-list (6/7) ist eine Ganzzahl-Testoption mit der Einheit Prozent und der Verwendung einer Feld- oder Wortlistenbegrenzung.

Die Option int-inexact (7/7) ist eine Ganzzahl-Testoption, die den erbetenen Wert erhöht und den Schalter SANE_INFO_INEXACT zurĂŒckliefert.

FESTE TESTOPTIONEN

Es gibt insgesamt 3 feste Testoptionen.

Die Option fixed (1/3) ist eine feste Testoption ohne gesetzte Einheit und Begrenzung.

Die Option fixed-constraint-range (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.

Die Option fixed-constraint-word-list (3/3) ist eine feste Testoption ohne gesetzte Einheit und gesetzter Wortlistenbegrenzung.

ZEICHENKETTENTESTOPTIONEN

Es gibt insgesamt 3 Zeichenkettentestoptionen.

Die Option string (1/3) ist eine Zeichenkettentestoption ohne Begrenzung.

Die Option string-constraint-string-list (2/3) ist eine Zeichenkettentestoption mit ZeichenkettenlistenbeschrÀnkung.

Die Option string-constraint-long-string-list (3/3) ist eine Zeichenkettentestoption mit ZeichenkettenlistenbeschrÀnkung. EnthÀlt einige weitere EintrÀge 


KNOPFTESTOPTIONEN

Die Option button (1/1) ist eine Knopftestoption. Gibt Text aus 


DATEIEN

/etc/sane.d/test.conf

Die Backendkonfigurationsdatei (siehe auch die nachfolgende Beschreibung von SANE_CONFIG_DIR ). 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 number_of_devices 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.

/usr/lib/x86_64-linux-gnu/sane/libsane-test.a

Die statische Bibliothek, die dieses Backend implementiert.

/usr/lib/x86_64-linux-gnu/sane/libsane-test.so

Die dynamische Bibliothek, die dieses Backend implementiert (auf Systemen verfĂŒgbar, die dynamisches Laden unterstĂŒtzen).

UMGEBUNGSVARIABLEN

SANE_CONFIG_DIR

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 /etc/sane.d . Falls der Wert der Umgebungsvariable mit dem Verzeichnis-Trennzeichen endet, dann werden die Standardverzeichnisse nach den explizit angegebenen Verzeichnissen durchsucht. Wenn Sie beispielsweise SANE_CONFIG_DIR auf »/tmp/config:« setzen, wird in den Verzeichnissen »tmp/config«, ».« und »/etc/sane.d« gesucht (in dieser Reihenfolge).

SANE_DEBUG_TEST

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

SIEHE AUCH

sane (7), scanimage (1), xscanimage (1)
http://www.meier-geinitz.de/sane/test-backend/

AUTOR

Henning Meier-Geinitz < henning@meier-geinitz.de >

FEHLER

- Konfigurationsdateiwerte werden nicht auf Korrektheit geprĂŒft

ÜBERSETZUNG

Die deutsche Übersetzung dieser Handbuchseite wurde von Mario BlĂ€ttermann <mario.blaettermann@gmail.com> und Helge Kreutzmann <debian@helgefjell.de> erstellt.

Diese Übersetzung ist Freie Dokumentation; lesen Sie die GNU General Public License Version 3 oder neuer bezĂŒglich der Copyright-Bedingungen. Es wird KEINE HAFTUNG ĂŒbernommen.

Wenn Sie Fehler in der Übersetzung dieser Handbuchseite finden, schicken Sie bitte eine E-Mail an die Mailingliste der Übersetzer: debian-l10n-german@lists.debian.org .