summaryrefslogtreecommitdiff
path: root/doc/sane-pieusb.man
diff options
context:
space:
mode:
authorJörg Frings-Fürst <debian@jff-webhosting.net>2015-09-27 08:20:20 +0200
committerJörg Frings-Fürst <debian@jff-webhosting.net>2015-09-27 08:20:20 +0200
commite94622c319e4307617b202f19d3ec05b21a9bb49 (patch)
treec5ddf44352b9bd47aeb3eb432ba79638079efe25 /doc/sane-pieusb.man
parent6f2255c9648b175d51e2c8e5e9670557f9dc4ee1 (diff)
merge to 1.0.25+git20150927
Diffstat (limited to 'doc/sane-pieusb.man')
-rw-r--r--doc/sane-pieusb.man111
1 files changed, 111 insertions, 0 deletions
diff --git a/doc/sane-pieusb.man b/doc/sane-pieusb.man
new file mode 100644
index 0000000..e38e8e1
--- /dev/null
+++ b/doc/sane-pieusb.man
@@ -0,0 +1,111 @@
+.TH sane\-pieusb 5 "10 Aug 2015" "@PACKAGEVERSION@" "SANE Scanner Access Now Easy"
+.IX sane\-pieusb
+.SH NAME
+sane\-pieusb \- SANE backend for USB-connected PIE PowerSlide and
+Reflecta DigitDia/CrystalScan/ProScan slide scanners
+
+.SH DESCRIPTION
+The
+.B sane\-pieusb
+library implements a SANE (Scanner Access Now Easy) backend that
+provides access to USB-connected PIE and Reflecta slide scanners.
+.br
+At present, the following scanners should work with this backend:
+.PP
+.ft CR
+.nf
+Model: Status
+------------------------- ------
+PIE PowerSlide 3600 Untested
+PIE PowerSlide 3650 Untested
+PIE PowerSlide 4000 Untested
+PIE PowerSlide 5000 Untested
+Reflecta CrystalScan 7200 Untested
+Reflecta ProScan 4000 Untested
+Reflecta ProScan 7200 Untested
+Reflecta DigitDia 3600 Untested
+Reflecta DigitDia 4000 Untested
+Reflecta DigitDia 5000 Untested
+Reflecta DigitDia 6000 Ok
+.fi
+.ft R
+.PP
+
+.SH "MULTIPLE SLIDES"
+Support for multiple slide scanners (like the PowerSlide or DigitDia
+series) is done by auto-advancing ('Advance slide' setting) the slide
+after each scan.
+
+However, for best results, it is recommended to do a preview for
+every slide since this sets gamma, brightness, and contrast to optimal
+values.
+
+Attention: SANE does not have an automatic landscape/portrait
+detection and re-orientation when scanning multiple slides. You have
+to put all slides into one orientation first !
+
+.SH "DIRT REMOVAL"
+If available, pieusb supports infrared scans for dirt detection and
+removal. This must be enabled via the 'Clean image' setting.
+
+.SH "KNOWN PROBLEMS"
+The pieusb backend supports dirt removal based on infrared scan
+information. Since SANE does not provide post-processing in the
+backend, pieusb does the scanning and dirt removal during the setup
+phase. The 'scan' phase is only used to transfer the completed image.
+Therefore pieusb does not multi-thread making a typical frontend
+appear as 'blocked'. Also cancel requests are only honored between
+scans.
+
+.SH "ENVIRONMENT"
+.TP
+.B SANE_DEBUG_PIEUSB
+If the library was compiled with debug support enabled, this
+environment variable controls the debug level for this backend. E.g.,
+a value of 128 requests all debug output to be printed. Smaller
+levels reduce verbosity.
+
+.PP
+.RS
+.ft CR
+.nf
+level debug output
+\-\-\-\-\-\-\- \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-
+ 0 nothing
+ 1 errors
+ 2 warnings & minor errors
+ 5 additional information
+ 7 SANE api calls
+ 9 backend functions
+11 scanner functions
+13 usb functions
+15 image buffer functions
+.fi
+.ft R
+.RE
+.PP
+
+.SH FILES
+.TP
+.I @CONFIGDIR@/pieusb.conf
+The backend configuration file
+.TP
+.I @LIBDIR@/libsane\-pieusb.a
+The static library implementing this backend.
+.TP
+.I @LIBDIR@/libsane\-pieusb.so
+The shared library implementing this backend (present on systems that
+support dynamic loading).
+.PP
+
+.SH SEE ALSO
+sane(7)
+
+.SH "CONTACT AND BUG-REPORTS"
+Please send any information and bug-reports to:
+.br
+.B Klaus Kämpf <kkaempf@suse.com>
+
+.SH AUTHORS
+The pieusb backend is based on work by Jan Vleeshouwers, Michael
+Rickmann, and Klaus Kämpf