xsane(1)


NAME

   xsane - scanner frontend for SANE

SYNOPSIS

   xsane  [--version|-v]  [--license|-l] [--device-settings file |-d file]
   [--viewer|-V] [--save|-s]  [--copy|-c]  [--fax|-f]  [--mail|-m]  [--no-
   mode-selection|-n] [--Fixed|-F] [--Resizable|-R] [--print-filenames|-p]
   [--force-filename name |-N name] [--display d] [--sync] [devicename]

DESCRIPTION

   xsane  provides  a  graphical  user-interface  to  control   an   image
   acquisition device such as a flatbed scanner.  It allows previewing and
   scanning individual images and can be invoked either directly from  the
   command-line  or  through  The GIMP image manipulation program.  In the
   former case, xsane acts as a stand-alone program  that  saves  acquired
   images  in  a  suitable PNM format (PBM for black-and-white images, PGM
   for grayscale images, and PPM for color images) or converts  the  image
   to  JPEG, PNG, PS or TIFF.  In the latter case, the images are directly
   passed to The GIMP for further processing.

   xsane accesses image acquisition  devices  through  the  SANE  (Scanner
   Access  Now  Easy) interface.  The list of available devices depends on
   installed hardware and configuration.  When invoked without an explicit
   devicename  argument,  xsane  presents  a  dialog listing all known and
   available devices.  To access an available device that is not known  to
   the  system, the devicename must be specified explicitly. The format of
   devicename is backendname:devicefile (eg: umax:/dev/sga).

RUNNING UNDER THE GIMP

   To run xsane under the gimp(1), you should  at  first  make  sure  that
   xsane  is compiled with gimp support by entering "xsane -v" on a shell.
   If xsane is compiled with gimp support then simply set a symbolic  link
   from  the xsane-binary to one of the gimp(1) plug-ins directories.  For
   example, for gimp-1.0.x the command

          ln -s /usr/bin/xsane ~/.gimp/plug-ins/

   for gimp 1.2.x the command:

          ln -s /usr/bin/xsane ~/.gimp-1.2/plug-ins/

   and for gimp 2.0.x the command:

          ln -s /usr/bin/xsane ~/.gimp-2.0/plug-ins/

   adds a symlink for the xsane binary to the user's  plug-ins  directory.
   After  creating this symlink, xsane will be queried by gimp(1) the next
   time it's  invoked.   From  then  on,  xsane  can  be  invoked  through
   "Xtns->XSane->Device     dialog..."     (gimp-1.0.x)     or     through
   "File->Acquire->XSane->Device dialog..." (gimp-1.2.x  and  2.0.x)  menu
   entry.

   You'll  also find that the "Xtns->XSane" or "File->Acquire->XSane" menu
   contains short-cuts to the SANE devices that were available at the time
   the  xsane  was  queried.  Note that gimp(1) caches these short-cuts in
   ~/.gimp/pluginrc.  Thus, when the list  of  available  devices  changes
   (e.g.,  a  new  scanner  is  installed or the device of the scanner has
   changed), then it is typically desirable to rebuild this cache.  To  do
   this,   you   can  either  touch(1)  the  xsane  binary  (e.g.,  "touch
   /usr/bin/xsane")   or   delete   the   plugin    cache    (e.g.,    "rm
   ~/.gimp/pluginrc").  Either way, invoking gimp(1) afterwards will cause
   the pluginrc to be rebuilt.

   When xsane is started from the gimp then it is not possible  to  add  a
   devicename explicitly. You have to make the devices known to the system
   by configuring sane-dll, sane-net and saned.

OPTIONS

   If  the  --version  or  -v  flag  is  given  xsane  prints  a   version
   information,  some  information  about  gtk+  and  gimp  version  it is
   compiled against and lists the supported file formats, then it exits.

   when the --license or -l flag is given xsane prints license information
   and exits.

   The  --device-settings  or  -d  flag  reads  the next option as default
   filename  for  device  settings.  The  extension  ".drc"  must  not  be
   included.

   The --viewer or -V flag forces xsane to start in viewer mode.

   The --save or -s flag forces xsane to start in save mode.

   The --copy or -c flag forces xsane to start in copy mode.

   The --fax or -f flag forces xsane to start in fax mode.

   The --mail or -m flag forces xsane to start in mail mode.

   The  --no-mode-selection  or  -n  flag disables the menu for xsane mode
   selection (viewer, save, copy, fax, mail).

   If the --Fixed or -F flag  is  given  then  xsane  uses  a  fixed,  non
   resizable main window.  The flag overwrites the preferences value.

   If  the  --Resizable or -R flag is given then xsane uses a scrolled and
   resizable main window.  The flag overwrites the preferences value.

   If --print-filenames or -p flag is given then xsane prints the names of
   created files to the standard output.

   When the flag --force-filename or -N is given then xsane reads the next
   option as default image filename. The name  should  be  of  the  format
   "name-001.ext". (or any other number instead of 001) that 001 part will
   be used as a filename counter if xsane is so  configured.  Beware  that
   the number of digits must correspond to the configuration of xsane. The
   selection box for filenames is disabled. This option normally should be
   used with the option --no-mode-selection and --save.

   The  --display  flag  selects  the  X11  display  used  to  present the
   graphical user-interface (see X(1) for details).

   The --sync flag requests a synchronous connection with the X11  server.
   This is for debugging purposes only.

ENVIRONMENT

   SANE_DEFAULT_DEVICE
          is  used  to preselect the device in the device dialog. This way
          you only have to accept the device (<ENTER> or OK-Button).

FILES

   $HOME/.sane/xsane/xsane.rc
          This files holds the  user  preferences.   Normally,  this  file
          should  not  be  manipulated directly.  Instead, the user should
          customize the program through the "Preferences" menu.

   $HOME/.sane/xsane/devicename.rc
          For each device, there is  one  rc-file  that  holds  the  saved
          settings for that particular device.  Normally, this file should
          not be manipulated directly.  Instead, the user should  use  the
          xsane  interface  to select appropriate values and then save the
          device settings using the  "Preferences->Save  Device  Settings"
          menubar entry.

   /usr/share/sane/xsane/xsane-style.rc
          This system-wide file controls the aspects of the user-interface
          such as colors and fonts.  It is a GTK style file  and  provides
          fine control over the visual aspects of the user-interface.

   $HOME/.sane/xsane/xsane-style.rc
          This file serves the same purpose as the system-wide style file.
          If present, it takes precedence over the system wide style file.

SEE ALSO

   gimp(1),   xscanimage(1),   scanimage(1),   sane-dll(5),   sane-net(5),
   saned(1), sane-scsi(5), sane-usb(5), sane-"backendname"(5)

AUTHOR

   Oliver Rauch <Oliver.Rauch@rauch-domain.de>

                              15 Jun 2002                         xsane(1)





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.