2003-02-24 21:05:18 +00:00
|
|
|
.TH sane 7 "Feb 24th, 2003" "@PACKAGEVERSION@" "SANE Scanner Access Now Easy"
|
2001-05-09 18:08:17 +00:00
|
|
|
.IX sane
|
|
|
|
|
|
|
|
.SH NAME
|
|
|
|
sane \- Scanner Access Now Easy: API for accessing scanners
|
|
|
|
|
|
|
|
.SH DESCRIPTION
|
|
|
|
.B SANE
|
|
|
|
is an application programming interface (API) that provides standardized
|
|
|
|
access to any raster image scanner hardware. The standardized interface makes
|
|
|
|
it possible to write just one driver for each scanner device instead of one
|
|
|
|
driver for each scanner and application.
|
|
|
|
|
|
|
|
While
|
|
|
|
.B SANE
|
|
|
|
is primarily targeted at a UNIX environment, the standard has been carefully
|
|
|
|
designed to make it possible to implement the API on virtually any hardware or
|
|
|
|
operating system.
|
|
|
|
.PP
|
2002-11-22 16:37:28 +00:00
|
|
|
This manual page provides a summary of the information available about
|
|
|
|
.BR SANE .
|
2001-05-09 18:08:17 +00:00
|
|
|
|
|
|
|
.SH TERMINOLOGY
|
|
|
|
|
|
|
|
An application that uses the
|
|
|
|
.B SANE
|
|
|
|
interface is called a
|
|
|
|
.B SANE frontend.
|
|
|
|
A driver that implements the
|
|
|
|
.B SANE
|
|
|
|
interface is called a
|
|
|
|
.B SANE backend.
|
|
|
|
A
|
|
|
|
.B meta backend
|
|
|
|
provides some means to manage one or more other backends.
|
|
|
|
|
2002-11-22 16:37:28 +00:00
|
|
|
.SH "SANE STANDARD AND WRITING BACKENDS"
|
2001-05-09 18:08:17 +00:00
|
|
|
The
|
|
|
|
.B SANE
|
|
|
|
standard defines the application programming interface (API) that is used to
|
|
|
|
communicate between frontends and backends. It can be found at
|
2002-11-22 16:37:28 +00:00
|
|
|
.I @DOCDIR@/sane.ps
|
|
|
|
(if latex is installed on your system) and on the
|
|
|
|
.B SANE
|
|
|
|
website:
|
|
|
|
.I http://www.mostang.com/sane/html/
|
|
|
|
(HTML), or
|
|
|
|
.I http://www.mostang.com/sane/sane.ps
|
|
|
|
(Postscript).
|
|
|
|
.PP
|
2001-05-09 18:08:17 +00:00
|
|
|
There is some more information for programmers in
|
2002-11-22 16:37:28 +00:00
|
|
|
.IR @DOCDIR@/backend-writing.txt .
|
|
|
|
Most of the internal
|
|
|
|
.B SANE
|
|
|
|
routines
|
|
|
|
.RB ( sanei )
|
|
|
|
are documented using doxygen:
|
|
|
|
.IR http://sanei.meier-geinitz.de/ .
|
|
|
|
Before a new backend or frontend project is started, have a look at
|
|
|
|
.I @DOCDIR@/PROJECTS
|
|
|
|
for projects that are planned or not yet included into the
|
|
|
|
.B SANE
|
|
|
|
distribution.
|
|
|
|
.PP
|
|
|
|
Your help is always appreciated. Look at
|
|
|
|
.I @DOCDIR@/TODO
|
|
|
|
for things that should be done. Not only programmers are needed, but also
|
|
|
|
reading and fixing the documentation and reporting bugs would be nice. Further
|
|
|
|
more, translations of the backend options are needed. Contact the
|
|
|
|
.B SANE
|
|
|
|
mailing list for details and tell us, when you start working on a project, so
|
|
|
|
no work id duplicated.
|
2001-05-09 18:08:17 +00:00
|
|
|
|
2002-11-22 16:37:28 +00:00
|
|
|
.SH "SOFTWARE PACKAGES"
|
2001-05-09 18:08:17 +00:00
|
|
|
The package
|
2002-11-22 16:37:28 +00:00
|
|
|
.RB ` sane-backends '
|
2001-05-09 18:08:17 +00:00
|
|
|
contains a lot of backends, documentation (including the
|
|
|
|
.B SANE
|
2002-11-22 16:37:28 +00:00
|
|
|
standard), networking support, and the command line frontend
|
|
|
|
.RB ` scanimage '.
|
|
|
|
The frontends
|
|
|
|
.RB ` xscanimage "', `" xcam "', and `" scanadf '
|
|
|
|
are included in the package
|
|
|
|
.RB ` sane-frontends '.
|
2001-05-09 18:08:17 +00:00
|
|
|
Both packages can be downloaded from the
|
|
|
|
.B SANE
|
2002-11-22 16:37:28 +00:00
|
|
|
homepage
|
|
|
|
.RI ( http://www.mostang.com/sane/ ).
|
|
|
|
Information about other frontends and backends can be found on the frontend
|
|
|
|
page
|
|
|
|
.RI ( http://www.mostang.com/sane/frontends.html ).
|
2001-05-09 18:08:17 +00:00
|
|
|
|
2002-11-22 16:37:28 +00:00
|
|
|
.SH "GENERAL INFORMATION"
|
2001-05-09 18:08:17 +00:00
|
|
|
The following sections provide short descriptions and links to more
|
|
|
|
information about several aspects of
|
|
|
|
.B SANE.
|
2002-11-22 16:37:28 +00:00
|
|
|
A name with a number in parenthesis (e.g.
|
|
|
|
.RB ` sane-dll (5)')
|
|
|
|
points to a manual page. In this case
|
|
|
|
.RB ` "man 5 sane-dll" '
|
|
|
|
will display the page. Entries like
|
|
|
|
.RI ` @DOCDIR@/sane.tex '
|
|
|
|
are references to text files that were copied to the
|
|
|
|
.B SANE
|
|
|
|
documentation directory
|
|
|
|
.RI ( @DOCDIR@/ )
|
|
|
|
during installation. Everything else is a URL to a resource on the web.
|
2001-05-09 18:08:17 +00:00
|
|
|
|
|
|
|
.TP 2
|
|
|
|
.B SANE homepage
|
|
|
|
Information on all aspects of SANE including a tutorial and a link to the SANE FAQ
|
2002-11-22 16:37:28 +00:00
|
|
|
can be found on the SANE homepage:
|
|
|
|
.IR http://www.mostang.com/sane/ .
|
2001-05-09 18:08:17 +00:00
|
|
|
.TP
|
|
|
|
.B SANE mailing list
|
|
|
|
There is a mailing list for the purpose of discussing the SANE standard and
|
2002-11-22 16:37:28 +00:00
|
|
|
its implementations: sane-devel. Despite its name, the list is not only
|
|
|
|
intended for developers, but also for users. Since this is currently the only
|
|
|
|
mailing list devoted to SANE, it's perfectly OK to ask questions that are not
|
|
|
|
strictly related to SANE development. How to subscribe and unsubscribe:
|
|
|
|
.IR http://www.mostang.com/sane/mail.html .
|
2001-05-09 18:08:17 +00:00
|
|
|
.TP
|
|
|
|
.B Compiling and installing SANE
|
2002-11-22 16:37:28 +00:00
|
|
|
Look at
|
|
|
|
.I @DOCDIR@/README
|
|
|
|
and the os-dependent README files for information about compiling and
|
|
|
|
installing
|
|
|
|
.B SANE.
|
2001-05-09 18:08:17 +00:00
|
|
|
.TP
|
|
|
|
.B SCSI configuration
|
2002-11-22 16:37:28 +00:00
|
|
|
For information about various systems and SCSI controllers see
|
|
|
|
.BR sane-scsi (5).
|
2002-10-25 12:19:34 +00:00
|
|
|
.TP
|
2001-08-11 13:25:06 +00:00
|
|
|
.B USB configuration
|
2002-11-22 16:37:28 +00:00
|
|
|
For information about USB configuration see
|
|
|
|
.BR sane-usb (5).
|
2001-05-09 18:08:17 +00:00
|
|
|
|
2002-11-22 16:37:28 +00:00
|
|
|
.SH "FRONTENDS AND MISCELLANEOUS PROGRAMS"
|
2001-05-09 18:08:17 +00:00
|
|
|
.TP 2
|
|
|
|
.B scanimage
|
2002-11-22 16:37:28 +00:00
|
|
|
Command-line frontend. See
|
|
|
|
.BR scanimage (1).
|
2001-05-09 18:08:17 +00:00
|
|
|
.TP
|
|
|
|
.B saned
|
|
|
|
.B SANE
|
|
|
|
network daemon that allows remote clients to access image acquisition devices
|
2002-11-22 16:37:28 +00:00
|
|
|
available on the local host. See
|
|
|
|
.BR saned (1).
|
2001-05-09 18:08:17 +00:00
|
|
|
.TP
|
|
|
|
.B sane-find-scanner
|
2002-11-22 16:37:28 +00:00
|
|
|
Ccommand-line tool to find SCSI and USB scanners and determine their Unix
|
|
|
|
device files. See
|
|
|
|
.BR sane-find-scanner (1).
|
|
|
|
.PP
|
|
|
|
Also, have a look at the
|
|
|
|
.B sane-frontends
|
|
|
|
package (including
|
|
|
|
.BR xscanimage ", " xcam ", and " scanadf )
|
|
|
|
and the frontend information page at
|
|
|
|
.IR http://www.mostang.com/sane/sane-frontends.html .
|
2001-05-09 18:08:17 +00:00
|
|
|
|
2002-11-22 16:37:28 +00:00
|
|
|
.SH "BACKENDS FOR SCANNERS"
|
2001-05-09 18:08:17 +00:00
|
|
|
.TP 2
|
|
|
|
.B abaton
|
|
|
|
The SANE backend for Abaton flatbed scanners supports the Scan 300/GS (8bit,
|
|
|
|
256 levels of gray) and the Scan 300/S (black and white, untested). See
|
2002-11-22 16:37:28 +00:00
|
|
|
.BR sane-abaton (5)
|
|
|
|
for details.
|
2001-05-09 18:08:17 +00:00
|
|
|
.TP
|
|
|
|
.B agfafocus
|
|
|
|
This backend supports AGFA Focus scanners and the Siemens S9036 (untested).
|
2002-11-22 16:37:28 +00:00
|
|
|
See
|
|
|
|
.BR sane-agfafocus (5)
|
|
|
|
for details.
|
2001-05-09 18:08:17 +00:00
|
|
|
.TP
|
|
|
|
.B apple
|
|
|
|
The SANE backend for Apple flatbed scanners supports the following scanners:
|
2002-11-22 16:37:28 +00:00
|
|
|
AppleScanner, OneScanner and ColorOneScanner. See
|
|
|
|
.BR sane-apple (5)
|
|
|
|
for details.
|
2001-05-09 18:08:17 +00:00
|
|
|
.TP
|
|
|
|
.B artec
|
2002-11-22 16:37:28 +00:00
|
|
|
The SANE Artec backend supports several Artec/Ultima SCSI flatbed scanners as
|
|
|
|
well as the BlackWidow BW4800SP and the Plustek 19200S. See
|
|
|
|
.BR sane-artec (5)
|
|
|
|
for details.
|
2001-05-09 18:08:17 +00:00
|
|
|
.TP
|
2002-11-20 12:23:07 +00:00
|
|
|
.B artec_eplus48u
|
|
|
|
The SANE artec_eplus48u backend supports the scanner Artec E+ 48U and re-badged
|
|
|
|
models like Tevion MD 9693, Medion MD 9693, Medion MD 9705 and Trust Easy
|
2002-11-22 16:37:28 +00:00
|
|
|
Webscan 19200. See
|
|
|
|
.BR sane-artec_eplus48u (5)
|
|
|
|
for details.
|
2002-11-20 12:23:07 +00:00
|
|
|
.TP
|
2001-05-09 18:08:17 +00:00
|
|
|
.B as6e
|
|
|
|
This is a SANE backend for using the Artec AS6E parallel port interface
|
2002-11-22 16:37:28 +00:00
|
|
|
scanner. See
|
|
|
|
.BR sane-as6e (5)
|
|
|
|
for details.
|
2001-05-09 18:08:17 +00:00
|
|
|
.TP
|
|
|
|
.B avision
|
2003-02-16 17:35:05 +00:00
|
|
|
This backend supports several Avision based scanners. This includes the
|
2003-02-16 19:16:03 +00:00
|
|
|
original Avision scanners (like AV 630, AV 620, ...) as well as the HP
|
|
|
|
ScanJet 53xx and 74xx series, Fujitsu ScanPartnerm, some Mitsubishi and
|
|
|
|
Minolta film-scanners.
|
|
|
|
See
|
2002-11-22 16:37:28 +00:00
|
|
|
.BR sane-avision (5)
|
2001-05-09 18:08:17 +00:00
|
|
|
for details.
|
|
|
|
.TP
|
|
|
|
.B bh
|
|
|
|
The bh backend provides access to Bell+Howell Copiscan II series document
|
2002-11-22 16:37:28 +00:00
|
|
|
scanners. See
|
|
|
|
.BR sane-bh (5)
|
|
|
|
for details.
|
2001-05-09 18:08:17 +00:00
|
|
|
.TP
|
|
|
|
.B canon
|
|
|
|
The canon backend supports the CanoScan 300, CanoScan 600, and CanoScan
|
2002-11-22 16:37:28 +00:00
|
|
|
2700F SCSI flatbed scanners. See
|
|
|
|
.BR sane-canon (5)
|
|
|
|
for details.
|
2001-05-09 18:08:17 +00:00
|
|
|
.TP
|
2002-04-07 12:58:56 +00:00
|
|
|
.B canon630u
|
|
|
|
The canon630u backend supports the CanoScan 630u and 636u USB scanners. See
|
2002-11-22 16:37:28 +00:00
|
|
|
.BR sane-canon630u (5)
|
|
|
|
for details.
|
2002-04-07 12:58:56 +00:00
|
|
|
.TP
|
2002-04-01 22:56:14 +00:00
|
|
|
.B canon_pp
|
|
|
|
The canon_pp backend supports the CanoScan FB330P, FB630P, N340P and N640P
|
2002-11-22 16:37:28 +00:00
|
|
|
parallel port scanners. See
|
|
|
|
.BR sane-canon_pp (5)
|
|
|
|
for details.
|
2002-04-01 22:56:14 +00:00
|
|
|
.TP
|
2001-05-09 18:08:17 +00:00
|
|
|
.B coolscan
|
2002-11-22 16:37:28 +00:00
|
|
|
This is a SANE backend for Nikon Coolscan film-scanners. See
|
|
|
|
.BR sane-coolscan (5)
|
2001-05-09 18:08:17 +00:00
|
|
|
for details.
|
|
|
|
.TP
|
2002-04-22 22:18:45 +00:00
|
|
|
.B coolscan2
|
2002-11-20 12:23:07 +00:00
|
|
|
This is a SANE backend for Nikon Coolscan film-scanners.
|
2002-11-22 16:37:28 +00:00
|
|
|
See
|
|
|
|
.BR sane-coolscan2 (5)
|
|
|
|
or
|
|
|
|
.I http://coolscan2.sourceforge.net
|
|
|
|
for details.
|
2002-04-22 22:18:45 +00:00
|
|
|
.TP
|
2001-05-09 18:08:17 +00:00
|
|
|
.B epson
|
|
|
|
The SANE epson backend provides support for Epson SCSI, parallel port and USB
|
2002-11-22 16:37:28 +00:00
|
|
|
flatbed scanners. See
|
|
|
|
.BR sane-epson (5)
|
|
|
|
for details.
|
2001-05-09 18:08:17 +00:00
|
|
|
.TP
|
2002-04-17 18:59:37 +00:00
|
|
|
.B fujitsu
|
|
|
|
The fujitsu backend provides support for Fujitsu 3091, 3093, 3096 and
|
2002-11-22 16:37:28 +00:00
|
|
|
fi-4340 SCSI scanners. See
|
|
|
|
.BR sane-fujitsu (5)
|
|
|
|
for details.
|
2002-04-17 18:59:37 +00:00
|
|
|
.TP
|
2002-10-25 12:19:34 +00:00
|
|
|
.B gt68xx
|
2002-11-22 16:37:28 +00:00
|
|
|
The gt68xx backend provides support for scanners based on the Grandtech GT-6801
|
2002-10-25 12:19:34 +00:00
|
|
|
and GT-6816 chips like the Artec Ultima 2000 and several Mustek BearPaw CU and
|
2002-11-22 16:37:28 +00:00
|
|
|
TA models. See
|
|
|
|
.BR sane-gt68xx (5)
|
|
|
|
for details.
|
2002-10-25 12:19:34 +00:00
|
|
|
.TP
|
2001-05-09 18:08:17 +00:00
|
|
|
.B hp
|
2002-11-22 16:37:28 +00:00
|
|
|
The SANE hp backend provides access to Hewlett-Packard ScanJet scanners which
|
|
|
|
support SCL (Scanner Control Language by HP). See
|
|
|
|
.BR sane-hp (5)
|
|
|
|
for details.
|
2001-05-09 18:08:17 +00:00
|
|
|
.TP
|
2002-05-29 19:10:12 +00:00
|
|
|
.B hpsj5s
|
2002-11-22 16:37:28 +00:00
|
|
|
The SANE backend for the Hewlett-Packard ScanJet 5S scanner. See
|
|
|
|
.BR sane-hpsj5s (5)
|
|
|
|
for details.
|
2002-05-29 19:10:12 +00:00
|
|
|
.TP
|
2002-04-21 23:13:44 +00:00
|
|
|
.B leo
|
2002-11-22 16:37:28 +00:00
|
|
|
This backend supports the Leo S3 and the Across FS-1130, which is a re-badged
|
|
|
|
LEO FS-1130 scanner. See
|
|
|
|
.BR sane-leo (5)
|
|
|
|
for details.
|
2002-04-21 23:13:44 +00:00
|
|
|
.TP
|
2003-02-24 21:05:18 +00:00
|
|
|
.B ma1509
|
|
|
|
The ma1509 backend supports the Mustek BearPaw 1200F USB flatbed scanner. See
|
|
|
|
.BR sane-ma1509 (5)
|
|
|
|
for details.
|
|
|
|
.TP
|
2002-03-06 23:54:26 +00:00
|
|
|
.B matsushita
|
|
|
|
This backend supports some Panasonic KVSS high speed scanners. See
|
2002-11-22 16:37:28 +00:00
|
|
|
.BR sane-matsushita (5)
|
|
|
|
for details.
|
2002-03-06 23:54:26 +00:00
|
|
|
.TP
|
2001-05-09 18:08:17 +00:00
|
|
|
.B microtek
|
|
|
|
The microtek backend provides access to the "second generation" Microtek
|
2002-11-22 16:37:28 +00:00
|
|
|
scanners with SCSI-1 command set. See
|
|
|
|
.BR sane-microtek (5)
|
|
|
|
for details.
|
2001-05-09 18:08:17 +00:00
|
|
|
.TP
|
|
|
|
.B microtek2
|
|
|
|
The microtek2 backend provides access to some Microtek scanners with a
|
2002-11-22 16:37:28 +00:00
|
|
|
SCSI-2 command set. See
|
|
|
|
.BR sane-microtek2 (5)
|
|
|
|
for details.
|
2001-05-09 18:08:17 +00:00
|
|
|
.TP
|
|
|
|
.B mustek
|
|
|
|
The SANE mustek backend supports most Mustek SCSI flatbed scanners including
|
2001-09-09 14:50:08 +00:00
|
|
|
the Paragon and ScanExpress series and the 600 II N (non-SCSI). Some Trust
|
2002-11-22 16:37:28 +00:00
|
|
|
scanners are also supported. See
|
|
|
|
.BR sane-mustek (5)
|
|
|
|
for details.
|
2001-05-09 18:08:17 +00:00
|
|
|
.TP
|
|
|
|
.B mustek_pp
|
|
|
|
The mustek_pp backend provides access to Mustek parallel port flatbed
|
2002-11-22 16:37:28 +00:00
|
|
|
scanners. See
|
|
|
|
.BR sane-mustek_pp (5)
|
|
|
|
for details.
|
2001-05-09 18:08:17 +00:00
|
|
|
.TP
|
2001-09-09 14:50:08 +00:00
|
|
|
.B mustek_usb
|
2002-10-25 12:19:34 +00:00
|
|
|
The mustek_usb backend provides access to some Mustek ScanExpress USB flatbed
|
2002-11-22 16:37:28 +00:00
|
|
|
scanners. See
|
|
|
|
.BR sane-mustek_usb (5)
|
|
|
|
for details.
|
2001-09-09 14:50:08 +00:00
|
|
|
.TP
|
2001-05-09 18:08:17 +00:00
|
|
|
.B nec
|
|
|
|
The SANE nec backend supports the NEC PC-IN500/4C SCSI scanner. See
|
2002-11-22 16:37:28 +00:00
|
|
|
.BR sane-nec (5)
|
|
|
|
for details.
|
2001-05-09 18:08:17 +00:00
|
|
|
.TP
|
|
|
|
.B pie
|
2002-11-22 16:37:28 +00:00
|
|
|
The pie backend provides access to Pacific Image Electronics (PIE) and Devcom
|
|
|
|
SCSI flatbed scanners. See
|
|
|
|
.BR sane-pie (5)
|
|
|
|
for details.
|
2001-05-09 18:08:17 +00:00
|
|
|
.TP
|
|
|
|
.B plustek
|
2002-03-11 22:31:41 +00:00
|
|
|
The SANE plustek backend supports Plustek parallel port and LM983[1/2/3] based
|
2002-11-22 16:37:28 +00:00
|
|
|
USB flatbed scanners. See
|
|
|
|
.BR sane-plustek (5)
|
|
|
|
for details.
|
2001-05-09 18:08:17 +00:00
|
|
|
.TP
|
|
|
|
.B ricoh
|
|
|
|
The ricoh backend provides access to the following Ricoh flatbed
|
2002-11-22 16:37:28 +00:00
|
|
|
scanners: IS50 and IS60. See
|
|
|
|
.BR sane-ricoh (5)
|
|
|
|
for details.
|
2001-05-09 18:08:17 +00:00
|
|
|
.TP
|
|
|
|
.B s9036
|
|
|
|
The s9036 backend provides access to Siemens 9036 flatbed scanners. See
|
2002-11-22 16:37:28 +00:00
|
|
|
.BR sane-s9036 (5)
|
|
|
|
for details.
|
2001-05-09 18:08:17 +00:00
|
|
|
.TP
|
2002-02-21 18:49:30 +00:00
|
|
|
.B sceptre
|
|
|
|
The sceptre backend provides access to the Sceptre S1200 flatbed scanner. See
|
2002-11-22 16:37:28 +00:00
|
|
|
.BR sane-sceptre (5)
|
|
|
|
for details.
|
2002-02-21 18:49:30 +00:00
|
|
|
.TP
|
2001-05-09 18:08:17 +00:00
|
|
|
.B sharp
|
2002-11-22 16:37:28 +00:00
|
|
|
The SANE sharp backend supports Sharp SCSI scanners. See
|
|
|
|
.BR sane-sharp (5)
|
|
|
|
for details.
|
2001-05-09 18:08:17 +00:00
|
|
|
.TP
|
2001-05-16 19:06:21 +00:00
|
|
|
.B sm3600
|
|
|
|
The SANE sm3600 backend supports the Microtek ScanMaker 3600 USB scanner. See
|
2002-11-22 16:37:28 +00:00
|
|
|
.BR sane-sm3600 (5)
|
|
|
|
for details.
|
2001-05-16 19:06:21 +00:00
|
|
|
.TP
|
2001-05-09 18:08:17 +00:00
|
|
|
.B snapscan
|
|
|
|
The snapscan backend supports AGFA SnapScan flatbed scanners. See
|
2002-11-22 16:37:28 +00:00
|
|
|
.BR sane-snapscan (5)
|
|
|
|
for details.
|
2001-05-09 18:08:17 +00:00
|
|
|
.TP
|
|
|
|
.B sp15c
|
2002-04-17 18:59:37 +00:00
|
|
|
This backend supports the Fujitsu FCPA ScanPartner 15C flatbed scanner. See
|
2002-11-22 16:37:28 +00:00
|
|
|
.BR sane-sp15c (5)
|
|
|
|
for details.
|
2001-05-09 18:08:17 +00:00
|
|
|
.TP
|
|
|
|
.B st400
|
|
|
|
The sane-st400 backend provides access to Siemens ST400 and ST800. See
|
2002-11-22 16:37:28 +00:00
|
|
|
.BR sane-st400 (5)
|
|
|
|
for details.
|
2001-05-09 18:08:17 +00:00
|
|
|
.TP
|
|
|
|
.B tamarack
|
|
|
|
The SANE tamarack backend supports Tamarack Artiscan flatbed scanners. See
|
2002-11-22 16:37:28 +00:00
|
|
|
.BR sane-tamarack (5)
|
|
|
|
for details.
|
2001-05-09 18:08:17 +00:00
|
|
|
.TP
|
2002-08-31 15:49:16 +00:00
|
|
|
.B teco1 teco2 teco3
|
|
|
|
The SANE teco1, teco2 and teco3 backends support some TECO scanners,
|
|
|
|
usually sold under the Relisys, Trust, Primax, Piotech, Dextra
|
2002-11-22 16:37:28 +00:00
|
|
|
names. See
|
|
|
|
.BR sane-teco1 "(5), " sane-teco2 "(5) and " sane-teco3 (5)
|
|
|
|
for details.
|
2002-04-08 23:45:33 +00:00
|
|
|
.TP
|
2001-05-09 18:08:17 +00:00
|
|
|
.B umax
|
|
|
|
The sane-umax backend provides access to several UMAX-SCSI-scanners and some
|
2002-11-22 16:37:28 +00:00
|
|
|
Linotype Hell SCSI-scanners. See
|
|
|
|
.BR sane-umax (5)
|
|
|
|
for details.
|
2001-05-09 18:08:17 +00:00
|
|
|
.TP
|
|
|
|
.B umax_pp
|
|
|
|
The sane-umax_pp backend provides access to Umax parallel port flatbed scanners
|
2002-11-22 16:37:28 +00:00
|
|
|
and the HP 3200C. See
|
|
|
|
.BR sane-umax_pp (5)
|
|
|
|
for details.
|
2002-01-07 23:22:07 +00:00
|
|
|
.TP
|
|
|
|
.B umax1200u
|
|
|
|
The sane-umax1220u backend supports the UMAX Astra 1220U (USB) flatbed scanner
|
2002-11-22 16:37:28 +00:00
|
|
|
(and also the UMAX Astra 2000U, sort of). See
|
|
|
|
.BR sane-umax1220u (5)
|
|
|
|
for details.
|
|
|
|
.PP
|
2001-05-09 18:08:17 +00:00
|
|
|
Also, have a look at the backend information page at
|
2002-11-22 16:37:28 +00:00
|
|
|
.I http://www.mostang.com/sane/sane-supported-devices.html
|
|
|
|
and the list of projects in
|
|
|
|
.IR @DOCDIR@/PROJECTS .
|
2001-05-09 18:08:17 +00:00
|
|
|
|
2002-11-22 16:37:28 +00:00
|
|
|
.SH "BACKENDS FOR DIGITAL CAMERAS"
|
2001-05-09 18:08:17 +00:00
|
|
|
.TP 2
|
2002-04-13 19:15:26 +00:00
|
|
|
.B dc210
|
2002-11-22 16:37:28 +00:00
|
|
|
Backend for Kodak DC210 Digital Camera. See
|
|
|
|
.BR sane-dc210 (5).
|
2001-05-09 18:08:17 +00:00
|
|
|
.TP
|
2002-04-13 19:15:26 +00:00
|
|
|
.B dc240
|
2002-11-22 16:37:28 +00:00
|
|
|
Backend for Kodak DC240 Digital Camera. See
|
|
|
|
.BR sane-dc240 (5).
|
2001-05-09 18:08:17 +00:00
|
|
|
.TP
|
2002-04-13 19:15:26 +00:00
|
|
|
.B dc25
|
2002-11-22 16:37:28 +00:00
|
|
|
Backend for Kodak DC20/DC25 Digital Cameras. See
|
|
|
|
.BR sane-dc25 (5).
|
2001-05-09 18:08:17 +00:00
|
|
|
.TP
|
2002-04-13 19:15:26 +00:00
|
|
|
.B dmc
|
2002-11-22 16:37:28 +00:00
|
|
|
Backend for the Polaroid Digital Microscope Camera. See
|
|
|
|
.BR sane-dmc(5).
|
2001-05-09 18:08:17 +00:00
|
|
|
.TP
|
2002-04-13 19:15:26 +00:00
|
|
|
.B gphoto2
|
2001-10-08 03:05:36 +00:00
|
|
|
Backend for digital cameras supported by the gphoto2 library package. (See
|
2002-11-22 16:37:28 +00:00
|
|
|
.I http://www.gphoto.org
|
|
|
|
for more information and a list of supported cameras.) Gphoto2 supports over
|
|
|
|
140 different camera models. However, please note that more development and
|
|
|
|
testing is needed before all of these cameras will be supported by
|
|
|
|
.B SANE
|
|
|
|
backend. See
|
|
|
|
.BR sane-gphoto2 (5).
|
2001-10-08 03:05:36 +00:00
|
|
|
.TP
|
2002-04-13 19:15:26 +00:00
|
|
|
.B qcam
|
2002-11-22 16:37:28 +00:00
|
|
|
Backend for Connectix QuickCam cameras. See
|
|
|
|
.BR sane-qcam (5).
|
|
|
|
.PP
|
2001-05-09 18:08:17 +00:00
|
|
|
Also, have a look at the backend information page at
|
2002-11-22 16:37:28 +00:00
|
|
|
.I http://www.mostang.com/sane/sane-supported-devices.html
|
|
|
|
and the list of projects in
|
|
|
|
.IR @DOCDIR@/PROJECTS .
|
2001-05-09 18:08:17 +00:00
|
|
|
|
2002-11-22 16:37:28 +00:00
|
|
|
.SH "MISCELLANEOUS BACKENDS"
|
2001-05-09 18:08:17 +00:00
|
|
|
.TP 2
|
2002-04-13 19:15:26 +00:00
|
|
|
.B dll
|
2002-11-22 16:37:28 +00:00
|
|
|
The sane-dll library implements a
|
|
|
|
.B SANE
|
|
|
|
backend that provides access to an arbitrary number of other
|
|
|
|
.B SANE
|
|
|
|
backends by dynamic loading. See
|
|
|
|
.BR sane-dll(5).
|
2001-05-09 18:08:17 +00:00
|
|
|
.TP
|
2002-04-13 19:15:26 +00:00
|
|
|
.B net
|
2001-05-09 18:08:17 +00:00
|
|
|
The
|
|
|
|
.B SANE
|
|
|
|
network daemon saned provides access to scanners located on different
|
2002-11-22 16:37:28 +00:00
|
|
|
computers in connection with the net backend. See
|
|
|
|
.BR sane-net "(5) and " saned (1).
|
2001-05-09 18:08:17 +00:00
|
|
|
.TP
|
2002-04-13 19:15:26 +00:00
|
|
|
.B pnm
|
2001-05-09 18:08:17 +00:00
|
|
|
PNM image reader pseudo-backend. The purpose of this backend is primarily to
|
2002-11-22 16:37:28 +00:00
|
|
|
aid in debugging of
|
|
|
|
.B SANE
|
|
|
|
frontends. See
|
|
|
|
.BR sane-pnm (5).
|
2001-05-09 18:08:17 +00:00
|
|
|
.TP
|
2002-04-13 19:15:26 +00:00
|
|
|
.B pint
|
2002-11-22 16:37:28 +00:00
|
|
|
Backend for scanners that use the
|
|
|
|
.B PINT
|
|
|
|
(Pint Is Not Twain) device driver. The
|
|
|
|
.B PINT
|
|
|
|
driver is being actively developed on the OpenBSD platform, and has been
|
|
|
|
ported to a few other *nix-like operating systems. See
|
|
|
|
.BR sane-pint (5).
|
2001-05-09 18:08:17 +00:00
|
|
|
.TP
|
2002-04-13 19:15:26 +00:00
|
|
|
.B test
|
2002-11-22 16:37:28 +00:00
|
|
|
The
|
|
|
|
.B SANE
|
|
|
|
test backend is for testing frontends and the
|
|
|
|
.B SANE
|
|
|
|
installation. It provides test pictures and various test options. See
|
|
|
|
.BR sane-test (5).
|
2002-04-13 19:15:26 +00:00
|
|
|
.TP
|
|
|
|
.B v4l
|
2001-05-09 18:08:17 +00:00
|
|
|
The sane-v4l library implements a
|
|
|
|
.B SANE
|
|
|
|
backend that provides generic access to video cameras and similar equipment
|
2002-11-22 16:37:28 +00:00
|
|
|
using the
|
|
|
|
.B V4L
|
|
|
|
(Video for Linux) API. See
|
|
|
|
.BR sane-v4l(5) .
|
|
|
|
.PP
|
2001-05-09 18:08:17 +00:00
|
|
|
Also, have a look at the backend information page at
|
2002-11-22 16:37:28 +00:00
|
|
|
.I http://www.mostang.com/sane/sane-supported-devices.html
|
|
|
|
and the list of projects in
|
|
|
|
.IR @DOCDIR@/PROJECTS .
|
2001-05-09 18:08:17 +00:00
|
|
|
|
|
|
|
.SH PROBLEMS
|
2002-11-22 16:37:28 +00:00
|
|
|
Please note that the default configuration uses
|
|
|
|
.B sane-dll
|
|
|
|
as the top-level backend. Hence it is probably a good idea to start with
|
|
|
|
reading
|
|
|
|
.BR sane-dll (5).
|
|
|
|
The top-level backend can be changed by copying or linking a backend to
|
|
|
|
.B libsane.so
|
|
|
|
in
|
|
|
|
.IR @LIBDIR@ .
|
|
|
|
.PP
|
2001-05-09 18:08:17 +00:00
|
|
|
If you encounter any problems with getting your device(s) recognized, try
|
|
|
|
setting the various environment variables that are available to assist in
|
|
|
|
debugging such problems. The environment variables are documented in the
|
|
|
|
relevant manual pages. For example, to get the maximum amount of debug
|
|
|
|
information when testing a Mustek SCSI scanner, set environment variables
|
2002-11-22 16:37:28 +00:00
|
|
|
.BR SANE_DEBUG_DLL ", " SANE_DEBUG_MUSTEK ", and " SANE_DEBUG_SANEI_SCSI
|
|
|
|
to 128 and then invoke
|
|
|
|
.B scanimage
|
|
|
|
or whatever program you're trying to debug. For a Mustek scanner at
|
|
|
|
.IR /dev/scanner,
|
|
|
|
you might want to invoke
|
|
|
|
.B scanimage
|
|
|
|
as follows:
|
2001-05-09 18:08:17 +00:00
|
|
|
.IP
|
2002-11-22 16:37:28 +00:00
|
|
|
.B scanimage \-d
|
|
|
|
.I mustek:/dev/scanner
|
|
|
|
.B \-h
|
2001-05-09 18:08:17 +00:00
|
|
|
.TP
|
|
|
|
If this works, you could try to acquire an image with:
|
|
|
|
.IP
|
2002-11-22 16:37:28 +00:00
|
|
|
.B scanimage \-d
|
|
|
|
.IR mustek:/dev/scanner " >t.pnm"
|
2001-05-09 18:08:17 +00:00
|
|
|
.PP
|
2002-11-22 16:37:28 +00:00
|
|
|
To check that the
|
|
|
|
.B SANE
|
|
|
|
libraries are installed correctly you can use the test backend, even if you
|
|
|
|
don't have a scanner or other
|
|
|
|
.B SANE
|
|
|
|
device:
|
2002-04-22 16:56:26 +00:00
|
|
|
.IP
|
2002-11-22 16:37:28 +00:00
|
|
|
.B scanimage \-d
|
|
|
|
.I test
|
|
|
|
.B \-T
|
2002-04-22 16:56:26 +00:00
|
|
|
.TP
|
|
|
|
You should get a list of PASSed tests.
|
|
|
|
.PP
|
2001-08-11 13:25:06 +00:00
|
|
|
If you are not sure what generic SCSI or USB device your scanner is connected
|
2002-11-22 16:37:28 +00:00
|
|
|
to, try the command
|
|
|
|
.BR sane-find-scanner .
|
|
|
|
Usually, It's sufficient to invoke the program without any arguments.
|
|
|
|
Invoking this command should produce output similar to this (informational
|
|
|
|
messages are ommitted):
|
2001-05-09 18:08:17 +00:00
|
|
|
.IP
|
2002-11-22 16:37:28 +00:00
|
|
|
found SCSI scanner "SCANNER 2.01" at /dev/sg1
|
2001-05-09 18:08:17 +00:00
|
|
|
.br
|
2002-11-22 16:37:28 +00:00
|
|
|
found USB scanner (vendor=0x05d8, product=0x4002) at libusb:001:012
|
2001-05-09 18:08:17 +00:00
|
|
|
.PP
|
|
|
|
Note that sane-find-scanner will find any scanner that is connected to a SCSI
|
2002-11-22 16:37:28 +00:00
|
|
|
or USB bus. It will even find scanners that are not supported at all by
|
|
|
|
.BR SANE .
|
|
|
|
.PP
|
2001-05-09 18:08:17 +00:00
|
|
|
There may be several causes for the following messages from the frontends:
|
|
|
|
"scanimage: no SANE devices found" or "xscanimage: no devices available.".
|
|
|
|
.TP 2
|
|
|
|
*
|
|
|
|
Your scanner is not recognized by any backend. It is not supported. You may
|
2002-11-22 16:37:28 +00:00
|
|
|
ask the maintainer of your backend (see
|
|
|
|
.IR @DOCDIR@/AUTHORS )
|
|
|
|
or the
|
|
|
|
.B SANE
|
|
|
|
mailing list (see above) if support is planned.
|
2001-05-09 18:08:17 +00:00
|
|
|
.TP
|
|
|
|
*
|
2002-11-22 16:37:28 +00:00
|
|
|
.B SANE
|
|
|
|
can't access the device files (e.g
|
|
|
|
.IR /dev/sg0 ).
|
|
|
|
Check the permissions.
|
2001-05-09 18:08:17 +00:00
|
|
|
.TP
|
|
|
|
*
|
2002-11-22 16:37:28 +00:00
|
|
|
Your backend is not listed in
|
|
|
|
.I @CONFIGDIR@/dll.conf
|
|
|
|
(or commented out).
|
2001-05-13 20:32:30 +00:00
|
|
|
.TP
|
|
|
|
*
|
2002-11-22 16:37:28 +00:00
|
|
|
There are older installations of
|
|
|
|
.B SANE
|
|
|
|
on your system. If you installed the
|
|
|
|
.B SANE
|
|
|
|
libraries in
|
|
|
|
.I /usr/local/lib
|
|
|
|
(default) you should check if there are older
|
|
|
|
.B SANE
|
|
|
|
libraries at
|
|
|
|
.IR /usr/lib .
|
|
|
|
Remove them using your distribution's package manager or manually
|
|
|
|
.RB ( "rm \-r"
|
|
|
|
.IR "/usr/lib/libsane* /usr/lib/sane" ).
|
2001-05-13 20:32:30 +00:00
|
|
|
.TP
|
|
|
|
*
|
2002-11-22 16:37:28 +00:00
|
|
|
If you can use
|
|
|
|
.B SANE
|
|
|
|
with
|
|
|
|
.B scanimage
|
|
|
|
but not with other (graphical) frontends, check that
|
|
|
|
.I /etc/ld.so.conf
|
|
|
|
contains
|
|
|
|
.I /usr/local/lib
|
|
|
|
and does
|
2001-05-13 20:32:30 +00:00
|
|
|
.B not
|
2002-11-22 16:37:28 +00:00
|
|
|
contain
|
|
|
|
.IR /usr/local/lib/sane .
|
|
|
|
See also the documentation of the frontends.
|
2001-05-13 20:32:30 +00:00
|
|
|
|
2002-03-11 22:31:41 +00:00
|
|
|
.SH FILES
|
|
|
|
.TP
|
|
|
|
.I @CONFIGDIR@/*.conf
|
|
|
|
The backend configuration files.
|
|
|
|
.TP
|
|
|
|
.I @LIBDIR@/libsane-*.a
|
|
|
|
The static libraries implementing the backends.
|
|
|
|
.TP
|
|
|
|
.I @LIBDIR@/libsane-*.so
|
|
|
|
The shared libraries implementing the backends (present on systems that
|
|
|
|
support dynamic loading).
|
|
|
|
.TP
|
|
|
|
.I @DOCDIR@/*
|
2002-11-22 16:37:28 +00:00
|
|
|
.B SANE
|
|
|
|
documentation: The standard, READMEs, text files for backends etc.
|
2002-03-11 22:31:41 +00:00
|
|
|
|
2002-11-22 16:37:28 +00:00
|
|
|
.SH "REPORTING BUGS"
|
2001-05-13 20:32:30 +00:00
|
|
|
If you think you found a bug in a backend, contact the author of your
|
2002-11-22 16:37:28 +00:00
|
|
|
backend. Usually the email address can be found in the
|
|
|
|
.I @DOCDIR@/AUTHORS
|
|
|
|
file or the backend's manpage. If the author isn't marked as `active
|
|
|
|
maintainer' or doesn't answer, you can also contact the
|
|
|
|
.B SANE
|
|
|
|
mailing list sane-devel (see
|
|
|
|
.I http://www.mostang.com/sane/mail.html
|
|
|
|
for details). You must be subscribed to the list, otherwise your mail won't be
|
|
|
|
sent to the subscribers.
|
|
|
|
.PP
|
2002-07-05 19:38:59 +00:00
|
|
|
If you want to report bugs concerning security, compilation, installation,
|
2002-11-22 16:37:28 +00:00
|
|
|
porting, and documentation of
|
|
|
|
.BR SANE ,
|
|
|
|
you can also contact the author of this manual page:
|
|
|
|
<henning@meier-geinitz.de>.
|
2001-05-09 18:08:17 +00:00
|
|
|
|
|
|
|
.SH AUTHOR
|
2002-11-22 16:37:28 +00:00
|
|
|
David Mosberger-Tang and many many more (see
|
|
|
|
.I @DOCDIR@/AUTHORS
|
|
|
|
for details). This man page was written by Henning Meier-Geinitz. Quite a lot
|
|
|
|
of text was taken from the
|
|
|
|
.B SANE
|
|
|
|
standard, several man pages, and README files.
|