| Current File : //usr/share/doc/hplip-3.15.7/hpscan.html |
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html><head>
<link rel="stylesheet" type="text/css" href="styles/css.css">
<link rel="shortcut icon" href="images/favicon.ico" type="image/x-icon">
<meta content="text/html; charset=ISO-8859-1" http-equiv="content-type">
<title>HPLIP HELP</title></head>
<body>
<div id="container">
<div id="header">
<hr class="hide">
<div id="mBody">
<center><h2 class="showhide_heading" id="mainmenu">HP Linux Imaging and Printing (HPLIP) Help</h2>
<a href="index.html"><li>Main Menu</li></a></center><br>
<p>
</p>
<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.
hp-scan is currently only implemented with a command line
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>
SANE device
URI:
-d<sane_device_uri> or
--device=<sane_device_uri>
<br>
URI format:
hpaio:/<bus>/<model>?<identification>
<br><br>[MODE]<br> Enter graphical UI
mode:
-u or --gui
(Default)
<br> Run in non-interactive
mode:
-n or
--non-interactive
<br><br>[-n OPTIONS] (General) (Not applicable to GUI mode)<br>
Scan
destinations:
-s<dest_list> or
--dest=<dest_list>
<br>
where <dest_list> is a comma separated list containing one or
more of:
'file'*,
<br>
'viewer', 'editor', 'pdf', 'fax', or 'print'. Use only commas between
values, no
spaces.
<br> Scan
mode:
-m<mode> or --mode=<mode>. Where <mode> is 'color'*,
'gray' or
'lineart'.
<br> Scanning
resolution:
-r<resolution_in_dpi> or --res=<resolution_in_dpi> or
--resolution=<resolution_in_dpi>
<br>
where <resolution_in_dpi> is 75, 150, 300, 600, 1200, 2400, 4800
(300 is
default).
<br> Image
resize:
--resize=<scale_in_%> (min=1%, max=400%,
default=100%)
<br> Image
contrast:
--contrast=<contrast>
<br> ADF mode
(EXPERIMENTAL):
--adf (Note, only PDF output is supported when using the
ADF)
<br><br>[-n OPTIONS] (Scan area) (Not applicable to GUI mode)<br>
Specify the units for
area/box
-t<units> or
--units=<units>
<br>
measurements:
<br>
where <units> is 'mm'*, 'cm', 'in', 'px', or 'pt' ('mm' is
default).
<br> Scan
area:
-a<tlx>,<tly>,<brx>,<bry> or
--area=<tlx>,<tly>,<brx>,<bry>
<br>
Coordinates are relative to the upper left corner of the scan
area.
<br>
Units for tlx, tly, brx, and bry are specified by -t/--units (default
is
'mm').
<br>
Use only commas between values, no
spaces.
<br> Scan
box:
--box=<tlx>,<tly>,<width>,<height>
<br>
tlx and tly coordinates are relative to the upper left corner of the
scan
area.
<br>
Units for tlx, tly, width, and height are specified by -t/--units
(default is
'mm').
<br>
Use only commas between values, no
spaces.
<br> Top left x of the scan
area:
--tlx=<tlx>
<br>
Coordinates are relative to the upper left corner of the scan
area.
<br>
Units are specified by -t/--units (default is
'mm').
<br> Top left y of the scan
area:
--tly=<tly>
<br>
Coordinates are relative to the upper left corner of the scan
area.
<br>
Units are specified by -t/--units (default is
'mm').
<br> Bottom right x of the scan
area:
--brx=<brx>
<br>
Coordinates are relative to the upper left corner of the scan
area.
<br>
Units are specified by -t/--units (default is
'mm').
<br> Bottom right y of the scan
area:
--bry=<bry>
<br>
Coordinates are relative to the upper left corner of the scan
area.
<br>
Units are specified by -t/--units (default is
'mm').
<br> Specify the scan area based on a
paper --size=<paper size
name>
<br>
size:
<br>
where <paper size name> is one of: 5x7, photo, a2_env, b4, b5,
3x5, 4x6, higaki, flsa, c6_env, legal,<br>
no_10_env, exec, a3, a5, a4, letter, a6, super_b, oufufu-hagaki,
dl_env, japan_env_4, japan_env_3 <br><br>[-n OPTIONS] ('file' dest) (Not applicable to GUI mode)<br>
Filename for 'file'
destination:
-o<file> or -f<file> or --file=<file> or
--output=<file>
<br><br>[-n OPTIONS] ('pdf' dest) (Not applicable to GUI mode)<br>
PDF viewer
application:
--pdf=<pdf_viewer>
<br><br>[-n OPTIONS] ('viewer' dest) (Not applicable to GUI mode)<br>
Image viewer
application:
-v<viewer> or
--viewer=<viewer>
<br><br>[-n OPTIONS] ('editor' dest) (Not applicable to GUI mode)<br>
Image editor
application:
-e<editor> or
--editor=<editor>
<br><br>[-n OPTIONS] ('email' dest) (Not applicable to GUI mode)<br>
From: address for 'email'
dest:
--email-from=<email_from_address> (required for 'email'
dest.)
<br> To: address for 'email'
dest:
--email-to=<email__to_address> (required for 'email'
dest.)
<br> Email subject for 'email'
dest:
--email-subject="<subject>"
<br>
Use double quotes (") around the subject if it contains space
characters.
<br> Note or message for the 'email'
dest: --email-msg="<msg>" or
--email-note="<note>"
<br>
Use double quotes (") around the note/message if it contains space
characters.
<br><br>[-n OPTIONS] ('fax' dest) (Not applicable to GUI mode)<br>
Fax
queue/printer:
--fax=<fax_printer_name>
<br><br>[-n OPTIONS] ('printer' dest) (Not applicable to GUI mode)<br>
Printer
queue/printer:
--printer=<printer_name>
<br><br>[-n OPTIONS] (advanced) (Not applicable to GUI mode)<br>
Set the scanner compression
mode:
-x<mode> or --compression=<mode>, <mode>='raw',
'none' or 'jpeg' ('jpeg' is default) ('raw'
and <br>
'none' are
equivalent)
<br><br>[OPTIONS]<br> Set the logging
level:
-l<level> or
--logging=<level>
<br>
<level>: none, info*, error, warn, debug
(*default)
<br> Run in debug
mode:
-g (same as option:
-ldebug)
<br> This help
information:
-h or
--help
<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.
The following features are not yet implemented: GUI mode, batch
scanning, film/negative scanning, contrast adjustment, brightness
adjustment, autocrop, resize to axb, resize to xKB, <br><br>Examples:<br>
Quickly (low-res) scan entire page
in $ hp-scan -n
-r75
<br> color to
file:
<br> Scan upper left 1in corner and send
as $ hp-scan -n --box=0,0,1,1 -tin
-semail --email-from=foo@bar.org
--email-to=bar@foo.org
<br>
email:
--email-note="Test scan" --email-subject="Test scan
email"
<br> Scan entire page in 300dpi grayscale and
$
hp-scan -n -seditor
-mgray
<br> then
edit:
<br> Launch the hp-scan
GUI:
$
hp-scan
<br> Scan into The
GIMP:
$ hp-scan -n --editor=gimp <span style="font-weight: bold;"><br><br></span></div>
<div id="footer">
<p class="copyright"></p><center>
<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>
<p></p>
</div>
</div>
</div></body></html>