![]() |
Visual Servoing Platform
version 3.2.0
|
#include <vpDetectorFace.h>
Public Member Functions | |
vpDetectorFace () | |
virtual | ~vpDetectorFace () |
bool | detect (const vpImage< unsigned char > &I) |
bool | detect (const cv::Mat &frame_gray) |
void | setCascadeClassifierFile (const std::string &filename) |
Inherited functionalities from vpDetectorBase | |
vpRect | getBBox (size_t i) const |
vpImagePoint | getCog (size_t i) const |
std::vector< std::string > & | getMessage () |
std::string & | getMessage (size_t i) |
size_t | getNbObjects () const |
std::vector< std::vector< vpImagePoint > > & | getPolygon () |
std::vector< vpImagePoint > & | getPolygon (size_t i) |
Protected Attributes | |
std::vector< cv::Rect > | m_faces |
cv::CascadeClassifier | m_face_cascade |
cv::Mat | m_frame_gray |
std::vector< std::vector< vpImagePoint > > | m_polygon |
std::vector< std::string > | m_message |
size_t | m_nb_objects |
The vpDetectorFace class is a wrapper over OpenCV Haar cascade face detection capabilities. To use this class ViSP should be build against OpenCV 2.2.0 or a more recent version. Installation instructions are provided here https://visp.inria.fr/3rd_opencv.
The following sample code shows how to use this class to detect the largest face in the image. The cascade classifier file "haarcascade_frontalface_alt.xml" can be found in ViSP source code or in OpenCV.
A more complete example that works with images acquired from a camera is provided in tutorial-face-detector-live.cpp.
Definition at line 87 of file vpDetectorFace.h.
vpDetectorFace::vpDetectorFace | ( | ) |
Default constructor.
Definition at line 51 of file vpDetectorFace.cpp.
|
inlinevirtual |
Default destructor.
Definition at line 99 of file vpDetectorFace.h.
bool vpDetectorFace::detect | ( | const cv::Mat & | frame_gray | ) |
Allows to detect a face in the image. When more than one face is detected, faces are sorted from largest to smallest.
frame_gray | : Input gray level image to process. |
The number of detected faces is returned using getNbObjects(). If a face is found the functions getBBox(), getCog() return some information about the location of the face.
The largest face is always available using getBBox(0) or getCog(0).
Definition at line 102 of file vpDetectorFace.cpp.
|
virtual |
Allows to detect a face in the image. When more than one face is detected, faces are sorted from largest to smallest.
I | : Input image to process. This ViSP image is converted internally in an OpenCV cv::Mat image. If you original image is an gray level OpenCV image, we suggest rather the use of detect(const cv::Mat &). |
The number of detected faces is returned using getNbObjects(). If a face is found the functions getBBox(), getCog() return some information about the location of the face.
The largest face is always available using getBBox(0) or getCog(0).
Implements vpDetectorBase.
Definition at line 83 of file vpDetectorFace.cpp.
|
inherited |
Return the bounding box of the ith object.
Definition at line 86 of file vpDetectorBase.cpp.
|
inherited |
Return the center of gravity location of the ith object.
Definition at line 73 of file vpDetectorBase.cpp.
|
inlineinherited |
Returns the contained message of the ith object if there is one.
Definition at line 106 of file vpDetectorBase.h.
|
inherited |
Returns the contained message of the ith object if there is one.
Definition at line 61 of file vpDetectorBase.cpp.
|
inlineinherited |
Return the number of objects that are detected.
Definition at line 116 of file vpDetectorBase.h.
|
inlineinherited |
Returns object container box as a vector of points.
Definition at line 121 of file vpDetectorBase.h.
|
inherited |
Returns ith object container box as a vector of points.
Definition at line 49 of file vpDetectorBase.cpp.
void vpDetectorFace::setCascadeClassifierFile | ( | const std::string & | filename | ) |
Set the name of the OpenCV cascade classifier file used for face detection.
filename | : Full path to access to the file. Such a file can be found in OpenCV. Within the last versions it was name "haarcascade_frontalface_alt.xml". |
Definition at line 59 of file vpDetectorFace.cpp.
|
protected |
Haar cascade classifier file name.
Definition at line 91 of file vpDetectorFace.h.
|
protected |
Bounding box of each detected face.
Definition at line 90 of file vpDetectorFace.h.
|
protected |
OpenCV image used as input for the face detection.
Definition at line 92 of file vpDetectorFace.h.
|
protectedinherited |
Message attached to each object.
Definition at line 70 of file vpDetectorBase.h.
|
protectedinherited |
Number of detected objects.
Definition at line 71 of file vpDetectorBase.h.
|
protectedinherited |
For each object, defines the polygon that contains the object.
Definition at line 66 of file vpDetectorBase.h.