VisageDetectorDemo

visage|SDK VisageDetectorDemo example project

## Dependencies

Prerequisites to building and running the sample project are:

- g++ compiler (versions 4.7.x) (sudo apt-get install g++)
- OpenGL with dynamic libraries: GL, GLU (sudo apt-get install freeglut3-dev)
- OpenCV library (sudo apt-get install libopencv-dev)
- Video4Linux library (sudo apt-get install libv4l-dev)
- GTK+ 2.0 with dynamic library: gtk-x11-2.0 (sudo apt-get install libgtk2.0-dev)
- curses terminal control library (sudo apt-get install libncurses5-dev)
- high level programming interface for IEEE1394 digital camera (sudo apt-get install libdc1394-22-dev)

## Running prebuilt sample

The VisageDetectorDemo example project demonstrates the following capabilities of visage|SDK:

- facial features detection in still images

To use the application: Run the './runDetector.sh <filename>' command from the terminal
This will perform facial features detection on a provided image (<filename>). If no image is provided detection will be performed on a default image. The sample is modified to run from the visageSDK/bin folder. It changes the current directory to ../Samples/data folder where Face Detector.cfg configuration file is located. Images are provided relative to that folder. The image should represent a face, in frontal pose and with a neutral expression. The face should not take a too big portion of the image, i.e., less than 50%. Several test images are available in the folder Samples/Linux/data/images.

The specific classes and methods that demonstrate visage|SDK are:

- main(): Initialises the Facial Feature Detector m_Detector.
- IplImage* DetectFeatures(char *fileName): Performs facial features detection on a still image and displays the result

## Building the project

The VisageDetectorDemo sample project source file is located in the Samples/Linux/source/VisageDetectorDemo subfolder of the visage|SDK for Linux folder. It is built using the provided Makefile located in Samples/Linux/build subfolder.

The application needs to be built with license key in order to work properly. More information on how to obtain license key and include it in the application can be found in Licensing section of the documentation.