gqcam 0.4
---------

At the moment this program is not at all fit to be installed.  So, this
file is a little bit misnamed.  However, I will tell you how to build it
here.

Required
--------
First off, you need a Black and White QuickCam (www.quickcam.com).  You
also need Linux, probably with kernal of 2.2.x or above.  Whatever kernel
it is, it needs to have Video4Linux support for the QuickCam either built
in or built as a module.  (Mine is built as a module on kernel 2.2.5)
You will also need libjpeg installed so it can save stuff to jpeg format.
In the future I will make this an option, but it is needed at the moment.
Last you will need GTK+ (www.gtk.org), probably version 1.2.x or above.
(Mine is 1.2.1)

I think got a nice confgure script setup correctly, meaning that all you
should need to do is:

./configure
make

A few moments and you should have a nice binary called gqcam in the
directory you typed make in.  To run it, type ./gqcam.  If you have
loaded any needed kernel modules and have permission to read from
/dev/video, you should have a window appear before you showing whatever
your camera is pointed at and some lovely controls.  Have fun!

System Setup
------------
Following is a very nice walkthrough on setting up the kernel to use
Video4Linux.  It was sent to me by James Sizemore (James@deny.org), and
covers things quite nicely.  For the next release the documentation will
be reorganized, and this will fit in much better.  For now, however, here
you go.  Thanks, James!

======================================================================
Gqcam  needs the Video4Linux API and the proper video drivers  loaded
in the kernel;  either as a module or  compiled in.  Provided you have a
modern kernel 2.2.x . You may already have the two module you need to
load.

Type either " modprobe -l -t misc " or  " modprobe -l -t video"  This will
list
all the modules you have in these categories on your screen. You should
find "videodev" and "bw-qcam" in the list. If so using modprobe and lsmod
you can load these on your system.

Type su and your root password; you will need to be root.
Type "modprobe -a videodev"
Type "modprobe -a bw-qcam"
This should have loaded the drivers you needed.
To check use lsmod.
After typing "lsmod" you should see something like this:

bw-qcam                 6964   0  (unused)
videodev                  2368   1  [bw-qcam]

If not you may have to compile the kernel modules by hand you can
find them at : http://www.exploits.org/v4l/
See "man modprobe" and "man lsmod" for more options.

After you load the modules You may need to create the /dev files
for Gqcam to access the drivers. Check to see if you have
"/dev/video0" or "/dev/video" if not you will need to use "mknod"
to create these files.  The Video4Linus API recommends you have these
/dev's on you system:

  Device Name       Minor Range      Function
 /dev/video             0-63                     Video Capture Interface
 /dev/radio             64-127                 AM/FM Radio Devices
 /dev/vtx                 192-223               Teletext Interface Chips
 /dev/vbi                 224-239                Raw VBI Data
(Intercast/teletext)
And  /dev/bttv should be a symlink to /dev/video0 for most people.
You can find the Major numbers here:
ftp://ftp.kernel.org/pub/linux/docs/device-list/

Type "mknod /dev/video0 c 81 0".
Type "mknod /dev/video1 c 81 1".
Type "mknod /dev/radio0 c 81 64".
Type "mknod /dev/radio1 c 81 65".
Type "mknod /dev/vtx0 c 81 192".
Type "mknod /dev/vtx1 c 81 193".
Type "mknod /dev/vbi0 c 81 224".
Type "mknod /dev/vbi1 c 81 225 ".
Type "ln -s video0 bttv".
Type "ln -s video0 video"
You will also need to "chmod 666 " all these files.
So Gqcam can read and write to the QuickCam.

You can find more information on this subject here:
http://roadrunner.swansea.uk.linux.org/v4lapi.shtml
and by typing "man mknod" and "man ln" and "chmod"

=============================================================

Note
----
Previous versions of gqcam needed to read from and write to the parallel
port directly, so they needed to be run with root permissions.  Since this
one uses the V4L interface, all you should need is read/write permissions
on /dev/video.
