sane-agfafocus(5)

sane-agfafocus -- SANE backend for AGFA Focus flatbed scanners

Description

sane-agfafocus implements a SANE (Scanner Access Now Easy) backend that provides access to AGFA Focus flatbed scanners. At present, the following scanners are supported from this backend:

AGFA Focus GS Scanner (6 bit gray scale) (untested)
AGFA Focus Lineart Scanner (Line Art) (untested)
AGFA Focus II (8 bit gray scale) (untested)
AGFA Focus Color (24 bit color 3-pass)
AGFA Focus Color Plus (24 bit color 3-pass)
Siemens S9036 (8 bit gray scale) (untested)

The driver supports Line Art, 6bpp and 8bpp gray, 18bpp and 24bpp color scans.

All of these scanners are pre-SCSI-2. They do not report properly to SCSI Inquiry. For example, in SCSI bus scans, the scanner will come up with incorrect vendor and models strings.

sane-agfafocus expects device names of the form:

special

where special is the path-name for the special device that corresponds to a SCSI scanner. For SCSI scanners, the special device name must be a generic SCSI device or a symbolic link to such a device.

agfafocus.conf contains a list of device names that correspond to Microtek scanners. Empty lines and lines starting with a hash (``#'') are ignored. A sample configuration file is shown below:

   /dev/scanner
   # this is a comment
   /dev/sge

The SANE_CONFIG_DIR environment variable specifies the list of directories that may contain the configuration file. The directories are separated by a colon (``:''). If this variable is not set, the configuration file is searched in two default directories: firstly, the current working directory (``.'') and then in /etc/sane.d. If the value of the environment variable ends with the directory separator character, then the default directories are searched after the explicitly specified directories. For example, setting SANE_CONFIG_DIR to ``/tmp/config:'' would result in directories tmp/config, ``.'', and /etc/sane.d being searched (in this order).

The SANE_DEBUG_AGFAFOCUS environment variable controls the debug level for the sane-agfafocus backend if the library was compiled with debug support enabled. For example, a value of 128 requests all debug output to be printed. Smaller levels reduce verbosity.

Files

/usr/local/etc/sane.d/agfafocus.conf: The backend configuration file (see the description of SANE_CONFIG_DIR).
/usr/lib/sane/libsane-agfafocus.a: The static library implementing this backend.
/usr/lib/sane/libsane-agfafocus.so: The shared library implementing this backend (present on systems that support dynamic loading).

Notices

Scanners that do not support ``disconnect'' have problems with SCSI timeouts if the SCSI bus gets loaded. For example, this happens if you build the kernel at the same time as scanning. To see if your scanner supports ``disconnect'', run:

SANE_DEBUG_AGFAFOCUS=128 scanimage -L

in sh(1) and look for the ``disconnect:'' line.

If SANE does not detect your scanner, make sure the sane-artec backend is disabled.

If you encounter a problem (for example, a SCSI bus error or trimmed or displaced images) set the environment variable SANE_DEBUG_AGFAFOCUS to 128 and try to regenerate the problem.

Authors are Ingo Schneider and Karl Anders Oygard.

References

sane-abaton(5), sane-apple(5), saned(1), sane-dc25(5), sane-dll(5), sane-dmc(5), sane-epson(5), sane-hp(5), sane-microtek(5), sane-microtek2(5), sane-mustek(5), sane-net(5), sane-pint(5), sane-pnm(5), sane-umax(5), scanimage(1), xsane(1), xscanimage(1)