Build 1.0_r1(from source)

android.media
Class FaceDetector

java.lang.Object
  extended by 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.

Build 1.0_r1(from source)

Please submit a feedback, bug or feature