kopia lustrzana https://gitlab.com/sane-project/frontends
2002-01-11 Tom Martone <tom@martoneconsulting.com>
* src/scanadf.c (new) * doc/scanadf.man (new) * ./configure.in * src/Makefile.in * doc/Makefile.in * AUTHORS added scanadf programDEVEL_2_0_BRANCH-1
Tom Martone
rodzic
f586af82c4
commit
260ae6bb24
2
AUTHORS
2
AUTHORS
|
|
@ -1,8 +1,10 @@
|
|||
xcam: David Mosberger
|
||||
xscanimage: Tristan Tarrant, Andreas Beck, and David Mosberger
|
||||
scanadf: Tom Martone, Andreas Beck, and David Mosberger
|
||||
|
||||
Email addresses:
|
||||
|
||||
Andreas Beck <becka@sunserver1.rz.uni-duesseldorf.de>
|
||||
David Mosberger <David.Mosberger@acm.org>
|
||||
Tom Martone <tom@martoneconsulting.com>
|
||||
Tristan Tarrant <ttarrant@etnoteam.it>
|
||||
|
|
|
|||
|
|
@ -13,7 +13,7 @@ V_EXTRA=-cvs
|
|||
PACKAGE=sane-frontends
|
||||
|
||||
GUIPROGS="xscanimage xcam"
|
||||
BINPROGS=""
|
||||
BINPROGS="scanadf"
|
||||
|
||||
# languages
|
||||
# ALL_LINGUAS="cs de fr sv it tr"
|
||||
|
|
|
|||
|
|
@ -35,7 +35,7 @@ LN_S = @LN_S@
|
|||
|
||||
@SET_MAKE@
|
||||
|
||||
SECT1 = xscanimage.1 xcam.1
|
||||
SECT1 = xscanimage.1 xcam.1 scanadf.1
|
||||
MANPAGES = $(SECT1)
|
||||
LATEX = TEXINPUTS=$(srcdir):$$TEXINPUTS latex
|
||||
DLH = TEXINPUTS=$(srcdir):$$TEXINPUTS dlh
|
||||
|
|
@ -44,7 +44,7 @@ MAN2HTML= nroff -man |\
|
|||
-title $${page} -cgiurl '$$title.$$section.html'|\
|
||||
sed 's,<BODY>,<BODY BGCOLOR=\#FFFFFF TEXT=\#000000><H1 ALIGN=CENTER><IMG SRC="../sane.png" HEIGHT=117 WIDTH=346></H1>,'
|
||||
|
||||
DISTFILES = Makefile.in sane.png xcam.man xscanimage.man
|
||||
DISTFILES = Makefile.in sane.png xcam.man xscanimage.man scanadf.man
|
||||
|
||||
.PHONY: all clean depend dist html html-man install ps uninstall
|
||||
|
||||
|
|
|
|||
|
|
@ -0,0 +1,250 @@
|
|||
.TH scanadf 1 "15 Sep 1999"
|
||||
.IX scanadf
|
||||
.SH NAME
|
||||
scanadf - acquire multiple images from a scanner equipped with an ADF
|
||||
.SH SYNOPSIS
|
||||
.B scanadf
|
||||
.RB [ -d | --device-name
|
||||
.IR dev ]
|
||||
.RB [ -h | --help ]
|
||||
.RB [ -L | --list-devices ]
|
||||
.RB [ -v | --verbose ]
|
||||
.RB [ -V | --version ]
|
||||
.RB [ -o | --output-file
|
||||
.IR name ]
|
||||
.RB [ -S | --scan-script
|
||||
.IR name ]
|
||||
.RB [ -s | --start-count
|
||||
.IR num ]
|
||||
.RB [ -e | --end-count
|
||||
.IR num ]
|
||||
.RB [ -r | --raw ]
|
||||
.RI [ device-specific-options ]
|
||||
.SH DESCRIPTION
|
||||
.B scanadf
|
||||
is a command-line interface to control image acquisition devices which
|
||||
are capable of returning a series of images (e.g. a scanner with an
|
||||
automatic document feeder (ADF)). The device is controlled via
|
||||
command-line options. After command-line processing,
|
||||
.B scanadf
|
||||
normally proceeds to acquire a series of images until the device returns
|
||||
the
|
||||
.B SANE_STATUS_NO_DOCS
|
||||
status code.
|
||||
.PP
|
||||
The images are written to output files, specified by the
|
||||
.B --output-file
|
||||
option. These files are typically written in one of the PNM (portable aNyMaP)
|
||||
formats (PBM for black-and-white images, PGM for grayscale images,
|
||||
and PPM for color images). Several optional frame formats (SANE_FRAME_JPEG,
|
||||
SANE_FRAME_G31D, SANE_FRAME_G32D, SANE_FRAME_G42D, and SANE_FRAME_TEXT)
|
||||
are supported. In each case, the data is written out to the output file
|
||||
as-is without a header. Unrecognized frame formats are handled in
|
||||
the same way, although a warning message is printed in verbose mode.
|
||||
.PP
|
||||
Typically, the optional frame formats are used in conjunction with a scan
|
||||
script (specified by the
|
||||
.B --scanscript
|
||||
option) which is invoked for each acquired image. The script is provided
|
||||
with a series of environment variables which describe the parameters
|
||||
and format of the image file.
|
||||
|
||||
.B scanadf
|
||||
accesses image acquisition devices through the SANE (Scanner Access
|
||||
Now Easy) interface and can thus support any device for which there
|
||||
exists a SANE backend (try "apropos sane\-" to get a list of available
|
||||
backends).
|
||||
.SH OPTIONS
|
||||
.PP
|
||||
The
|
||||
.B -d
|
||||
or
|
||||
.B --device-name
|
||||
options must be followed by a SANE device-name. A (partial) list of
|
||||
available devices can be obtained with the
|
||||
.B --list-devices
|
||||
option (see below). If no device-name is specified explicitly,
|
||||
.B scanadf
|
||||
will attempt to open the first available device.
|
||||
.PP
|
||||
The
|
||||
.B -h
|
||||
or
|
||||
.B --help
|
||||
options request help information. The information is printed on
|
||||
standard output and in this case, no attempt will be made to acquire
|
||||
an image.
|
||||
.PP
|
||||
The
|
||||
.B -L
|
||||
or
|
||||
.B --list-devices
|
||||
option requests a (partial) list of devices that are available. The
|
||||
list is not complete since some devices may be available, but are not
|
||||
listed in any of the configuration files (which are typically stored
|
||||
in directory @CONFIGDIR@). This is particularly the case when
|
||||
accessing scanners through the network. If a device is not listed in
|
||||
a configuration file, the only way to access it is by its full device
|
||||
name. You may need to consult your system administrator to find out
|
||||
the names of such devices.
|
||||
.PP
|
||||
The
|
||||
.B -v
|
||||
or
|
||||
.B --verbose
|
||||
options increase the verbosity of the operation of
|
||||
.B scanadf.
|
||||
The option may be specified repeatedly, each time increasing the verbosity
|
||||
level.
|
||||
|
||||
The
|
||||
.B -V
|
||||
or
|
||||
.B --version
|
||||
option requests that
|
||||
.B scanadf
|
||||
print the program and package name, as well as the version number of
|
||||
the SANE distribution that it came with.
|
||||
|
||||
.PP
|
||||
The
|
||||
.B -o
|
||||
or
|
||||
.B --output-file
|
||||
option specifies a format string used to generate the name of file to
|
||||
write the image data to. You can use %d replacement in the output file
|
||||
name; this will be replaced with the current page number. The default
|
||||
format string is image-%04d.
|
||||
|
||||
.PP
|
||||
The
|
||||
.B -S
|
||||
or
|
||||
.B --scan-script
|
||||
option specifies the name of script to run after each scanned image
|
||||
is acquired. The script receives the name of the image output file
|
||||
as its first and only command line argument. Additionally the scan
|
||||
script can reference the following environment variables to get
|
||||
information about the parameters of the image.
|
||||
|
||||
.PP
|
||||
.RS
|
||||
.B SCAN_RES
|
||||
- the image resolution (in DPI)
|
||||
.br
|
||||
.B SCAN_WIDTH
|
||||
- the image width (in pixels)
|
||||
.br
|
||||
.B SCAN_HEIGHT
|
||||
- the image height (in pixels)
|
||||
.br
|
||||
.B SCAN_DEPTH
|
||||
- the image bit-depth (in bits)
|
||||
.br
|
||||
.B SCAN_FORMAT
|
||||
- a string representing the image format (e.g. gray, g42d, text, etc)
|
||||
.br
|
||||
.B SCAN_FORMAT_ID
|
||||
- the numeric image format identifier
|
||||
.br
|
||||
.RE
|
||||
|
||||
.PP
|
||||
The
|
||||
.B -s
|
||||
or
|
||||
.B --start-count
|
||||
option specifies the page number of first scanned image.
|
||||
|
||||
.PP
|
||||
The
|
||||
.B -e
|
||||
or
|
||||
.B --end-count
|
||||
option specifies the last page number to scan. Using this option,
|
||||
you can request a specific number of pages to be scanned, rather than
|
||||
scanning until there are no more images available.
|
||||
|
||||
.PP
|
||||
The
|
||||
.B -r
|
||||
or
|
||||
.B --raw
|
||||
option specifies that the raw image data be written to the output file
|
||||
as-is without interpretation. This disables the writing of the PNM
|
||||
header for basic frame types. This feature is usually used in
|
||||
conjunction with the
|
||||
.B --scan-script
|
||||
option where the scan script uses the environment variables to
|
||||
understand the format and parameters of the image and converts
|
||||
the file to a more useful format. NOTE: With support for the
|
||||
optional frame types and the default handling of unrecognized
|
||||
frametypes, this option becomes less and less useful.
|
||||
|
||||
As you might imagine, much of the power of
|
||||
.B scanadf
|
||||
comes from the fact that it can control any SANE backend. Thus, the
|
||||
exact set of command-line options depends on the capabilities of the
|
||||
selected device. To see the options for a device named
|
||||
.IR dev ,
|
||||
invoke
|
||||
.B scanadf
|
||||
via a command-line of the form:
|
||||
.PP
|
||||
.RS
|
||||
scanadf --help --device
|
||||
.I dev
|
||||
.RE
|
||||
.PP
|
||||
The documentation for the device-specific options printed by
|
||||
.B --help
|
||||
is explained in the manual page for
|
||||
.B scanimage.
|
||||
|
||||
.SH FILES
|
||||
.TP
|
||||
.I @CONFIGDIR@
|
||||
This directory holds various configuration files. For details, please
|
||||
refer to the manual pages listed below.
|
||||
.SH "SEE ALSO"
|
||||
scanimage(1), xscanimage(1)
|
||||
|
||||
.SH AUTHOR
|
||||
scanadf is an adaptation by Tom Martone of scanimage by David Mosberger,
|
||||
Andreas Beck, and Gordon Matzigkeit following closely the features of
|
||||
bnhscan by Sean Reifschneider of tummy.com, ltd.
|
||||
|
||||
.SH BUGS
|
||||
Please send reports to
|
||||
.IR sane\-devel@mostang.com
|
||||
.PP
|
||||
This program relies on the backend to return the
|
||||
.B SANE_STATUS_NO_DOCS
|
||||
status code when the automatic document feeder is out of paper. Use of
|
||||
this program with backends that do not support ADFs (e.g. flatbed scanners)
|
||||
will likely result in repeated scans of the same document. In this
|
||||
case, it is essential to use the start-count and end-count to
|
||||
control the number of images acquired.
|
||||
|
||||
.PP
|
||||
Only a subset of the SANE backends support feeders and return
|
||||
SANE_STATUS_NO_DOCS appropriately. Backends which are known to
|
||||
work at this time are:
|
||||
|
||||
.RS
|
||||
.br
|
||||
.B sane-bh
|
||||
- Bell+Howell Copiscan II series scanners.
|
||||
.br
|
||||
.B sane-hp
|
||||
- Hewlett Packard scanners. A patch to the sane-hp backend
|
||||
is necessary. The --scantype=ADF option must be specified (earlier
|
||||
versions of the backend used the --scan-from-adf option, instead).
|
||||
.br
|
||||
.B sane-umax
|
||||
- UMAX scanners. Support exists in build 12 and later.
|
||||
The --source="Automatic Document Feeder" option must be specified.
|
||||
.br
|
||||
.RE
|
||||
|
||||
|
||||
|
|
@ -56,10 +56,11 @@ LIBSANEI = ../sanei/libsanei.a
|
|||
|
||||
XSCANIMAGE_OBJS = xscanimage.o progress.o preview.o preferences.o gtkglue.o
|
||||
XCAM_OBJS = xcam.o preferences.o gtkglue.o
|
||||
SCANADF_OBJS = scanadf.o
|
||||
|
||||
DISTFILES = Makefile.in gtkglue.c gtkglue.h preferences.c preferences.h \
|
||||
preview.c preview.h progress.c progress.h sane-style.rc xcam.c \
|
||||
xscanimage-gimp-1_0-compat.h xscanimage.c
|
||||
xscanimage-gimp-1_0-compat.h xscanimage.c scanadf.c
|
||||
|
||||
.PHONY: all clean depend dist distclean install uninstall
|
||||
|
||||
|
|
@ -97,6 +98,9 @@ xcam: $(XCAM_OBJS) $(LIBSANEI) $(LIBLIB)
|
|||
$(LINK) $(XCAM_OBJS) $(LIBSANEI) \
|
||||
$(LIBLIB) $(GTK_LIBS) $(LIBS)
|
||||
|
||||
scanadf: $(SCANADF_OBJS) $(LIBLIB)
|
||||
$(LINK) $(SCANADF_OBJS) $(LIBLIB) $(LIBS)
|
||||
|
||||
clean:
|
||||
rm -f *.o *~ .*~ *.bak
|
||||
rm -rf .libs
|
||||
|
|
|
|||
Plik diff jest za duży
Load Diff
Ładowanie…
Reference in New Issue