man-pages/man1/hp-scan.1.html
2021-03-31 01:06:50 +01:00

239 lines
8.6 KiB
HTML

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<HTML><HEAD><TITLE>Man page of hp-scan</TITLE>
</HEAD><BODY>
<H1>hp-scan</H1>
Section: User Manuals (1)<BR>Updated: 2.2<BR><A HREF="#index">Index</A>
<A HREF="/cgi-bin/man/man2html">Return to Main Contents</A><HR>
<A NAME="lbAB">&nbsp;</A>
<H2>NAME</H2>
hp-scan - Scan Utility
<A NAME="lbAC">&nbsp;</A>
<H2>DESCRIPTION</H2>
SANE-based scan utility for HPLIP supported all-in-one/mfp devices.
<A NAME="lbAD">&nbsp;</A>
<H2>SYNOPSIS</H2>
<B>hp-scan [DEVICE_URI|PRINTER_NAME] [MODE] [OPTIONS]</B>
<A NAME="lbAE">&nbsp;</A>
<H2>PRINTER|DEVICE-URI</H2>
<DL COMPACT>
<DT id="1">To specify a device-URI:<DD>
-d&lt;device-uri&gt; or --device=&lt;device-uri&gt;
<DT id="2">To specify a CUPS printer:<DD>
-p&lt;printer&gt; or --printer=&lt;printer&gt;
</DL>
<A NAME="lbAF">&nbsp;</A>
<H2>MODE</H2>
<DL COMPACT>
<DT id="3">Run in interactive mode:<DD>
-i or --interactive
</DL>
<A NAME="lbAG">&nbsp;</A>
<H2>OPTIONS</H2>
<DL COMPACT>
<DT id="4">Set the logging level:<DD>
-l&lt;level&gt; or --logging=&lt;level&gt;
&lt;level&gt;: none, info*, error, warn, debug (*default)
<DT id="5">Run in debug mode:<DD>
-g (same as option: -ldebug)
<DT id="6">This help information:<DD>
-h or --help
</DL>
<A NAME="lbAH">&nbsp;</A>
<H2>OPTIONS (GENERAL)</H2>
<DL COMPACT>
<DT id="7">Scan destinations:<DD>
-s&lt;dest_list&gt; or --dest=&lt;dest_list&gt;
where &lt;dest_list&gt; is a comma separated list containing one or more of: 'file'
, 'viewer', 'editor', 'pdf', or 'print'. Use only commas between values, no spaces.
<DT id="8">Scan mode:<DD>
-m&lt;mode&gt; or --mode=&lt;mode&gt;. Where &lt;mode&gt; is 'gray'*, 'color' or 'lineart'.
<DT id="9">Scanning resolution:<DD>
-r&lt;resolution_in_dpi&gt; or --res=&lt;resolution_in_dpi&gt; or --resolution=&lt;resolution_in_dpi&gt;
where 300 is default.
<DT id="10">Image resize:<DD>
--resize=&lt;scale_in_%&gt; (min=1%, max=400%, default=100%)
<DT id="11">Color Dropout Red :<DD>
-color_dropout_red_value=&lt;color_dropout_red_value&gt; or --color_dropout_red_value=&lt;color_dropout_red_value&gt;
<DT id="12">Color Dropout Green :<DD>
-color_dropout_green_value=&lt;color_dropout_green_value&gt; or --color_dropout_green_value=&lt;color_dropout_green_value&gt;
<DT id="13">Color Dropout Blue :<DD>
-color_dropout_blue_value=&lt;color_dropout_blue_value&gt; or --color_dropout_blue_value=&lt;color_dropout_blue_value&gt;
<DT id="14">Color Dropout Range :<DD>
-color_range=&lt;color_range&gt; or --color_range=&lt;color_range&gt;
<DT id="15">Image contrast:<DD>
-c=&lt;contrast&gt; or --contrast=&lt;contrast&gt;
The contrast range varies from device to device.
<DT id="16">Image brightness:<DD>
-b=&lt;brightness&gt; or --brightness=&lt;brightness&gt;
The brightness range varies from device to device.
<DT id="17">ADF mode:<DD>
--adf (Note, only PDF output is supported when using the ADF)
--duplex or --dup for duplex scanning using ADF.
</DL>
<A NAME="lbAI">&nbsp;</A>
<H2>OPTIONS (SCAN AREA)</H2>
<DL COMPACT>
<DT id="18">Specify the units for area/box measurements:<DD>
-t&lt;units&gt; or --units=&lt;units&gt;
where &lt;units&gt; is 'mm'*, 'cm', 'in', 'px', or 'pt' ('mm' is default).
<DT id="19">Scan area:<DD>
-a&lt;tlx&gt;,&lt;tly&gt;,&lt;brx&gt;,&lt;bry&gt; or --area=&lt;tlx&gt;,&lt;tly&gt;,&lt;brx&gt;,&lt;bry&gt;
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.
<DT id="20">Scan box:<DD>
--box=&lt;tlx&gt;,&lt;tly&gt;,&lt;width&gt;,&lt;height&gt;
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.
<DT id="21">Top left x of the scan area:<DD>
--tlx=&lt;tlx&gt;
Coordinates are relative to the upper left corner of the scan area.
Units are specified by -t/--units (default is 'mm').
<DT id="22">Top left y of the scan area:<DD>
--tly=&lt;tly&gt;
Coordinates are relative to the upper left corner of the scan area.
Units are specified by -t/--units (default is 'mm').
<DT id="23">Bottom right x of the scan area:<DD>
--brx=&lt;brx&gt;
Coordinates are relative to the upper left corner of the scan area.
Units are specified by -t/--units (default is 'mm').
<DT id="24">Bottom right y of the scan area:<DD>
--bry=&lt;bry&gt;
Coordinates are relative to the upper left corner of the scan area.
Units are specified by -t/--units (default is 'mm').
<DT id="25">Specify the scan area based on a paper size:<DD>
--size=&lt;paper size name&gt;
where &lt;paper size name&gt; 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
</DL>
<A NAME="lbAJ">&nbsp;</A>
<H2>OPTIONS ('FILE' DEST)</H2>
<DL COMPACT>
<DT id="26">Filename for 'file' destination:<DD>
-o&lt;file&gt; or -f&lt;file&gt; or --file=&lt;file&gt; or --output=&lt;file&gt;
</DL>
<A NAME="lbAK">&nbsp;</A>
<H2>OPTIONS ('PDF' DEST)</H2>
<DL COMPACT>
<DT id="27">PDF viewer application:<DD>
--pdf=&lt;pdf_viewer&gt;
</DL>
<A NAME="lbAL">&nbsp;</A>
<H2>OPTIONS ('VIEWER' DEST)</H2>
<DL COMPACT>
<DT id="28">Image viewer application:<DD>
-v&lt;viewer&gt; or --viewer=&lt;viewer&gt;
</DL>
<A NAME="lbAM">&nbsp;</A>
<H2>OPTIONS ('EDITOR' DEST)</H2>
<DL COMPACT>
<DT id="29">Image editor application:<DD>
-e&lt;editor&gt; or --editor=&lt;editor&gt;
</DL>
<A NAME="lbAN">&nbsp;</A>
<H2>OPTIONS ('EMAIL' DEST)</H2>
<DL COMPACT>
<DT id="30">From: address for 'email' dest:<DD>
--email-from=&lt;email_from_address&gt; (required for 'email' dest.)
<DT id="31">To: address for 'email' dest:<DD>
--email-to=&lt;email__to_address&gt; (required for 'email' dest.)
<DT id="32">Email subject for 'email' dest:<DD>
--email-subject=&quot;&lt;subject&gt;&quot; or --subject=&quot;&lt;subject&gt;&quot;
Use double quotes (&quot;) around the subject if it contains space characters.
<DT id="33">Note or message for the 'email' dest:<DD>
--email-msg=&quot;&lt;msg&gt;&quot; or --email-note=&quot;&lt;note&gt;&quot;
Use double quotes (&quot;) around the note/message if it contains space characters.
</DL>
<A NAME="lbAO">&nbsp;</A>
<H2>OPTIONS ('PRINTER' DEST)</H2>
<DL COMPACT>
<DT id="34">Printer queue/printer dest:<DD>
--dp=&lt;printer_name&gt; or --dest-printer=&lt;printer_name&gt;
<DT id="35">Printer device-URI dest:<DD>
--dd=&lt;device-uri&gt; or --dest-device=&lt;device-uri&gt;
</DL>
<A NAME="lbAP">&nbsp;</A>
<H2>OPTIONS (ADVANCED)</H2>
<DL COMPACT>
<DT id="36">Set the scanner compression mode:<DD>
-x&lt;mode&gt; or --compression=&lt;mode&gt;, &lt;mode&gt;='raw', 'none' or 'jpeg' ('jpeg' is default) ('raw' and 'none' are equivalent)
</DL>
<A NAME="lbAQ">&nbsp;</A>
<H2>SEE ALSO</H2>
<A NAME="lbAR">&nbsp;</A>
<H2>AUTHOR</H2>
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.
<A NAME="lbAS">&nbsp;</A>
<H2>REPORTING BUGS</H2>
The HPLIP Launchpad.net site
<B><A HREF="https://launchpad.net/hplip">https://launchpad.net/hplip</A></B>
is available to get help, report
bugs, make suggestions, discuss the HPLIP project or otherwise
contact the HPLIP Team.
<A NAME="lbAT">&nbsp;</A>
<H2>COPYRIGHT</H2>
Copyright (c) 2001-18 HP Development Company, L.P.
<P>
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.
<P>
<P>
<HR>
<A NAME="index">&nbsp;</A><H2>Index</H2>
<DL>
<DT id="37"><A HREF="#lbAB">NAME</A><DD>
<DT id="38"><A HREF="#lbAC">DESCRIPTION</A><DD>
<DT id="39"><A HREF="#lbAD">SYNOPSIS</A><DD>
<DT id="40"><A HREF="#lbAE">PRINTER|DEVICE-URI</A><DD>
<DT id="41"><A HREF="#lbAF">MODE</A><DD>
<DT id="42"><A HREF="#lbAG">OPTIONS</A><DD>
<DT id="43"><A HREF="#lbAH">OPTIONS (GENERAL)</A><DD>
<DT id="44"><A HREF="#lbAI">OPTIONS (SCAN AREA)</A><DD>
<DT id="45"><A HREF="#lbAJ">OPTIONS ('FILE' DEST)</A><DD>
<DT id="46"><A HREF="#lbAK">OPTIONS ('PDF' DEST)</A><DD>
<DT id="47"><A HREF="#lbAL">OPTIONS ('VIEWER' DEST)</A><DD>
<DT id="48"><A HREF="#lbAM">OPTIONS ('EDITOR' DEST)</A><DD>
<DT id="49"><A HREF="#lbAN">OPTIONS ('EMAIL' DEST)</A><DD>
<DT id="50"><A HREF="#lbAO">OPTIONS ('PRINTER' DEST)</A><DD>
<DT id="51"><A HREF="#lbAP">OPTIONS (ADVANCED)</A><DD>
<DT id="52"><A HREF="#lbAQ">SEE ALSO</A><DD>
<DT id="53"><A HREF="#lbAR">AUTHOR</A><DD>
<DT id="54"><A HREF="#lbAS">REPORTING BUGS</A><DD>
<DT id="55"><A HREF="#lbAT">COPYRIGHT</A><DD>
</DL>
<HR>
This document was created by
<A HREF="/cgi-bin/man/man2html">man2html</A>,
using the manual pages.<BR>
Time: 00:05:17 GMT, March 31, 2021
</BODY>
</HTML>