org.openimaj.image.processing.face.detection

Enum FaceDetectorFeatures

java.lang.Object

java.lang.Enum<FaceDetectorFeatures>

org.openimaj.image.processing.face.detection.FaceDetectorFeatures

All Implemented Interfaces:

Serializable, Comparable<FaceDetectorFeatures>

public enum FaceDetectorFeatures
extends Enum<FaceDetectorFeatures>

Simple features that can be extracted from a list of detected faces and an image. Contains things like the count of faces, bounding boxes, etc.

Author:

Jonathon Hare (jsh2@ecs.soton.ac.uk)

Enum Constant Summary

Enum Constants

Enum Constant and Description
AREA Get the relative area of each detected face (normalised by the image area).
BLOBS Get the set of pixels describing each face.
BOX Get the bounding box describing each face.
COUNT Count the faces in the image.
ORIBOX Get the oriented bounding box describing each face.

Method Summary

Modifier and Type	Method and Description
protected ConnectedComponent	getConnectedComponent(DetectedFace df)
abstract <T extends Image<?,T>> FeatureVector	getFeatureVector(List<? extends DetectedFace> faces, T img) Compute a feature vector describing the detections.
static FaceDetectorFeatures	valueOf(String name) Returns the enum constant of this type with the specified name.
static FaceDetectorFeatures[]	values() Returns an array containing the constants of this enum type, in the order they are declared.

Methods inherited from class java.lang.Enum

clone, compareTo, equals, finalize, getDeclaringClass, hashCode, name, ordinal, toString, valueOf

Methods inherited from class java.lang.Object

getClass, notify, notifyAll, wait, wait, wait

Enum Constant Detail

COUNT

public static final FaceDetectorFeatures COUNT

Count the faces in the image. Returns the count as a single element, 1-dimensional MultidimensionalIntFV.

BLOBS

public static final FaceDetectorFeatures BLOBS

Get the set of pixels describing each face. Returns the result as a 2d MultidimensionalIntFV where each row has interlaced x and y values: x1, y1, x2, y2, ... The returned feature is not square; the length of each row is dependent on the number of pixels associated with the respective face.

BOX

public static final FaceDetectorFeatures BOX

Get the bounding box describing each face. The bounding boxes are encoded as a 2D MultidimensionalIntFV with each row corresponding to a face. Each row is encoded as the x, y, width, height values of the bounding box.

ORIBOX

public static final FaceDetectorFeatures ORIBOX

Get the oriented bounding box describing each face. The bounding boxes are encoded as a 2D MultidimensionalIntFV with each row corresponding to a face. Each row is encoded as the the four corners of the bounding box: x1, y1, x2, y2, x3, y3, x4, y4.

AREA

public static final FaceDetectorFeatures AREA

Get the relative area of each detected face (normalised by the image area). The returned feature is a 1D DoubleFV with each element corresponding to an individual face detection.

Method Detail

values

public static FaceDetectorFeatures[] values()

Returns an array containing the constants of this enum type, in the order they are declared. This method may be used to iterate over the constants as follows:

for (FaceDetectorFeatures c : FaceDetectorFeatures.values())
    System.out.println(c);

Returns:

an array containing the constants of this enum type, in the order they are declared

valueOf

public static FaceDetectorFeatures valueOf(String name)

Returns the enum constant of this type with the specified name. The string must match exactly an identifier used to declare an enum constant in this type. (Extraneous whitespace characters are not permitted.)

Parameters:

name - the name of the enum constant to be returned.

Returns:

the enum constant with the specified name

Throws:

IllegalArgumentException - if this enum type has no constant with the specified name

NullPointerException - if the argument is null

getConnectedComponent

protected ConnectedComponent getConnectedComponent(DetectedFace df)

getFeatureVector

public abstract <T extends Image<?,T>> FeatureVector getFeatureVector(List<? extends DetectedFace> faces,
                                                                      T img)

Compute a feature vector describing the detections.

Type Parameters:

T - Type of Image

Parameters:

faces - The detected faces.

img - The image the faces were detected from.

Returns:

a feature vector.