NAME
ScanBooklet - Document scan controller program.
SYNOPSIS
ScanBooklet {switches} <archivedate string> <PublicationTitle> \
<Publication Directory>
--fp | --firstpage=str Number for initial page of document.
Default is "001".
-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.
--sw | --spine=num Width of the document spine. Default is 1 inch.
--scanner=s Scanner id: Default is "gt68xx:libusb:001:003".
--ps | --pagesource=s Page source. Default is "NotApplicable."
-d | --debug Turn on internal debug code, if any.
-v ! --verbose=num Set level of diagnostic output. 0 for none.
-h | --help Print this usage information.
--man Print the man page for this command.
Description
This is a command line scanner control program for working with documents. For example, to scan the 17 July 2006 issue of New Scientist, one might type:
ScanBooklet 20060717 NewScientist /path/Publications/NewScientist
to create a directory containing scans of all the pages of that issue:
/path/Publications/NewScientist/20060717-NewScientist/
Each page must be manually set up on the scan bed before typing commands.
The commands are:
a: Scan the next batch of sheets without asking questions.
f: Scan sheet with title of cover.
c: Scan sheet with title of contents.
p: Scan sheet with default blank title.
b: Scan sheet with title of backcover.
s: Scan the document spine.
1: One sheet number per scan.
2: Two sheet numbers per scan.
i: Print information on the current job.
h: Help.
q: Quit.
x: eXit.
CR: Stay in the same mode.
The selection of a sheet as front or back automatically set the next scan to be a single page per sheet. The assumption is that the user initialized sheet size was either for single page per sheet documents or if for sized for two pages per sheet, the document has been laid on the scan table on the right or left of the field as appropriate. The program does not change the sheet size one going from one to the other. The sheet size is fixed for a given document and must be able to fit the largest field required during the entire document scan.
Pages per sheet is limited to 1 or 2. If there are more than 2 pages in a scan field, use the numbers of the first and last pages in the field. You can even generate overlapping fields of page numbers, so long as no overlapping field has the same start and end page numbers, eg "001-002", "002-003", "004-005", "005-006", "003-006" would be one way to deal with the pages in a 3 page foldout in a magazine.
Page numbers "001" and "001-001" will both result in a filename of "filename-p001.jpeg".
If you selected the wrong sheet type and are in the page number prompt, clear the line back to the prompt and hit ^d. This will return you to the sheet type prompt without doing anything else.
A ^p uses the history list to give you the previous pages if you want to rescan.
Valid page numbers are:
001 Will increment until 999.
001a Will increment unil 001z.
000.spine No incrementing.
001.01 Will increment until 001.99.
001.01a Will increment unil 001.01z.
Notes
In unix you can use the program:
lsusb
(as root) to help you find where a usb scanner is and to help you use the "hp:libusb:001:019" format.
A few thus far known supported scanners and their valid page sources are:
Umax 1200 umax:/dev/scsi/host0/bus0/target6/lun0/generic
"NotApplicable";
Old HP's: "hp:libusb:001:003"
"adf"
"Normal"
ScanJet 5590 "hp5590:libusb:001:003"
"adf" (*)
"Normal"
Mustek A3 USB "gt68xx:libusb:001:003"
"NotApplicable"
* The SANE driver for this scanner does not properly handle page
feeds through the ADF. It pulls multiple pages for every single
page scan request. HP says it ain't there problem and the SANE
guy doesn't have time to work on it.
Examples
# Using the default scanner and A4 page size
ScanBooklet 20080817 Scanner.pm-annotatedDMA /home/me/
# Specifying the scanner and page format.
ScanBooklet --scanner "gt68xx:lubusb:001:003" -f "L:12x17" \
20080817 Relativity-EinsteinEtAl /home/me/
Errors and Warnings
None.
KNOWN BUGS
See TODO.
SEE ALSO
Term::Readline, Term::Readline::Gnu, Scanner::Device, Scanner::Job
AUTHOR
Dale Amon <amon@vnl.com>