android.media
public
class
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
Public Methods
Protected Methods
clone,
equals,
finalize,
getClass,
hashCode,
notify,
notifyAll,
toString,
wait,
wait,
wait
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.