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

Class FacialKeypoint

java.lang.Object

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

All Implemented Interfaces:

ReadableBinary, ReadWriteableBinary, WriteableBinary

Direct Known Subclasses:

FacePatchFeature.DetectedFacePart

public class FacialKeypoint
extends Object
implements ReadWriteableBinary

A FacialKeypoint represents a keypoint on a face. Keypoints are representative points found on all faces.

Keypoint types are based on Mark Everingham's Oxford VGG Baseline Face Processing Code

Author:

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

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	FacialKeypoint.FacialKeypointType Types/locations of FacialKeypoint.

Field Summary

Fields

Modifier and Type	Field and Description
Point2dImpl	position The position of the keypoint in the image
FacialKeypoint.FacialKeypointType	type The type of facial keypoint

Constructor Summary

Constructors

Constructor and Description
FacialKeypoint() Default constructor.
FacialKeypoint(FacialKeypoint.FacialKeypointType type) Construct a FacialKeypoint at the origin with the specified type.
FacialKeypoint(FacialKeypoint.FacialKeypointType type, Point2d pt) Construct a FacialKeypoint with the specified type and position.

Method Summary

Modifier and Type	Method and Description
byte[]	binaryHeader() Header for binary input.
static FacialKeypoint	getKeypoint(FacialKeypoint[] pts, FacialKeypoint.FacialKeypointType type) Search the given points for the a keypoint with the specified type and return it.
void	readBinary(DataInput in) Read internal state from in.
protected static void	updateImagePosition(FacialKeypoint[] kpts, Jama.Matrix transform)
protected void	updatePosition(Jama.Matrix transform)
void	writeBinary(DataOutput out) Write the content of this as binary to out.

Methods inherited from class java.lang.Object

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

Field Detail

type

public FacialKeypoint.FacialKeypointType type

The type of facial keypoint

position

public Point2dImpl position

The position of the keypoint in the image

Constructor Detail

FacialKeypoint

public FacialKeypoint()

Default constructor. Sets type to FacialKeypoint.FacialKeypointType.EYE_LEFT_CENTER and position to the origin.

FacialKeypoint

public FacialKeypoint(FacialKeypoint.FacialKeypointType type)

Construct a FacialKeypoint at the origin with the specified type.

Parameters:

type - the type of facial keypoint

FacialKeypoint

public FacialKeypoint(FacialKeypoint.FacialKeypointType type,
                      Point2d pt)

Construct a FacialKeypoint with the specified type and position.

Parameters:

type - the type of facial keypoint

pt - the position in the image of the facial keypoint

Method Detail

updatePosition

protected void updatePosition(Jama.Matrix transform)

updateImagePosition

protected static void updateImagePosition(FacialKeypoint[] kpts,
                                          Jama.Matrix transform)

getKeypoint

public static FacialKeypoint getKeypoint(FacialKeypoint[] pts,
                                         FacialKeypoint.FacialKeypointType type)

Search the given points for the a keypoint with the specified type and return it.

Parameters:

pts - the points to search

type - the type of facial keypoint

Returns:

the selected keypoint; or null if not found

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