android.hardware.camera2
API for new
applications.@Deprecated public static class Camera.Area extends Object
The Area class is used for choosing specific metering and focus areas for the camera to use when calculating auto-exposure, auto-white balance, and auto-focus.
To find out how many simultaneous areas a given camera supports, use
Camera.Parameters.getMaxNumMeteringAreas()
and
Camera.Parameters.getMaxNumFocusAreas()
. If metering or focusing area
selection is unsupported, these methods will return 0.
Each Area consists of a rectangle specifying its bounds, and a weight that determines its importance. The bounds are relative to the camera's current field of view. The coordinates are mapped so that (-1000, -1000) is always the top-left corner of the current field of view, and (1000, 1000) is always the bottom-right corner of the current field of view. Setting Areas with bounds outside that range is not allowed. Areas with zero or negative width or height are not allowed.
The weight must range from 1 to 1000, and represents a weight for every pixel in the area. This means that a large metering area with the same weight as a smaller area will have more effect in the metering result. Metering areas can overlap and the driver will add the weights in the overlap region.
Modifier and Type | Field and Description |
---|---|
Rect |
rect
Deprecated.
Bounds of the area. (-1000, -1000) represents the top-left of the
camera field of view, and (1000, 1000) represents the bottom-right of
the field of view.
|
int |
weight
Deprecated.
Weight of the area.
|
Constructor and Description |
---|
Area(Rect rect,
int weight)
Deprecated.
Create an area with specified rectangle and weight.
|
Modifier and Type | Method and Description |
---|---|
boolean |
equals(Object obj)
Deprecated.
Compares
obj to this area. |
public Rect rect
public int weight
public Area(Rect rect, int weight)
rect
- the bounds of the area.weight
- the weight of the area.public boolean equals(Object obj)
obj
to this area.equals
in class Object
obj
- the object to compare this area with.true
if the rectangle and weight of obj
is
the same as those of this area. false
otherwise.Object.hashCode()
,
HashMap