org.ptolemy.opencv

Class FaceRecognizer

java.lang.Object

org.ptolemy.opencv.FaceRecognizer

public class FaceRecognizer
extends java.lang.Object

A face recognition image filter. This filter detects faces in the given frame that lie in a square of dimensions [x,x], where _minFaceSize <= x >= _maxFaceSize. The parameters of the filter are:

• MinFaceSize: Minimum face size to be considered ( one side of a bounding square)
• MaxFaceSize: Maximum face size to be considered ( one side of a bounding square)

The class uses Haar Cascade classifier based object detection, as well as the classifiers for frontal face recognition are based on implementations provided by OpenCV 3.1.0.

Since:

Ptolemy II 11.0

Version:

$Id$

Author:

Ilge Akkaya

Pt.AcceptedRating:

Red (cxh)

Pt.ProposedRating:

Yellow (cxh)

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
class	FaceRecognizer.Eyes A filter that detects eyes and faces.
class	FaceRecognizer.Faces A filter that detects faces.

Constructor Summary

Constructors

Constructor and Description
FaceRecognizer() Construct an instance of FaceRecognizer and load the face recognition classifier.

Method Summary

Modifier and Type	Method and Description
org.opencv.core.Mat	bufferedImage2Mat(java.awt.image.BufferedImage source) Convert a BufferedImage object to OpenCV's Mat representation.
org.opencv.core.Rect[]	detectFaces(org.opencv.core.Mat img) Detect faces.
java.awt.image.BufferedImage	filter(java.awt.image.BufferedImage source, java.lang.String filterName) Apply the specified filter to the source image.
int	getFaceCount() Return the number of faces detected.
org.opencv.core.Rect[]	getFaceRectangles() Return the number of faces detected.
java.awt.image.BufferedImage	mat2BufferedImage(org.opencv.core.Mat matrix) Convert a Mat image into a BufferedImage.
void	setMaxFaceSize(int size) Set the maximum face size.
void	setMinFaceSize(int size) Set the minimum face size.
java.lang.String	toString() Return a string description of the filter.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

FaceRecognizer

public FaceRecognizer()
               throws java.io.IOException

Construct an instance of FaceRecognizer and load the face recognition classifier.

Throws:

java.io.IOException - If the shared library cannot be found.

Method Detail

filter

public java.awt.image.BufferedImage filter(java.awt.image.BufferedImage source,
                                           java.lang.String filterName)
                                    throws IllegalActionException

Apply the specified filter to the source image.

Parameters:

source - The source image to transform.

filterName - "eyes" or "faces".

Returns:

The transformed image.

Throws:

IllegalActionException - If the filter is anything other than "eyes" or "faces".

bufferedImage2Mat

public org.opencv.core.Mat bufferedImage2Mat(java.awt.image.BufferedImage source)

Convert a BufferedImage object to OpenCV's Mat representation.

Parameters:

source - BufferedImage input

Returns:

Mat matrix

mat2BufferedImage

public java.awt.image.BufferedImage mat2BufferedImage(org.opencv.core.Mat matrix)

Convert a Mat image into a BufferedImage.

Parameters:

matrix - Mat input

Returns:

BufferedImage output

detectFaces

public org.opencv.core.Rect[] detectFaces(org.opencv.core.Mat img)
                                   throws java.io.IOException

Detect faces.

Parameters:

img - The image containing faces

Returns:

An array of faces.

Throws:

java.io.IOException - if the haar cascade file cannot be found.

getFaceCount

public int getFaceCount()

Return the number of faces detected.

Returns:

The number of faces detected.

getFaceRectangles

public org.opencv.core.Rect[] getFaceRectangles()

Return the number of faces detected.

Returns:

The number of faces detected.

setMinFaceSize

public void setMinFaceSize(int size)
                    throws IllegalActionException

Set the minimum face size.

Parameters:

size - the minimum face size, which must be positive.

Throws:

IllegalActionException - If the value of the size parameter is less than 0.

setMaxFaceSize

public void setMaxFaceSize(int size)
                    throws IllegalActionException

Set the maximum face size.

Parameters:

size - the maximum face size, which must be positive.

Throws:

IllegalActionException - If the value of the size parameter is less than 0.

toString

public java.lang.String toString()

Return a string description of the filter.

Overrides:

toString in class java.lang.Object

Returns:

The string "MotionDetectorFilter".