kopia lustrzana https://gitlab.com/sane-project/backends
936 wiersze
26 KiB
Groff
936 wiersze
26 KiB
Groff
.TH sane 7 "14 Jul 2008" "@PACKAGEVERSION@" "SANE Scanner Access Now Easy"
|
|
.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
|
|
This manual page provides a summary of the information available about
|
|
.BR SANE .
|
|
.PP
|
|
If you have trouble getting your scanner detected, read the PROBLEMS section.
|
|
|
|
.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.
|
|
|
|
|
|
.SH "SOFTWARE PACKAGES"
|
|
The package
|
|
.RB ` sane\-backends '
|
|
contains a lot of backends, documentation (including the
|
|
.B SANE
|
|
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 '.
|
|
Both packages can be downloaded from the
|
|
.B SANE
|
|
homepage
|
|
.RI ( http://www.sane\-project.org/ ).
|
|
Information about other frontends and backends can also be found on the
|
|
.B SANE
|
|
homepage.
|
|
|
|
.SH "GENERAL INFORMATION"
|
|
The following sections provide short descriptions and links to more
|
|
information about several aspects of
|
|
.B SANE.
|
|
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.
|
|
|
|
.TP 2
|
|
.B SANE homepage
|
|
Information on all aspects of SANE including a tutorial and a link to the SANE FAQ
|
|
can be found on the SANE homepage:
|
|
.IR http://www.sane\-project.org/ .
|
|
.TP
|
|
.B SANE device lists
|
|
The
|
|
.B SANE
|
|
device lists contain information about the status of
|
|
.B SANE
|
|
support for a specific device. If your scanner is not listed there (either
|
|
supported or unsupported), please contact us. See section HOW CAN YOU HELP
|
|
SANE for details. There are lists for specific releases of SANE, for the
|
|
current development version and a search engine:
|
|
.IR http://www.sane\-project.org/sane\-supported\-devices.html .
|
|
The lists are also installed on your system at @DOCDIR@/.
|
|
.TP
|
|
.B SANE mailing list
|
|
There is a mailing list for the purpose of discussing the SANE standard and its
|
|
implementations: sane\-devel. Despite its name, the list is not only intended
|
|
for developers, but also for users. There are also some more lists for special
|
|
topics, however, for users, sane\-devel is the right list. How to subscribe and
|
|
unsubscribe:
|
|
.IR http://www.sane\-project.org/mailing\-lists.html .
|
|
.TP
|
|
.B SANE IRC channel
|
|
The IRC (Internet Relay Chat) channel #sane can be found on the Freenode
|
|
network (irc.freenode.net). It's for discussing
|
|
.B SANE
|
|
problems, talking about development and general
|
|
.B SANE
|
|
related chatting. Before asking for help, please read the other documentation
|
|
mentioned in this manual page. The channel's topic is also used for
|
|
announcements of problems with SANE infrastructure (mailing lists, web server,
|
|
etc.).
|
|
.TP
|
|
.B Compiling and installing SANE
|
|
Look at
|
|
.I @DOCDIR@/README
|
|
and the os-dependent README files for information about compiling and
|
|
installing
|
|
.B SANE.
|
|
.TP
|
|
.B SCSI configuration
|
|
For information about various systems and SCSI controllers see
|
|
.BR sane\-scsi (5).
|
|
.TP
|
|
.B USB configuration
|
|
For information about USB configuration see
|
|
.BR sane\-usb (5).
|
|
|
|
.SH "FRONTENDS AND MISCELLANEOUS PROGRAMS"
|
|
.TP 2
|
|
.B scanimage
|
|
Command-line frontend. See
|
|
.BR scanimage (1).
|
|
.TP
|
|
.B saned
|
|
.B SANE
|
|
network daemon that allows remote clients to access image acquisition devices
|
|
available on the local host. See
|
|
.BR saned (8).
|
|
.TP
|
|
.B sane\-find\-scanner
|
|
Command-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.sane\-project.org/sane\-frontends.html .
|
|
|
|
.SH "BACKENDS FOR SCANNERS"
|
|
.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
|
|
.BR sane\-abaton (5)
|
|
for details.
|
|
.TP
|
|
.B agfafocus
|
|
This backend supports AGFA Focus scanners and the Siemens S9036 (untested).
|
|
See
|
|
.BR sane\-agfafocus (5)
|
|
for details.
|
|
.TP
|
|
.B apple
|
|
The SANE backend for Apple flatbed scanners supports the following scanners:
|
|
AppleScanner, OneScanner and ColorOneScanner. See
|
|
.BR sane\-apple (5)
|
|
for details.
|
|
.TP
|
|
.B artec
|
|
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.
|
|
.TP
|
|
.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
|
|
Webscan 19200. See
|
|
.BR sane\-artec_eplus48u (5)
|
|
for details.
|
|
.TP
|
|
.B as6e
|
|
This is a SANE backend for using the Artec AS6E parallel port interface
|
|
scanner. See
|
|
.BR sane\-as6e (5)
|
|
for details.
|
|
.TP
|
|
.B avision
|
|
This backend supports several Avision based scanners. This includes the
|
|
original Avision scanners (like AV 630, AV 620, ...) as well as the HP
|
|
ScanJet 53xx and 74xx series, Fujitsu ScanPartner, some Mitsubishi and
|
|
Minolta film-scanners.
|
|
See
|
|
.BR sane\-avision (5)
|
|
for details.
|
|
.TP
|
|
.B bh
|
|
The bh backend provides access to Bell+Howell Copiscan II series document
|
|
scanners. See
|
|
.BR sane\-bh (5)
|
|
for details.
|
|
.TP
|
|
.B canon
|
|
The canon backend supports the CanoScan 300, CanoScan 600, and CanoScan
|
|
2700F SCSI flatbed scanners. See
|
|
.BR sane\-canon (5)
|
|
for details.
|
|
.TP
|
|
.B canon630u
|
|
The canon630u backend supports the CanoScan 630u and 636u USB scanners. See
|
|
.BR sane\-canon630u (5)
|
|
for details.
|
|
.TP
|
|
.B canon_dr
|
|
The canon_dr backend supports the Canon DR-Series ADF SCSI and USB scanners. See
|
|
.BR sane\-canon_dr (5)
|
|
for details.
|
|
.TP
|
|
.B canon_pp
|
|
The canon_pp backend supports the CanoScan FB330P, FB630P, N340P and N640P
|
|
parallel port scanners. See
|
|
.BR sane\-canon_pp (5)
|
|
for details.
|
|
.TP
|
|
.B cardscan
|
|
This backend provides support for Corex Cardscan USB scanners. See
|
|
.BR sane\-cardscan (5)
|
|
for details.
|
|
.TP
|
|
.B coolscan
|
|
This is a SANE backend for Nikon Coolscan film-scanners. See
|
|
.BR sane\-coolscan (5)
|
|
for details.
|
|
.TP
|
|
.B coolscan2
|
|
This is a SANE backend for Nikon Coolscan film-scanners.
|
|
See
|
|
.BR sane\-coolscan2 (5)
|
|
or
|
|
.I http://coolscan2.sourceforge.net
|
|
for details.
|
|
.TP
|
|
.B epjitsu
|
|
The epjitsu backend provides support for Epson-based Fujitsu USB scanners. See
|
|
.BR sane\-epjitsu (5)
|
|
for details.
|
|
.TP
|
|
.B epson
|
|
The SANE epson backend provides support for Epson SCSI, parallel port and USB
|
|
flatbed scanners. See
|
|
.BR sane\-epson (5)
|
|
for details.
|
|
.TP
|
|
.B fujitsu
|
|
The fujitsu backend provides support for most Fujitsu SCSI and USB, flatbed
|
|
and adf scanners. See
|
|
.BR sane\-fujitsu (5)
|
|
for details.
|
|
.TP
|
|
.B genesys
|
|
The genesys backend provides support for several scanners based on the Genesys Logic
|
|
GL646, GL841, GL843, GL847 and GL124 chips like the Medion 6471 and Hewlett-Packard 2300c.
|
|
See
|
|
.BR sane\-genesys (5)
|
|
for details.
|
|
.TP
|
|
.B gt68xx
|
|
The gt68xx backend provides support for scanners based on the Grandtech
|
|
GT-6801 and GT-6816 chips like the Artec Ultima 2000 and several Mustek
|
|
BearPaw CU and TA models. Some Genius, Lexmark, Medion, Packard Bell, Plustek,
|
|
and Trust scanners are also supported. See
|
|
.BR sane\-gt68xx (5)
|
|
for details.
|
|
.TP
|
|
.B hp
|
|
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.
|
|
.TP
|
|
.B hpsj5s
|
|
The SANE backend for the Hewlett-Packard ScanJet 5S scanner. See
|
|
.BR sane\-hpsj5s (5)
|
|
for details.
|
|
.TP
|
|
.B hp3500
|
|
The SANE backend for the Hewlett-Packard ScanJet 3500 series. See
|
|
.BR sane\-hp3500 (5)
|
|
for details.
|
|
.TP
|
|
.B hp3900
|
|
The SANE backend for the Hewlett-Packard ScanJet 3900 series. See
|
|
.BR sane\-hp3900 (5)
|
|
for details.
|
|
.TP
|
|
.B hp4200
|
|
The SANE backend for the Hewlett-Packard ScanJet 4200 series. See
|
|
.BR sane\-hp4200 (5)
|
|
for details.
|
|
.TP
|
|
.B hp5400
|
|
The SANE backend for the Hewlett-Packard ScanJet 54XXC series. See
|
|
.BR sane\-hp5400 (5)
|
|
for details.
|
|
.TP
|
|
.B hpljm1005
|
|
The SANE backend for the Hewlett-Packard LaserJet M1005 scanner. See
|
|
.BR sane\-hpljm1005(5)
|
|
for details.
|
|
.TP
|
|
.B hs2p
|
|
The SANE backend for the Ricoh IS450 family of SCSI scanners. See
|
|
.BR sane\-hs2p (5)
|
|
for details.
|
|
.TP
|
|
.B ibm
|
|
The SANE backend for some IBM and Ricoh SCSI scanners. See
|
|
.BR sane\-ibm (5)
|
|
for details.
|
|
.TP
|
|
.B kodak
|
|
The SANE backend for some large Kodak scanners. See
|
|
.BR sane\-kodak (5)
|
|
for details.
|
|
.TP
|
|
.B kodakaio
|
|
The SANE backend for Kodak AiO printer/scanners. See
|
|
.BR sane\-kodakaio (5)
|
|
for details.
|
|
.TP
|
|
.B kvs1025
|
|
The SANE backend for Panasonic KV-S102xC scanners. See
|
|
.BR sane\-kvs1025 (5)
|
|
for details.
|
|
.TP
|
|
.B leo
|
|
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.
|
|
.TP
|
|
.B lexmark
|
|
This backend supports the Lexmark X1100 series of USB scanners. See
|
|
.BR sane\-lexmark (5)
|
|
for details.
|
|
.TP
|
|
.B ma1509
|
|
The ma1509 backend supports the Mustek BearPaw 1200F USB flatbed scanner. See
|
|
.BR sane\-ma1509 (5)
|
|
for details.
|
|
.TP
|
|
.B magicolor
|
|
The magicolor backend supports the KONICA MINOLTA magicolor 1690MF multi-function printer/scanner/fax. See
|
|
.BR sane\-magicolor (5)
|
|
for details.
|
|
.TP
|
|
.B matsushita
|
|
This backend supports some Panasonic KVSS high speed scanners. See
|
|
.BR sane\-matsushita (5)
|
|
for details.
|
|
.TP
|
|
.B microtek
|
|
The microtek backend provides access to the "second generation" Microtek
|
|
scanners with SCSI-1 command set. See
|
|
.BR sane\-microtek (5)
|
|
for details.
|
|
.TP
|
|
.B microtek2
|
|
The microtek2 backend provides access to some Microtek scanners with a
|
|
SCSI-2 command set. See
|
|
.BR sane\-microtek2 (5)
|
|
for details.
|
|
.TP
|
|
.B mustek
|
|
The SANE mustek backend supports most Mustek SCSI flatbed scanners including the
|
|
Paragon and ScanExpress series and the 600 II N and 600 II EP (non-SCSI). Some
|
|
Trust scanners are also supported. See
|
|
.BR sane\-mustek (5)
|
|
for details.
|
|
.TP
|
|
.B mustek_pp
|
|
The mustek_pp backend provides access to Mustek parallel port flatbed
|
|
scanners. See
|
|
.BR sane\-mustek_pp (5)
|
|
for details.
|
|
.TP
|
|
.B mustek_usb
|
|
The mustek_usb backend provides access to some Mustek ScanExpress USB flatbed
|
|
scanners. See
|
|
.BR sane\-mustek_usb (5)
|
|
for details.
|
|
.TP
|
|
.B mustek_usb2
|
|
The mustek_usb2 backend provides access to scanners using the SQ113
|
|
chipset like the Mustek BearPaw 2448 TA Pro USB flatbed scanner. See
|
|
.BR sane\-mustek_usb2 (5)
|
|
for details.
|
|
.TP
|
|
.B nec
|
|
The SANE nec backend supports the NEC PC-IN500/4C SCSI scanner. See
|
|
.BR sane\-nec (5)
|
|
for details.
|
|
.TP
|
|
.B niash
|
|
The niash backend supports the Agfa Snapscan Touch and the HP ScanJet 3300c,
|
|
3400c, and 4300c USB flatbed scanners. See
|
|
.BR sane\-niash (5)
|
|
for details.
|
|
.TP
|
|
.B p5
|
|
The SANE backend for Primax PagePartner. See
|
|
.BR sane\-p5 (5)
|
|
for details.
|
|
.TP
|
|
.B pie
|
|
The pie backend provides access to Pacific Image Electronics (PIE) and Devcom
|
|
SCSI flatbed scanners. See
|
|
.BR sane\-pie (5)
|
|
for details.
|
|
.TP
|
|
.B pixma
|
|
The pixma backend supports Canon PIXMA MP series (multi-function devices). See
|
|
.BR sane\-pixma (5)
|
|
or
|
|
.I http://home.arcor.de/wittawat/pixma/
|
|
for details.
|
|
.TP
|
|
.B plustek
|
|
The SANE plustek backend supports USB flatbed scanners that use the National
|
|
Semiconductor LM983[1/2/3] chipset aka Merlin. Scanners using this LM983x chips
|
|
include some models from Plustek, KYE/Genius, Hewlett-Packard, Mustek, Umax,
|
|
Epson, and Canon. See
|
|
.BR sane\-plustek (5)
|
|
for details.
|
|
.TP
|
|
.B plustek_pp
|
|
The SANE plustek_pp backend supports Plustek parallel port flatbed scanners.
|
|
Scanners using the Plustek ASIC P96001, P96003, P98001 and P98003 include some
|
|
models from Plustek, KYE/Genius, Primax. See
|
|
.BR sane\-plustek_pp (5)
|
|
for details.
|
|
.TP
|
|
.B ricoh
|
|
The ricoh backend provides access to the following Ricoh flatbed
|
|
scanners: IS50 and IS60. See
|
|
.BR sane\-ricoh (5)
|
|
for details.
|
|
.TP
|
|
.B s9036
|
|
The s9036 backend provides access to Siemens 9036 flatbed scanners. See
|
|
.BR sane\-s9036 (5)
|
|
for details.
|
|
.TP
|
|
.B sceptre
|
|
The sceptre backend provides access to the Sceptre S1200 flatbed scanner. See
|
|
.BR sane\-sceptre (5)
|
|
for details.
|
|
.TP
|
|
.B sharp
|
|
The SANE sharp backend supports Sharp SCSI scanners. See
|
|
.BR sane\-sharp (5)
|
|
for details.
|
|
.TP
|
|
.B sm3600
|
|
The SANE sm3600 backend supports the Microtek ScanMaker 3600 USB scanner. See
|
|
.BR sane\-sm3600 (5)
|
|
for details.
|
|
.TP
|
|
.B sm3840
|
|
The SANE sm3840 backend supports the Microtek ScanMaker 3840 USB scanner. See
|
|
.BR sane\-sm3840 (5)
|
|
for details.
|
|
.TP
|
|
.B snapscan
|
|
The snapscan backend supports AGFA SnapScan flatbed scanners. See
|
|
.BR sane\-snapscan (5)
|
|
for details.
|
|
.TP
|
|
.B sp15c
|
|
This backend supports the Fujitsu FCPA ScanPartner 15C flatbed scanner. See
|
|
.BR sane\-sp15c (5)
|
|
for details.
|
|
.TP
|
|
.B st400
|
|
The sane\-st400 backend provides access to Siemens ST400 and ST800. See
|
|
.BR sane\-st400 (5)
|
|
for details.
|
|
.TP
|
|
.B tamarack
|
|
The SANE tamarack backend supports Tamarack Artiscan flatbed scanners. See
|
|
.BR sane\-tamarack (5)
|
|
for details.
|
|
.TP
|
|
.B teco1 teco2 teco3
|
|
The SANE teco1, teco2 and teco3 backends support some TECO scanners,
|
|
usually sold under the Relisys, Trust, Primax, Piotech, Dextra
|
|
names. See
|
|
.BR sane\-teco1 "(5), " sane\-teco2 "(5) and " sane\-teco3 (5)
|
|
for details.
|
|
.TP
|
|
.B u12
|
|
The sane\-u12 backend provides USB flatbed scanners based on Plustek's ASIC 98003
|
|
(parallel-port ASIC) and a GeneSys Logics' USB-parport bridge chip like the
|
|
Plustek OpticPro U(T)12. See
|
|
.BR sane\-u12 (5)
|
|
for details.
|
|
.TP
|
|
.B umax
|
|
The sane\-umax backend provides access to several UMAX-SCSI-scanners and some
|
|
Linotype Hell SCSI-scanners. See
|
|
.BR sane\-umax (5)
|
|
for details.
|
|
.TP
|
|
.B umax_pp
|
|
The sane\-umax_pp backend provides access to Umax parallel port flatbed scanners
|
|
and the HP 3200C. See
|
|
.BR sane\-umax_pp (5)
|
|
for details.
|
|
.TP
|
|
.B umax1200u
|
|
The sane\-umax1220u backend supports the UMAX Astra 1220U (USB) flatbed scanner
|
|
(and also the UMAX Astra 2000U, sort of). See
|
|
.BR sane\-umax1220u (5)
|
|
for details.
|
|
.TP
|
|
.B xerox_mfp
|
|
The sane\-xerox_mfp backend supports multiple Samsung-based Samsung, Xerox, and Dell
|
|
scanners. See
|
|
.BR sane\-xerox_mfp (5)
|
|
for details.
|
|
.PP
|
|
Also, have a look at the backend information page at
|
|
.I http://www.sane\-project.org/sane\-supported\-devices.html
|
|
and the list of projects in
|
|
.IR @DOCDIR@/PROJECTS .
|
|
|
|
.SH "BACKENDS FOR DIGITAL CAMERAS"
|
|
.TP 2
|
|
.B dc210
|
|
Backend for Kodak DC210 Digital Camera. See
|
|
.BR sane\-dc210 (5).
|
|
.TP
|
|
.B dc240
|
|
Backend for Kodak DC240 Digital Camera. See
|
|
.BR sane\-dc240 (5).
|
|
.TP
|
|
.B dc25
|
|
Backend for Kodak DC20/DC25 Digital Cameras. See
|
|
.BR sane\-dc25 (5).
|
|
.TP
|
|
.B dmc
|
|
Backend for the Polaroid Digital Microscope Camera. See
|
|
.BR sane\-dmc (5).
|
|
.TP
|
|
.B gphoto2
|
|
Backend for digital cameras supported by the gphoto2 library package. (See
|
|
.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).
|
|
.TP
|
|
.B qcam
|
|
Backend for Connectix QuickCam cameras. See
|
|
.BR sane\-qcam (5).
|
|
.TP
|
|
.B stv680
|
|
The sane\-st680 backend provides access to webcams with a stv680 chip. See
|
|
.BR sane\-st680 (5)
|
|
for details.
|
|
.PP
|
|
Also, have a look at the backend information page at
|
|
.I http://www.sane\-project.org/sane\-supported\-devices.html
|
|
and the list of projects in
|
|
.IR @DOCDIR@/PROJECTS .
|
|
|
|
.SH "MISCELLANEOUS BACKENDS"
|
|
.TP 2
|
|
.B dll
|
|
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).
|
|
.TP
|
|
.B net
|
|
The
|
|
.B SANE
|
|
network daemon saned provides access to scanners located on different
|
|
computers in connection with the net backend. See
|
|
.BR sane\-net "(5) and " saned (8).
|
|
.TP
|
|
.B pnm
|
|
PNM image reader pseudo-backend. The purpose of this backend is primarily to
|
|
aid in debugging of
|
|
.B SANE
|
|
frontends. See
|
|
.BR sane\-pnm (5).
|
|
.TP
|
|
.B pint
|
|
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).
|
|
.TP
|
|
.B test
|
|
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).
|
|
.TP
|
|
.B v4l
|
|
The sane\-v4l library implements a
|
|
.B SANE
|
|
backend that provides generic access to video cameras and similar equipment
|
|
using the
|
|
.B V4L
|
|
(Video for Linux) API. See
|
|
.BR sane\-v4l (5) .
|
|
.PP
|
|
Also, have a look at the backend information page at
|
|
.I http://www.sane\-project.org/sane\-supported\-devices.html
|
|
and the list of projects in
|
|
.IR @DOCDIR@/PROJECTS .
|
|
|
|
.SH "CHANGING THE TOP-LEVEL BACKEND"
|
|
By default, all
|
|
.B SANE
|
|
backends (drivers) are loaded dynamically by the
|
|
.B sane\-dll
|
|
meta backend. If you have any questions about the dynamic loading,
|
|
read
|
|
.BR sane\-dll (5).
|
|
.B SANE
|
|
frontend can also be linked to other backends directly by copying or linking a
|
|
backend to
|
|
.B libsane.so
|
|
in
|
|
.IR @LIBDIR@ .
|
|
.PP
|
|
|
|
.SH "DEVELOPER'S DOCUMENTATION"
|
|
It's not hard to write a
|
|
.B SANE
|
|
backend. It can take some time, however. You should have basic knowledge of C
|
|
and enough patience to work through the documentation and find out how your
|
|
scanner works. Appended is a list of some documents that help to write backends
|
|
and frontends.
|
|
.PP
|
|
The
|
|
.B SANE
|
|
standard defines the application programming interface (API) that is used to
|
|
communicate between frontends and backends. It can be found at
|
|
.I @DOCDIR@/sane.ps
|
|
(if latex is installed on your system) and on the
|
|
.B SANE
|
|
website:
|
|
.I http://www.sane\-project.org/html/
|
|
(HTML), or
|
|
.I http://www.sane\-project.org/sane.ps
|
|
(Postscript).
|
|
.PP
|
|
There is some more information for programmers in
|
|
.IR @DOCDIR@/backend\-writing.txt .
|
|
Most of the internal
|
|
.B SANE
|
|
routines
|
|
.RB ( sanei )
|
|
are documented using doxygen:
|
|
.IR http://www.sane\-project.org/sanei/ .
|
|
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 and at our bug-tracking system:
|
|
.IR http://www.http://www.sane\-project.org/bugs.html .
|
|
.PP
|
|
There are some links on how to find out about the protocol of a scanner:
|
|
.IR http://www.meier\-geinitz.de/sane/misc/develop.html .
|
|
|
|
.PP
|
|
If you start writing a backend or frontend or any other part of
|
|
.BR SANE,
|
|
please contact the sane\-devel mailing list for coordination so the same work
|
|
isn't done twice.
|
|
|
|
.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@/*
|
|
.B SANE
|
|
documentation: The standard, READMEs, text files for backends etc.
|
|
|
|
.SH "PROBLEMS"
|
|
If your device isn't found but you know that it is supported, make
|
|
sure that it is detected by your operating system. For SCSI and USB scanners,
|
|
use the
|
|
.B sane\-find\-scanner
|
|
tool (see
|
|
.BR sane\-find\-scanner (1)
|
|
for details). It prints one line for each scanner it has detected and some
|
|
comments (#). If
|
|
.B sane\-find\-scanner
|
|
finds your scanner only as root but not as normal user, the permissions for
|
|
the device files are not adjusted correctly. If the scanner isn't found at all,
|
|
the operating system hasn't detected it and may need some help. Depending on
|
|
the type of your scanner, read
|
|
.BR sane\-usb (5)
|
|
or
|
|
.BR sane\-scsi (5).
|
|
If your scanner (or other device) is not connected over the SCSI bus or USB,
|
|
read the backend's manual page for details on how to set it up.
|
|
.PP
|
|
|
|
Now your scanner is detected by the operating system but not by
|
|
.BR SANE ?
|
|
Try
|
|
.BR "scanimage \-L" .
|
|
If the scanner is not found, check that the backend's name is mentioned in
|
|
.IR @CONFIGDIR@/dll.conf .
|
|
Some backends are commented out by default. Remove the comment sign for your
|
|
backend in this case. Also some backends aren't compiled at all if one of their
|
|
prerequisites are missing. Examples include dc210, dc240, canon_pp, hpsj5s,
|
|
gphoto2, pint, qcam, v4l, net, sm3600, snapscan, pnm. If you need one of these
|
|
backends and they aren't available, read the build instructions in the
|
|
.B README
|
|
file and the individual manual pages of the backends.
|
|
.PP
|
|
|
|
Another reason for not being detected by
|
|
.B scanimage \-L
|
|
may be a missing or wrong configuration in the backend's configuration
|
|
file. While
|
|
.B SANE
|
|
tries to automatically find most scanners, some can't be setup correctly
|
|
without the intervention of the administrator. Also on some operating systems
|
|
auto-detection may not work. Check the backend's manual page for details.
|
|
.PP
|
|
If your scanner is still not found, try
|
|
setting the various environment variables that are available to assist in
|
|
debugging. 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
|
|
.BR SANE_DEBUG_DLL ", " SANE_DEBUG_MUSTEK ", and " SANE_DEBUG_SANEI_SCSI
|
|
to 128 and then invoke
|
|
.B scanimage
|
|
.B \-L .
|
|
The debug messages for the dll backend tell if the mustek backend was found
|
|
and loaded at all. The mustek messages explain what the mustek backend is
|
|
doing while the SCSI debugging shows the low level handling. If you can't find
|
|
out what's going on by checking the messages carefully, contact the sane\-devel
|
|
mailing list for help (see REPORTING BUGS below).
|
|
.PP
|
|
Now that your scanner is found by
|
|
.BR "scanimage \-L" ,
|
|
try to do a scan:
|
|
.BR "scanimage >image.pnm" .
|
|
This command starts a scan for the default scanner with default settings. All
|
|
the available options are listed by running
|
|
.BR "scanimage \-\-help" .
|
|
If scanning aborts with an error message, turn on debugging as mentioned
|
|
above. Maybe the configuration file needs some tuning, e.g. to setup the path
|
|
to a firmware that is needed by some scanners. See the backend's manual page
|
|
for details. If you can't find out what's wrong, contact sane\-devel.
|
|
.PP
|
|
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:
|
|
.IP
|
|
.B scanimage \-d
|
|
.I test
|
|
.B \-T
|
|
.PP
|
|
You should get a list of PASSed tests. You can do the same with your backend
|
|
by changing "test" to your backend's name.
|
|
.PP
|
|
So now scanning with
|
|
.B scanimage
|
|
works and you want to use one of the graphical frontends like
|
|
.BR xsane ,
|
|
.BR xscanimage ", or"
|
|
.B quiteinsane
|
|
but those frontends don't detect your scanner? One reason may be that you
|
|
installed two versions of
|
|
.BR SANE .
|
|
E.g. the version that was installed by your distribution in
|
|
.I /usr
|
|
and one you installed from source in
|
|
.IR /usr/local/ .
|
|
Make sure that only one version is installed. Another possible reason is, that
|
|
your system's dynamic loader can't find the
|
|
.B SANE
|
|
libraries. For Linux, make sure that
|
|
.I /etc/ld.so.conf
|
|
contains
|
|
.I /usr/local/lib
|
|
and does
|
|
.B not
|
|
contain
|
|
.IR /usr/local/lib/sane .
|
|
See also the documentation of the frontends.
|
|
.PP
|
|
|
|
.SH "HOW CAN YOU HELP SANE"
|
|
We appreciate any help we can get. Please have a look at our web page about
|
|
contributing to
|
|
.BR SANE :
|
|
.I http://www.sane\-project.org/contrib.html
|
|
.PP
|
|
|
|
.SH "CONTACT"
|
|
For reporting bugs or requesting new features, please use our bug-tracking
|
|
system:
|
|
.IR http://www.sane\-project.org/bugs.html .
|
|
You can also contact the author of your backend directly. Usually the email
|
|
address can be found in the
|
|
.I @DOCDIR@/AUTHORS
|
|
file or the backend's manpage. For general discussion about SANE, please use
|
|
the
|
|
.B SANE
|
|
mailing list sane\-devel (see
|
|
.I http://www.sane\-project.org/mailing\-lists.html
|
|
for details).
|
|
.PP
|
|
|
|
.SH "SEE ALSO"
|
|
.BR saned (8),
|
|
.BR sane\-find\-scanner (1),
|
|
.BR scanimage (1),
|
|
.BR sane\-abaton (5),
|
|
.BR sane\-agfafocus (5),
|
|
.BR sane\-apple (5),
|
|
.BR sane\-artec (5),
|
|
.BR sane\-artec_eplus48u (5),
|
|
.BR sane\-as6e (5),
|
|
.BR sane\-avision (5),
|
|
.BR sane\-bh (5),
|
|
.BR sane\-canon (5),
|
|
.BR sane\-canon630u (5),
|
|
.BR sane\-canon_dr (5),
|
|
.BR sane\-canon_pp (5),
|
|
.BR sane\-cardscan (5),
|
|
.BR sane\-coolscan2 (5),
|
|
.BR sane\-coolscan (5),
|
|
.BR sane\-dc210 (5),
|
|
.BR sane\-dc240 (5),
|
|
.BR sane\-dc25 (5),
|
|
.BR sane\-dll (5),
|
|
.BR sane\-dmc (5),
|
|
.BR sane\-epson (5),
|
|
.BR sane\-fujitsu (5),
|
|
.BR sane\-genesys (5),
|
|
.BR sane\-gphoto2 (5),
|
|
.BR sane\-gt68xx (5),
|
|
.BR sane\-hp (5),
|
|
.BR sane\-hpsj5s (5),
|
|
.BR sane\-hp3500 (5),
|
|
.BR sane\-hp3900 (5),
|
|
.BR sane\-hp4200 (5),
|
|
.BR sane\-hp5400 (5),
|
|
.BR sane\-hpljm1005 (5),
|
|
.BR sane\-ibm (5),
|
|
.BR sane\-kodak (5),
|
|
.BR sane\-leo (5),
|
|
.BR sane\-lexmark (5),
|
|
.BR sane\-ma1509 (5),
|
|
.BR sane\-matsushita (5),
|
|
.BR sane\-microtek2 (5),
|
|
.BR sane\-microtek (5),
|
|
.BR sane\-mustek (5),
|
|
.BR sane\-mustek_pp (5),
|
|
.BR sane\-mustek_usb (5),
|
|
.BR sane\-mustek_usb2 (5),
|
|
.BR sane\-nec (5),
|
|
.BR sane\-net (5),
|
|
.BR sane\-niash (5),
|
|
.BR sane\-pie (5),
|
|
.BR sane\-pint (5),
|
|
.BR sane\-plustek (5),
|
|
.BR sane\-plustek_pp (5),
|
|
.BR sane\-pnm (5),
|
|
.BR sane\-qcam (5),
|
|
.BR sane\-ricoh (5),
|
|
.BR sane\-s9036 (5),
|
|
.BR sane\-sceptre (5),
|
|
.BR sane\-scsi (5),
|
|
.BR sane\-sharp (5),
|
|
.BR sane\-sm3600 (5),
|
|
.BR sane\-sm3840 (5),
|
|
.BR sane\-snapscan (5),
|
|
.BR sane\-sp15c (5),
|
|
.BR sane\-st400 (5),
|
|
.BR sane\-stv680 (5),
|
|
.BR sane\-tamarack (5),
|
|
.BR sane\-teco1 (5),
|
|
.BR sane\-teco2 (5),
|
|
.BR sane\-teco3 (5),
|
|
.BR sane\-test (5),
|
|
.BR sane\-u12 (5),
|
|
.BR sane\-umax1220u (5),
|
|
.BR sane\-umax (5),
|
|
.BR sane\-umax_pp (5),
|
|
.BR sane\-usb (5),
|
|
.BR sane\-v4l (5),
|
|
.BR sane\-xerox_mfp (5)
|
|
|
|
.SH AUTHOR
|
|
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.
|