Debian Codegraph @

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

raw
1 .TH sane\-matsushita 5 "11 Jul 2008" "" "SANE Scanner Access Now Easy"
2 .IX sane\-matsushita
3 .SH NAME
4 sane\-matsushita \- SANE backend for Panasonic KV-SS high speed scanners
5 .SH DESCRIPTION
6 The
7 .B sane\-matsushita
8 library implements a SANE (Scanner Access Now Easy) backend that
9 provides access to some Panasonic KV-SS high speed scanners. This
10 backend is stable.
11 .PP
12 At present, the following scanners are known to work with this
13 backend:
14 .PP
15 .RS
16 .ft CR
17 .nf
18 Product id
19 --------------
20 KV-SS25
21 KV-SS25D
22 KV-SS55EX (*)
23 KV-S2025C (*)
24 KV-S2045C (*)
25 KV-S2065L (*)
26 .fi
27 .ft R
28 .RE
29 .PP
30 (*) WARNING: None of the advanced options of these scanners are available (i.e. no color, no high resolution, no automatic cropping). Basically, the driver does no more than what it does for the KV-SS25. I don't have access to such scanners, and thus cannot add these options.
31
32 Other Panasonic high speed scanners may or may not work with that backend.
33
34 Valid command line options and their syntax can be listed by using:
35 .RS
36 .PP
37 .I scanimage \-\-help \-d matsushita
38 .RE
39
40 .TP
41 .B Scan Mode
42
43 .TP
44 .B \-\-mode
45 selects the basic mode of operation of the scanner.
46 .TP
47 .B \-\-resolution
48 selects the resolution for a scan. Each model supports all or a subset of these resolutions: 100, 150, 200, 240, 300, 360, 400.
49 .TP
50 .B \-\-duplex
51 indicates whether to scan both side of the sheet.
52 .TP
53 .B \-\-feeder\-mode
54 selects the number of pages to scan (one or until the tray is empty).
55
56 .TP
57 .B Geometry
58
59 .TP
60 .B \-\-paper\-size A4|...|Legal|Letter [A4]
61 selects the area to scan. It adjusts the
62 .B \-l \-t \-x \-y
63 options accordingly. It does not need to be the real size of the paper.
64
65 .TP
66 .B \-l \-t \-x \-y
67 controls the scan area: \-l sets the top left x coordinate, \-t the top
68 left y coordinate, \-x selects the width and \-y the height of the scan
69 area. All parameters are specified in millimeters. It is possible to use
70 the option
71 .I \-\-paper\-size
72 instead.
73
74 .TP
75 .B Enhancement
76
77 .TP
78 .B \-\-brightness
79 controls the brightness of the acquired image. The value varies from 1 to 255, or less, depending on the scanner model.
80 .TP
81 .B \-\-contrast
82 controls the contrast of the acquired image. Some models do not support that option.
83 .TP
84 .B \-\-automatic\-threshold
85 automatically sets brightness, contrast, white level, gamma, noise reduction and image emphasis. These options are not available when automatic\-threshold is in use.
86 .TP
87 .B \-\-halftone\-pattern
88 sets the tonal gradation for the halftone mode. Pattern downloading is not implemented by the backend.
89 .TP
90 .B \-\-autoseparation
91 provides automatic separation of text and images.
92 .TP
93 .B \-\-white\-level
94 indicates the source of the white base.
95 .TP
96 .B \-\-noise\-reduction
97 reduces the isolated dot noise. This option is not supported by all scanners.
98 .TP
99 .B \-\-image\-emphasis
100 sets the image emphasis. Some selection are not available on all scanners.
101 .TP
102 .B \-\-gamma
103 sets the gamma curve. It is only valid for Gray modes, and is not available on all scanners. Gamma downloading is not implemented by the backend.
104
105
106 .SH CONFIGURATION FILE
107 The configuration file
108 .I /etc/sane.d/matsushita.conf
109 supports the device name to use (e.g.
110 .IR /dev/scanner )
111 and the SCSI option to auto-detect the scanners supported.
112
113 .SH FILES
114 .TP
115 .I /usr/lib/x86_64-linux-gnu/sane/libsane\-matsushita.a
116 The static library implementing this backend.
117 .TP
118 .I /usr/lib/x86_64-linux-gnu/sane/libsane\-matsushita.so
119 The shared library implementing this backend (present on systems that
120 support dynamic loading).
121
122
123 .SH ENVIRONMENT
124 .TP
125 .B SANE_DEBUG_MATSUSHITA
126 If the library was compiled with debug support enabled, this
127 environment variable controls the debug level for this backend. E.g.,
128 a value of 128 requests all debug output to be printed. Smaller
129 levels reduce verbosity.
130
131
132 .SH LIMITATIONS
133 .TP
134 .B Memory in the KV-SS 25
135 The KV-SS 25 has not enough internal memory to scan a whole A4 page in duplex mode at high resolution. The frontend will return a memory error in that case. Apparently, the KV-SS 25D has not that problem.
136 .TP
137 .B Pattern and gamma downloading
138 The scanner, with the proper firmware, can download a halftone pattern
139 and a gamma table. This is not implemented.
140 .TP
141 .B Sub-areas
142 The scanner can support up to 3 sub-areas on each side to define some
143 more precise enhancement options. This is not implemented.
144 .TP
145 .B Duplex mode
146 The backend does not support the setting of different options for each side. The scan will occur with the same options (halftone pattern, brightness, image emphasis) for both sides.
147
148
149 .SH SCANNING EXAMPLE
150 To date, the only frontend capable of using this scanner at full speed is
151 .BR scanadf (1).
152
153 A
154 .BR scanadf (1)
155 command line would be:
156
157 scanadf \-d matsushita \-\-output\-file scan%04d.pbm \-\-start\-count 0 \-\-duplex \-\-resolution 300 \-\-feeder\-mode="All pages" \-\-paper\-size="A4"
158
159
160 .SH BUGS
161 None known.
162
163
164 .SH "SEE ALSO"
165 .BR sane\-scsi (5),
166 .BR scanimage (1),
167 .BR xscanimage (1),
168 .BR xsane (1),
169 .BR sane (7)
170
171
172 .SH AUTHOR
173
174 .TP
175 The package is actively maintained by Frank Zago.
176 .I http://www.zago.net/sane/#matsushita