org.openimaj.image.processing.face.detection.keypoints

Class FKEFaceDetector

java.lang.Object

org.openimaj.image.processing.face.detection.keypoints.FKEFaceDetector

All Implemented Interfaces:

FaceDetector<KEDetectedFace,FImage>, ReadableBinary, ReadWriteableBinary, WriteableBinary

@Reference(type=Inproceedings,
           author={"Mark Everingham","Josef Sivic","Andrew Zisserman"},
           title="Hello! My name is... Buffy - Automatic naming of characters in TV video",
           year="2006",
           booktitle="In BMVC")
public class FKEFaceDetector
extends Object
implements FaceDetector<KEDetectedFace,FImage>

F(rontal)K(eypoint)E(nriched)FaceDetector uses an underlying face detector to detect frontal faces in an image, and then looks for facial keypoints within the detections.

Implementation and data is based on Mark Everingham's Oxford VGG Baseline Face Processing Code

Author:

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

Field Summary

Fields

Modifier and Type	Field and Description
protected FaceDetector<? extends DetectedFace,FImage>	faceDetector
protected FacialKeypointExtractor	facialKeypointExtractor

Constructor Summary

Constructors

Constructor and Description
FKEFaceDetector() Default constructor.
FKEFaceDetector(FaceDetector<? extends DetectedFace,FImage> detector) Construct with the given underlying (frontal) face detector.
FKEFaceDetector(FaceDetector<? extends DetectedFace,FImage> detector, float patchScale) Construct with the given underlying (frontal) face detector, and the given scale-factor for extracting the face patch.
FKEFaceDetector(float patchScale) Default constructor.
FKEFaceDetector(int size) Construct with a standard HaarCascadeDetector and the given minimum search size.
FKEFaceDetector(int size, float patchScale) Construct with a standard HaarCascadeDetector and the given minimum search size, and the given scale-factor for extracting the face patch.

Method Summary

Modifier and Type	Method and Description
byte[]	binaryHeader() Header for binary input.
List<KEDetectedFace>	detectFaces(FImage image) Detect faces in the image and return a list of faces found.
static FImage	extractPatch(FImage image, Jama.Matrix transform, int size, int border) Extract a patch from the image based on the parameters.
int	hashCode()
static FImage	pyramidResize(FImage image, Jama.Matrix transform) Resize the image using a pyramid.
void	readBinary(DataInput in) Read internal state from in.
String	toString()
void	writeBinary(DataOutput out) Write the content of this as binary to out.

Methods inherited from class java.lang.Object

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

Field Detail

faceDetector

protected FaceDetector<? extends DetectedFace,FImage> faceDetector

facialKeypointExtractor

protected FacialKeypointExtractor facialKeypointExtractor

Constructor Detail

FKEFaceDetector

public FKEFaceDetector()

Default constructor. Uses the standard HaarCascadeDetector with a minimum search size of 80 pixels.

FKEFaceDetector

public FKEFaceDetector(int size)

Construct with a standard HaarCascadeDetector and the given minimum search size.

Parameters:

size - minimum detection size.

FKEFaceDetector

public FKEFaceDetector(float patchScale)

Default constructor. Uses the standard HaarCascadeDetector with a minimum search size of 80 pixels, and the given scale-factor for extracting the face patch.

Parameters:

patchScale - the scale of the patch compared to the patch extracted by the internal detector.

FKEFaceDetector

public FKEFaceDetector(int size,
                       float patchScale)

Construct with a standard HaarCascadeDetector and the given minimum search size, and the given scale-factor for extracting the face patch.

Parameters:

patchScale - the scale of the patch compared to the patch extracted by the internal detector.

size - minimum detection size.

FKEFaceDetector

public FKEFaceDetector(FaceDetector<? extends DetectedFace,FImage> detector)

Construct with the given underlying (frontal) face detector.

Parameters:

detector - the face detector.

FKEFaceDetector

public FKEFaceDetector(FaceDetector<? extends DetectedFace,FImage> detector,
                       float patchScale)

Construct with the given underlying (frontal) face detector, and the given scale-factor for extracting the face patch.

Parameters:

patchScale - the scale of the patch compared to the patch extracted by the internal detector.

detector - the face detector.

Method Detail

pyramidResize

public static FImage pyramidResize(FImage image,
                                   Jama.Matrix transform)

Resize the image using a pyramid.

Parameters:

image - the image

transform - the resize transform

Returns:

the resized image

extractPatch

public static FImage extractPatch(FImage image,
                                  Jama.Matrix transform,
                                  int size,
                                  int border)

Extract a patch from the image based on the parameters.

Parameters:

image - the image

transform - the transform

size - the patch size

border - the size of the border

Returns:

the patch

detectFaces

public List<KEDetectedFace> detectFaces(FImage image)

Description copied from interface: FaceDetector

Detect faces in the image and return a list of faces found.

Specified by:

detectFaces in interface FaceDetector<KEDetectedFace,FImage>

Parameters:

image - Image to search in

Returns:

List of detected faces.

hashCode

public int hashCode()

Overrides:

hashCode in class Object

readBinary

public void readBinary(DataInput in)
                throws IOException

Description copied from interface: ReadableBinary

Read internal state from in.

Specified by:

readBinary in interface ReadableBinary

Parameters:

in - source to read from.

Throws:

IOException - an error reading input

binaryHeader

public byte[] binaryHeader()

Description copied from interface: ReadableBinary

Header for binary input. Will be automatically read by IOUtils when using readBinary().

Specified by:

binaryHeader in interface ReadableBinary

Specified by:

binaryHeader in interface WriteableBinary

Returns:

header

writeBinary

public void writeBinary(DataOutput out)
                 throws IOException

Description copied from interface: WriteableBinary

Write the content of this as binary to out.

Specified by:

writeBinary in interface WriteableBinary

Parameters:

out - sink to write to

Throws:

IOException - an error writing to out

toString

public String toString()

Overrides:

toString in class Object