Single Author Info
  dehuber   Daniel E. Huber

Group Info
  dehuber   Daniel E. Huber
  jjwinega  Joel   J. Winegarden


Lego group #4

README for image processing routines for camtrack


Compilation
----------------------

Use the following commands to compile the camtrack image processing software.

>$ qmake
>$ make

This creates an executable named "camtrack".

LNPD must be running, and the quickcam kernel module must be loaded.

camtrack defaults to using the /dev/video1 device, but this can be changed
by a command line argument, e.g. "camtrack /dev/video2".

This software was built using Qt-3.1.1-6.  It may or may not work on other
versions of Qt.

The quickcam driver can be found at: http://qce-ga.sourceforge.net


Solution Outline
----------------------

camtrack grabs a frame from the quickcam once every 50 milliseconds.  It then
searches every pixel in the image looking for one that is closest to the
target color.  If the found pixel is on the left side, camtrack sends a
message through lnpd to turn the camera left, and if it's on the right side,
then it sends a message to turn right, and if it's in the middle, then it
sends a message to stop moving.

The closeness to the target color is calculated as a euclidean distance in
RGB values.  The target color can be selected from the menus.

