blog:corrected_facerec_demo.cpp_for_opencv_2.4

philipp — Fri, 04 May 2012 20:12:06 +0200

Corrected facerec_demo.cpp for OpenCV 2.4

There's a small bug in the facerec_demo.cpp, that ships with OpenCV 2.4. I'll put a corrected version upstream as soon as possible. However, here's a corrected version if you can't wait:

http://bytefish.de/dev/cpp/facerec_demo.cpp

opencv

blog:opencv_visual_studio_and_libfacerec

philipp — Thu, 19 Apr 2012 22:33:24 +0200

opencv, visual studio and libfacerec

I've got a lot of mails from people, who have problems to use OpenCV with Microsoft Visual Studio 2008/2010. While I think it's unbelievably easy by using CMake, I am going to explain how to build the libfacerec demo without using CMake. I have illustrated each step with screenshots and detailed explanation, so it's easy for you to follow. I am going to use Microsoft Windows 7, Microsoft Visual Studio 2010 and OpenCV 2.3.1 in this tutorial.

Setting up OpenCV

First of all you'll need OpenCV. For this tutorial I suggest to download the OpenCV Superpack 2.3.1, which is available as OpenCV-2.3.1-win-superpack.exe at:

http://sourceforge.net/projects/opencvlibrary/files/opencv-win/2.3.1/

There are a lot of other ways to install OpenCV, so please consult the http://opencv.willowgarage.com/wiki/ if you don't like the suggested one. The Superpack itself is not an installer, but a self-extracting archive. It contains the pre-built OpenCV library for VC9 (Microsoft Visual Studio 2008), VC10 (Microsoft Visual Studio 2010) and MinGW to mention a few. You'll only need the VC10 binaries for this tutorial.

Double-click the OpenCV-2.3.1-win-superpack.exe and select a folder to extract to. I'll choose D:\projects in this example:

The OpenCV superpack is no installer, so you'll need to manually add the OpenCV libraries to the DLL search path of Windows. The search paths of Windows are given in the PATH environment variable, which is a list of the directories to search, each separated by a semicolon.

Windows Vista and Windows 7 users

From the Desktop (or Start Menu), right-click My Computer and click Properties.
Click Advanced System Settings link in the left column.
In the System Properties window click the Environment Variables button.
In the Environment Variables window, highlight the Path variable in the Systems Variable section and click the Edit button. In the PATH variable each search path is separated with a semicolon.
At the end of the line add the following directories:
- D:\projects\opencv\build\x86\vc10\bin
- D:\projects\opencv\build\common\tbb\ia32\vc10

So you have to append a line like this to the existing PATH:

;D:\projects\opencv\build\x86\vc10\bin;D:\projects\opencv\build\common\tbb\ia32\vc10

Windows 2000 and Windows XP users

From the Desktop, right-click My Computer and click Properties.
In the System Properties window, click on the Advanced tab.
In the Advanced section, click the Environment Variables button.
In the Environment Variables window, highlight the Path variable in the Systems Variable section and click the Edit button. In the PATH variable each search path is separated with a semicolon.
At the end of the line add the following directories:
- D:\projects\opencv\build\x86\vc10\bin
- D:\projects\opencv\build\common\tbb\ia32\vc10

So you have to append a line like this to the existing PATH:

;D:\projects\opencv\build\x86\vc10\bin;D:\projects\opencv\build\common\tbb\ia32\vc10

Getting libfacerec

Next you'll need to download libfacerec, which is available from:

http://www.github.com/bytefish/libfacerec

If you don't know how to clone a github repository with git, then you can download the source from:

https://github.com/bytefish/libfacerec/downloads (zip, tar.gz)

Then extract the zip or tar.gz file to a folder of your choice, I am using D:\downloads\libfacerec in this tutorial. If you are using an other folder, then just keep it consistent.

Setting up Visual Studio

You'll now learn how to configure a Microsoft Visual Studio 10 C++ project with OpenCV. Parts might resemble the post by karlphilipp, which also explains how to configure OpenCV 2.3 on Visual Studio 2010. I won't reinvent the wheel, so you probably want to read hist post at:

http://stackoverflow.com/a/7014918/513875

The difference is, that I've decided to use pre-built Visual Studio 2010 (VC 10) libraries from the superpack. And I mention some pitfalls you'll encounter when compiling libfacerec.

Create an Empty project

Start Visual Studio and from the main menu select “File → New Project…“. Then create an “Empty Project”, name it libfacerec and store it in D:\projects:

Adding the libfacerec headers and sources

First of all the libfacerec headers and sources are added to our solution. For this copy the libfacerec header files from your extracted archive in D:\downloads\libfacerec\include to where your the solution is located in D:\projects\libfacerec\libfacerec. Also copy the source files from D:\downloads\libfacerec\src to D:\projects\libfacerec\libfacerec.

Now add the files to the Microsoft Visual Studio solution. In the Solution Explorer right click on Header Files and select Add → Existing Item…“, then select all *.hpp files you've just copied. Do the same for the source files and right click on Source Files and select all *.cpp files.

Your project now looks like this:

Additional Include Directories

Your project doesn't compile yet, because we didn't configure OpenCV. The first step is to set the additional include directories for our project. Go to the Project Properties by either right click on your project and select Properties or by pressing Alt + F7, in the new window do the following:

From the Configuration box (combo box in the top left), select All Configurations
Open Configuration Properties → C/C++ → General and edit the field Additional Include Directories to add these 3 include paths:
- D:\projects\opencv\build\include
- D:\projects\opencv\build\include\opencv
- D:\projects\opencv\build\include\opencv2

Additional Library Directories and Additional Dependencies

Then we need to add the libraries to build against. Again in the Project Properties Window do the following:

Add the path of the OpenCV libraries by Configuration Properties → Linker → General and on the Additional Library Directories field add:
- D:\projects\opencv\build\x86\vc10\lib

Then go to Configuration Properties → Linker → Input and in the Additional Dependencies field add:

opencv_highgui231.lib
opencv_core231.lib
opencv_imgproc231.lib

Build libfacerec

Finally libfacerec can be built. We are linking against the libraries:

opencv_core231.lib
opencv_highgui231.lib
opencv_imgproc231.lib

Those libraries have no Debug symbols, so we build libfacerec with the Release Configuration:

Then build the project and its executable by simply selecting Build → Build Solution (F7) from the Menu. And you should see:

Congratulations!

Running the Demo

Now to the Eigenfaces Demo. You need some data to make the examples work, sorry but I really can't include those face databases in my repository. First of all this. In the demo I have decided to read the images from a very simple CSV file. Why? Because it's the simplest platform-independent approach I can think of. However, if you know a simpler solution please ping me about it. Basically all the CSV file needs to contain are lines composed of a filename followed by a ; followed by the label (as integer number), making up a line like this:

/path/to/image.ext;0

Think of the label as the subject (the person) this image belongs to, so same subjects (persons) should have the same label. So let's make up an example. Download the AT&T Facedatabase from AT&T Facedatabase and the corresponding CSV file from at.txt, which looks like this (file is without … of course):

./at/s1/1.pgm;0
./at/s1/2.pgm;0
...
./at/s2/1.pgm;1
./at/s2/2.pgm;1
...
./at/s40/1.pgm;39
./at/s40/2.pgm;39

Imagine I have extracted the files to D:/data/at and have downloaded the CSV file to D:/data/at.txt.

Then I would simply Search & Replace ./ with D:/data/. You can do that in an editor of your choice, every sufficiently advanced editor can do this. Once you have a CSV file with valid filenames and labels, you can run the demo by with the path to the CSV file as parameter:

D:\projects\libfacerec\Release\libfacerec.exe D:/data/at.txt

and you should see (Note I have switched to the Eigenfaces model in the demo. Latest version in trunk is Fisherfaces!):

So yes. I am pretty sure all this also works in Microsoft Windows.

opencv

blog:libfacerec_c_cpp.jpg

philipp — Thu, 19 Apr 2012 00:58:08 +0200

blog:release_build.jpg

philipp — Thu, 19 Apr 2012 00:58:07 +0200

blog:libfacerec_linker_input.jpg

philipp — Thu, 19 Apr 2012 00:58:05 +0200

blog:libfacerec_vs_new_proj.jpg

philipp — Thu, 19 Apr 2012 00:58:00 +0200

blog:libfacerec_added_files.jpg

philipp — Thu, 19 Apr 2012 00:57:54 +0200

blog:installer_path.jpg

philipp — Thu, 19 Apr 2012 00:57:54 +0200

blog:installer_extracting.jpg

philipp — Thu, 19 Apr 2012 00:57:53 +0200

blog:eigenfaces.jpg

philipp — Thu, 19 Apr 2012 00:57:52 +0200

blog:build.jpg

philipp — Thu, 19 Apr 2012 00:57:50 +0200

blog:arnie_30_30_200_200.jpg

philipp — Tue, 10 Apr 2012 21:52:52 +0200

blog:arnie_20_20_200_200.jpg

philipp — Tue, 10 Apr 2012 21:52:51 +0200

blog:arnie_20_20_70_70.jpg

philipp — Tue, 10 Apr 2012 21:52:50 +0200

blog:arnie_10_10_200_200.jpg