hp-scan: Scan Utility (ver. 0.5)
SANE-based scan utility for HPLIP.
Usage: hp-scan [SANE-DEVICE-URI] [MODE] [-n OPTIONS] [OPTIONS]
[SANE-DEVICE-URI]
SANE device URI: | -d<sane_device_uri> or --device=<sane_device_uri> |
URI format: hpaio:/<bus>/<model>?<identification> |
[MODE]
Enter graphical UI mode: | -u or --gui (Default) |
Run in non-interactive mode: | -n or --non-interactive |
[-n OPTIONS] (General) (Not applicable to GUI mode)
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', 'fax', or 'print'. Use only commas between values, no spaces. | |
Scan mode: | -m<mode> or --mode=<mode>. Where <mode> is 'color'*, 'gray' or 'lineart'. |
Scanning resolution: | -r<resolution_in_dpi> or --res=<resolution_in_dpi> or --resolution=<resolution_in_dpi> |
where <resolution_in_dpi> is 75, 150, 300, 600, 1200, 2400, 4800 (300 is default). | |
Image resize: | --resize=<scale_in_%> (min=1%, max=400%, default=100%) |
Image contrast: | --contrast=<contrast> |
ADF mode (EXPERIMENTAL): | --adf (Note, only PDF output is supported when using the ADF) |
[-n OPTIONS] (Scan area) (Not applicable to GUI mode)
Specify the units for area/box measurements: | -t<units> or --units=<units> |
where <units> is 'mm'*, 'cm', 'in', 'px', or 'pt' ('mm' is default). | |
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. | |
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. | |
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'). | |
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'). | |
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'). | |
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'). | |
Specify the scan area based on a paper size: | --size=<paper size name> |
where <paper size name> is one of: 5x7, photo, a2_env, b4, b5, 3x5, 4x6, higaki, flsa, c6_env, legal, no_10_env, exec, a3, a5, a4, letter, a6, super_b, oufufu-hagaki, dl_env, japan_env_4, japan_env_3 |
[-n OPTIONS] ('file' dest) (Not applicable to GUI mode)
Filename for 'file' destination: | -o<file> or -f<file> or --file=<file> or --output=<file> |
[-n OPTIONS] ('pdf' dest) (Not applicable to GUI mode)
PDF viewer application: | --pdf=<pdf_viewer> |
[-n OPTIONS] ('viewer' dest) (Not applicable to GUI mode)
Image viewer application: | -v<viewer> or --viewer=<viewer> |
[-n OPTIONS] ('editor' dest) (Not applicable to GUI mode)
Image editor application: | -e<editor> or --editor=<editor> |
[-n OPTIONS] ('email' dest) (Not applicable to GUI mode)
From: address for 'email' dest: | --email-from=<email_from_address> (required for 'email' dest.) |
To: address for 'email' dest: | --email-to=<email__to_address> (required for 'email' dest.) |
Email subject for 'email' dest: | --email-subject="<subject>" |
Use double quotes (") around the subject if it contains space characters. | |
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. |
[-n OPTIONS] ('fax' dest) (Not applicable to GUI mode)
Fax queue/printer: | --fax=<fax_printer_name> |
[-n OPTIONS] ('printer' dest) (Not applicable to GUI mode)
Printer queue/printer: | --printer=<printer_name> |
[-n OPTIONS] (advanced) (Not applicable to GUI mode)
Set the scanner compression mode: | -x<mode> or --compression=<mode>, <mode>='raw', 'none' or 'jpeg' ('jpeg' is default) ('raw' and 'none' are equivalent) |
[OPTIONS]
Set the logging level: | -l<level> or --logging=<level> |
<level>: none, info*, error, warn, debug (*default) | |
Run in debug mode: | -g (same as option: -ldebug) |
This help information: | -h or --help |
Notes:
|
|
|
|
|
|
|
|
|
|
|
Examples:
Quickly (low-res) scan entire page in color to file: | $ hp-scan -n -r75 |
Scan upper left 1in corner and send as email: | $ hp-scan -n --box=0,0,1,1 -tin -semail --email-from=foo@bar.org --email-to=bar@foo.org --email-note="Test scan" --email-subject="Test scan email" |
Scan entire page in 300dpi grayscale and then edit: | $ hp-scan -n -seditor -mgray |
Launch the hp-scan GUI: | $ hp-scan |
Scan into The GIMP: | $ hp-scan -n --editor=gimp |