| 1 |
.TH sane\-pieusb 5 "10 Aug 2015" "" "SANE Scanner Access Now Easy" |
| 2 |
.IX sane\-pieusb |
| 3 |
.SH NAME |
| 4 |
sane\-pieusb \- SANE backend for USB-connected PIE PowerSlide and |
| 5 |
Reflecta DigitDia/CrystalScan/ProScan slide scanners |
| 6 |
|
| 7 |
.SH DESCRIPTION |
| 8 |
The |
| 9 |
.B sane\-pieusb |
| 10 |
library implements a SANE (Scanner Access Now Easy) backend that |
| 11 |
provides access to USB-connected PIE and Reflecta slide scanners. |
| 12 |
.br |
| 13 |
At present, the following scanners should work with this backend: |
| 14 |
.PP |
| 15 |
.ft CR |
| 16 |
.nf |
| 17 |
Model: Status |
| 18 |
------------------------- ------ |
| 19 |
PIE PowerSlide 3600 Untested |
| 20 |
PIE PowerSlide 3650 Untested |
| 21 |
PIE PowerSlide 4000 Untested |
| 22 |
PIE PowerSlide 5000 Untested |
| 23 |
Reflecta CrystalScan 7200 Untested |
| 24 |
Reflecta ProScan 4000 Untested |
| 25 |
Reflecta ProScan 7200 Untested |
| 26 |
Reflecta DigitDia 3600 Untested |
| 27 |
Reflecta DigitDia 4000 Untested |
| 28 |
Reflecta DigitDia 5000 Untested |
| 29 |
Reflecta DigitDia 6000 Ok |
| 30 |
.fi |
| 31 |
.ft R |
| 32 |
.PP |
| 33 |
|
| 34 |
.SH "MULTIPLE SLIDES" |
| 35 |
Support for multiple slide scanners (like the PowerSlide or DigitDia |
| 36 |
series) is done by auto-advancing ('Advance slide' setting) the slide |
| 37 |
after each scan. |
| 38 |
|
| 39 |
However, for best results, it is recommended to do a preview for |
| 40 |
every slide since this sets gamma, brightness, and contrast to optimal |
| 41 |
values. |
| 42 |
|
| 43 |
Attention: SANE does not have an automatic landscape/portrait |
| 44 |
detection and re-orientation when scanning multiple slides. You have |
| 45 |
to put all slides into one orientation first ! |
| 46 |
|
| 47 |
.SH "DIRT REMOVAL" |
| 48 |
If available, |
| 49 |
.B sane\-pieusb |
| 50 |
supports infrared scans for dirt detection and |
| 51 |
removal. This must be enabled via the 'Clean image' setting. |
| 52 |
|
| 53 |
.SH "KNOWN PROBLEMS" |
| 54 |
The |
| 55 |
.B sane\-pieusb |
| 56 |
backend supports dirt removal based on infrared scan |
| 57 |
information. Since SANE does not provide post-processing in the |
| 58 |
backend, |
| 59 |
.B sane\-pieusb |
| 60 |
does the scanning and dirt removal during the setup |
| 61 |
phase. The 'scan' phase is only used to transfer the completed image. |
| 62 |
Therefore |
| 63 |
.B sane\-pieusb |
| 64 |
does not multi-thread making a typical frontend |
| 65 |
appear as 'blocked'. Also cancel requests are only honored between |
| 66 |
scans. |
| 67 |
|
| 68 |
.SH "ENVIRONMENT" |
| 69 |
.TP |
| 70 |
.B SANE_DEBUG_PIEUSB |
| 71 |
If the library was compiled with debug support enabled, this |
| 72 |
environment variable controls the debug level for this backend. E.g., |
| 73 |
a value of 128 requests all debug output to be printed. Smaller |
| 74 |
levels reduce verbosity. |
| 75 |
|
| 76 |
.PP |
| 77 |
.RS |
| 78 |
.ft CR |
| 79 |
.nf |
| 80 |
level debug output |
| 81 |
\-\-\-\-\-\-\- \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\- |
| 82 |
0 nothing |
| 83 |
1 errors |
| 84 |
2 warnings & minor errors |
| 85 |
5 additional information |
| 86 |
7 SANE api calls |
| 87 |
9 backend functions |
| 88 |
11 scanner functions |
| 89 |
13 usb functions |
| 90 |
15 image buffer functions |
| 91 |
.fi |
| 92 |
.ft R |
| 93 |
.RE |
| 94 |
.PP |
| 95 |
|
| 96 |
.SH FILES |
| 97 |
.TP |
| 98 |
.I /etc/sane.d/pieusb.conf |
| 99 |
The backend configuration file |
| 100 |
.TP |
| 101 |
.I /usr/lib/x86_64-linux-gnu/sane/libsane\-pieusb.a |
| 102 |
The static library implementing this backend. |
| 103 |
.TP |
| 104 |
.I /usr/lib/x86_64-linux-gnu/sane/libsane\-pieusb.so |
| 105 |
The shared library implementing this backend (present on systems that |
| 106 |
support dynamic loading). |
| 107 |
.PP |
| 108 |
|
| 109 |
.SH SEE ALSO |
| 110 |
.BR sane (7) |
| 111 |
|
| 112 |
.SH "CONTACT AND BUG-REPORTS" |
| 113 |
Please send any information and bug-reports to: |
| 114 |
.br |
| 115 |
Klaus Kämpf |
| 116 |
.RI < [email protected] > |
| 117 |
|
| 118 |
.SH AUTHORS |
| 119 |
The pieusb backend is based on work by Jan Vleeshouwers, Michael |
| 120 |
Rickmann, and Klaus Kämpf |