ofxCvHaarFinder: OpenCV face/eye/mouth tracking

Edit: The most recent version is now maintained at http://kyle.googlecode.com/.

ofxCvHaarFinder is for quickly finding features in an image using haar-like features. This is built into OpenCV, but usage is slightly complicated… hence this wrapper.

This wrapper was originally developed by charlie_e, based on an example by stefanix. I rewrote all the code and added some more features.

I spoke with stefanix, and it seems like this would fit with ofxOpenCv but isn’t quite ready yet. To avoid creating YAA (yet another addon :slight_smile: ) I’m going to support/update this code in this thread for now. Download the code and add it to your ofxOpenCv/src.

For Haar cascades that can be used with this addon, I’ve found two really good compilations:

1 OpenCV, which can be downloaded via SVN from here: http://opencvlibrary.svn.sourceforge.net/svnroot/opencvlibrary/tags/latest-tested-snapshot/opencv/data/haarcascades


2 Modesto Fernando Castrillón Santana from University of Las Palmas de Gran Canaria, which can be downloaded here: ftp://mozart.dis.ulpgc.es/pub/Software/HaarClassifiers/FaceFeaturesDetectors.zip

ojoD/right eye
nariz nuevo/nose new
ojoI/left eye
HS/head and shoulders
parojosG/big eye-pair

Some links regarding this addon:

Origin: http://forum.openframeworks.cc/t/opencv-functions/432/0
Old bugs: http://forum.openframeworks.cc/t/strange-bug-with-haar-finder-and-opencv-1.1pre/1853/0
The OpenCV function itself: http://www.comp.leeds.ac.uk/vision/opencv/opencvref-cv.html#decl-cvHaarDetectObjects

Using this code requires something like this:

ofxCvHaarFinder finder;  
finder.findHaarObjects(img); // an ofxCvGrayscaleImage  
for(int i = 0; i < finder.blobs.size(); i++) {  
  ofxCvBlob cur = finder.blobs[i];  
  printf("found: %i, %i %ix%i\n",   
    cur.x, cur.y, cur.width, cur.height);  

The attachment is newer than the last one I posted. It implements the copy constructor and correctly deallocates memory.


I agree if this were built into ofxOpenCv it would be great. I have a addon that I built ahile back, has function like:

void setRes(w, h);

each haar file when you open them or make them need to be set a a set dimension, or this is what I have read.

I also made a ofxHaarBlob since there is no need for vector pnts and I wanted to add some other stuff, but maybe it could just extend ofxCvBlob to keep clean. I will try to post it up on my google code.


Hey Todd… do you remember where you heard about setting the dimensions of the input when loading the training file?

I know in the xml there is a field that encodes the dimensions of the training target, but that’s independent of the files you’re loading.

Or maybe you’re thinking of the last argument to cvHaarDetectObjects, which specifies the minimum size, in pixels, to search for? (I wrapped this with my code, too).

ofxHaarBlob is nice… but it is kind of ambiguous how the “haar results aren’t quite blobs” thing should be handled. Maybe instead of haar blobs extending regular blobs it should be the other way around. You would have ofxCvShape (which could actually just be an ofRectangle, or an ofRectangle plus a few other things), and that would be what haar results are returned as. Blobs from contour tracking would extend that – as they have a bounding box, length, and center… but vertices, too.

I totally agree with you about blobs, that would make so much more sense. I will look for that article, i found it awhile back when working on the haarTraining app ( i still need to post this, sorry, getting better with google code tho). In this function:

		 #define CV_HAAR_DO_CANNY_PRUNING    1  
		 #define CV_HAAR_SCALE_IMAGE         2  
		 #define CV_HAAR_DO_ROUGH_SEARCH     8  
		 CVAPI(CvSeq*) cvHaarDetectObjects( const CvArr* image,  
		 CvHaarClassifierCascade* cascade,  
		 CvMemStorage* storage,   
		 double scale_factor CV_DEFAULT(1.1),  
		 int min_neighbors CV_DEFAULT(3),   
		 int flags CV_DEFAULT(0),  
		 CvSize min_size CV_DEFAULT(cvSize(0,0)));  

In the XML file

<?xml version="1.0"?>
<!-- Tree-based 20x20 frontal eye detector with better handling of eyeglasses. Created by Shameem Hameed ([http://umich.edu/~shameem](http://umich.edu/~shameem)) min\_size(20, 20) is from what I understand based on the haar file sample size. I just tried leaving that param blank and it still works, maybe cvHaarDetectObjects get that param from the file.. hmmm

Yeah, you’ve got it exactly right. If you go further into the xml there is a tag that will say 20 20 or something similar. If you leave the final argument out of the call to cvHaarDetectObjects, it uses that size. Also, if you set the value as cvSize(0, 0) it uses the default as well.

I left some notes in my code about those #defines btw, and what exactly they do.

In my face finder I just have…

typedef struct {
float area;
ofRectangle box;
ofPoint centre;
} CvHaarResult;

My class is also running in its own thread, but I’m trying to iron out the kinks in it. That way you can have multiple haars running at once, without slowing each other down.

Does it really take less time to run multiple cvHaarDetectObjects in threads than it does to run them sequentially in a single thread? I don’t understand how that works…?

It would be nice to have it, fundamentally, threaded. Then optionally provide a blocking call for people who don’t want to deal with that.

how can i do for used to another thing???

i just i can do working the example(face) :S, the others xml doesn’t work

[quote author=“johnavila2”]how can i do for used to another thing???

i just i can do working the example(face) :S, the others xml doesn’t work[/quote]

Do you mean, “how do i use it with other objects besides faces”, or something else?

Also, if you’re using Code::Blocks on Windows I could write a simple example for you.

Do you mean, “how do i use it with other objects besides faces”, or something else?

Also, if you’re using Code::Blocks on Windows I could write a simple example for you.


thx yes i am using code::Blocks on windows

yes i need this i little example for guideme

Sorry for my english i tried to make better this…

Your English is good enough for me to understand, so no worries :slight_smile:

Here’s a complete example.


#include "testApp.h"  
#include "ofAppGlutWindow.h"  
int main() {  
	ofAppGlutWindow window;  
	ofSetupOpenGL(&window, 1024, 680, OF_WINDOW);  
	ofRunApp(new testApp());  


#pragma once  
#include "ofMain.h"  
#include "ofxCvHaarFinder.h"  
class testApp : public ofBaseApp{  
		void setup();  
		void update();  
		void draw();  
		ofImage img;  
		ofxCvHaarFinder finder;  


#include "testApp.h"  
void testApp::setup(){  
void testApp::update(){  
void testApp::draw(){  
	img.draw(0, 0);  
	for(int i = 0; i < finder.blobs.size(); i++) {  
		ofRectangle cur = finder.blobs[i].boundingRect;  
		ofRect(cur.x, cur.y, cur.width, cur.height);  

Make sure you’ve downloaded the most recent version and copied the files to the opencv/src folder. I added an inefficient method that uses an ofImage, so you don’t have to worry about the ofImage->ofxCvImage conversion. Also, you need to put a file in /data called test.jpg that the test is run on. Here’s what it looks like running for me:


Hi again i download this


File comment: r2: May 29, 2009
ofxCvHaarFinder.zip [2.32 KiB]
Downloaded 3 times

File comment: r1: May 24, 2009
ofxCvHaarFinder.zip [2.26 KiB]
Downloaded 15 times

And download

File comment: Complete example of using ofxCvHaarFinder
haarTester.zip [149.26 KiB]
Downloaded 3 times

But appear this error

obj\release\src\testApp.o:testApp.cpp:(.text+0x128)||undefined reference to `ofxCvHaarFinder::findHaarObjects(ofImage&, int, int)’|

i need some else in


i put an image test.jpg in data…

thx for your example can you help me

Make sure that you unzip the code from the ofxCvHaarFinder.zip into of/addons/ofxOpenCv/src, otherwise the project won’t be able to find it.

poor Damian no face :frowning:

[quote author=“vanderlin”]poor Damian no face :slight_smile:

at the OF workshop in brussels, we made a little game with face tracking,
so I made this xcode example project with ofxCvHaarFinder for OF 0.06
(working with the FAT version)

was a very interesting workshop, thanks Arturo & Zach!


hey kylemcdonald

look i can, this is the example for codeblocks in windows

if anyone nedd remember put in folder 0.06/apps/addonExample

and make a folder in 0.06/addond/ofxCvhaarFinder/src and put .h and .cpp haarfinder

and finish :slight_smile:


thx man

Upsss :smiley: :slight_smile:

Just found this link that has all the haar cascades I mentioned above, plus a few more:


Personally, I’m really excited to use “the wall clock detector” at some point :slight_smile:

Hey there,

I’m trying to get this working to, however I get:

../../../addons/ofxOpenCv/libs/opencv/lib/linux/libcv.a(cvhaar.o)||In function `cvSetImagesForHaarClassifierCascade.omp_fn.1':|  
/src/testApp.h(.text+0x3f3a)||undefined reference to `GOMP_loop_dynamic_start'|  

any ideas?

thanks once again!