Device/QuickCam version 0.02
============================

The README is used to introduce the module and provide instructions on
how to install the module, any machine dependencies it may have (for
example C compilers and installed libraries) and any other information
that should be provided before the module is installed.

A README file is required for CPAN modules since CPAN extracts the
README file from a module distribution so that people browsing the
archive can use it get an idea of the modules uses. It is usually a
good idea to provide version information here so that people can
decide whether fixes for the module are worth downloading.

INSTALLATION

To install this module type the following:

   perl Makefile.PL
   make
   make test
   make install

DEPENDENCIES

This module requires these other modules and libraries:

  libcqcam
  
  libjpeg

SYNOPSIS

 use Device::QuickCam;

 my $cam = Device::QuickCam->new();
 $cam->set_quality(50); #Set JPEG Quality in %
 $cam->set_bpp(24); #Set bits per pixel (24 or 32)
 $cam->set_width(320); #Set image width
 $cam->set_height(240); #Set image height
 for(1..10)
 { $cam->set_file("foo-$_.jpg"); #Use filename
   $cam->grab(); #Grab it
 }

 #HTTP Example

 use Device::QuickCam;

 my $cam = Device::QuickCam->new();
 $cam->set_quality(100);
 $cam->set_bpp(32);
 $cam->set_width(640);
 $cam->set_height(480);
 #No file set - dump to STDOUT
 $cam->set_http(1);
 #Enable HTTP Support
 $cam->grab();
 #This dumps JPEG Data to STDOUT
 
DESCRIPTION
This module allows access to the Connectix/Logitech QuickCam. This
module uses libcqcam and expects the user to play around with it.
libcqcam isn't installed as library during a default cqcam installation
(altho Debian does appear to provide it as a package).

REQUIREMENTS
You'll need :

 * root
   Root access or similar permissions to access the port.

 * libcqcam
   libcqcam installed and headers nearby. You will need them while building
   the C++ code. Location of libcqcam can be found below.

 * libjpeg
   libcqcam and this module output images in JPEG. You will need libjpeg
   installed.

 * a Connectix/Logitech QuickCam
   Well, obviously a QuickCam. These cameras were first manufactured by
   Connectix. Logitech later bought the company and same webcams were
   then/now sold under the Logitech brand. There are FAQs on how to get
   these cameras working in Linux.

 * Linux
   Well, It helps anyway. I have no idea how this might work on other
   platforms altho libcqcam supports a few.

FUNCTIONS
 grab()
 This function grabs image data, using settings defined beforehand.

 set_quality(int)
 This function can be used to set JPEG Quality. Values range from 0 to
 100. Default is 50.

 set_bpp(int)
 This function can be used to set a bits per pixel rate. Valid values are
 24 and 32. Default is 24.

 set_width(int)
 This function can be used to set the output image width. Values range
 from 0 to 640. Default is 320.

 set_height(int)
 This function can be used to set the output image height. Values range
 from 0 to 480. Default is 240.

 set_red(int)
 This function can be used to set the red level of the output image.
 Values range from 0 to 255.

 set_green(int)
 This function can be used to set the green level of the output image.
 Values range from 0 to 255.

 set_blue(int)
 This function can be used to set the blue level of the output image.
 Values range from 0 to 255.

 set_decimation(int)
 This function can be used to set scaling of the image. Valid values are
 1, 2 and 4. Default is 1.

 set_autoadj(int)
 This function can be used to toggle auto adjusting. Set 0 for off, 1 for
 on. Default is on.

 set_port(int)
 This function can be used to set a camera port. Default value is 0 for
 autoprobe. Valid values are 0x378, 0x278 and 0x3bc. If unsure, leave
 this at 0.

 set_debug(int)
 This function allows you to toggle debug info. 0 is off, 1 is on.
 Default is off.

 set_file(string)
 This functions allows you to set a filename for output.
 By not setting a filename, you force output to STDOUT.

EXPORT
None by default.

AUTHOR
Hendrik Van Belleghem, 
<beatnik - at - quickndirty - dot - org>

Based on code by Patrick Reynolds 
<reynolds - at - cs - dot - duke - dot - edu>

SEE ALSO

libcqcam, part of cqcam. http://www.cs.duke.edu/~reynolds/cqcam/

COPYRIGHT AND LICENCE

See COPYING and COPYRIGHT for more information

Copyright (C) 2003 Hendrik Van Belleghem
Portions Copyright (C) 1998 Patrick Reynolds