VisageTrackerDemo
visage|SDK VisageTrackerDemo example project

Dependencies

Prerequisites to building the sample project are:
  • g++ compiler (versions 9.3.x) (sudo apt-get install build-essential)
  • libz (sudo apt-get install zlib1g-dev)
  • OpenCV and OpenCV dependencies (sudo apt-get install libopencv-dev):
    • jpeg dynamic libraries (sudo apt-get install libjpeg8-dev)
    • FFMPEG with dynamic libraries: swscale, avformat (sudo apt-get install libswscale-dev libavformat-dev)
    • libpng16 (sudo apt-get install libpng-dev)
    • libv4l (sudo apt-get install libv4l-dev)
  • OpenBLAS library (sudo apt-get install libopenblas-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 VisageTrackerDemo example project demonstrates the following capabilities of visage|SDK:

  • real-time head/facial features tracking on multiple faces from video file or camera, with on-the-fly animation, based on the VisageSDK::VisageTracker tracker. Currently, tracking is limited to 4 faces, although this can be modified.

To use the application:

Run the './runTracker.sh' command from the terminal

This is an intentionally simplified version of a tracking application, intended to be used by developers as an introduction. VisageTrackerDemo is a console application, with keyboard based choices made by the user. It then starts tracking and displays tracking status and numeric results in the console. Results are also visualized in an additional window as an overlay over the original image.

Classes and methods that are important for detailed understanding how this sample project is implemented and how it used visage|SDK are:

  • main(): implements the main user interaction.

Building the project

The VisageTrackerDemo sample project source file is located in the Samples/Linux/source/VisageTrackerDemo 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.