home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: OtherApp / OtherApp.zip / wincam.zip / wincd.man < prev   
Text File  |  1997-05-16  |  9KB  |  240 lines
  1.  
  2.  
  3.  
  4. WINCD(1)                         WINCD(1)
  5.  
  6.  
  7. NAME
  8.        wincd  -     a  daemon  which gets images from the WinCam.One
  9.        camera.
  10.  
  11. SYNOPSIS
  12.        wincd [-options]
  13.  
  14. DESCRIPTION
  15.        wincd periodically gets and saves images from the  digital
  16.        camera known as the WinCam.  It is a 640x492 capable color
  17.        digital camera, interfaced to  a     computer  via    a  serial
  18.        cable.    See  http://www.wincam.com  for     more information
  19.        about this camera.
  20.  
  21.        Images grabbed by wincd are dumped in PGM or PNM format to
  22.        a  specified  file.   An     optional script may be specified
  23.        which will run after  the  image     is  saved.   Optionally,
  24.        images may be saved only if they are determined to be dif-
  25.        ferent than previous images.  "Difference" in this case is
  26.        determined  by  comparing  reduced  versions  of     the  two
  27.        images: if a 64x48 version of the image has fewer  than    M
  28.        pixes  which  differ  by more than R grey levels, then the
  29.        images are considered to be the "same".    (These limits are
  30.        settable with -r and -m.)
  31.  
  32.        wincd  controls    image  exposure automatically, though the
  33.        WinCamBrightness configuration variable    can  be     used  to
  34.        control    the  brightness     goal.    (See the winc manual page
  35.        for information on configuration variables.)
  36.  
  37.  
  38. LOCKING
  39.        Under OS/2, wincd.exe locks the com port while in use.
  40.  
  41. OPTIONS
  42.        -h     prints the usage message
  43.  
  44.        -p pollseconds
  45.           The  loop interval is the amount of time wincd will
  46.           pause during iterations of the  image  poll/compare
  47.           loop.   Default  is 10.  This is the interval wincd
  48.           will pause after it does not take a picture.
  49.  
  50.        -w waitseconds
  51.           The wait interval is the amount of time wincd  will
  52.           pause  when it does take a picture.  Default is 60.
  53.  
  54.        -n nsave
  55.           wincd will keep "small" versions of images that  it
  56.           has  saved  in  memory,  and  compare freshly taken
  57.           images to these.    If it determines that a new image
  58.           is  a duplicate of one that has already been saved,
  59.           it will not save the new one.  The -n option deter-
  60.           mines the length of this history, which defaults to
  61.           6.  If simple "take  a  picture  every  N     seconds"
  62.           behavior is desired, set nsave to 0 and use "-w N".
  63.           If a comparison history is desired,  set    nsave  to
  64.           the  length  of  the history.  Use -p to choose how
  65.           often wincd will look for changed images, and -w to
  66.           "rate-limit"  the frequency of real pictures taken.
  67.  
  68.        -r threshold
  69.  
  70.        -m maxdiff
  71.           Successive images are compared (in  reduced,  64x48
  72.           form)   until  an     "interesting"    image  is  found.
  73.           "Interesting" is defined    as  "different    than  the
  74.           last",  and  that     is  defined  as having more than
  75.           MAXDIFF percent of the pixels differ  by    at  least
  76.           THRESHOLD     percent of the total grey levels.  MAXD-
  77.           IFF is expressed as a percentage of image area, and
  78.           THRESHOLD     is  expressed as a percentage of maximum
  79.           pixel value.  When the draft-quality  image  passes
  80.           this  criterion,    then  a full-size image is taken.
  81.           (So actually, the premise that comparisons are done
  82.           on reduced versions of images is false -- actually,
  83.           the reduced and fullsize images come from two sepa-
  84.           rate exposures.)
  85.  
  86.        -f filename
  87.           Images  grabbed by wincd are saved in the specified
  88.           filename.     It is    recommended  that  this     file  be
  89.           given  the  suffix  ".ppm" or ".pgm", since this is
  90.           the conventional suffix for images in  PNM  or  PGM
  91.           format.    (PPM for color, PGM for greyscale) (These
  92.           formats are specified as part of the widely  avail-
  93.           able  PBMPLUS  or "netpbm" packages.)  
  94.  
  95.              (OS/2 Note:  The Independent JPEG Group's JPEG Software 
  96.               v 6a is currently at:
  97.                 ftp://hobbes.nmsu.edu/old/os2/graphics/jpeg6a_os2a.zip
  98.  
  99.              The GBM Utils also deal with the PNM format - they can
  100.              currently be found at:
  101.             ftp://hobbes.nmsu.edu/old/os2/graphics/gbm.zip
  102.  
  103.              As the Hobbes archive is re-organizing as this is being 
  104.              written, expect this to change. )
  105.  
  106.  
  107.  
  108.               The  filename  defaults  to    "wincd.pnm".     The  
  109.               modification  time  of the file  will be set to the 
  110.           time at which the picture  was snapped, rather than 
  111.               being  set  by  the  system  to  the time  at which 
  112.               the last part  of the  file was written.  (The time 
  113.               difference can  be tens of seconds.)
  114.  
  115.        -s scriptname
  116.           After  an     image is saved, the specified script (if
  117.           any) will be run.     It is handed the filename of the
  118.           image  as     its  only  argument.  
  119.  
  120.        -c     Grabs color images.  This is the default action.
  121.  
  122.        -g     Grabs  greyscale    images,     instead of color images.
  123.           Greyscale images are 8 bits deep,     with  a  maximum
  124.           grey  level of 255.  Color images are 24 bits deep,
  125.           with 255 values for each of red, green,  and  blue.
  126.           The  default  size  of  either  type  of    image  is
  127.           640x492.
  128.  
  129.        -l lighting
  130.           Affect the color balance of  the    image.     See  the
  131.           COLOR  BALANCE  section of the winc manual page for
  132.           more information.
  133.  
  134.        -2     Normally images are captured in a single    scan:  in
  135.           this  mode,  of  the  492 lines in a default image,
  136.           only the even rows are "real":  the  odd    rows  are
  137.           created  by duplicating the row above.  If the sub-
  138.           ject matter is still enough, the -2 option  can  be
  139.           used to force a second scan about 1/8th of a second
  140.           later.  This will fill in the odd     rows  with  real
  141.           data, and yield a higher quality picture.
  142.  
  143.        -z N   Sets  the     image reduction factor to 1, 2, 4.  This
  144.           might be done when the full imagesize or resolution
  145.           is not wanted or needed.    The values 1, 2, 4, and 8
  146.           represent linear scaling of both the horizontal and
  147.           vertical    axes.  Thus "-z 4" gives an image that is
  148.           160x123 rather than the default 640x492.    (So actu-
  149.           ally,  the arguments should really be 1, 4, 16, and
  150.           64.)
  151.  
  152.        -e NN or -E NN
  153.           Sets exposure in milliseconds(-e)     or  microseconds
  154.           (-E).   The  shortest  possible  exposure     time  is
  155.           1/100,000th of a second, the longest  is    a  little
  156.           over  1.3 seconds.  If neither option is used, winc
  157.           will try several exposures until an  average  pixel
  158.           brightness  goal    is  reached, which is set via the
  159.           WinCamBrightness variable.
  160.  
  161.        -a     Sound an audible alarm when the picture is actually
  162.           snapped.    The process of "finding" the camera, tak-
  163.           ing the  picture,     and  downloading  the    image  is
  164.           fairly lengthy.  Hearing a small beep when the pic-
  165.           ture has been taken can be helpful.
  166.  
  167.        -i IDSTRING
  168.           Specify the "name" of the camera to be used.   This
  169.           name  will  affect  the  way in which configuration
  170.           information will be looked up.  See the section  on
  171.           MULIPLE  CAMERAS    on  the winc manual page for more
  172.           information.
  173.  
  174.        -t tracestring
  175.           Turns on program tracing.     See the winc manual page
  176.           for more information.
  177.  
  178. STARTUP
  179.        winc will load configuration  information  from    the  file
  180.        $ETC/winc.rc. $ETC, for  those of  you who don't  know, is
  181.        the  directory pointed  to by  the "SET ETC=" line in your
  182.        config.sys file. This  pathname can be overridden with the
  183.        $WINC_RC environment  variable.    See  the manual  page for 
  184.        the "winc" command for more details.
  185.  
  186. COPYING and COPYRIGHT
  187.        This software is Copyright (C) 1996, by Paul G. Fox.  Spe-
  188.        cific  image  processing     code  is  Copyright (C) 1996, by
  189.        StarDot Technologies.
  190.  
  191.        This program is free software;  you  can     redistribute  it
  192.        and/or modify it under the terms of the GNU General Public
  193.        License as published  by     the  Free  Software  Foundation;
  194.        either  version    2 of the License, or (at your option) any
  195.        later version.
  196.  
  197.        This program is distributed in the hope that  it     will  be
  198.        useful, but WITHOUT ANY WARRANTY; without even the implied
  199.        warranty of MERCHANTABILITY or FITNESS  FOR  A  PARTICULAR
  200.        PURPOSE.      See  the  GNU     General  Public License for more
  201.        details.
  202.  
  203.        You should have received a copy of the GNU General  Public
  204.        License along with this program; if not, write to the Free
  205.        Software Foundation, Inc., 675  Mass  Ave,  Cambridge,  MA
  206.        02139, USA.
  207.  
  208. DEBTS
  209.        wincd was created with the help of proprietary information
  210.        belonging to StarDot Technologies, makers of  the  WinCam.
  211.        Contact them at help@wincam.com for information on obtain-
  212.        ing a copy of that information.
  213.  
  214. AUTHORS
  215.        wincd and the winc library were created by  Paul     G.  Fox,
  216.        pgf@foxharp.boston.ma.us.
  217.  
  218.        Port to OS/2 by Derek J Decker, derek@decker.net
  219.  
  220. BUGS
  221.        Oh well.
  222.  
  223.  
  224.  
  225.  
  226.  
  227.  
  228.  
  229.  
  230.  
  231.  
  232.  
  233.  
  234.  
  235.  
  236.  
  237.                                 4
  238.  
  239.  
  240.