FreeBSD/NetBSD/OpenBSD Simple OV511 video capture program
Version 1.0.1 (2000-05-07)

This is a simple image capture program for USB webcams based on the
OmniVision Technologies OV511 bridge chip attached to an OV7610 CCD
imager.  This includes webcams such as:

 * Creative Labs WebCam 3
 * D-Link DSB-C300
 * Puretek PT-6007
 * Koala-Cam
 * Lifeview RoboCam
 * AverMedia InterCam Elite
 * MediaForte MV300

Information about the OV511 and OV7610 chips are available from the
OmniVision Technologies website, http://www.ovt.com/

This program is heavily based on the OV511 linux driver by Mark
W. McClelland.  (See http://alpha.dyndns.org/ov511/ for more
information).  Recent versions of that driver support a wider array of
cameras; if it supports something that this program doesn't then
contact me and I'll see what I can do.

Since USB webcams transfer image data using an isochronous endpoint,
support for isochronous transfers in the FreeBSD/NetBSD generic USB
device (ugen) driver is required.  A patch adding this support is
available separately on my WWW page.

In addition to kernel support, to compile the program you will need
the Netpbm 8.4 libraries (included in the graphics/netpbm port).

After capturing an image, the program will write the image data to
standard output in PNM (portable anymap) format.  This format is
directly readable by many graphics programs, and can be processed by
any of the utilities in the Netpbm package.  To capture the output as
a 640x480 color PNG file, for instance, you could use

	vid | pnmtopng > output.png

Command line options include:

--version              print program version information
--usage                summarize command line options
--help                 print this description
--small                capture as 320x240 image (default is 640x480)
-d device, --device-name=device
                       specify OV511 ugen device

If no device file is specified, the program will cycle through the
/dev/ugen0, /dev/ugen1, ... devices until it finds an attached OV511.

The OV511 and OV7610 allow many parameters to be modified that are not
accessible using this program.  In fact, this program is only intended
as a stopgap measure, and I hope to replace it with a SANE (Scanner
Access Now Easy) driver at some point in the near future.  (See the
graphics/sane port or http://www.mostang.com/sane/ for more
information.)

Please report any bugs to me at housel@acm.org; see my home page
http://members.home.com/housel/ for updates.

-Peter S. Housel-

Note from the OpenBSD port-monkeys: Since @Home has gone bust, try the
sourceforge homepage: <http://ovtvid-bsd.sourceforge.net/>
