Google is committed to advancing racial equity for Black communities. See how.

Landmark

public final class Landmark extends Object

A point on a detected face, such as an eye, nose, or mouth.

When 'left' and 'right' are used, they are relative to the subject. For example, the LEFT_EYE landmark is the subject's left eye, not the eye that is on the left when viewing the image.

Constant Summary

int BOTTOM_MOUTH The center of the subject's bottom lip.
int LEFT_CHEEK The midpoint between the subject's left mouth corner and the outer corner of the subject's left eye.
int LEFT_EAR The midpoint of the subject's left ear tip and left ear lobe.
int LEFT_EAR_TIP Treating the top of the subject's left ear as a circle, this is the point at 45 degrees around the circle in Cartesian coordinates.
int LEFT_EYE The center of the subject's left eye cavity.
int LEFT_MOUTH The subject's left mouth corner where the lips meet.
int NOSE_BASE The midpoint between the subject's nostrils where the nose meets the face.
int RIGHT_CHEEK The midpoint between the subject's right mouth corner and the outer corner of the subject's right eye.
int RIGHT_EAR The midpoint of the subject's right ear tip and right ear lobe.
int RIGHT_EAR_TIP Treating the top of the subject's right ear as a circle, this is the point at 135 degrees around the circle in Cartesian coordinates.
int RIGHT_EYE The center of the subject's right eye cavity.
int RIGHT_MOUTH The subject's right mouth corner where the lips meet.

Public Method Summary

PointF
getPosition()
Returns the (x, y) position of the landmark where (0, 0) is the upper-left corner of the image.
int
getType()
Returns the type of landmark (LEFT_EYE, RIGHT_EYE, NOSE_BASE, etc.).

Inherited Method Summary

Constants

public static final int BOTTOM_MOUTH

The center of the subject's bottom lip.

Constant Value: 0

public static final int LEFT_CHEEK

The midpoint between the subject's left mouth corner and the outer corner of the subject's left eye. For full profile faces, this becomes the centroid of the nose base, nose tip, left ear lobe and left ear tip.

Constant Value: 1

public static final int LEFT_EAR

The midpoint of the subject's left ear tip and left ear lobe.

Constant Value: 3

public static final int LEFT_EAR_TIP

Treating the top of the subject's left ear as a circle, this is the point at 45 degrees around the circle in Cartesian coordinates.

Constant Value: 2

public static final int LEFT_EYE

The center of the subject's left eye cavity.

Constant Value: 4

public static final int LEFT_MOUTH

The subject's left mouth corner where the lips meet.

Constant Value: 5

public static final int NOSE_BASE

The midpoint between the subject's nostrils where the nose meets the face.

Constant Value: 6

public static final int RIGHT_CHEEK

The midpoint between the subject's right mouth corner and the outer corner of the subject's right eye. For full profile faces, this becomes the centroid of the nose base, nose tip, right ear lobe and right ear tip.

Constant Value: 7

public static final int RIGHT_EAR

The midpoint of the subject's right ear tip and right ear lobe.

Constant Value: 9

public static final int RIGHT_EAR_TIP

Treating the top of the subject's right ear as a circle, this is the point at 135 degrees around the circle in Cartesian coordinates.

Constant Value: 8

public static final int RIGHT_EYE

The center of the subject's right eye cavity.

Constant Value: 10

public static final int RIGHT_MOUTH

The subject's right mouth corner where the lips meet.

Constant Value: 11

Public Methods

public PointF getPosition ()

Returns the (x, y) position of the landmark where (0, 0) is the upper-left corner of the image. The point is guaranteed to be within the bounds of the image.

Returns
  • the position of the landmark

public int getType ()

Returns the type of landmark (LEFT_EYE, RIGHT_EYE, NOSE_BASE, etc.).

Returns
  • the type of landmark