NAME

scan - Scan pages for archive.

SYNOPSIS

scan {--scanner scannername} {--pagesource normal|adf} {--dpi integer} {--format string} isodate title {pageid} {subtitle}

Options:
 --scanner	    A USB name or other scanimage device string 
                   like "hp:libusb:001:004 [Default=umax or ENV{'Scanner'}]
 -f | --format=str      Scan format. The default is an A4 in 
                             Portrait: P:8.5x13
                             First field is orientation, L or P, for 
                             landscape or portrait.
                             Second field is size in inches across scanner 
                             width.
                             Third field is size in inches down scanner 
                             length.
 --pagesource      Normal or ADF [Default=Normal]
 --dpi	num	    Set the dpi value. [Default=150 or scanner specific]
 --debug|-d	    Set $::DEBUG switch.
 --help|-h	    Display help and exit.
 --man		    Display man page and exit.

    A USB name or other device name string acceptable to the scanimage program, for example, "hp:libusb:001:004". The default is "umax" unless overridden by the $SCANNER environment variable.

    --pagesource sourcename

    Set the page source. Currently ADF or Normal for the flatbed. The default is Normal.

    --dpi num

    Set the number of dots per inch. The default is 150 unless overriden for the Scanner type, ie 200 for an hp5590.

    --help or -h

    Display help message and exit.

    --help or -h

    Display man page message and exit.

DESCRIPTION

scan will scan a full color page of the specified size at the specified resolution from the specified page source on the specified scanner. The first arg is either a P or an L to specify that the page is in Portrait or in Landscape format. Landscape images will be rotated 90 degrees clockwise; Portrait images will be left as scanned. The result is stored as jpeg file in a specific naming format:

<startdate>{-<enddate>}-<title>-{p<startpage>{-<endpage>}}{-subtitle}.jpeg

For example:

20040812-FooGazette.jpeg
20040812-20040817-FooNotes.jpeg
20040812-FooGazette-p001.jpeg
20040812-FooGazette-p001-FooingForProfit.jpeg

Are examples of resulting names.

Examples

# Using the default scanner and A4 page size
scan 20080817 Scanner.pm-annotatedDMA

# Specifying the scanner and page format.
ScanBooklet --scanner "gt68xx:lubusb:001:003" L:12x17" \
            20080817 Relativity-EinsteinEtAl

Errors and Warnings

None.

KNOWN BUGS

See TODO.

SEE ALSO

ScanBooklet, Scanner, Scanner::Job, Scanner::Page

AUTHOR

Dale Amon <amon@vnl.com>

1 POD Error

The following errors were encountered while parsing the POD:

Around line 149:

=over should be: '=over' or '=over positive_number'

You can't have =items (as at line 157) unless the first thing after the =over is an =item