to top
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

? Examples
float confidence()
Returns a confidence factor between 0 and 1.

? Examples
float eyesDistance()
Returns the distance between the eyes.

? Examples
void getMidPoint( PointF point)
Sets the position of the mid-point between the eyes.

? Examples
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
No examples for this method.
Frequently called with: [Clear]
Portions of this page are reproduced from work created and shared by the Android Open Source Project and used according to terms described in the Creative Commons 2.5 Attribution License. The original page is available here.