NAME

scanpages - scan multiple pages via automatic document feeder (ADF)


SYNOPSIS

scanpages [options] [file]


DESCRIPTION

Pictures are scanned from a scanner equipped with an automatic document feeder (ADF) and converted to one of several formats specified by options.

An optional filename stub gives the name of the resulting files; either numbered like file-xxxxx.jpg, ... or file.pdf

Please consider that scanned pages take a large amount of disk space and remove any pictures you won't need anymore.


OPTIONS

--man|--help|-?
show manual page or short help screen

--g3, --g4
TODO: TIFF with G3 or G4 compression ???? do we need tiff multipage ????

--png
TODO: Portable Network Grafik

--jpg
TODO: Joint Photographic Expert Group (maybe you'd better use xsane(1) for scanning photographs)

--pnm
TODO: Portable Anymap - takes a LOT of disk space but is best suited for postprocessing with gocr

--ps|--pdf [pdf]
Create a multipage document in PostScript or Portable Document Format (PDF). Default format is PDF.

--100|--150|--200|--300 [150]
Set scanner resolution to 100, 150, 200 or 300 dpi. Default is 150 dpi, this setting should be high enough for most screen reading and printing purposes.

--A4|--A5|--A5l|--letter|--legal [A4]
Set scanning area to A4, A5. A5 landscape ... . ``letter'' and ``legal'' should work but have never been tested.

--bw|--grey|--gray [gray]
Scan in grayscale mode and reduce to black and white only or to a maximum of 16 different shades of gray.

--col|--color|--colour|--lots-of-colors
Scan in colormode and reduce to 16 respective 256 distinct colors. Please note that color mode takes longer to scan and needs more storage space.

[file]
TODO: prefix for generated files, default value is 'pict'


NOTES

The primary purpose of this programm is to aid in quick and troublefree creation of archival scans from printed documentation. To achieve this goal it is neccesary to sacrifice quality in terms of resolution and color rendition; some care is taken to not hurt clearity and legibility. This programm is therefore clearly not meant for mass scanning of photographs or other pieces of art, you'd better use xsane(1) for those tasks.

After despeckling (-despeckle / -noise 2) all pictures are normalised to provide constant contrast and lightness. Unless other options like --color have been selected, different colors or graylevels are reduced to black and white only. Sorry, we set a maximum of 256 distinct colors as storage space is really tight today.

ToDo

better cleaning of pictures before conversion; better compression

pngcrush

toolchain: (despeckle|noise) / color (2|16|256) / normalize


LICENSE

Copyright 2004-2005, Andreas Hirczy <ahi@itp.tu-graz.ac.at>

scanpages is distributed under the GNU General Public License. See the file COPYING for details. scanpages is available from http://itp.tugraz.at/~ahi/Computer/SW/

GNU General Public License

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA


SEE ALSO

scanimage(1), convert(1), ps2pdf(1), gocr(1)

http://www.mostang.com/sane/

http://www.imagemagick.org/

http://www.ghostscript.com/

http://www.gnu.org/software/ghostscript/