Documentation for this section has not yet been entered.
List of metering areas to use for auto-focus.
Not available if CameraCharacteristics.ControlMaxRegionsAf is 0. Otherwise will always be present.
The maximum number of focus areas supported by the device is determined by the value of CameraCharacteristics.ControlMaxRegionsAf.
The coordinate system is based on the active pixel array, with (0,0) being the top-left pixel in the active pixel array, and (CameraCharacteristics.SensorInfoActiveArraySize.width - 1, CameraCharacteristics.SensorInfoActiveArraySize.height - 1) being the bottom-right pixel in the active pixel array.
The weight must be within [0, 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 partially overlap and the camera device will add the weights in the overlap region.
The weights are relative to weights of other metering regions, so if only one region is used, all non-zero weights will have the same effect. A region with 0 weight is ignored.
If all regions have 0 weight, then no specific metering area needs to be used by the camera device.
If the metering region is outside the used CaptureRequest.ScalerCropRegion returned in capture result metadata, the camera device will ignore the sections outside the crop region and output only the intersection rectangle as the metering region in the result metadata. If the region is entirely outside the crop region, it will be ignored and not reported in the result metadata.
Units: Pixel coordinates within CameraCharacteristics.SensorInfoActiveArraySize
Range of valid values:
Coordinates must be between [(0,0), (width, height)) of
CameraCharacteristics.SensorInfoActiveArraySize
Optional - This value may be null on some devices.