sane-avision(5)


NAME

   sane-avision  -  SANE  backend  for  original  Avision  and Avision OEM
   scanners (HP, Minolta, Mitsubishi, UMAX and possibly more) flatbed  and
   film scanners.

ABOUT THIS FILE

   This  file  is a short description for the avision-backend shipped with
   SANE.

DESCRIPTION

   The sane-avision library implements a SANE (Scanner  Access  Now  Easy)
   backend  that  provides  access  to  various  Avision  scanners and the
   Avision OEM scanners labelled by HP, Minolta, Mitsubishi or Fujitsu.

   It is fully big-endian aware and in every-day use on PowerPC and  SPARC
   systems.

   I  suggest  you  hold one hand on the power-button of the scanner while
   you try the first scans - especially with film-scanners!

CONFIGURATION

   The    configuration    file    for    this    backend    resides    in
   /etc/sane.d/avision.conf.

   Its  contents  is a list of device names that correspond to Avision and
   Avision compatible scanners and backend-options. Empty lines and  lines
   starting  with a hash mark (#) are ignored. A sample configuration file
   is shown below:

    # this is a comment

    option force-a4
    option force-a3
    option disable-gamma-table
    option disable-calibration

    #scsi Vendor Model Type Bus Channel ID LUN
    scsi AVISION
    scsi HP
    scsi /dev/scanner
    usb 0x03f0 0x0701

   force-a4:
          Forces the backend to overwrite the scanable  area  returned  by
          the  scanner  to  ISO A4. Scanner that are known to return bogus
          data are marked in the backend so if you need this option please
          report this to the backend maintainer. USE WITH CARE!

   force-a3:
          Forces  the  backend  to overwrite the scanable area returned by
          the scanner to ISO A3. Scanner that are known  to  return  bogus
          data are marked in the backend so if you need this option please
          report this to the backend maintainer. USE WITH CARE!

   disable-gamma-table:
          Disables the usage of the scanner's gamma-table. You  might  try
          this if your scans hang or only produces random garbage.

   disable-calibration:
          Disables  the scanner's color calibration. You might try this if
          your scans hang or only produces random garbage.

   Note:  Any  option  above  modifies  the  default  code-flow  for  your
          scanner.  The  options  should  only  be used when you encounter
          problems with the default be- haviour  of  the  backend.  Please
          report  the need of options to the backend-author so the backend
          can be fixed as soon as possible.

DEVICE NAMES

   This backend expects device names of the form:

          scsi scsi-spec

          usb usb-spec

   Where scsi-spec is the path-name to a special device or a device ID for
   the  device that corresponds to a SCSI scanner. The special device name
   must be a generic SCSI device or  a  symlink  to  such  a  device,  for
   example  on  Linux  "/dev/sga"  or  "/dev/sg0". The device ID is the ID
   returned  by  the  scanner,  for  example  "HP"   or   "AVISION".   See
   sane-scsi(5) for details.

   Note:  Since  the  backend  now  includes  native  USB access, it is no
          longer needed - even considered obsolete - to access USB scanner
          via  the  SCSI  emulation (named hpusbscsi on Linux) for Avision
          USB devices such as the  HP  53xx,  HP  74xx  or  Minolta  film-
          scanners.

   usb-spec is the USB device name, the vendor/product ID pair or the name
   used by libusb corresponding to the USB scanner.  For  example  "0x03f0
   0x0701" or "libusb:002:003". See sane-usb(5) for details.

   The program sane-find-scanner helps to find out the correct scsi or usb
   device name.

   A list with supported devices is built  into  the  avision  backend  so
   normally specifying an ID should not be necessary.

FILES

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

   /usr/lib/arch_triplet/sane/libsane-avision.a
          The static library implementing this backend.

   /usr/lib/arch_triplet/sane/libsane-avision.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.  Under UNIX, 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_AVISION
          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.  The
          debug  level  7 is the author's preferred value to debug backend
          problems.

          Example: export SANE_DEBUG_AVISION=7

SEE ALSO

   sane(7), sane-scsi(5), sane-usb(5)
   http://exactcode.com/site/open_source/saneavision/

MAINTAINER

   Ren Rebe

AUTHOR

   Ren Rebe and Meino Christian Cramer

                              11 Jul 2008                  sane-avision(5)





Opportunity


Personal Opportunity - Free software gives you access to billions of dollars of software at no cost. Use this software for your business, personal use or to develop a profitable skill. Access to source code provides access to a level of capabilities/information that companies protect though copyrights. Open source is a core component of the Internet and it is available to you. Leverage the billions of dollars in resources and capabilities to build a career, establish a business or change the world. The potential is endless for those who understand the opportunity.

Business Opportunity - Goldman Sachs, IBM and countless large corporations are leveraging open source to reduce costs, develop products and increase their bottom lines. Learn what these companies know about open source and how open source can give you the advantage.





Free Software


Free Software provides computer programs and capabilities at no cost but more importantly, it provides the freedom to run, edit, contribute to, and share the software. The importance of free software is a matter of access, not price. Software at no cost is a benefit but ownership rights to the software and source code is far more significant.


Free Office Software - The Libre Office suite provides top desktop productivity tools for free. This includes, a word processor, spreadsheet, presentation engine, drawing and flowcharting, database and math applications. Libre Office is available for Linux or Windows.





Free Books


The Free Books Library is a collection of thousands of the most popular public domain books in an online readable format. The collection includes great classical literature and more recent works where the U.S. copyright has expired. These books are yours to read and use without restrictions.


Source Code - Want to change a program or know how it works? Open Source provides the source code for its programs so that anyone can use, modify or learn how to write those programs themselves. Visit the GNU source code repositories to download the source.





Education


Study at Harvard, Stanford or MIT - Open edX provides free online courses from Harvard, MIT, Columbia, UC Berkeley and other top Universities. Hundreds of courses for almost all major subjects and course levels. Open edx also offers some paid courses and selected certifications.


Linux Manual Pages - A man or manual page is a form of software documentation found on Linux/Unix operating systems. Topics covered include computer programs (including library and system calls), formal standards and conventions, and even abstract concepts.