.TH "hp-scan" 1 "2.2" Linux "User Manuals"
.SH NAME
hp-scan \- Scan Utility
.SH DESCRIPTION
SANE-based scan utility for HPLIP supported all-in-one/mfp devices.
.SH SYNOPSIS
.B  hp-scan [DEVICE_URI|PRINTER_NAME] [MODE] [OPTIONS]
.SH PRINTER|DEVICE-URI
.IP "To specify a device-URI:"
-d<device-uri> or --device=<device-uri>
.IP "To specify a CUPS printer:"
-p<printer> or --printer=<printer>
.SH MODE
.IP "Run in interactive mode:"
-i or --interactive
.SH OPTIONS
.IP "Set the logging level:"
-l<level> or --logging=<level>
<level>: none, info*, error, warn, debug (*default)
.IP "Run in debug mode:"
-g (same as option: -ldebug)
.IP "This help information:"
-h or --help
.SH OPTIONS (GENERAL)
.IP "Scan destinations:"
-s<dest_list> or --dest=<dest_list>
where <dest_list> is a comma separated list containing one or more of: 'file'
, 'viewer', 'editor', 'pdf', or 'print'. Use only commas between values, no spaces.
.IP "Scan mode:"
-m<mode> or --mode=<mode>. Where <mode> is 'gray'*, 'color' or 'lineart'.
.IP "Scanning resolution:"
-r<resolution_in_dpi> or --res=<resolution_in_dpi> or --resolution=<resolution_in_dpi>
where 300 is default.
.IP "Image resize:"
--resize=<scale_in_%> (min=1%, max=400%, default=100%)
.IP "Color Dropout Red :"
-color_dropout_red_value=<color_dropout_red_value> or --color_dropout_red_value=<color_dropout_red_value>
.IP "Color Dropout Green :"
-color_dropout_green_value=<color_dropout_green_value> or --color_dropout_green_value=<color_dropout_green_value>
.IP "Color Dropout Blue :"
-color_dropout_blue_value=<color_dropout_blue_value> or --color_dropout_blue_value=<color_dropout_blue_value>
.IP "Color Dropout Range :"
-color_range=<color_range> or --color_range=<color_range>
.IP "Image contrast:"
-c=<contrast> or --contrast=<contrast>
The contrast range varies from device to device.
.IP "Image brightness:"
-b=<brightness> or --brightness=<brightness>
The brightness range varies from device to device.
.IP "ADF mode:"
--adf (Note, only PDF output is supported when using the ADF)
--duplex or --dup for duplex scanning using ADF.
.SH OPTIONS (SCAN AREA)
.IP "Specify the units for area/box measurements:"
-t<units> or --units=<units>
where <units> is 'mm'*, 'cm', 'in', 'px', or 'pt' ('mm' is default).
.IP "Scan area:"
-a<tlx>,<tly>,<brx>,<bry> or --area=<tlx>,<tly>,<brx>,<bry>
Coordinates are relative to the upper left corner of the scan area.
Units for tlx, tly, brx, and bry are specified by -t/--units (default is 'mm').
Use only commas between values, no spaces.
.IP "Scan box:"
--box=<tlx>,<tly>,<width>,<height>
tlx and tly coordinates are relative to the upper left corner of the scan area.
Units for tlx, tly, width, and height are specified by -t/--units (default is 'mm').
Use only commas between values, no spaces.
.IP "Top left x of the scan area:"
--tlx=<tlx>
Coordinates are relative to the upper left corner of the scan area.
Units are specified by -t/--units (default is 'mm').
.IP "Top left y of the scan area:"
--tly=<tly>
Coordinates are relative to the upper left corner of the scan area.
Units are specified by -t/--units (default is 'mm').
.IP "Bottom right x of the scan area:"
--brx=<brx>
Coordinates are relative to the upper left corner of the scan area.
Units are specified by -t/--units (default is 'mm').
.IP "Bottom right y   of the scan area:"
--bry=<bry>
Coordinates are relative to the upper left corner of the scan area.
Units are specified by -t/--units (default is 'mm').
.IP "Specify the scan area based on a paper size:"
--size=<paper size name>
where <paper size name> is one of: 3x5, 4x6, 5x7, a2_env, a3, a4, a5, a6, b4, b5, c6_env, dl_env, exec, flsa, higaki, japan_env_3, japan_env_4, legal, letter, no_10_env, oufufu-hagaki, photo, super_b
.SH OPTIONS ('FILE' DEST)
.IP "Filename for 'file' destination:"
-o<file> or -f<file> or --file=<file> or --output=<file>
.SH OPTIONS ('PDF' DEST)
.IP "PDF viewer application:"
--pdf=<pdf_viewer>
.SH OPTIONS ('VIEWER' DEST)
.IP "Image viewer application:"
-v<viewer> or --viewer=<viewer>
.SH OPTIONS ('EDITOR' DEST)
.IP "Image editor application:"
-e<editor> or --editor=<editor>
.SH OPTIONS ('EMAIL' DEST)
.IP "From: address for 'email' dest:"
--email-from=<email_from_address> (required for 'email' dest.)
.IP "To: address for 'email' dest:"
--email-to=<email__to_address> (required for 'email' dest.)
.IP "Email subject for 'email' dest:"
--email-subject="<subject>" or --subject="<subject>"
Use double quotes (") around the subject if it contains space characters.
.IP "Note or message for the 'email' dest:"
--email-msg="<msg>" or --email-note="<note>"
Use double quotes (") around the note/message if it contains space characters.
.SH OPTIONS ('PRINTER' DEST)
.IP "Printer queue/printer dest:"
--dp=<printer_name> or --dest-printer=<printer_name>
.IP "Printer device-URI dest:"
--dd=<device-uri> or --dest-device=<device-uri>
.SH OPTIONS (ADVANCED)
.IP "Set the scanner compression mode:"
-x<mode> or --compression=<mode>, <mode>='raw', 'none' or 'jpeg' ('jpeg' is default) ('raw' and 'none' are equivalent)
.SH SEE ALSO
.SH AUTHOR
HPLIP (HP Linux Imaging and Printing) is an
HP developed solution for printing, scanning, and faxing with
HP inkjet and laser based printers in Linux.
.SH REPORTING BUGS
The HPLIP Launchpad.net site
.B https://launchpad.net/hplip
is available to get help, report
bugs, make suggestions, discuss the HPLIP project or otherwise
contact the HPLIP Team.
.SH COPYRIGHT
Copyright (c) 2001-15 HP Development Company, L.P.
.LP
This software comes with ABSOLUTELY NO WARRANTY.
This is free software, and you are welcome to distribute it
under certain conditions. See COPYING file for more details.