lightbulb_outline Help shape the future of the Google Play Console, Android Studio, and Firebase. Start survey

FaceDetector.Face

public class FaceDetector.Face
extends Object

java.lang.Object
   ↳ android.media.FaceDetector.Face


A Face contains all the information identifying the location of a face in a bitmap.

Summary

Constants

float CONFIDENCE_THRESHOLD

The minimum confidence factor of good face recognition

int EULER_X

The x-axis Euler angle of a face.

int EULER_Y

The y-axis Euler angle of a face.

int EULER_Z

The z-axis Euler angle of a face.

Public methods

float confidence()

Returns a confidence factor between 0 and 1.

float eyesDistance()

Returns the distance between the eyes.

void getMidPoint(PointF point)

Sets the position of the mid-point between the eyes.

float pose(int euler)

Returns the face's pose.

Inherited methods

Constants

CONFIDENCE_THRESHOLD

added in API level 1
public static final float CONFIDENCE_THRESHOLD

The minimum confidence factor of good face recognition

Constant Value: 0.4

EULER_X

added in API level 1
public static final int EULER_X

The x-axis Euler angle of a face.

Constant Value: 0 (0x00000000)

EULER_Y

added in API level 1
public static final int EULER_Y

The y-axis Euler angle of a face.

Constant Value: 1 (0x00000001)

EULER_Z

added in API level 1
public static final int EULER_Z

The z-axis Euler angle of a face.

Constant Value: 2 (0x00000002)

Public methods

confidence

added in API level 1
public float confidence ()

Returns a confidence factor between 0 and 1. This indicates how certain what has been found is actually a face. A confidence factor above 0.3 is usually good enough.

Returns
float

eyesDistance

added in API level 1
public float eyesDistance ()

Returns the distance between the eyes.

Returns
float

getMidPoint

added in API level 1
public void getMidPoint (PointF point)

Sets the position of the mid-point between the eyes.

Parameters
point PointF: the PointF coordinates (float values) of the face's mid-point

pose

added in API level 1
public float pose (int euler)

Returns the face's pose. That is, the rotations around either the X, Y or Z axis (the positions in 3-dimensional Euclidean space).

Parameters
euler int: the Euler axis to retrieve an angle from (EULER_X, EULER_Y or EULER_Z)

Returns
float the Euler angle of the of the face, for the given axis