kopia lustrzana https://gitlab.com/sane-project/backends
211 wiersze
7.6 KiB
Plaintext
211 wiersze
7.6 KiB
Plaintext
How to configure, build, and install SANE.
|
|
|
|
Quick install:
|
|
==============
|
|
|
|
./configure
|
|
make
|
|
make install
|
|
|
|
Prerequisites
|
|
=============
|
|
|
|
In order to build SANE, the following tools and libraries are required:
|
|
|
|
- GNU make: version 3.70 or newer
|
|
|
|
- ANSI C compiler: GNU C (gcc) is recommended for best performance,
|
|
but any ANSI-compliant compiler should do
|
|
|
|
- To build the graphical frontends (xscanimage and xcam), it is
|
|
necessary to have the GTK libraries (libgtk, libgdk, and
|
|
libglib) and associated header files installed. In
|
|
addition, if you want to use xscanimage from within GIMP,
|
|
you'll need to make sure libgimp (version 0.99.13 or newer)
|
|
and its header files are installed as well. The GTK libraries and
|
|
GIMP can be obtained from:
|
|
|
|
ftp://ftp.gimp.org/pub/
|
|
|
|
SANE should build on most Unix-like systems. Support for OS/2 is also
|
|
available. For more details look at the operating system specific
|
|
README.* files. For a detailed support matrix, see:
|
|
|
|
http://www.mostang.com/sane/sane-support.html
|
|
|
|
This table may be out of date. Please send any corrections or additions
|
|
to sane-devel@mostang.com together with your platform, os and version.
|
|
|
|
|
|
Configuration
|
|
=============
|
|
|
|
Simply invoke configure in the top-level directory. Besides the usual
|
|
GNU configure options, there are the following SANE specific options:
|
|
|
|
--disable-shared
|
|
Don't use shared libraries. Useful for debugging or when there
|
|
is a problem building shared libraries. This implicitly turns
|
|
on --disable-dynamic as well.
|
|
|
|
--disable-dynamic
|
|
Disable dynamic loading of backends (in the dll backend).
|
|
configure normally turns on dynamic loading when it
|
|
can find the appropriate header files and libraries
|
|
(<dlfcn.h> and -dl).
|
|
|
|
--enable-preload
|
|
Preload backends into DLL backend. This is useful for debugging,
|
|
when dynamic loading is unavailable, or to reduce runtime linking
|
|
overheads. If dynamic loading or shared libraries are unavailable
|
|
or disabled, this option is turned on automatically.
|
|
|
|
--enable-scsibuffersize=N
|
|
Specify the buffer size of the buffer for SCSI commands. The default
|
|
value is 131072 bytes (128 kb). This may be changed at runtime by
|
|
setting the environment variable SANE_SG_BUFFERSIZE to the desired
|
|
value. The option is Linux-only at this time.
|
|
--enable-scsibuffersize and SANE_SG_BUFFERSIZE have no effect for
|
|
the Mustek, Umax and Sharp backends. For these backends, the buffer
|
|
size is set automatically and/or can be specified in the backend's
|
|
configuration file. Please refer to the backend's man pages for
|
|
details.
|
|
|
|
In addition to these SANE-specific configuration options, there are
|
|
many standard-options. To get a description of available standard
|
|
option, invoke configure with option --help.
|
|
|
|
If you plan on debugging one of the SANE programs, we recommend to run
|
|
configure like this:
|
|
|
|
CFLAGS="-g -O -Wall" ./configure --disable-shared
|
|
|
|
For operating system specific information, look at the README.* files.
|
|
|
|
|
|
Build
|
|
=====
|
|
|
|
To build SANE, simply type "make" in the top-level directory.
|
|
|
|
|
|
Installation and Configuration
|
|
==============================
|
|
|
|
Once the build has finished, install SANE with "make install". By
|
|
default, this will place the SANE libraries in /usr/local/lib/, the
|
|
configuration files in /usr/local/etc/sane.d/, and the manual pages in
|
|
/usr/local/man/. The location of these directories can be overridden
|
|
with configure options; see "configure --help" for details.
|
|
|
|
Before running any SANE program, read the PROBLEMS file in this directory.
|
|
For information on configuring and trouble-shooting the various SANE
|
|
components, please refer to the manual pages and other documentation listed
|
|
below:
|
|
|
|
Regarding: Read:
|
|
----------------- ------------------------------------------
|
|
Frontends:
|
|
scanimage scanimage(1)
|
|
xscanimage xscanimage(1)
|
|
saned saned(1)
|
|
xcam xcam(1)
|
|
|
|
Backends for scanners:
|
|
Abaton sane-abaton(5)
|
|
AGFA Focus sane-agfafocus(5)
|
|
AGFA SnapScan sane-snapscan(5)
|
|
Apple sane-apple(5)
|
|
Artec sane-artec(5)
|
|
Avision sane-avision(5)
|
|
Canon sane-canon(5)
|
|
Nikon Coolscan sane-coolscan(5)
|
|
Epson sane-epson(5)
|
|
Fujitsu sane-fujitsu(5)
|
|
HP sane-hp(5)
|
|
Microtek sane-microtek(5)
|
|
Microtek SCSI-2 sane-microtek2(5)
|
|
Mustek sane-mustek(5)
|
|
Mustek parallel port sane-mustek_pp(5)
|
|
Plustek sane-plustek(5)
|
|
Ricoh sane-ricoh(5)
|
|
Sharp sane-sharp(5)
|
|
Siemens S9036 sane-s9036(5)
|
|
Siemens ST400,ST800 sane-st400(5)
|
|
Tamarack sane-tamarack(5)
|
|
UMAX sane-umax(5)
|
|
|
|
Backends for digital cameras:
|
|
Connectix QuickCam sane-qcam(5)
|
|
Kodak DC20/DC25 sane-dc25(5)
|
|
Kodak dc210 sane-dc210(5)
|
|
Polaroid sane-dmc(5)
|
|
|
|
Miscellaneous backends:
|
|
PNM image reader sane-pnm(5)
|
|
PINT scanners sane-pint(5)
|
|
Video for Linux sane-v4l(5)
|
|
|
|
Miscellaneous:
|
|
Dynamic loading sane-dll(5)
|
|
Networking sane-net(5) and saned(1)
|
|
SCSI configuration sane-scsi(5)
|
|
|
|
For more details on supported scanners and cameras look at the SANE
|
|
website: http://www.mostang.com/sane/sane-backends.html
|
|
|
|
Please note that the default configuration uses sane-dll as the
|
|
top-level backend. Hence it is probably a good idea to start with
|
|
reading sane-dll(5). The top-level backend is determined by the
|
|
libsane.* symlinks in /usr/local/lib/.
|
|
|
|
For SCSI scanners reading of sane-scsi(5) is recommended.
|
|
|
|
Please also read the file PROJECTS for projects that are planned or
|
|
not yet included into the SANE distribution.
|
|
|
|
If you encounter any problems with getting your device(s) recognized,
|
|
try setting the various environment variables that are there 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 scanner, set environment
|
|
variables SANE_DEBUG_DLL, SANE_DEBUG_MUSTEK, and SANE_DEBUG_SANEI_SCSI
|
|
to 128 and then invoke scanimage or whatever program you're trying to
|
|
debug. For a Mustek scanner at /dev/scanner, you might want to invoke
|
|
scanimage as follows:
|
|
|
|
scanimage -d mustek:/dev/scanner -h
|
|
|
|
If this works, you could try to acquire an image with:
|
|
|
|
scanimage -d mustek:/dev/scanner >t.pnm
|
|
|
|
If you are not sure what generic SCSI device your scanner is connected
|
|
to, try the command tools/find-scanner. It is normally sufficient to
|
|
invoke the program without any arguments. Invoking this command
|
|
should produce output similar to this:
|
|
|
|
$ tools/find-scanner
|
|
find-scanner: found "MUSTEK MFC-06000CZ 1.01" at device /dev/scanner
|
|
find-scanner: found "MUSTEK MFC-06000CZ 1.01" at device /dev/sge
|
|
|
|
Note that find-scanner will find any scanner that is connected to a
|
|
SCSI bus. It will even find scanners that are not supported at all
|
|
by SANE.
|
|
|
|
There may be several causes for the following messages from the
|
|
frontends: "scanimage: no SANE devices found" or "xscanimage: no
|
|
devices available.".
|
|
|
|
* Your scanner is not recognized by any backend. It is not supported.
|
|
You may ask the maintainer of your backend (see AUTHORS) or
|
|
sane-devel@mostang.com if support is planned.
|
|
|
|
* SANE can't access the device files (e.g /dev/sga). Check the permissions.
|
|
|
|
* Your backend is not listed in dll.conf (or commented out).
|
|
|
|
The tools directory contains some small programs that may be helpfull. They
|
|
are described in tools/README.
|
|
|