Camera: Update documentation for AF_REGIONS metadata

Allow AF_REGIONS in capture result to have non-0 weight if the app sets a
0-weight AF_REGIONS. This is for the case where camera HAL decides what
AF regions are used internally.

Test: Compile
Bug: 29398609
Change-Id: Ia5b4ecabb1493110e26b7476c3574bf8570d88b0

diff --git a/camera/docs/docs.html b/camera/docs/docs.html
index 5c53635..5213868 100644 (file)
--- a/camera/docs/docs.html
+++ b/camera/docs/docs.html
@@ -3075,7 +3075,8 @@ camera device will add the weights in the overlap region.<wbr/></p>
 is used,<wbr/> all non-zero weights will have the same effect.<wbr/> A region with 0 weight is
 ignored.<wbr/></p>
 <p>If all regions have 0 weight,<wbr/> then no specific metering area needs to be used by the
-camera device.<wbr/></p>
+camera device.<wbr/> The capture result will either be a zero weight region as well,<wbr/> or
+the region selected by the camera device as the focus area of interest.<wbr/></p>
 <p>If the metering region is outside the used <a href="#controls_android.scaler.cropRegion">android.<wbr/>scaler.<wbr/>crop<wbr/>Region</a> returned in
 capture result metadata,<wbr/> the camera device will ignore the sections outside the crop
 region and output only the intersection rectangle as the metering region in the result
@@ -7280,7 +7281,8 @@ camera device will add the weights in the overlap region.<wbr/></p>
 is used,<wbr/> all non-zero weights will have the same effect.<wbr/> A region with 0 weight is
 ignored.<wbr/></p>
 <p>If all regions have 0 weight,<wbr/> then no specific metering area needs to be used by the
-camera device.<wbr/></p>
+camera device.<wbr/> The capture result will either be a zero weight region as well,<wbr/> or
+the region selected by the camera device as the focus area of interest.<wbr/></p>
 <p>If the metering region is outside the used <a href="#controls_android.scaler.cropRegion">android.<wbr/>scaler.<wbr/>crop<wbr/>Region</a> returned in
 capture result metadata,<wbr/> the camera device will ignore the sections outside the crop
 region and output only the intersection rectangle as the metering region in the result

diff --git a/camera/docs/metadata_definitions.xml b/camera/docs/metadata_definitions.xml
index 1800dab..58c5b9f 100644 (file)
--- a/camera/docs/metadata_definitions.xml
+++ b/camera/docs/metadata_definitions.xml
@@ -993,7 +993,8 @@ xsi:schemaLocation="http://schemas.android.com/service/camera/metadata/ metadata
               ignored.
 
               If all regions have 0 weight, then no specific metering area needs to be used by the
-              camera device.
+              camera device. The capture result will either be a zero weight region as well, or
+              the region selected by the camera device as the focus area of interest.
 
               If the metering region is outside the used android.scaler.cropRegion returned in
               capture result metadata, the camera device will ignore the sections outside the crop