android.media
Class FaceDetector

java.lang.Object
  android.media.FaceDetector

public class FaceDetector
extends Object

Identifies the faces of people in a Bitmap graphic object.

Nested Class Summary

class

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

Constructor Summary

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.

Method Summary

protected void	finalize() Called by the virtual machine when there are no longer any (non-weak) references to the receiver.
int	findFaces(Bitmap bitmap, FaceDetector.Face[] faces) Finds all the faces found in a given Bitmap.

Methods inherited from class java.lang.Object

clone, equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

FaceDetector

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

Method Detail

findFaces

public int findFaces(Bitmap bitmap,
                     FaceDetector.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

finalize

protected void finalize()
                 throws Throwable

Description copied from class: Object

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.

Overrides:

finalize in class Object

Throws:

Throwable - The virtual machine ignores any exceptions which are thrown during finalization.