Debian Codegraph @

upstream/debian-unstable/man5/sane-pieusb.5

raw
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