Readme for the QTrack face tracker, version 0.90

QTrack is a face tracker for use with OpenCV. QTrack is both faster
and more robust than OpenCV's Camshift for tracking faces.

QTrack version 0.90 was written by Robin Hewitt and is distributed
under the BSD license. You can download the complete QTrack package,
including installer, sample code, use license, and a minimal runtime
version of OpenCV 1.0 from either
http://www.cognotics.com/opencv/downloads/qtrack/index.html
or
http://www.robinhewitt.com/research/track/qtrack/index.html


Licensing:

QTrack 0.90 is released under the BSD license. You should have received the
QTrack license in your download package. You can also view this license online
at either download site.

QTrack uses OpenCV. The OpenCV license is located in the opencv subdirectory
of the download package.

QTrack uses OpenCV's haarcascade_frontalface_default.xml for face
detection. The license for this cascade is in haar-cascade-license.txt,
at the root of the download package. (Note that the cascade has been
incorporated into the QTrack dll, so you don't need to tell it where to
find this cascade.)


Installing QTrack:

  1. Download the zip archive from one of the links above and unzip
     it into the directory you wish to use for QTrack.

  2. Run the program install_qtrack_090.exe.

  3. Test the installation by running the program QTrackTest.exe, located
     in the sample/bin subdirectory.


Using QTrack in your own code:

  Include qtrack.h in your source file. You will also need to include
  any OpenCV libraries you will use. At a minimum, you will need to
  include cv.h

  To build, you will need to configure your development environment:
    Set the compiler (or preprocessor) path to include
      the directory with qtrack.h
      the directory or directories with the OpenCV header files
        (cv.h, cxcore.h, and the rest of the OpenCV headers)
    Set the linker path to include
      the directory with qtrack.lib
      the directory with qtrack.h
    Add these libraries to you linker's input list
      cxcore.lib, cv.lib highgui.lib, and qtrack.lib
      (The first three are OpenCV libraries)

  Note that most of these steps are the same as you'd use for any
  program that includes OpenCV libraries. The only extra steps are
  including qtrack.h and linking to qtrack.lib

  The source code for QTrackTest is in the sample subdirectory. You may
  wish to use it as a start point for your own code.


Release notes for version 0.90:

  Windows:
    QTrack is released as a dll, qtrack_090.dll. The installer program for
    Windows will place the dll in your Windows System directory.

    QTrack requires OpenCV to run. For your convenience, a minimal runtime
    version of OpenCV 1.0 is included in the QTrack download. If you
    do not have OpenCV installed, the installer will also place the dlls
    for OpenCV, version 1.0, in your Windows System directory. It will only
    do this if the OpenCV dlls are not already there. It won't overwrite
    existing dlls.

  Please view the license.txt file for OpenCV 1.0, located in the opencv
  subfolder, after you have unzipped the QTrack download.

  Subfolders include and lib under opencv contain the include files and
  .lib files for OpenCV version 1.0. Note that these files are only a small
  portion of the complete OpenCV package. If you wish to download and install
  the complete OpenCV package, or wish to install a newer version of OpenCV,
  you can of course do so. At the present time, the OpenCV download site is
  http://sourceforge.net/projects/opencvlibrary/

  At the top level of the unzipped download, you will find the readme and
  license files for QTrack itself. You will also find qtrack.h and the source
  code for QTrackTest in QTrackTest.c. The compiled test program uses the
  images in the bin directory, so if you want to run it outside that
  directory, copy the images as well.

  Status:
    Tested with OpenCV, version 1.0. No known bugs.