From cfd27ef2ad8b005fd47ab41ef29b71d9e3d48201 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?J=C3=B6rg=20Frings-F=C3=BCrst?= Date: Thu, 8 Oct 2015 12:32:49 +0200 Subject: Imported Upstream version 1.0.25 --- doc/sane-pieusb.man | 111 ++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 111 insertions(+) create mode 100644 doc/sane-pieusb.man (limited to 'doc/sane-pieusb.man') 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 + +.SH AUTHORS +The pieusb backend is based on work by Jan Vleeshouwers, Michael +Rickmann, and Klaus Kämpf -- cgit v1.2.3