summaryrefslogtreecommitdiff
path: root/doc/sane-lexmark.man
blob: 0f1fd6e525f406347a0ea489cac4b50dc00a4f38 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
.TH "sane\-lexmark" "5" "12 Jul 2008" "@PACKAGEVERSION@" "SANE Scanner Access Now Easy"
.IX sane\-lexmark
.SH "NAME"
sane\-lexmark \- SANE backend for Lexmark X1100/X1200 Series scanners
.SH "DESCRIPTION"
The
.B sane\-lexmark
library implements a SANE (Scanner Access Now Easy) backend that
provides access to the scanner part of Lexmark X1100/X1200 AIOs. This backend
should be considered
.B beta-quality
software!
.PP
The scanners that should work with this backend are:
.PP
.RS
.ft CR
.nf
   Vendor Model           status
\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-  \-\-\-\-\-\-\-\-\-\-\-
  Lexmark X74             good
  Lexmark X1110           untested
  Lexmark X1140           untested
  Lexmark X1150           good
  Lexmark X1170           good
  Lexmark X1180           good
  Lexmark X1185           complete
  Lexmark X12xx           good in USB1.1,
                          not fully tested in USB2.0
  Dell    A920            good
.fi
.ft R
.RE

The options the backend supports can either be selected through
command line options to programs like
.BR scanimage (1)
or through GUI elements in
.BR xscanimage (1)
or
.BR xsane (1).

.br
If you notice any strange behavior, please report to the backend
maintainer or to the SANE mailing list.

Valid command line options and their syntax can be listed by using
.RS
.PP
scanimage \-\-help \-d lexmark:usb:<usb port>
.RE

.TP
.B Scan Mode Options

.TP
.B \-\-mode
selects the basic mode of operation of the scanner. Valid choices are
.IR Color ,
.I Gray
and
.IR Lineart .
The default mode is
.IR Color .
The
.I Lineart
mode is black and white only (1 bit).
.I Gray
mode will produce 256 levels of gray (8 bits).
.I Color
mode allows for over 16 million different colors produced from 24
bits of color information.

.TP
.B \-\-resolution
selects the resolution for a scan. The horizontal and vertical resolutions are set
by the value of this option. The scanner is capable of the following resolutions for the specified option value:
.PP
.RS
.ft CR
.nf
  Value   Hor. Resolution  Vert. Resolution
  \-\-\-\-\-   \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-  \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-
  75      75dpi            75dpi
  150     150dpi           150dpi
  300     300dpi           300dpi
  600     600dpi           600dpi
  1200    600dpi           1200dpi  (only for X11xx models with 'B2' sensor)
.fi
.ft R
.RE

.TP
.B \-\-preview
requests a preview scan. The resolution used for that scan is 75 dpi
and the scan area and the scan mode are as specified through their options,
or the default if not specified. The default value for preview mode is "no".

.TP
.B \-\-threshold
selects the  minimum-brightness to get a white point. The threshold is only used with Lineart mode scans.
It is specified as a percentage in the range 0..100% (in steps of 1).
The default value of the threshold option is 50.


.SH "CONFIGURATION FILE"
The configuration file
.I @CONFIGDIR@/lexmark.conf
contains only the usb device id (eg usb 0x043d 0x007c).


.SH "FILES"
.TP
.I @LIBDIR@/libsane\-lexmark.a
The static library implementing this backend.
.TP
.I @LIBDIR@/libsane\-lexmark.so
The shared library implementing this backend (present on systems that
support dynamic loading).


.SH "ENVIRONMENT"
.TP
.B SANE_DEBUG_LEXMARK
If the library was compiled with debug support enabled, this
environment variable controls the debug level for this backend. E.g.,
a value of 255 requests all debug output to be printed. Smaller levels
reduce verbosity.
.TP
.B SANE_DEBUG_LEXMARK_LOW
Provides debug output for low level Lexmark functions.

.SH "LIMITATIONS"
The windows TWAIN driver has many more options than this SANE
backend. However they are only software adjustments. This backend only
implements what the scanner can support. For instance, shading correction
(vertical stripes due to sensor variation across its width) is done in
software. Head park position is also detected by software.
The data compression isn't supported for the X1200 series on USB 1.1,
leading to slow scans.

.SH "BUGS"
.br
No bugs currently known.



.SH "SEE ALSO"
.BR sane\-scsi (5),
.BR scanimage (1),
.BR xscanimage (1),
.BR xsane (1),
.BR sane (7)


.SH "AUTHOR"
.TP
The backend was originally written by Fred Odendaal.
.I http://ca.geocities.com/freshshelf@rogers.com/
.TP
The new version is currently developed by St\['e]phane Voltz.
.I http://stef.dev.free.fr/sane/lexmark
.TP
X74 support was written by Torsten Houwaart
.RI < ToHo@gmx.de >

.SH "CREDITS"
.TP
Many thanks go to:
Julien Furgerot who lent me a Dell A920.
Robert Price, Dani Ele  and Dalai Felinto for the time they spent recording
USB activity and testing the experimental version.