Please note that the contents of this offline web site may be out of date. To access the most recent documentation visit the online version .
Note that links that point to online resources are green in color and will open in a new window.
We would love it if you could give us feedback about this material by filling this form (You have to be online to fill it)
Android APIs
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

Added in API level 1

The minimum confidence factor of good face recognition

Constant Value: 0.4

public static final int EULER_X

Added in API level 1

The x-axis Euler angle of a face.

Constant Value: 0 (0x00000000)

public static final int EULER_Y

Added in API level 1

The y-axis Euler angle of a face.

Constant Value: 1 (0x00000001)

public static final int EULER_Z

Added in API level 1

The z-axis Euler angle of a face.

Constant Value: 2 (0x00000002)

Public Methods

public float confidence ()

Added in 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 ()

Added in API level 1

Returns the distance between the eyes.

public void getMidPoint ( PointF point)

Added in 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)

Added in 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