


xscanimage(1)                                       xscanimage(1)


NNAAMMEE
       xscanimage - scan an image

SSYYNNOOPPSSIISS
       xxssccaanniimmaaggee  [----ddiissppllaayy _d] [----nnoo--xxsshhmm] [----[[nnoo--]]sshhooww--eevveennttss]
       [----ssyynncc] [----ddeebbuugg--lleevveell _n] [_d_e_v_i_c_e_n_a_m_e]

DDEESSCCRRIIPPTTIIOONN
       xxssccaanniimmaaggee provides a graphical user-interface to  control
       an image acquisition device such as a flatbed scanner or a
       camera.  It allows previewing and scanning invidual images
       and  can  be invoked either directly from the command-line
       or through The GIMP image manipulation  program.   In  the
       former case, xxssccaanniimmaaggee 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).  In the latter  case,  the  images  are
       directly passed to The GIMP for further processing.

       xxssccaanniimmaaggee  accesses image acquisition devices through the
       SANE (Scanner Access Now Easy)  interface.   The  list  of
       available  devices  depends on installed hardware and con-
       figuration.  When invoked without an  explicit  devicename
       argument,  xxssccaanniimmaaggee  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 speci-
       fied explicitly.

RRUUNNNNIINNGG UUNNDDEERR TTHHEE GGIIMMPP
       To run xxssccaanniimmaaggee under the ggiimmpp(1), simply copy it to one
       of  the ggiimmpp(1) plug-ins directories.  If you want to con-
       serve disk-space, you can create a symlink  instead.   For
       example, the command

              ln -s /usr/local/bin/xscanimage ~/.gimp/plug-ins/

       adds  a  symlink  for  the xxssccaanniimmaaggee binary to the user's
       plug-ins directory.  After creating this symlink, xxssccaanniimm--
       aaggee will be queried by ggiimmpp(1) the next time it's invoked.
       From  then  on,  xxssccaanniimmaaggee   can   be   invoked   through
       "Xtns->Acquire Image->Device dialog..." menu entry.

       You'll  also find that the "Xtns->Acquire Image" menu con-
       tains short-cuts to the SANE devices that  were  available
       at  the time the xxssccaanniimmaaggee was queried.  For example, the
       first PNM pseudo-device  is  typically  available  as  the
       short-cut "Xtns->Acquire Image->pnm:0".  Note that ggiimmpp(1)
       caches these short-cuts in ~/.gimp/pluginrc.   Thus,  when
       the list of available devices changes (e.g., a new scanner
       is installed), then it is typically desirable  to  rebuild
       this  cache.   To  do  this,  you  can either ttoouucchh(1) the
       xxssccaanniimmaaggee binary  (e.g.,  "touch  /usr/local/bin/xscanim-
       age")   or   delete   the   plug-ins   cache   (e.g.,  "rm
       ~/.gimp/plug-ins").    Either   way,   invoking    ggiimmpp(1)



                           13 May 1998                          1





xscanimage(1)                                       xscanimage(1)


       afterwards will cause the pluginrc to be rebuilt.

OOPPTTIIOONNSS
       The ----ddiissppllaayy flag selects the X11 display used to present
       the graphical user-interface (see XX(1) for details).

       The ----nnoo--xxsshhmm flag  requests  not  to  use  shared  memory
       images.   Shared memory images usually enhance performance
       but cause problems with some buggy  X11  servers.   Unless
       your  X11  server dies when running this program, there is
       no need or advantage to specify this flag.

       The ----sshhooww--eevveennttss flag requests the display of X11 events.
       This  is  for debugging only.  Flag ----nnoo--sshhooww--eevveennttss turns
       off the display of X11 events.

       The ----ssyynncc flag requests a synchronous connection with the
       X11 server.  This is for debugging purposes only.

FFIILLEESS
       _$_H_O_M_E_/_._s_a_n_e_/_x_s_c_a_n_i_m_a_g_e_/_x_s_c_a_n_i_m_a_g_e_._r_c
              This  files  holds the user preferences.  Normally,
              this  file  should  not  be  manipulated  directly.
              Instead,  the  user  should  customize  the program
              through the "Preferences" dialog.

       _$_H_O_M_E_/_._s_a_n_e_/_x_s_c_a_n_i_m_a_g_e_/_d_e_v_i_c_e_n_a_m_e_._r_c
              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 xxssccaann--
              iimmaaggee interface to select  appropriate  values  and
              then  save  the  device settings using the "Prefer-
              ences->Save Device Settings" menubar entry.

       _$_H_O_M_E_/_._s_a_n_e_/_p_r_e_v_i_e_w_-_d_e_v_i_c_e_n_a_m_e_._p_p_m
              After  acquiring  a  preview,  xxssccaanniimmaaggee  normally
              saves  the  preview  image  in this device-specific
              file.  Thus, next time the program is  started  up,
              the  program  can  present  the  old preview image.
              This feature can be turned off through the "Prefer-
              ences->Preview Options..." dialog.

       _/_u_s_r_/_l_o_c_a_l_/_s_h_a_r_e_/_s_a_n_e_-_s_t_y_l_e_._r_c
              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.

       _$_H_O_M_E_/_._s_a_n_e_/_s_a_n_e_-_s_t_y_l_e_._r_c
              This file serves the same purpose  as  the  system-
              wide  style  file.  If present, it takes precedence
              over the system wide style file.




                           13 May 1998                          2





xscanimage(1)                                       xscanimage(1)


SSEEEE AALLSSOO
       gimp(1),    scanimage(1),    sane-dll(5),     sane-dmc(5),
       sane-epson(5),        sane-hp(5),        sane-microtek(5),
       sane-mustek(5),  sane-net(5),  sane-pnm(5),  sane-pint(5),
       sane-qcam(5), sane-umax(5)

AAUUTTHHOORR
       Tristan Tarrant, Andreas Beck, and David Mosberger

















































                           13 May 1998                          3


