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, Based on code by Patrick Reynolds 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