


sane-dmc(5)                                           sane-dmc(5)


NNAAMMEE
       sane-dmc  -  SANE  backend for the Polaroid Digital Micro-
       scope Camera

DDEESSCCRRIIPPTTIIOONN
       The ssaannee--ddmmcc library implements a SANE (Scanner Access Now
       Easy) backend that provides access to the Polaroid Digital
       Microscope Camera.

DDEEVVIICCEE NNAAMMEESS
       This backend expects device names of the form:

              _s_p_e_c_i_a_l

       Where _s_p_e_c_i_a_l is the UNIX path-name for the special device
       that  corresponds to the scanner.  The special device name
       must be a generic SCSI device  or  a  symlink  to  such  a
       device.  Under Linux, such a device name could be _/_d_e_v_/_s_g_a
       or _/_d_e_v_/_s_g_e, for example.

IIMMAAGGIINNGG MMOODDEESS
       The Polaroid DMC supports a number of imaging modes.  This
       driver supports five of the imaging modes:


       FFuullll FFrraammee
              This mode corresponds to the 801-by-600 pixel full-
              color full-frame image.

       VViieewwffiinnddeerr
              This mode corresponds to the 270-by-201 pixel grey-
              scale  viewfinder  image.   This  image is acquired
              very quickly.

       RRaaww    This mode  corresponds  to  the  1599-by-600  pixel
              "raw"  image  from the CCD.  It is grey-scale, with
              pixels alternating horizontally between red,  green
              and  blue stripes.  The pixels are twice as high as
              they are wide, so the image is distorted.

       TThhuummbbnnaaiill
              This mode corresponds to the 80-by-60  pixel  full-
              color thumbnail image.

       SSuuppeerr RReessoolluuttiioonn
              This image is a 1599-by-1200 pixel full-color image
              constructed  by  filtering  and  interpolating  the
              "raw"  image.   The  filtering and interpolation is
              done in software, so this mode is very slow.  Also,
              this  mode  places restrictions on how the image is
              read which means that the "preview" mode of  xscan-
              image  does  not  work  in  Super  Resolution mode.
              (xcam and the non-preview modes  of  scanimage  and
              xscanimage work fine, however.)



                           13 May 1998                          1





sane-dmc(5)                                           sane-dmc(5)


OOTTHHEERR SSEETTTTIINNGGSS
       AASSAA SSeettttiinngg
              This setting adjusts the camera's sensitivity.  You
              can choose one of 25, 50, or 100 "equivalent"  ASA.

       SShhuutttteerr SSppeeeedd
              You  can select a shutter speed from 8 to 1000 mil-
              liseconds.  The shutter speed is quantized in units
              of 32 microseconds.

       WWhhiittee BBaallaannccee
              You can choose one of "Daylight", "Incandescent" or
              "Fluorescent" white balances.  This  setting  more-
              or-less corresponds to the "Color Temperature" set-
              tings on Polaroid's Windows and Mac software.

CCOONNFFIIGGUURRAATTIIOONN
       The contents of the _d_m_c_._c_o_n_f file  is  a  list  of  device
       names  that  correspond  to DMC scanners.  Empty lines and
       lines starting with a hash mark (#) are ignored.  A sample
       configuration file is shown below:

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

FFIILLEESS
       _/_u_s_r_/_l_o_c_a_l_/_e_t_c_/_s_a_n_e_._d_/_d_m_c_._c_o_n_f
              The  backend  configuration file (see also descrip-
              tion of SSAANNEE__CCOONNFFIIGG__DDIIRR below).

       _/_u_s_r_/_l_o_c_a_l_/_l_i_b_/_l_i_b_s_a_n_e_-_d_m_c_._a
              The static library implementing this backend.

       _/_u_s_r_/_l_o_c_a_l_/_l_i_b_/_l_i_b_s_a_n_e_-_d_m_c_._s_o
              The shared library implementing this backend  (pre-
              sent on systems that support dynamic loading).

EENNVVIIRROONNMMEENNTT
       SSAANNEE__CCOONNFFIIGG__DDIIRR
              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  /usr/local/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 spec-
              ified directories.  For example, setting  SSAANNEE__CCOONN--
              FFIIGG__DDIIRR  to "/tmp/config:" would result in directo-
              ries "tmp/config", ".", and "/usr/local/etc/sane.d"



                           13 May 1998                          2





sane-dmc(5)                                           sane-dmc(5)


              being searched (in this order).

       SSAANNEE__DDEEBBUUGG__DDMMCC
              If  the  library  was  compiled  with debug support
              enabled, this  environment  variable  controls  the
              debug level for this backend.  E.g., a value of 128
              requests all debug output to be  printed.   Smaller
              levels reduce verbosity.

BBUUGGSS
       In  the  "Full Frame" and "Raw" modes, images must be read
       in units of entire lines.  The driver performs no  buffer-
       ing  in  these  modes; if you ask sane_read to read a non-
       integral number of lines, it may read less  than  you  ask
       for.   If  you  ask  sane_read  to read less than a single
       line, it returns SANE_STATUS_INVAL.

       In the "Super Resolution" mode, images  must  be  read  in
       units  of  _t_w_o  lines (3198 pixels or 9594 bytes.)  If you
       try to  read  less  than  two  lines,  you  get  SANE_STA-
       TUS_INVAL.  The Super Resolution mode is very slow.

       In  the  "Viewfinder"  and  "Thumbnail"  modes, the entire
       image must be read in one SCSI transfer.   In  this  case,
       the  driver  performs buffering and you can read the image
       in as small an increment as you like.

SSEEEE AALLSSOO
       sane-scsi(5)

AAUUTTHHOORR
       David F. Skoll

       The backend is derived from ssaannee--hhpp by David Mosberger























                           13 May 1998                          3


