# Print output for @column tags ?>
Developers

- Design
- Develop
- Distribute

Developer Console

## Most visited

## Recently visited

## Results for

Summary: Fields | Ctors | Inherited Methods

# Camera.Face

`public static class Camera.Face`
`extends Object` ``

java.lang.Object
↳ | android.hardware.Camera.Face

This class is deprecated.
We recommend using the new `android.hardware.camera2` API for new applications.

Information about a face identified through camera face detection.

When face detection is used with a camera, the `FaceDetectionListener` returns a list of face objects for use in focusing and metering.

See also:

- `Camera.FaceDetectionListener`

## Summary

### Fields
`public int` | `id` An unique id per face while the face is visible to the tracker.
`public Point` | `leftEye` The coordinates of the center of the left eye.
`public Point` | `mouth` The coordinates of the center of the mouth.
`public Rect` | `rect` Bounds of the face.
`public Point` | `rightEye` The coordinates of the center of the right eye.
`public int` | `score` The confidence level for the detection of the face.

### Public constructors
`Face()` Create an empty face.

### Inherited methods
From class `java.lang.Object`
`Object` | `clone()` Creates and returns a copy of this object.
`boolean` | `equals(Object obj)` Indicates whether some other object is "equal to" this one.
`void` | `finalize()` Called by the garbage collector on an object when garbage collection determines that there are no more references to the object.
`final Class<?>` | `getClass()` Returns the runtime class of this `Object`.
`int` | `hashCode()` Returns a hash code value for the object.
`final void` | `notify()` Wakes up a single thread that is waiting on this object's monitor.
`final void` | `notifyAll()` Wakes up all threads that are waiting on this object's monitor.
`String` | `toString()` Returns a string representation of the object.
`final void` | `wait(long timeout, int nanos)` Causes the current thread to wait until another thread invokes the `notify()` method or the `notifyAll()` method for this object, or some other thread interrupts the current thread, or a certain amount of real time has elapsed.
`final void` | `wait(long timeout)` Causes the current thread to wait until either another thread invokes the `notify()` method or the `notifyAll()` method for this object, or a specified amount of time has elapsed.
`final void` | `wait()` Causes the current thread to wait until another thread invokes the `notify()` method or the `notifyAll()` method for this object.

## Fields

### id

    public int id

An unique id per face while the face is visible to the tracker. If the face leaves the field-of-view and comes back, it will get a new id. This is an optional field, may not be supported on all devices. If not supported, id will always be set to -1. The optional fields are supported as a set. Either they are all valid, or none of them are.

### leftEye

    public Point leftEye

The coordinates of the center of the left eye. The coordinates are in the same space as the ones for `rect`. This is an optional field, may not be supported on all devices. If not supported, the value will always be set to null. The optional fields are supported as a set. Either they are all valid, or none of them are.

### mouth

    public Point mouth

The coordinates of the center of the mouth. The coordinates are in the same space as the ones for `rect`. This is an optional field, may not be supported on all devices. If not supported, the value will always be set to null. The optional fields are supported as a set. Either they are all valid, or none of them are.

### rect

    public Rect rect

Bounds of the face. (-1000, -1000) represents the top-left of the camera field of view, and (1000, 1000) represents the bottom-right of the field of view. For example, suppose the size of the viewfinder UI is 800x480. The rect passed from the driver is (-1000, -1000, 0, 0). The corresponding viewfinder rect should be (0, 0, 400, 240). It is guaranteed left < right and top < bottom. The coordinates can be smaller than -1000 or bigger than 1000. But at least one vertex will be within (-1000, -1000) and (1000, 1000).

The direction is relative to the sensor orientation, that is, what the sensor sees. The direction is not affected by the rotation or mirroring of `Camera.setDisplayOrientation(int)`. The face bounding rectangle does not provide any information about face orientation.

Here is the matrix to convert driver coordinates to View coordinates in pixels.

     Matrix matrix = new Matrix();
     CameraInfo info = CameraHolder.instance().getCameraInfo()[cameraId];
     // Need mirror for front camera.
     boolean mirror = (info.facing == CameraInfo.CAMERA_FACING_FRONT);
     matrix.setScale(mirror ? -1 : 1, 1);
     // This is the value for android.hardware.Camera.setDisplayOrientation.
     matrix.postRotate(displayOrientation);
     // Camera driver coordinates range from (-1000, -1000) to (1000, 1000).
     // UI coordinates range from (0, 0) to (width, height).
     matrix.postScale(view.getWidth() / 2000f, view.getHeight() / 2000f);
     matrix.postTranslate(view.getWidth() / 2f, view.getHeight() / 2f);

See also:

- `Camera.startFaceDetection()`

### rightEye

    public Point rightEye

The coordinates of the center of the right eye. The coordinates are in the same space as the ones for `rect`.This is an optional field, may not be supported on all devices. If not supported, the value will always be set to null. The optional fields are supported as a set. Either they are all valid, or none of them are.

### score

    public int score

The confidence level for the detection of the face. The range is 1 to 100. 100 is the highest confidence.

Depending on the device, even very low-confidence faces may be listed, so applications should filter out faces with low confidence, depending on the use case. For a typical point-and-shoot camera application that wishes to display rectangles around detected faces, filtering out faces with confidence less than 50 is recommended.

See also:

- `Camera.startFaceDetection()`

## Public constructors

### Face

    public Face ()

Create an empty face.

Full name *
Email address *
Company / developer name
One of your Play Store app URLs *
Which best describes your business:*
Apps
Games
Apps & Games
*
*