camera_metadata: Update sceneFlicker tag spec
Change-Id: I1dac4109848b7514d94858ca29d786585d422e97
diff --git a/camera/docs/docs.html b/camera/docs/docs.html
index e6ae2c5..60013d3 100644
--- a/camera/docs/docs.html
+++ b/camera/docs/docs.html
@@ -13810,8 +13810,8 @@
</td> <!-- entry_type -->
<td class="entry_description">
- <p>The HAL estimated scene illumination lighting
-frequency</p>
+ <p>The camera device estimated scene illumination lighting
+frequency.<wbr/></p>
</td>
<td class="entry_units">
@@ -13829,8 +13829,18 @@
</tr>
<tr class="entry_cont">
<td class="entry_details" colspan="5">
- <p>Report NONE if there doesn't appear to be flickering
-illumination</p>
+ <p>Many light sources,<wbr/> such as most fluorescent lights,<wbr/> flicker at a rate
+that depends on the local utility power standards.<wbr/> This flicker must be
+accounted for by auto-exposure routines to avoid artifacts in captured images.<wbr/>
+The camera device uses this entry to tell the application what the scene
+illuminant frequency is.<wbr/></p>
+<p>When manual exposure control is enabled
+(<code><a href="#controls_android.control.aeMode">android.<wbr/>control.<wbr/>ae<wbr/>Mode</a> == OFF</code> or <code><a href="#controls_android.control.mode">android.<wbr/>control.<wbr/>mode</a> == OFF</code>),<wbr/>
+the <a href="#controls_android.control.aeAntibandingMode">android.<wbr/>control.<wbr/>ae<wbr/>Antibanding<wbr/>Mode</a> doesn't do the antibanding,<wbr/> and the
+application can ensure it selects exposure times that do not cause banding
+issues by looking into this metadata field.<wbr/> See android.<wbr/>control.<wbr/>ae<wbr/>Antibanding<wbr/>Mode
+for more details.<wbr/></p>
+<p>Report NONE if there doesn't appear to be flickering illumination.<wbr/></p>
</td>
</tr>
diff --git a/camera/docs/metadata_properties.xml b/camera/docs/metadata_properties.xml
index 44167cb..870a68d 100644
--- a/camera/docs/metadata_properties.xml
+++ b/camera/docs/metadata_properties.xml
@@ -3776,10 +3776,24 @@
<value>50HZ</value>
<value>60HZ</value>
</enum>
- <description>The HAL estimated scene illumination lighting
- frequency</description>
- <details>Report NONE if there doesn't appear to be flickering
- illumination</details>
+ <description>The camera device estimated scene illumination lighting
+ frequency.</description>
+ <details>
+ Many light sources, such as most fluorescent lights, flicker at a rate
+ that depends on the local utility power standards. This flicker must be
+ accounted for by auto-exposure routines to avoid artifacts in captured images.
+ The camera device uses this entry to tell the application what the scene
+ illuminant frequency is.
+
+ When manual exposure control is enabled
+ (`android.control.aeMode == OFF` or `android.control.mode == OFF`),
+ the android.control.aeAntibandingMode doesn't do the antibanding, and the
+ application can ensure it selects exposure times that do not cause banding
+ issues by looking into this metadata field. See android.control.aeAntibandingMode
+ for more details.
+
+ Report NONE if there doesn't appear to be flickering illumination.
+ </details>
</entry>
</dynamic>
<controls>