
          quickeye2 QuickCam viewer for os2

      Copyright (c) 1996 A.Poethke All Rights Reserved.

*********************************************************************
This program is shareware, that means you're allowed to 
distribute it freely (but only the complete archive!). You are 
allowed to test it over a period of 30 days. After that time
you have to register! 
*********************************************************************

I'm proud to present my QuickCam viewer for OS/2 called "quickeye2".

It features :
   - 16 and 64 graylevels
   - 3 resolutions
   - dive support, which means a free scaleable image area 
   - taking pictures
   - taking picture sequences (for mpeg encoding etc.)

Requirements:
   - PC running os/2 warp V3 (maybe "or later" but not tested)
   - HPFS filesystem or any other that supports long filenames
   - MMPM installed 
   - Connectix QuickCam (a b&w digital camera)

Installation:
1) Unpack the zipfile in a separate directory on a hpfs drive.
2) (If not yet installed) install the device driver xf86sup.sys:
        Add the following line to your "config.sys":
        DEVICE=C:\quickeye2\xf86sup.sys
   If your program is placed in C:\quickeye2, if not insert the 
   right path.
   Note: You have to reboot in order to take effect of your
   changes in the "config.sys"!
3) Start quickeye2 by typing quickeye2 on a comand line in the
   quickeye2 directory or create a shadow of it at your workplace
   shell or double click on the program symbol.

Usage:
   - Optional: 
     Choose the initial settings in the file quickeye2.conf which 
     best fit to your needs. 
   - Use your mouse or the hotkeys to set the propper value for
     contrast, brightness and whiteballance at the dialog under
     options->image settings (F2)
   - Take a picture via 
	      options->TakeAPic
     The program produces a *.pbm image file which can be seen 
     and converted using shareware programs like pmjpeg e.g. In later 
     releases I will use the jpeg image format for a single picture.
   - Start the recording of a sequence by 
	      options->start/stop sequence (F6)
     A short beep after each picture will remind you, that a recording 
     is running.
     (I'm currently working on a script which allows you to make a 
      mpeg encoded video from your recorded sequence. It works but
      I have to write a documentation  :-(  Contact me if you are 
      interested in.)
   - Modify the initial settings by editing the file quickeye2.conf by
	      options->qcam settings (F3)

Performance remarks:
  The frames per seconds depend strongly on the selected 
  resolution and color depth. This is because of the botleneck 
  'parallel port'. Typical values are on a 486DX2-80:
	320x240x64: 1 fps
	320x240x16: 1.5 fps
	160x120x64: 3.5 fps
	160x120x16: 5 fps
	80x80x16: 15 fps
	80x80x16: not supported

Problems:
The program is succesfully tested on 5 different computers. No Problems 
are known. 
If the program terminates itself immediately after the start:
   - Did you reboot after editing your "config.sys"?
   - Edit the file "quickeye2.conf" and choose the propper parallel port,
     on which your QuickCam is plugged in. Try it again...
   - Make sure that all nessecary files are in the quickeye2 - directory.
     Nessecary are "quickeye2.conf" and "quickeye2.exe".

   If it still doesn't work... I have no idea. Please, write a bug report to me.
   email: "a.poethke@link-goe.de"

How to Register:
    private use:
	- No money needed! Just an email to "a.poethke@link-goe.de" 
    commercial use:
	- DM 50.00 or US$ 40.00 to 
		A.Poethke
		Otto-Lauffer-Str. 8
		37077 Goettingen 
		Germany

Thanks to:
 - Holger Veit for his great work on "xf86sup.sys" as a part of the
   "xfree86 for os/2" project.
 - Scott Laird for the good sources and documentations of the quickcam
   protocol.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
IN NO EVENT SHALL ANDREAS POETHKE BE LIABLE FOR ANY CLAIM, DAMAGES OR
OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
OTHER DEALINGS IN THE SOFTWARE.

Copyrights of others:
xf86sup.sys (c) Holger Veit

Trademarks:
os/2     is a trademark of IBM Corporation
quickcam is a trademark of Connectix Corporation

