Android
android.media
public class

android.media.FaceDetector

java.lang.Object
android.media.FaceDetector

Identifies the faces of people in a Bitmap graphic object.

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

Summary

Public Constructors

            FaceDetector(int width, int height, int maxFaces)
Creates a FaceDetector, configured with the size of the images to be analysed and the maximum number of faces that can be detected.

Public Methods

          int  findFaces(Bitmap bitmap, Face[] faces)
Finds all the faces found in a given Bitmap.

Protected Methods

          void  finalize()
Called by the virtual machine when there are no longer any (non-weak) references to the receiver.
Methods inherited from class java.lang.Object

Details

Public Constructors

public FaceDetector(int width, int height, int maxFaces)

Creates a FaceDetector, configured with the size of the images to be analysed and the maximum number of faces that can be detected. These parameters cannot be changed once the object is constructed.

Parameters

width the width of the image
height the height of the image
maxFaces the maximum number of faces to identify

Public Methods

public int findFaces(Bitmap bitmap, Face[] faces)

Finds all the faces found in a given Bitmap. The supplied array is populated with FaceDetector.Faces for each face found. The bitmap must be in 565 format (for now).

Parameters

bitmap the Bitmap graphic to be analyzed
faces an array in which to place all found FaceDetector.Faces. The array must be sized equal to the maxFaces value set at initialization

Returns

  • the number of faces found

Throws

IllegalArgumentException if the Bitmap dimensions don't match the dimensions defined at initialization or the given array is not sized equal to the maxFaces value defined at initialization

Protected Methods

protected void finalize()

Called by the virtual machine when there are no longer any (non-weak) references to the receiver. Subclasses can use this facility to guarantee that any associated resources are cleaned up before the receiver is garbage collected. Uncaught exceptions which are thrown during the running of the method cause it to terminate immediately, but are otherwise ignored.

Note: The virtual machine assumes that the implementation in class Object is empty.

Throws

Throwable
Copyright 2007 Google Inc. Build 0.9_r1-98467 - 14 Aug 2008 18:56