home *** CD-ROM | disk | FTP | other *** search
/ Chip 1999 November / Chip_1999-11_cd.bin / sharewar / wccc / wccc.exe / Manual.txt < prev    next >
Text File  |  1999-07-09  |  15KB  |  266 lines
  1.                            WebCam-Control-Center V2.0
  2.                            ==========================
  3.  
  4.                            (c) Marc Schneider 1999
  5.                            EMAIL: M_S_E@bigfoot.com
  6.                            WEBPAGE: http://www.marcweb.de
  7.  
  8.  
  9.  
  10. With the WebCam-Control-Center you can adjust your video device in many ways. You can take 
  11. pictures from the actual video source, record AVIs, use the motion detector and transfer 
  12. files to your server with the FTP client.
  13.  
  14. Program options:
  15. ----------------
  16. MAIN (Dialog):
  17.  
  18.   PREVIEW VIDEO DEVICE:
  19.     - VIDEO RUN .......... enable the video running in the video window
  20.     - VIDEO HALT ......... halts the video at the actual picture
  21.     - SHOW WINDOW ........ shows a window in which the video is shown
  22.     - HIDE WINDOW ........ hides the video window
  23.  
  24.   ADJUST VIDEO SOURCE:
  25.     - FRAMES/SEC ......... adjust the number of frames which comes from the 
  26.                            video device ( max. 60 fps, but the limit determines the device )
  27.     - VIDEO SOURCE ....... this dialog is supported from the device driver  
  28.                            of the video device ( enabled if available )
  29.     - VIDEO FORMAT ....... this dialog is supported from the device driver  
  30.                            of the video device ( enabled if available )
  31.     - VIDEO DISPLAY ...... this dialog is supported from the device driver  
  32.                            of the video device ( enabled if available )
  33.     - VIDEO COMPRESSION .. this dialog is supported from the device driver  
  34.                            of the video device ( enabled if available )
  35.  
  36.   AVI RECORD:
  37.     - SELECT FILENAME .... select the filename for the AVI file ( the filename
  38.                            is shown above the button )
  39.     - AVI WITH AUDIO ..... check if the AVI should recorded with audio if possible
  40.     - START AVI RECORD ... starts the recording
  41.     - STOP AVI RECORD .... stops the recording
  42.  
  43.   PICTURE CAPTURE:
  44.     - SELECT FILENAME .... select the filename for the BMP picturefile ( the filename
  45.                            is shown above the button )
  46.     - TAKE A PICTURE ..... takes from the actual video a picture
  47.     - VIEW PICTURE ....... shows the picture from the picturefile in a separat window
  48.  
  49.   MOTION DETECTOR:
  50.     - ADJUST ............. adjust all motion detector settings
  51.     - STOP ............... stops the motion detector
  52.     - START .............. starts the motion detector
  53.     - DIFFERENCE ......... shows the difference between the two tested pictures in %
  54.     - TESTED ............. shows how often the motion detection tested for difference since start
  55.     - DETECTED ........... shows how often the motion detection have detected a motion
  56.  
  57.   FILE TRANSFER:
  58.     - ACTIVATE FILE TRANSFER . check this if you want to enable the periodic file transfer or the
  59.                                file transfer on motion detection
  60.     - ADJUST ................. opens the FILE TRANSFER (FTP) Dialog to adjust all settings
  61.  
  62.  
  63. ADJUST MOTION DETECTOR (Dialog):
  64.  
  65.     - SELECT RELEVANT AREAS ........... selection of the areas which are tested while motion detection
  66.     - CHECK AGAINST START PICTURE ..... the actual picture is always compared against the start picture
  67.                                         made at the start of the motion detection
  68.     - CHECK AGAINST PREVIOUS PICTURE .. the actual picture is compared against the previous 
  69.                                         actual picture, so permanent changes are only reported once 
  70.   TEST FOR MOTION:
  71.     - UNTIL THE FIRST DETECTION .. the motion detection runs only until the first detection appears,
  72.                                    it runs with the EVERY X SEC adjustment ( see below )
  73.     - OFTEN AS POSSIBLE .......... detection runs often as your PC it make possible ( be careful 
  74.                                    with that mode ! )
  75.     - EVERY X SEC ................ every x seconds the program tests for motion ( if you want one
  76.                                    test in an hour input 3600 ! )
  77.  
  78.     - DETECTION AT X% AREA CHANGE .... to detect a motion X% of the selected area must be different
  79.     - X COLOR-VALUE-DIFF FOR CHANGE .. if the color value difference of one pixel is greater than X
  80.                                        this pixel is count as a different one ( see below )
  81.  
  82.   ACTION AT DETECTION:
  83.     - RECORD AVI ................. AVI recording at motion detection ( disables picture taking )
  84.     - ONLY ONE AVI ............... there is only one AVI file in existence, the actual motion 
  85.                                    detection overwrites the AVI file ( this is useful if you have 
  86.                                    less harddisk space ! )
  87.     - EVERY DETECTION A NEW AVI .. a new AVI file is created every detection, the filenames are
  88.                                    the selected filename plus the detection number 001...999 !
  89.                         ( example: filename is MOVE_.AVI results in MOVE_001.AVI, MOVE_002.AVI, ... )
  90.     - AVI LENGTH X SEC ........... the AVI length in seconds     
  91.     - SELECT FILENAME ............ select the filename for the AVI ( or the AVIs + 001...999 ! )
  92.  
  93.     - TAKE A PICTURE ............. takes a picture at motion detection ( disables AVI recording )
  94.     - ONLY ONE PICTURE ........... there is only one BMP file in existence, the actual motion 
  95.                                    detection overwrites the BMP file ( this is useful if you have 
  96.                                    less harddisk space ! )
  97.     - EVERY DETECTION A NEW PIC .. a new BMP file is created every detection, the filenames are
  98.                                    the selected filename plus the detection number 001...999 !
  99.                         ( example: filename is MOVE_.BMP results in MOVE_001.BMP, MOVE_002.BMP, ... )
  100.     - SELECT FILENAME ............ select the filename for the picture ( or the pictures + 001...999 ! )
  101.  
  102.     - EXECUTE A PROGRAM .......... an extern program would be executed if a motion detection occurs
  103.     - EXECUTE ONCE ............... the program will be executed only once
  104.     - EXECUTE AT EACH DETECTION .. the program will be executed at each motion detection
  105.     - SELECT FILENAME ............ select the filename for the program
  106.  
  107.     - CREATE A PROTOCOL FILE ..... a protocol file would be created, it's a TEXT file which includes
  108.                                    the detection number, date and time when the detection occurs:
  109.                                    ( Nr.:001   DATE: 13-04-1999   TIME: 17:48:47 
  110.                                      Nr.:002   DATE: 13-04-1999   TIME: 17:48:53 )
  111.     - SELECT FILENAME ............ select the filename for the protocol file
  112.  
  113.     - PLAY A SOUND ............... plays a sound if a motion detection occurs ( WAV file ! )
  114.     - PLAY IN A LOOP ............. plays the sound permanent, if you don't check, the sound plays
  115.                                    only until it ends 
  116.     - SELECT FILENAME ............ select the filename for the WAV file
  117.  
  118.  
  119. SELECT RELEVANT AREAS (Dialog):
  120.     You have to select areas of the video screen or the whole screen, before you can start the
  121.     motion detection. The pixels in this selected areas are the only ones, which are tested for
  122.     differences. You create a mask for testing ! This mask is saved in MASK.BIN .
  123.  
  124.     - SELECT ALL ................. select the whole video area
  125.     - UNSELECT ALL ............... unselect all
  126.     - 3 BUTTONS FOR BRUSH SIZE ... change the brush size for drawing the mask
  127.     - COLOR ...................... change the brush color to get a better contrast against the pic
  128.  
  129.  
  130. FILE TRANSFER ( FTP ) (Dialog):
  131.  
  132.   DIAL UP  
  133.     - PHONE # .................... insert the phone number for your internet access
  134.     - USERNAME ................... username for your internet access
  135.     - PASSWORD ................... password for your internet access
  136.     - ATTEMPTS TO CONNECT ........ quantity of attempts to connect
  137.     - SEC PAUSE BETWEEN ATTEMPTS . sec pause between attempts to connect
  138.  
  139.   FTP CONNECTION
  140.     - HOSTNAME ................... the ftp server name (address)
  141.     - USERNAME ................... username for your ftp server access
  142.     - PASSWORD ................... password for your ftp server access
  143.     - HOSTPORT ................... the port of your host ( 21 is default and in most cases correct ! )
  144.     - CHANGE TO DIR............... if you want to change on your ftp server to a decided directory
  145.                                    before upload then input the directory name ( input nothing for
  146.                                    no directory change ! )
  147.  
  148.     - DIALUP BEFORE FILE TRANSFER. check if you wish to dial up ( and later hang up ) and connect to the 
  149.                                    internet before the program uploads the files ( if you are already or  
  150.                                    allways in the net don't check this ) 
  151.                                      
  152.   FILE TRANSFER
  153.     - ON MOTION DETECTION ........ check if the transfer should start after a motion detection occurs
  154.     - EVERY X SEC ................ check if the transfer should start periodic every X sec
  155.     - TAKE A PICTURE ............. takes a picture from the actual video source before transfer 
  156.                                    ( the filename is taken from the PICTURE CAPTURE option ! )
  157.     - CONVERT TO GIF ............. the picture would be converted to a GIF file, if you have checked
  158.                                    TAKE A PICTURE then this picture would be converted, if not, the
  159.                                    actual motion detection picture AKT.BMP would be converted
  160.  
  161.     - TRANSFER NOW ............... starts the file transfer direct
  162.     - STOP TRANSFER .............. stops the file transfer
  163.     - CHOOSE FILES ............... opens the FILES TO TRANSFER Dialog
  164.  
  165.  
  166. FILES TO TRANSFER (Dialog)
  167.  
  168.     - INSERT ..................... inserts a file or several files into the file list
  169.     - DELETE ..................... deletes the actual selected file from the file list
  170.     - DELETE ALL ................. erases the file list
  171.  
  172.  
  173.  
  174. Motion detection remarks:
  175. -------------------------
  176. The motion detection generates at the start the picture START.BMP. During the detection the 
  177. program generates the picture AKT.BMP every time a detection should be made.
  178. Then the pictures would be compared and different pixels will counted. The pixels ONLY in the
  179. areas of the mask will be compared ! Are X% of the pixels are different, a motion detection occurs.
  180. The COLOR-VALUE-DIFF value is important to decide if two pixels are different. Video cameras makes
  181. always different pictures, also when the object doesn't change. To bring the difference on a
  182. useful level you can adjust this value. The program calculates the difference for the red, green
  183. and blue value of the both pixels. If the difference is greater than the COLOR-VALUE-DIFF value,
  184. the pixel is counted as different ! You get the best results if you choose a RGB-24Bit format for
  185. your device ! At 16Bit the 3 RGB parts have too less bits for their value ( use RGB-24/32Bit ).
  186.  
  187. FTP remarks:
  188. ------------
  189. The CONVERT TO GIF option is useful if you would show your video picture as a GIF on your webpage !
  190. A GIF picture has max. 256 colors, so it's smaller than the BMP. If the BMP has more than 256 colors,
  191. the amount of colors would be decreased to 256 ! All browsers supports GIF pictures.
  192. If you have checked TAKE A PICTURE, this picture ( filename + .GIF ) results from the conversion. To 
  193. upload this file, insert filename.GIF into the 'files to transfer' list. If you haven't checked TAKE A
  194. PICTURE the actual motion detection picture AKT.BMP would be converted, it results AKT.GIF !
  195.  
  196. During the file transfer is running, a separat dialog shows you the status of the transfer !
  197.  
  198. If you have checked DIALUP BEFORE FILE TRANSFER the program dials up before connection to the FTP server
  199. and hangs up after all files where uploaded !
  200.  
  201.  
  202. General remarks:
  203. ----------------
  204. - If you have enabled AVI recording, the next motion detection and the next file transfer are made 
  205.   not until the recording ends.
  206. - If a file transfer is running, the motion detection halts for this time.
  207. - All program settings were loaded at the program start and saved at the end in 
  208.   the file WCCC.INI .
  209. - The selected files for the file transfer are listed in the file FILES.DAT. You can edit this file
  210.   manual. In the first line stands the number of files, in the following lines are the filenames with
  211.   pathes.
  212. - Use more than 256 colors for your Windows desktop to view the pictures correct.   
  213. - The picture file AREA.BMP will be generated if you activate the SELECT RELEVANT AREAS dialog.
  214.   In this picture you select the relevant areas.
  215. - The mask file MASK.BIN is generated if you close the SELECT RELEVANT AREAS dialog and
  216.   will be loaded at the program start.
  217. - If you change the video format ( resolution etc. ) the mask file MASK.BIN will
  218.   be erased and you have to generate a new one before you start the motion detection.
  219.  
  220.  
  221. Included files:
  222. ---------------
  223.   WCCC.EXE    - the WebCam-Control-Center program
  224.   MANUAL.TXT     - this file
  225.   ORDER.TXT    - description of how to order this program
  226.   ALARM1.WAV    - WAV sound which you can use with the motion detector
  227.   AKT.GIF    - dummy GIF picture to select in the FILES TO TRANSFER Dialog
  228.   TEST.GIF    - dummy GIF picture to select in the FILES TO TRANSFER Dialog                
  229.                  
  230.  
  231.  
  232.  
  233. DEVELOPMENT HISTORY:
  234. --------------------
  235.  
  236. WebCam-Control-Center V2.0    07.07.1999
  237. ==========================
  238. New in version 2.0:
  239. - automatic connection to the internet ( dialup/hangup )
  240. - connection to a FTP server
  241. - directory change and file upload to the server
  242. - periodic and direct uploads
  243.  
  244.  
  245. WebCam-Control-Center V1.1    20.04.1999
  246. ==========================
  247. New in version 1.1:
  248. - take a picture from the video device
  249. - view the picture in a picture window
  250. - record AVI videos
  251. - motion detector, with a lot of settings
  252.  
  253.  
  254. WebCam-Control-Center V1.0    28.03.1999
  255. ==========================
  256. First version:
  257. - adjust the video device over the driver specific dialog boxes
  258. - adjust the frames per sec setting of the video device
  259. - show/hide a preview video window from the video device
  260. - run/halt the preview video
  261.  
  262.  
  263.  
  264.  
  265.  
  266.