Debian Codegraph @

upstream/fedora-44/man5/sane-artec_eplus48u.5

raw
1 .TH sane\-artec_eplus48u 5 "11 Jul 2008" "" "SANE"
2 .SH NAME
3 sane\-artec_eplus48u \- SANE backend for the scanner Artec E+ 48U and re-badged models
4 .SH DESCRIPTION
5 The
6 .B sane\-artec_eplus48u
7 library implements a SANE (Scanner Access Now Easy) backend that provides
8 access to several USB flatbed scanners using the GT6816 chipset like the Artec E+ 48U.
9 These scanners have a contact image sensor (CIS).
10 .PP
11 A complete list of supported devices can be found on
12 .IR http://www.sane\-project.org/sane\-supported\-devices.html .
13 .PP
14 This is ALPHA software. Especially if you test new or untested scanners, keep
15 your hand at the scanner's plug and unplug it, if the head bumps at the end of
16 the scan area.
17 .PP
18 If you own a scanner other than the ones mentioned on the list that works with this
19 backend, please let us know this by sending the scanner's exact model name and
20 the USB vendor and product ids (e.g. from
21 .IR /proc/bus/usb/devices ,
22 .BR sane\-find\-scanner (1)
23 or syslog) to me. Even if the scanner's name is only
24 slightly different from the models mentioned above, please let me know.
25 .PP
26 .SH KERNEL ISSUES
27 If libusb-0.1.6 or later is installed, this section can be skipped. The
28 scanner should be found by
29 .BR sane\-find\-scanner (1)
30 without further actions. For setting permissions and general USB information
31 look at
32 .BR sane\-usb (5).
33 .PP
34 When you are using the scanner module, a Linux kernel 2.4.12 or newer is
35 required.
36
37 .SH FIRMWARE FILE
38 You need a firmware file for your scanner. That's a small file containing
39 software that will be uploaded to the scanner's memory. For the scanners
40 mentioned above, it's usually named
41 .I Artec48.usb
42 or
43 .IR 1200.usb .
44 You can find it on the installation CD that was provided by the manufacturer,
45 normally in the directory Win98, WinMe or similar.
46 If the Windows-driver is installed on your computer, then you can also
47 find the firmware file under
48 .IR c:\\windows\\system32\\drivers .
49
50 .SH CONFIGURATION
51 The contents of the
52 .I artec_eplus48u.conf
53 file is a list of
54 .I usb
55 lines containing vendor and product ids that correspond
56 to USB scanners. The file can also contain option lines. Empty lines and
57 lines starting with a hash mark (#) are ignored. The scanners are
58 autodetected by
59 .I usb vendor_id product_id
60 statements which are already included into
61 .I artec_eplus48u.conf .
62 "vendor_id" and "product_id" are hexadecimal numbers that identify the scanner.
63 .PP
64 Every
65 .I usb
66 section can have additional options.
67 .TP
68 .B artecFirmwareFile /usr/share/sane/artec_eplus48u/Artec48.usb
69 The path to the firmware file. This option is required.
70 .TP
71 .B redGamma 1.0
72 .TP
73 .B greenGamma 1.0
74 .TP
75 .B blueGamma 1.0
76 .TP
77 .B masterGamma 1.9
78 These are the default gamma values. If you set the "Defaults" option with a frontend,
79 then the gamma options are reset to the values specified here.
80 .TP
81 .B redOffset 0x28
82 .TP
83 .B greenOffset 0x2f
84 .TP
85 .B blueOffset 0x2f
86 .TP
87 .B redExposure 0xa7
88 .TP
89 .B greenExposure 0x116
90 .TP
91 .B blueExposure 0xdc
92 These are the default values for offset and exposure time.
93 You can change them (e.g. to speed up calibration)
94 if you don't want to save the calibration data permanently.
95 .TP
96 .B vendorString "Artec"
97 .TP
98 .B modelString "E+ 48U"
99 By default, the scanner is reported as "Artec E+ 48U". If you don't like this, e.g.
100 because you have an Tevion MD 9693, then change the options accordingly.
101 .SH FILES
102 .TP
103 .I /usr/local/etc/sane.d/artec_eplus48u.conf
104 The backend configuration file (see also description of
105 .B SANE_CONFIG_DIR
106 below).
107 .TP
108 .I /usr/local/lib/sane/libsane\-artec_eplus48u.a
109 The static library implementing this backend.
110 .TP
111 .I /usr/local/lib/sane/libsane\-artec_eplus48u.so
112 The shared library implementing this backend (present on systems that
113 support dynamic loading).
114 .SH ENVIRONMENT
115 .TP
116 .B SANE_CONFIG_DIR
117 This environment variable specifies the list of directories that may
118 contain the configuration file. On *NIX systems, the directories are
119 separated by a colon (`:'), under OS/2, they are separated by a
120 semi-colon (`;'). If this variable is not set, the configuration file
121 is searched in two default directories: first, the current working
122 directory (".") and then in
123 .IR /etc/sane.d .
124 If the value of the environment variable ends with the directory
125 separator character, then the default directories are searched after
126 the explicitly specified directories. For example, setting
127 .B SANE_CONFIG_DIR
128 to "/tmp/config:" would result in directories
129 .IR tmp/config ,
130 .IR . ,
131 and
132 .I /etc/sane.d
133 being searched (in this order).
134 .TP
135 .B SANE_DEBUG_ARTEC_EPLUS48U
136 If the library was compiled with debug support enabled, this
137 environment variable controls the debug level for this backend. Higher
138 debug levels increase the verbosity of the output.
139
140 Example:
141 export SANE_DEBUG_ARTEC_EPLUS48U=3
142
143 .SH "SEE ALSO"
144 .BR sane (7),
145 .BR sane\-usb (5)
146
147 .SH AUTHOR
148 Michael Herder.
149 .br
150 This backend is based on the gt68xx test-program written by Sergey Vlasov, Andreas Nowack, and
151 David Stevenson. Thanks to everyone who tested the backend or reported bugs.
152 .br
153 This man page is based on man
154 .BR sane\-gt68xx (5),
155 written by Henning Meier-Geinitz.
156
157 .SH BUGS
158 This backend has been tested on Linux only. If you are using it on a different platform, please
159 contact us.
160 .PP
161 Interpolation with 1200 dpi is weak.
162 .PP
163 Support for buttons is missing due to missing support in SANE.
164 .PP
165 Please contact us if you find a bug:
166 .IR http://www.sane\-project.org/bugs.html .