public class

FaceDetector.Face

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

Class Overview

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.
[Expand]
Inherited Methods
From class java.lang.Object

Constants

public static final float CONFIDENCE_THRESHOLD

Since: API Level 1

The minimum confidence factor of good face recognition

Constant Value: 0.4

public static final int EULER_X

Since: API Level 1

The x-axis Euler angle of a face.

Constant Value: 0 (0x00000000)

public static final int EULER_Y

Since: API Level 1

The y-axis Euler angle of a face.

Constant Value: 1 (0x00000001)

public static final int EULER_Z

Since: API Level 1

The z-axis Euler angle of a face.

Constant Value: 2 (0x00000002)

Public Methods

public float confidence ()

Since: API Level 1

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.

public float eyesDistance ()

Since: API Level 1

Returns the distance between the eyes.

public void getMidPoint (PointF point)

Since: API Level 1

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

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

public float pose (int euler)

Since: API Level 1

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 the Euler axis to retrieve an angle from (EULER_X, EULER_Y or EULER_Z)
Returns
  • the Euler angle of the of the face, for the given axis