1 <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
3 <link rel="stylesheet" type="text/css" href="styles/css.css">
4 <link rel="shortcut icon" href="images/favicon.ico" type="image/x-icon">
5 <meta content="text/html; charset=ISO-8859-1" http-equiv="content-type">
6 <title>HPLIP HELP</title></head>
13 <center><h2 class="showhide_heading" id="mainmenu">HP Linux Imaging and Printing (HPLIP) Help</h2>
14 <a href="index.html"><li>Main Menu</li></a></center><br>
18 <h3 class="showhide_heading" id="Startup">Scanning with HP Device Manager Scan (hp-scan)</h3><br>hp-scan is a new feature with hplip that uses sane for scanning.
19 hp-scan is currently only implemented with a command line
20 interface. a GUI interface will be added in the future.<br><br>SANE-based scan utility for HPLIP.<br><br>Usage: hp-scan [SANE-DEVICE-URI] [MODE] [-n OPTIONS] [OPTIONS]<br><br>[SANE-DEVICE-URI]<br>
22 URI:
23 -d<sane_device_uri> or
24 --device=<sane_device_uri>
25 <br>
27 hpaio:/<bus>/<model>?<identification>
28 <br><br>[MODE]<br> Enter graphical UI
29 mode:
31 (Default)
32 <br> Run in non-interactive
33 mode:
35 --non-interactive
36 <br><br>[-n OPTIONS] (General) (Not applicable to GUI mode)<br>
38 destinations:
39 -s<dest_list> or
40 --dest=<dest_list>
41 <br>
42 where <dest_list> is a comma separated list containing one or
44 'file'*,
45 <br>
46 'viewer', 'editor', 'pdf', 'fax', or 'print'. Use only commas between
48 spaces.
50 mode:
51 -m<mode> or --mode=<mode>. Where <mode> is 'color'*,
53 'lineart'.
55 resolution:
56 -r<resolution_in_dpi> or --res=<resolution_in_dpi> or
57 --resolution=<resolution_in_dpi>
58 <br>
59 where <resolution_in_dpi> is 75, 150, 300, 600, 1200, 2400, 4800
61 default).
63 resize:
64 --resize=<scale_in_%> (min=1%, max=400%,
65 default=100%)
67 contrast:
68 --contrast=<contrast>
70 (EXPERIMENTAL):
71 --adf (Note, only PDF output is supported when using the
72 ADF)
73 <br><br>[-n OPTIONS] (Scan area) (Not applicable to GUI mode)<br>
75 area/box
77 --units=<units>
79 measurements:
80 <br>
81 where <units> is 'mm'*, 'cm', 'in', 'px', or 'pt' ('mm' is
82 default).
84 area:
85 -a<tlx>,<tly>,<brx>,<bry> or
86 --area=<tlx>,<tly>,<brx>,<bry>
87 <br>
88 Coordinates are relative to the upper left corner of the scan
89 area.
90 <br>
91 Units for tlx, tly, brx, and bry are specified by -t/--units (default
93 'mm').
94 <br>
95 Use only commas between values, no
96 spaces.
98 box:
99 --box=<tlx>,<tly>,<width>,<height>
100 <br>
101 tlx and tly coordinates are relative to the upper left corner of the
103 area.
104 <br>
105 Units for tlx, tly, width, and height are specified by -t/--units
107 'mm').
108 <br>
109 Use only commas between values, no
110 spaces.
111 <br> Top left x of the scan
112 area:
113 --tlx=<tlx>
114 <br>
115 Coordinates are relative to the upper left corner of the scan
116 area.
117 <br>
118 Units are specified by -t/--units (default is
119 'mm').
120 <br> Top left y of the scan
121 area:
122 --tly=<tly>
123 <br>
124 Coordinates are relative to the upper left corner of the scan
125 area.
126 <br>
127 Units are specified by -t/--units (default is
128 'mm').
129 <br> Bottom right x of the scan
130 area:
131 --brx=<brx>
132 <br>
133 Coordinates are relative to the upper left corner of the scan
134 area.
135 <br>
136 Units are specified by -t/--units (default is
137 'mm').
138 <br> Bottom right y of the scan
139 area:
140 --bry=<bry>
141 <br>
142 Coordinates are relative to the upper left corner of the scan
143 area.
144 <br>
145 Units are specified by -t/--units (default is
146 'mm').
147 <br> Specify the scan area based on a
148 paper --size=<paper size
149 name>
151 size:
152 <br>
153 where <paper size name> is one of: 5x7, photo, a2_env, b4, b5,
154 3x5, 4x6, higaki, flsa, c6_env, legal,<br>
155 no_10_env, exec, a3, a5, a4, letter, a6, super_b, oufufu-hagaki,
156 dl_env, japan_env_4, japan_env_3 <br><br>[-n OPTIONS] ('file' dest) (Not applicable to GUI mode)<br>
158 destination:
159 -o<file> or -f<file> or --file=<file> or
160 --output=<file>
161 <br><br>[-n OPTIONS] ('pdf' dest) (Not applicable to GUI mode)<br>
163 application:
164 --pdf=<pdf_viewer>
165 <br><br>[-n OPTIONS] ('viewer' dest) (Not applicable to GUI mode)<br>
167 application:
169 --viewer=<viewer>
170 <br><br>[-n OPTIONS] ('editor' dest) (Not applicable to GUI mode)<br>
172 application:
174 --editor=<editor>
175 <br><br>[-n OPTIONS] ('email' dest) (Not applicable to GUI mode)<br>
176 From: address for 'email'
177 dest:
178 --email-from=<email_from_address> (required for 'email'
179 dest.)
180 <br> To: address for 'email'
181 dest:
182 --email-to=<email__to_address> (required for 'email'
183 dest.)
184 <br> Email subject for 'email'
185 dest:
186 --email-subject="<subject>"
187 <br>
188 Use double quotes (") around the subject if it contains space
189 characters.
190 <br> Note or message for the 'email'
191 dest: --email-msg="<msg>" or
192 --email-note="<note>"
193 <br>
194 Use double quotes (") around the note/message if it contains space
195 characters.
196 <br><br>[-n OPTIONS] ('fax' dest) (Not applicable to GUI mode)<br>
198 queue/printer:
199 --fax=<fax_printer_name>
200 <br><br>[-n OPTIONS] ('printer' dest) (Not applicable to GUI mode)<br>
202 queue/printer:
203 --printer=<printer_name>
204 <br><br>[-n OPTIONS] (advanced) (Not applicable to GUI mode)<br>
205 Set the scanner compression
206 mode:
207 -x<mode> or --compression=<mode>, <mode>='raw',
208 'none' or 'jpeg' ('jpeg' is default) ('raw'
209 and <br>
211 equivalent)
212 <br><br>[OPTIONS]<br> Set the logging
213 level:
215 --logging=<level>
216 <br>
217 <level>: none, info*, error, warn, debug
218 (*default)
219 <br> Run in debug
220 mode:
222 -ldebug)
224 information:
226 --help
227 <br><br>Notes:<br>1. If no dest is provided, the 'file' dest will be automatically invoked.<br>2. If applications for viewer, editor, or pdf viewer are not provided, reasonable defaults will be used.<br>3. If --printer is not specified, the CUPS default will be used if available.<br>4. If an output file is not specified with the 'file' dest, a reasonable default will be used.<br>5. Some options may not be valid on some scanning devices.<br>6.
228 The following features are not yet implemented: GUI mode, batch
229 scanning, film/negative scanning, contrast adjustment, brightness
230 adjustment, autocrop, resize to axb, resize to xKB, <br><br>Examples:<br>
231 Quickly (low-res) scan entire page
232 in $ hp-scan -n
233 -r75
235 file:
236 <br> Scan upper left 1in corner and send
237 as $ hp-scan -n --box=0,0,1,1 -tin
238 -semail --email-from=foo@bar.org
239 --email-to=bar@foo.org
241 email:
242 --email-note="Test scan" --email-subject="Test scan
243 email"
244 <br> Scan entire page in 300dpi grayscale and
247 -mgray
249 edit:
250 <br> Launch the hp-scan
251 GUI:
253 hp-scan
254 <br> Scan into The
255 GIMP:
256 $ hp-scan -n --editor=gimp <span style="font-weight: bold;"><br><br></span></div>
259 <p class="copyright"></p><center>
260 <a href="http://welcome.hp.com/country/us/en/privacy.html">Privacy Statement</a> | <a href="http://hplip.sourceforge.net/legal.html">Legal Notices</a> | © 2008 Hewlett-Packard Development Company, L.P. <br></center>