Ubuntu Manpage: sane-artec_eplus48u - SANE backend for the scanner Artec E+ 48U and re-badged models

NAME

       sane-artec_eplus48u - SANE backend for the scanner Artec E+ 48U and re-badged models

DESCRIPTION

       The  sane-artec_eplus48u  library implements a SANE (Scanner Access Now Easy) backend that
       provides access to several USB flatbed scanners using the GT6816 chipset like the Artec E+
       48U.  These scanners have a contact image sensor (CIS).

       A      complete      list     of     supported     devices     can     be     found     on
       http://www.sane-project.org/sane-supported-devices.html.

       This is ALPHA software. Especially if you test new or untested scanners, keep your hand at
       the scanner's plug and unplug it, if the head bumps at the end of the scan area.

       If  you  own  a  scanner  other  than  the ones mentioned on the list that works with this
       backend, please let us know this by sending the scanner's exact model  name  and  the  USB
       vendor  and  product ids (e.g. from /proc/bus/usb/devices, sane-find-scanner(1) or syslog)
       to me. Even if the scanner's name is only slightly different  from  the  models  mentioned
       above, please let me know.

KERNEL ISSUES

       If  libusb-0.1.6 or later is installed, this section can be skipped. The scanner should be
       found by sane-find-scanner(1) without further actions. For setting permissions and general
       USB information look at sane-usb(5).

       When you are using the scanner module, a Linux kernel 2.4.12 or newer is required.

FIRMWARE FILE

       You  need  a  firmware file for your scanner. That's a small file containing software that
       will be uploaded to the scanner's memory. For the scanners mentioned above,  it's  usually
       named  Artec48.usb  or 1200.usb.  You can find it on the installation CD that was provided
       by the manufacturer, normally in the directory Win98, WinMe or similar.  If  the  Windows-
       driver  is  installed  on  your  computer,  then you can also find the firmware file under
       c:\windows\system32\drivers.

CONFIGURATION

The contents of the artec_eplus48u.conf file is a list of usb lines containing vendor and
product ids that correspond to USB scanners. The file can also contain option lines.
Empty lines and lines starting with a hash mark (#) are ignored. The scanners are
autodetected by usb vendor_id product_id statements which are already included into
artec_eplus48u.conf . "vendor_id" and "product_id" are hexadecimal numbers that identify
the scanner.

Every usb section can have additional options.

artecFirmwareFile /usr/share/sane/artec_eplus48u/Artec48.usb
The path to the firmware file. This option is required.

redGamma 1.0

greenGamma 1.0

blueGamma 1.0

masterGamma 1.9
These are the default gamma values. If you set the "Defaults" option with a
frontend, then the gamma options are reset to the values specified here.

redOffset 0x28

greenOffset 0x2f

blueOffset 0x2f

redExposure 0xa7

greenExposure 0x116

blueExposure 0xdc
These are the default values for offset and exposure time. You can change them
(e.g. to speed up calibration) if you don't want to save the calibration data
permanently.

vendorString Artec

modelString E+ 48U
By default, the scanner is reported as "Artec E+ 48U". If you don't like this, e.g.
because you have an Tevion MD 9693, then change the options accordingly.

FILES

       /usr/local/etc/sane.d/artec_eplus48u.conf
              The backend configuration file (see also description of SANE_CONFIG_DIR below).

       /usr/local/lib/sane/libsane-artec_eplus48u.a
              The static library implementing this backend.

       /usr/local/lib/sane/libsane-artec_eplus48u.so
              The  shared  library  implementing  this  backend  (present on systems that support
              dynamic loading).

ENVIRONMENT

       SANE_CONFIG_DIR
              This environment variable specifies the list of directories that  may  contain  the
              configuration  file.   On  *NIX  systems,  the directories are separated by a colon
              (`:'), under OS/2, they are separated by a semi-colon (`;').  If this  variable  is
              not  set, the configuration file is searched in two default directories: first, 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).

       SANE_DEBUG_ARTEC_EPLUS48U
              If the library was compiled with debug support enabled, this  environment  variable
              controls  the  debug  level  for  this  backend.   Higher debug levels increase the
              verbosity of the output.

              Example: export SANE_DEBUG_ARTEC_EPLUS48U=3

AUTHOR

       Michael Herder.
       This backend is based on the gt68xx test-program written by Sergey Vlasov, Andreas Nowack,
       and David Stevenson. Thanks to everyone who tested the backend or reported bugs.
       This man page is based on man sane-gt68xx(5), written by Henning Meier-Geinitz.

BUGS

       This  backend  has been tested on Linux only. If you are using it on a different platform,
       please contact us.

       Interpolation with 1200 dpi is weak.

       Support for buttons is missing due to missing support in SANE.

       Please contact us if you find a bug: http://www.sane-project.org/bugs.html.

                                           11 Jul 2008                     sane-artec_eplus48u(5)