Debian Codegraph @

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

raw
1 .TH sane\-hpsj5s 5 "13 Jul 2008" "" "SANE Scanner Access Now Easy"
2 .IX sane\-hpsj5s
3 .SH NAME
4 sane\-hpsj5s \- SANE backend for HP ScanJet 5S sheet-fed scanner
5 .SH DESCRIPTION
6 The
7 .B sane\-hpsj5s
8 library implements a SANE (Scanner Access Now Easy) backend that
9 provides access to a parallel port Hewlett-Packard ScanJet 5S scanner.
10 .PP
11 IMPORTANT: this is alpha code. Don't expect this to work
12 correctly. Many functions are missing, others contain errors. In some
13 cases, your computer might even hang. It cannot be excluded (although
14 I consider it extremely improbable) that your scanner will be
15 damaged.
16 .PP
17 LIMITATIONS: For now this backend works only on Linux. This limitation
18 is due to dependence on the
19 .BR libieee1284 (3)
20 library. If your system supports
21 .BR libieee1284 (3)
22 too, this backend should work. If you ported
23 .BR libieee1284 (3)
24 for your platform, please let me know. Your system should support
25 .B EPP
26 (or
27 .BR EPP+ECP )
28 mode to operate this scanner. Future versions will support ECP and SPP
29 (Nibble and Byte) modes also. It's planned to support scanners not only
30 at daisy-chain position 0, but anywhere. Support for multiple scanners could
31 be implemented too.
32 .PP
33 Current version implements only gray scale scanning. True Color and B/W modes are
34 not supported for now.
35 .PP
36 That said, TESTERS ARE WELCOME. Send your bug reports and comments to
37 Max Vorobiev
38 .RI < [email protected] >.
39 .PP
40 .SH "DEVICE NAMES"
41 This backend expects device names of the form:
42 .PP
43 .RS
44 .I special
45 .RE
46 .PP
47 Where
48 .I special
49 is the parallel port name in form,
50 .BR libieee1284 (3)
51 expects. It seems to be system dependent. Under Linux it's parport0, parport1, etc.
52 .SH CONFIGURATION
53 The contents of the
54 .I hpsj5s.conf
55 file is a list of parport names that correspond to HP ScanJet 5S
56 scanners. Empty lines and lines starting with a hash mark (#) are
57 ignored. Only one device name can be listed in
58 .IR hpsj5s.conf
59 for this moment. Future versions will support daisy chain selection.
60
61 .SH TIPS
62 .PP
63 It seems that HP ScanJet 5S scanner uses software noise correction. This
64 feature, along with gamma correction and calibration, are not implemented for now.
65 They will be handled in future versions.
66 Native resolution for this scanner is 300 DPI.
67 Other modes may present aliasing artifacts.
68 .PP
69 .SH FILES
70 .TP
71 .I /etc/sane.d/hpsj5s.conf
72 The backend configuration file (see also description of
73 .B SANE_CONFIG_DIR
74 below).
75 .TP
76 .I /usr/lib/x86_64-linux-gnu/sane/libsane\-hpsj5s.a
77 The static library implementing this backend.
78 .TP
79 .I /usr/lib/x86_64-linux-gnu/sane/libsane\-hpsj5s.so
80 The shared library implementing this backend (present on systems that
81 support dynamic loading).
82 .SH ENVIRONMENT
83 .TP
84 .B SANE_CONFIG_DIR
85 This environment variable specifies the list of directories that may
86 contain the configuration file. On *NIX systems, the directories are
87 separated by a colon (`:'), under OS/2, they are separated by a
88 semi-colon (`;'). If this variable is not set, the configuration file
89 is searched in two default directories: first, the current working
90 directory (".") and then in
91 .IR /etc/sane.d .
92 If the value of the
93 environment variable ends with the directory separator character, then
94 the default directories are searched after the explicitly specified
95 directories. For example, setting
96 .B SANE_CONFIG_DIR
97 to "/tmp/config:" would result in directories
98 .IR tmp/config ,
99 .IR . ,
100 and
101 .I "/etc/sane.d"
102 being searched (in this order).
103 .TP
104 .B SANE_DEBUG_HPSJ5S
105 If the library was compiled with debug support enabled, this environment
106 variable controls the debug level for this backend. Higher debug levels
107 increase the verbosity of the output.
108
109 .SH "SEE ALSO"
110 .BR sane (7),
111 .BR libieee1284 (3)
112 .br
113 .I http://hpsj5s.sourceforge.net
114 .br
115 .I http://cyberelk.net/tim/libieee1284
116 .br
117 .SH AUTHOR
118 Max Vorobiev
119 .br
120 Man page mostly based on
121 .IR canon.man .