Gitiles
Code Review Sign In
gerrit-public.fairphone.software / platform / system / media / 12744b268f3e30de24c34962abc4f27943ebc447 / . / camera / docs / docs.html
blob: 306e920cb69573b32f35dfb7b0b68149d80bdf68 [file] [log] [blame]
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1<!DOCTYPE html>
2<html>
3<!-- Copyright (C) 2012 The Android Open Source Project
4
5 Licensed under the Apache License, Version 2.0 (the "License");
6 you may not use this file except in compliance with the License.
7 You may obtain a copy of the License at
8
9 http://www.apache.org/licenses/LICENSE-2.0
10
11 Unless required by applicable law or agreed to in writing, software
12 distributed under the License is distributed on an "AS IS" BASIS,
13 WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
14 See the License for the specific language governing permissions and
15 limitations under the License.
16-->
17<head>
18 <!-- automatically generated from html.mako. do NOT edit directly -->
19 <meta charset="utf-8" />
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]20 <title>Android Camera HAL3.0 Properties</title>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]21 <style type="text/css">
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]22 body { background-color: #f7f7f7; font-family: Roboto, sans-serif;}
23 h1 { color: #333333; }
24 h2 { color: #333333; }
25 a:link { color: #258aaf; text-decoration: none}
26 a:hover { color: #459aaf; text-decoration: underline }
27 a:visited { color: #154a5f; text-decoration: none}
28 .section { color: #eeeeee; font-size: 1.5em; font-weight: bold; background-color: #888888; padding: 0.5em 0em 0.5em 0.5em; border-width: thick thin thin thin; border-color: #111111 #777777 #777777 #777777}
29 .kind { color: #eeeeee; font-size: 1.2em; font-weight: bold; padding-left: 1.5em; background-color: #aaaaaa }
30 .entry { background-color: #f0f0f0 }
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]31 .entry_cont { background-color: #f0f0f0 }
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]32 .entries_header { background-color: #dddddd; text-align: center}
33
34 /* toc style */
35 .toc_section_header { font-size:1.3em; }
36 .toc_kind_header { font-size:1.2em; }
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]37
38 /* table column sizes */
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]39 table { border-collapse:collapse; table-layout: fixed; width: 100%; word-wrap: break-word }
40 td,th { border: 1px solid; border-color: #aaaaaa; padding-left: 0.5em; padding-right: 0.5em }
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]41 .th_name { width: 20% }
42 .th_units { width: 10% }
43 .th_tags { width: 5% }
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]44 .th_details { width: 25% }
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]45 .th_type { width: 20% }
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]46 .th_description { width: 20% }
47 .th_range { width: 10% }
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]48 td { font-size: 0.9em; }
49
50 /* hide the first thead, we need it there only to enforce column sizes */
51 .thead_dummy { visibility: hidden; }
52
53 /* Entry flair */
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]54 .entry_name { color: #333333; padding-left:1.0em; font-size:1.1em; font-family: monospace; vertical-align:top; }
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]55
56 /* Entry type flair */
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]57 .entry_type_name { font-size:1.1em; color: #669900; font-weight: bold;}
58 .entry_type_name_enum:after { color: #669900; font-weight: bold; content:" (enum)" }
59 .entry_type_visibility { font-weight: bolder; padding-left:1em}
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]60 .entry_type_enum_name { font-family: monospace; font-weight: bolder; }
61 .entry_type_enum_notes:before { content:" - " }
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]62 .entry_type_enum_notes>p:first-child { display:inline; }
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]63 .entry_type_enum_value:before { content:" = " }
64 .entry_type_enum_value { font-family: monospace; }
65 .entry ul { margin: 0 0 0 0; list-style-position: inside; padding-left: 0.5em; }
66 .entry ul li { padding: 0 0 0 0; margin: 0 0 0 0;}
67
68 /* Entry tags flair */
69 .entry_tags ul { list-style-type: none; }
70
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]71 /* Entry details (full docs) flair */
72 .entry_details_header { font-weight: bold; background-color: #dddddd;
73 text-align: center; font-size: 1.1em; margin-left: 0em; margin-right: 0em; }
74
75 /* Entry spacer flair */
76 .entry_spacer { background-color: transparent; border-style: none; height: 0.5em; }
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]77
78 /* TODO: generate abbr element for each tag link? */
79 /* TODO for each x.y.z try to link it to the entry */
80
81 </style>
82
83 <style>
84
85 {
86 /* broken...
87 supposedly there is a bug in chrome that it lays out tables before
88 it knows its being printed, so the page-break-* styles are ignored
89 */
90 tr { page-break-after: always; page-break-inside: avoid; }
91 }
92
93 </style>
94</head>
95
96
97
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]98<body>
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]99 <h1>Android Camera HAL3.0 Properties</h1>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]100
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]101
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]102 <h2>Table of Contents</h2>
103 <ul class="toc">
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]104 <li><a href="#tag_index" class="toc_section_header">Tags</a></li>
105 <li>
106 <span class="toc_section_header"><a href="#section_colorCorrection">colorCorrection</a></span>
107 <ul class="toc_section">
108 <li>
109 <span class="toc_kind_header">controls</span>
110 <ul class="toc_section">
111 <li><a href="#controls_android.colorCorrection.mode">android.colorCorrection.mode</a></li>
112 <li><a href="#controls_android.colorCorrection.transform">android.colorCorrection.transform</a></li>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]113 <li><a href="#controls_android.colorCorrection.gains">android.colorCorrection.gains</a></li>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]114 </ul>
115 </li>
116 <li>
117 <span class="toc_kind_header">dynamic</span>
118 <ul class="toc_section">
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]119 <li><a href="#dynamic_android.colorCorrection.transform">android.colorCorrection.transform</a></li>
120 <li><a href="#dynamic_android.colorCorrection.gains">android.colorCorrection.gains</a></li>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]121 </ul>
122 </li>
123 </ul> <!-- toc_section -->
124 </li>
125 <li>
126 <span class="toc_section_header"><a href="#section_control">control</a></span>
127 <ul class="toc_section">
128 <li>
129 <span class="toc_kind_header">controls</span>
130 <ul class="toc_section">
131 <li><a href="#controls_android.control.aeAntibandingMode">android.control.aeAntibandingMode</a></li>
132 <li><a href="#controls_android.control.aeExposureCompensation">android.control.aeExposureCompensation</a></li>
133 <li><a href="#controls_android.control.aeLock">android.control.aeLock</a></li>
134 <li><a href="#controls_android.control.aeMode">android.control.aeMode</a></li>
135 <li><a href="#controls_android.control.aeRegions">android.control.aeRegions</a></li>
136 <li><a href="#controls_android.control.aeTargetFpsRange">android.control.aeTargetFpsRange</a></li>
137 <li><a href="#controls_android.control.aePrecaptureTrigger">android.control.aePrecaptureTrigger</a></li>
138 <li><a href="#controls_android.control.afMode">android.control.afMode</a></li>
139 <li><a href="#controls_android.control.afRegions">android.control.afRegions</a></li>
140 <li><a href="#controls_android.control.afTrigger">android.control.afTrigger</a></li>
141 <li><a href="#controls_android.control.awbLock">android.control.awbLock</a></li>
142 <li><a href="#controls_android.control.awbMode">android.control.awbMode</a></li>
143 <li><a href="#controls_android.control.awbRegions">android.control.awbRegions</a></li>
144 <li><a href="#controls_android.control.captureIntent">android.control.captureIntent</a></li>
145 <li><a href="#controls_android.control.effectMode">android.control.effectMode</a></li>
146 <li><a href="#controls_android.control.mode">android.control.mode</a></li>
147 <li><a href="#controls_android.control.sceneMode">android.control.sceneMode</a></li>
148 <li><a href="#controls_android.control.videoStabilizationMode">android.control.videoStabilizationMode</a></li>
149 </ul>
150 </li>
151 <li>
152 <span class="toc_kind_header">static</span>
153 <ul class="toc_section">
154 <li><a href="#static_android.control.aeAvailableAntibandingModes">android.control.aeAvailableAntibandingModes</a></li>
155 <li><a href="#static_android.control.aeAvailableModes">android.control.aeAvailableModes</a></li>
156 <li><a href="#static_android.control.aeAvailableTargetFpsRanges">android.control.aeAvailableTargetFpsRanges</a></li>
157 <li><a href="#static_android.control.aeCompensationRange">android.control.aeCompensationRange</a></li>
158 <li><a href="#static_android.control.aeCompensationStep">android.control.aeCompensationStep</a></li>
159 <li><a href="#static_android.control.afAvailableModes">android.control.afAvailableModes</a></li>
160 <li><a href="#static_android.control.availableEffects">android.control.availableEffects</a></li>
161 <li><a href="#static_android.control.availableSceneModes">android.control.availableSceneModes</a></li>
162 <li><a href="#static_android.control.availableVideoStabilizationModes">android.control.availableVideoStabilizationModes</a></li>
163 <li><a href="#static_android.control.awbAvailableModes">android.control.awbAvailableModes</a></li>
164 <li><a href="#static_android.control.maxRegions">android.control.maxRegions</a></li>
165 <li><a href="#static_android.control.sceneModeOverrides">android.control.sceneModeOverrides</a></li>
166 </ul>
167 </li>
168 <li>
169 <span class="toc_kind_header">dynamic</span>
170 <ul class="toc_section">
171 <li><a href="#dynamic_android.control.aePrecaptureId">android.control.aePrecaptureId</a></li>
Eino-Ville Talvala9fa0d902014-01-08 16:16:53 -0800[diff] [blame]172 <li><a href="#dynamic_android.control.aeMode">android.control.aeMode</a></li>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]173 <li><a href="#dynamic_android.control.aeRegions">android.control.aeRegions</a></li>
174 <li><a href="#dynamic_android.control.aeState">android.control.aeState</a></li>
175 <li><a href="#dynamic_android.control.afMode">android.control.afMode</a></li>
176 <li><a href="#dynamic_android.control.afRegions">android.control.afRegions</a></li>
177 <li><a href="#dynamic_android.control.afState">android.control.afState</a></li>
178 <li><a href="#dynamic_android.control.afTriggerId">android.control.afTriggerId</a></li>
179 <li><a href="#dynamic_android.control.awbMode">android.control.awbMode</a></li>
180 <li><a href="#dynamic_android.control.awbRegions">android.control.awbRegions</a></li>
181 <li><a href="#dynamic_android.control.awbState">android.control.awbState</a></li>
182 <li><a href="#dynamic_android.control.mode">android.control.mode</a></li>
183 </ul>
184 </li>
185 </ul> <!-- toc_section -->
186 </li>
187 <li>
188 <span class="toc_section_header"><a href="#section_demosaic">demosaic</a></span>
189 <ul class="toc_section">
190 <li>
191 <span class="toc_kind_header">controls</span>
192 <ul class="toc_section">
193 <li><a href="#controls_android.demosaic.mode">android.demosaic.mode</a></li>
194 </ul>
195 </li>
196 </ul> <!-- toc_section -->
197 </li>
198 <li>
199 <span class="toc_section_header"><a href="#section_edge">edge</a></span>
200 <ul class="toc_section">
201 <li>
202 <span class="toc_kind_header">controls</span>
203 <ul class="toc_section">
204 <li><a href="#controls_android.edge.mode">android.edge.mode</a></li>
205 <li><a href="#controls_android.edge.strength">android.edge.strength</a></li>
206 </ul>
207 </li>
208 <li>
209 <span class="toc_kind_header">dynamic</span>
210 <ul class="toc_section">
211 <li><a href="#dynamic_android.edge.mode">android.edge.mode</a></li>
212 </ul>
213 </li>
214 </ul> <!-- toc_section -->
215 </li>
216 <li>
217 <span class="toc_section_header"><a href="#section_flash">flash</a></span>
218 <ul class="toc_section">
219 <li>
220 <span class="toc_kind_header">controls</span>
221 <ul class="toc_section">
222 <li><a href="#controls_android.flash.firingPower">android.flash.firingPower</a></li>
223 <li><a href="#controls_android.flash.firingTime">android.flash.firingTime</a></li>
224 <li><a href="#controls_android.flash.mode">android.flash.mode</a></li>
225 </ul>
226 </li>
227 <li>
228 <span class="toc_kind_header">static</span>
229 <ul class="toc_section">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]230
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]231 <li><a href="#static_android.flash.info.available">android.flash.info.available</a></li>
232 <li><a href="#static_android.flash.info.chargeDuration">android.flash.info.chargeDuration</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]233
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]234 <li><a href="#static_android.flash.colorTemperature">android.flash.colorTemperature</a></li>
235 <li><a href="#static_android.flash.maxEnergy">android.flash.maxEnergy</a></li>
236 </ul>
237 </li>
238 <li>
239 <span class="toc_kind_header">dynamic</span>
240 <ul class="toc_section">
241 <li><a href="#dynamic_android.flash.firingPower">android.flash.firingPower</a></li>
242 <li><a href="#dynamic_android.flash.firingTime">android.flash.firingTime</a></li>
243 <li><a href="#dynamic_android.flash.mode">android.flash.mode</a></li>
244 <li><a href="#dynamic_android.flash.state">android.flash.state</a></li>
245 </ul>
246 </li>
247 </ul> <!-- toc_section -->
248 </li>
249 <li>
250 <span class="toc_section_header"><a href="#section_geometric">geometric</a></span>
251 <ul class="toc_section">
252 <li>
253 <span class="toc_kind_header">controls</span>
254 <ul class="toc_section">
255 <li><a href="#controls_android.geometric.mode">android.geometric.mode</a></li>
256 <li><a href="#controls_android.geometric.strength">android.geometric.strength</a></li>
257 </ul>
258 </li>
259 </ul> <!-- toc_section -->
260 </li>
261 <li>
262 <span class="toc_section_header"><a href="#section_hotPixel">hotPixel</a></span>
263 <ul class="toc_section">
264 <li>
265 <span class="toc_kind_header">controls</span>
266 <ul class="toc_section">
267 <li><a href="#controls_android.hotPixel.mode">android.hotPixel.mode</a></li>
268 </ul>
269 </li>
270 <li>
271 <span class="toc_kind_header">static</span>
272 <ul class="toc_section">
273
274 <li><a href="#static_android.hotPixel.info.map">android.hotPixel.info.map</a></li>
275
276 </ul>
277 </li>
278 <li>
279 <span class="toc_kind_header">dynamic</span>
280 <ul class="toc_section">
281 <li><a href="#dynamic_android.hotPixel.mode">android.hotPixel.mode</a></li>
282 </ul>
283 </li>
284 </ul> <!-- toc_section -->
285 </li>
286 <li>
287 <span class="toc_section_header"><a href="#section_jpeg">jpeg</a></span>
288 <ul class="toc_section">
289 <li>
290 <span class="toc_kind_header">controls</span>
291 <ul class="toc_section">
292 <li><a href="#controls_android.jpeg.gpsCoordinates">android.jpeg.gpsCoordinates</a></li>
293 <li><a href="#controls_android.jpeg.gpsProcessingMethod">android.jpeg.gpsProcessingMethod</a></li>
294 <li><a href="#controls_android.jpeg.gpsTimestamp">android.jpeg.gpsTimestamp</a></li>
295 <li><a href="#controls_android.jpeg.orientation">android.jpeg.orientation</a></li>
296 <li><a href="#controls_android.jpeg.quality">android.jpeg.quality</a></li>
297 <li><a href="#controls_android.jpeg.thumbnailQuality">android.jpeg.thumbnailQuality</a></li>
298 <li><a href="#controls_android.jpeg.thumbnailSize">android.jpeg.thumbnailSize</a></li>
299 </ul>
300 </li>
301 <li>
302 <span class="toc_kind_header">static</span>
303 <ul class="toc_section">
304 <li><a href="#static_android.jpeg.availableThumbnailSizes">android.jpeg.availableThumbnailSizes</a></li>
305 <li><a href="#static_android.jpeg.maxSize">android.jpeg.maxSize</a></li>
306 </ul>
307 </li>
308 <li>
309 <span class="toc_kind_header">dynamic</span>
310 <ul class="toc_section">
311 <li><a href="#dynamic_android.jpeg.gpsCoordinates">android.jpeg.gpsCoordinates</a></li>
312 <li><a href="#dynamic_android.jpeg.gpsProcessingMethod">android.jpeg.gpsProcessingMethod</a></li>
313 <li><a href="#dynamic_android.jpeg.gpsTimestamp">android.jpeg.gpsTimestamp</a></li>
314 <li><a href="#dynamic_android.jpeg.orientation">android.jpeg.orientation</a></li>
315 <li><a href="#dynamic_android.jpeg.quality">android.jpeg.quality</a></li>
316 <li><a href="#dynamic_android.jpeg.size">android.jpeg.size</a></li>
317 <li><a href="#dynamic_android.jpeg.thumbnailQuality">android.jpeg.thumbnailQuality</a></li>
318 <li><a href="#dynamic_android.jpeg.thumbnailSize">android.jpeg.thumbnailSize</a></li>
319 </ul>
320 </li>
321 </ul> <!-- toc_section -->
322 </li>
323 <li>
324 <span class="toc_section_header"><a href="#section_lens">lens</a></span>
325 <ul class="toc_section">
326 <li>
327 <span class="toc_kind_header">controls</span>
328 <ul class="toc_section">
329 <li><a href="#controls_android.lens.aperture">android.lens.aperture</a></li>
330 <li><a href="#controls_android.lens.filterDensity">android.lens.filterDensity</a></li>
331 <li><a href="#controls_android.lens.focalLength">android.lens.focalLength</a></li>
332 <li><a href="#controls_android.lens.focusDistance">android.lens.focusDistance</a></li>
333 <li><a href="#controls_android.lens.opticalStabilizationMode">android.lens.opticalStabilizationMode</a></li>
334 </ul>
335 </li>
336 <li>
337 <span class="toc_kind_header">static</span>
338 <ul class="toc_section">
339
340 <li><a href="#static_android.lens.info.availableApertures">android.lens.info.availableApertures</a></li>
341 <li><a href="#static_android.lens.info.availableFilterDensities">android.lens.info.availableFilterDensities</a></li>
342 <li><a href="#static_android.lens.info.availableFocalLengths">android.lens.info.availableFocalLengths</a></li>
343 <li><a href="#static_android.lens.info.availableOpticalStabilization">android.lens.info.availableOpticalStabilization</a></li>
344 <li><a href="#static_android.lens.info.geometricCorrectionMap">android.lens.info.geometricCorrectionMap</a></li>
345 <li><a href="#static_android.lens.info.geometricCorrectionMapSize">android.lens.info.geometricCorrectionMapSize</a></li>
346 <li><a href="#static_android.lens.info.hyperfocalDistance">android.lens.info.hyperfocalDistance</a></li>
347 <li><a href="#static_android.lens.info.minimumFocusDistance">android.lens.info.minimumFocusDistance</a></li>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]348 <li><a href="#static_android.lens.info.shadingMapSize">android.lens.info.shadingMapSize</a></li>
349
350 <li><a href="#static_android.lens.facing">android.lens.facing</a></li>
351 <li><a href="#static_android.lens.opticalAxisAngle">android.lens.opticalAxisAngle</a></li>
352 <li><a href="#static_android.lens.position">android.lens.position</a></li>
353 </ul>
354 </li>
355 <li>
356 <span class="toc_kind_header">dynamic</span>
357 <ul class="toc_section">
358 <li><a href="#dynamic_android.lens.aperture">android.lens.aperture</a></li>
359 <li><a href="#dynamic_android.lens.filterDensity">android.lens.filterDensity</a></li>
360 <li><a href="#dynamic_android.lens.focalLength">android.lens.focalLength</a></li>
361 <li><a href="#dynamic_android.lens.focusDistance">android.lens.focusDistance</a></li>
362 <li><a href="#dynamic_android.lens.focusRange">android.lens.focusRange</a></li>
363 <li><a href="#dynamic_android.lens.opticalStabilizationMode">android.lens.opticalStabilizationMode</a></li>
364 <li><a href="#dynamic_android.lens.state">android.lens.state</a></li>
365 </ul>
366 </li>
367 </ul> <!-- toc_section -->
368 </li>
369 <li>
370 <span class="toc_section_header"><a href="#section_noiseReduction">noiseReduction</a></span>
371 <ul class="toc_section">
372 <li>
373 <span class="toc_kind_header">controls</span>
374 <ul class="toc_section">
375 <li><a href="#controls_android.noiseReduction.mode">android.noiseReduction.mode</a></li>
376 <li><a href="#controls_android.noiseReduction.strength">android.noiseReduction.strength</a></li>
377 </ul>
378 </li>
379 <li>
380 <span class="toc_kind_header">dynamic</span>
381 <ul class="toc_section">
382 <li><a href="#dynamic_android.noiseReduction.mode">android.noiseReduction.mode</a></li>
383 </ul>
384 </li>
385 </ul> <!-- toc_section -->
386 </li>
387 <li>
388 <span class="toc_section_header"><a href="#section_quirks">quirks</a></span>
389 <ul class="toc_section">
390 <li>
391 <span class="toc_kind_header">static</span>
392 <ul class="toc_section">
393 <li><a href="#static_android.quirks.meteringCropRegion">android.quirks.meteringCropRegion</a></li>
394 <li><a href="#static_android.quirks.triggerAfWithAuto">android.quirks.triggerAfWithAuto</a></li>
395 <li><a href="#static_android.quirks.useZslFormat">android.quirks.useZslFormat</a></li>
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]396 <li><a href="#static_android.quirks.usePartialResult">android.quirks.usePartialResult</a></li>
397 </ul>
398 </li>
399 <li>
400 <span class="toc_kind_header">dynamic</span>
401 <ul class="toc_section">
402 <li><a href="#dynamic_android.quirks.partialResult">android.quirks.partialResult</a></li>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]403 </ul>
404 </li>
405 </ul> <!-- toc_section -->
406 </li>
407 <li>
408 <span class="toc_section_header"><a href="#section_request">request</a></span>
409 <ul class="toc_section">
410 <li>
411 <span class="toc_kind_header">controls</span>
412 <ul class="toc_section">
413 <li><a href="#controls_android.request.frameCount">android.request.frameCount</a></li>
414 <li><a href="#controls_android.request.id">android.request.id</a></li>
415 <li><a href="#controls_android.request.inputStreams">android.request.inputStreams</a></li>
416 <li><a href="#controls_android.request.metadataMode">android.request.metadataMode</a></li>
417 <li><a href="#controls_android.request.outputStreams">android.request.outputStreams</a></li>
418 <li><a href="#controls_android.request.type">android.request.type</a></li>
419 </ul>
420 </li>
421 <li>
422 <span class="toc_kind_header">static</span>
423 <ul class="toc_section">
424 <li><a href="#static_android.request.maxNumOutputStreams">android.request.maxNumOutputStreams</a></li>
425 <li><a href="#static_android.request.maxNumReprocessStreams">android.request.maxNumReprocessStreams</a></li>
Zhijun He12744b22014-01-22 15:58:57 -0800[diff] [blame^]426 <li><a href="#static_android.request.maxNumInputStreams">android.request.maxNumInputStreams</a></li>
Igor Murashkina46e02f2014-01-09 17:43:38 -0800[diff] [blame]427 <li><a href="#static_android.request.pipelineMaxDepth">android.request.pipelineMaxDepth</a></li>
Igor Murashkin2e291102014-01-10 14:18:30 -0800[diff] [blame]428 <li><a href="#static_android.request.partialResultCount">android.request.partialResultCount</a></li>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]429 </ul>
430 </li>
431 <li>
432 <span class="toc_kind_header">dynamic</span>
433 <ul class="toc_section">
434 <li><a href="#dynamic_android.request.frameCount">android.request.frameCount</a></li>
435 <li><a href="#dynamic_android.request.id">android.request.id</a></li>
436 <li><a href="#dynamic_android.request.metadataMode">android.request.metadataMode</a></li>
437 <li><a href="#dynamic_android.request.outputStreams">android.request.outputStreams</a></li>
Igor Murashkina46e02f2014-01-09 17:43:38 -0800[diff] [blame]438 <li><a href="#dynamic_android.request.pipelineDepth">android.request.pipelineDepth</a></li>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]439 </ul>
440 </li>
441 </ul> <!-- toc_section -->
442 </li>
443 <li>
444 <span class="toc_section_header"><a href="#section_scaler">scaler</a></span>
445 <ul class="toc_section">
446 <li>
447 <span class="toc_kind_header">controls</span>
448 <ul class="toc_section">
449 <li><a href="#controls_android.scaler.cropRegion">android.scaler.cropRegion</a></li>
450 </ul>
451 </li>
452 <li>
453 <span class="toc_kind_header">static</span>
454 <ul class="toc_section">
455 <li><a href="#static_android.scaler.availableFormats">android.scaler.availableFormats</a></li>
456 <li><a href="#static_android.scaler.availableJpegMinDurations">android.scaler.availableJpegMinDurations</a></li>
457 <li><a href="#static_android.scaler.availableJpegSizes">android.scaler.availableJpegSizes</a></li>
458 <li><a href="#static_android.scaler.availableMaxDigitalZoom">android.scaler.availableMaxDigitalZoom</a></li>
459 <li><a href="#static_android.scaler.availableProcessedMinDurations">android.scaler.availableProcessedMinDurations</a></li>
460 <li><a href="#static_android.scaler.availableProcessedSizes">android.scaler.availableProcessedSizes</a></li>
461 <li><a href="#static_android.scaler.availableRawMinDurations">android.scaler.availableRawMinDurations</a></li>
462 <li><a href="#static_android.scaler.availableRawSizes">android.scaler.availableRawSizes</a></li>
463 </ul>
464 </li>
465 <li>
466 <span class="toc_kind_header">dynamic</span>
467 <ul class="toc_section">
468 <li><a href="#dynamic_android.scaler.cropRegion">android.scaler.cropRegion</a></li>
469 </ul>
470 </li>
471 </ul> <!-- toc_section -->
472 </li>
473 <li>
474 <span class="toc_section_header"><a href="#section_sensor">sensor</a></span>
475 <ul class="toc_section">
476 <li>
477 <span class="toc_kind_header">controls</span>
478 <ul class="toc_section">
479 <li><a href="#controls_android.sensor.exposureTime">android.sensor.exposureTime</a></li>
480 <li><a href="#controls_android.sensor.frameDuration">android.sensor.frameDuration</a></li>
481 <li><a href="#controls_android.sensor.sensitivity">android.sensor.sensitivity</a></li>
Igor Murashkina46e02f2014-01-09 17:43:38 -0800[diff] [blame]482 <li><a href="#controls_android.sensor.testPatternData">android.sensor.testPatternData</a></li>
483 <li><a href="#controls_android.sensor.testPatternMode">android.sensor.testPatternMode</a></li>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]484 </ul>
485 </li>
486 <li>
487 <span class="toc_kind_header">static</span>
488 <ul class="toc_section">
489
490 <li><a href="#static_android.sensor.info.activeArraySize">android.sensor.info.activeArraySize</a></li>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]491 <li><a href="#static_android.sensor.info.sensitivityRange">android.sensor.info.sensitivityRange</a></li>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]492 <li><a href="#static_android.sensor.info.colorFilterArrangement">android.sensor.info.colorFilterArrangement</a></li>
493 <li><a href="#static_android.sensor.info.exposureTimeRange">android.sensor.info.exposureTimeRange</a></li>
494 <li><a href="#static_android.sensor.info.maxFrameDuration">android.sensor.info.maxFrameDuration</a></li>
495 <li><a href="#static_android.sensor.info.physicalSize">android.sensor.info.physicalSize</a></li>
496 <li><a href="#static_android.sensor.info.pixelArraySize">android.sensor.info.pixelArraySize</a></li>
497 <li><a href="#static_android.sensor.info.whiteLevel">android.sensor.info.whiteLevel</a></li>
498
499 <li><a href="#static_android.sensor.baseGainFactor">android.sensor.baseGainFactor</a></li>
500 <li><a href="#static_android.sensor.blackLevelPattern">android.sensor.blackLevelPattern</a></li>
501 <li><a href="#static_android.sensor.calibrationTransform1">android.sensor.calibrationTransform1</a></li>
502 <li><a href="#static_android.sensor.calibrationTransform2">android.sensor.calibrationTransform2</a></li>
503 <li><a href="#static_android.sensor.colorTransform1">android.sensor.colorTransform1</a></li>
504 <li><a href="#static_android.sensor.colorTransform2">android.sensor.colorTransform2</a></li>
505 <li><a href="#static_android.sensor.forwardMatrix1">android.sensor.forwardMatrix1</a></li>
506 <li><a href="#static_android.sensor.forwardMatrix2">android.sensor.forwardMatrix2</a></li>
507 <li><a href="#static_android.sensor.maxAnalogSensitivity">android.sensor.maxAnalogSensitivity</a></li>
508 <li><a href="#static_android.sensor.noiseModelCoefficients">android.sensor.noiseModelCoefficients</a></li>
509 <li><a href="#static_android.sensor.orientation">android.sensor.orientation</a></li>
510 <li><a href="#static_android.sensor.referenceIlluminant1">android.sensor.referenceIlluminant1</a></li>
511 <li><a href="#static_android.sensor.referenceIlluminant2">android.sensor.referenceIlluminant2</a></li>
Igor Murashkina46e02f2014-01-09 17:43:38 -0800[diff] [blame]512 <li><a href="#static_android.sensor.availableTestPatternModes">android.sensor.availableTestPatternModes</a></li>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]513 </ul>
514 </li>
515 <li>
516 <span class="toc_kind_header">dynamic</span>
517 <ul class="toc_section">
518 <li><a href="#dynamic_android.sensor.exposureTime">android.sensor.exposureTime</a></li>
519 <li><a href="#dynamic_android.sensor.frameDuration">android.sensor.frameDuration</a></li>
520 <li><a href="#dynamic_android.sensor.sensitivity">android.sensor.sensitivity</a></li>
521 <li><a href="#dynamic_android.sensor.timestamp">android.sensor.timestamp</a></li>
Igor Murashkin656aa5a2013-08-13 14:23:39 -0700[diff] [blame]522 <li><a href="#dynamic_android.sensor.temperature">android.sensor.temperature</a></li>
Igor Murashkina46e02f2014-01-09 17:43:38 -0800[diff] [blame]523 <li><a href="#dynamic_android.sensor.testPatternMode">android.sensor.testPatternMode</a></li>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]524 </ul>
525 </li>
526 </ul> <!-- toc_section -->
527 </li>
528 <li>
529 <span class="toc_section_header"><a href="#section_shading">shading</a></span>
530 <ul class="toc_section">
531 <li>
532 <span class="toc_kind_header">controls</span>
533 <ul class="toc_section">
534 <li><a href="#controls_android.shading.mode">android.shading.mode</a></li>
535 <li><a href="#controls_android.shading.strength">android.shading.strength</a></li>
536 </ul>
537 </li>
538 <li>
539 <span class="toc_kind_header">dynamic</span>
540 <ul class="toc_section">
541 <li><a href="#dynamic_android.shading.mode">android.shading.mode</a></li>
542 </ul>
543 </li>
544 </ul> <!-- toc_section -->
545 </li>
546 <li>
547 <span class="toc_section_header"><a href="#section_statistics">statistics</a></span>
548 <ul class="toc_section">
549 <li>
550 <span class="toc_kind_header">controls</span>
551 <ul class="toc_section">
552 <li><a href="#controls_android.statistics.faceDetectMode">android.statistics.faceDetectMode</a></li>
553 <li><a href="#controls_android.statistics.histogramMode">android.statistics.histogramMode</a></li>
554 <li><a href="#controls_android.statistics.sharpnessMapMode">android.statistics.sharpnessMapMode</a></li>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]555 <li><a href="#controls_android.statistics.lensShadingMapMode">android.statistics.lensShadingMapMode</a></li>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]556 </ul>
557 </li>
558 <li>
559 <span class="toc_kind_header">static</span>
560 <ul class="toc_section">
561
562 <li><a href="#static_android.statistics.info.availableFaceDetectModes">android.statistics.info.availableFaceDetectModes</a></li>
563 <li><a href="#static_android.statistics.info.histogramBucketCount">android.statistics.info.histogramBucketCount</a></li>
564 <li><a href="#static_android.statistics.info.maxFaceCount">android.statistics.info.maxFaceCount</a></li>
565 <li><a href="#static_android.statistics.info.maxHistogramCount">android.statistics.info.maxHistogramCount</a></li>
566 <li><a href="#static_android.statistics.info.maxSharpnessMapValue">android.statistics.info.maxSharpnessMapValue</a></li>
567 <li><a href="#static_android.statistics.info.sharpnessMapSize">android.statistics.info.sharpnessMapSize</a></li>
568
569 </ul>
570 </li>
571 <li>
572 <span class="toc_kind_header">dynamic</span>
573 <ul class="toc_section">
574 <li><a href="#dynamic_android.statistics.faceDetectMode">android.statistics.faceDetectMode</a></li>
575 <li><a href="#dynamic_android.statistics.faceIds">android.statistics.faceIds</a></li>
576 <li><a href="#dynamic_android.statistics.faceLandmarks">android.statistics.faceLandmarks</a></li>
577 <li><a href="#dynamic_android.statistics.faceRectangles">android.statistics.faceRectangles</a></li>
578 <li><a href="#dynamic_android.statistics.faceScores">android.statistics.faceScores</a></li>
579 <li><a href="#dynamic_android.statistics.histogram">android.statistics.histogram</a></li>
580 <li><a href="#dynamic_android.statistics.histogramMode">android.statistics.histogramMode</a></li>
581 <li><a href="#dynamic_android.statistics.sharpnessMap">android.statistics.sharpnessMap</a></li>
582 <li><a href="#dynamic_android.statistics.sharpnessMapMode">android.statistics.sharpnessMapMode</a></li>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]583 <li><a href="#dynamic_android.statistics.lensShadingMap">android.statistics.lensShadingMap</a></li>
584 <li><a href="#dynamic_android.statistics.predictedColorGains">android.statistics.predictedColorGains</a></li>
585 <li><a href="#dynamic_android.statistics.predictedColorTransform">android.statistics.predictedColorTransform</a></li>
586 <li><a href="#dynamic_android.statistics.sceneFlicker">android.statistics.sceneFlicker</a></li>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]587 </ul>
588 </li>
589 </ul> <!-- toc_section -->
590 </li>
591 <li>
592 <span class="toc_section_header"><a href="#section_tonemap">tonemap</a></span>
593 <ul class="toc_section">
594 <li>
595 <span class="toc_kind_header">controls</span>
596 <ul class="toc_section">
597 <li><a href="#controls_android.tonemap.curveBlue">android.tonemap.curveBlue</a></li>
598 <li><a href="#controls_android.tonemap.curveGreen">android.tonemap.curveGreen</a></li>
599 <li><a href="#controls_android.tonemap.curveRed">android.tonemap.curveRed</a></li>
600 <li><a href="#controls_android.tonemap.mode">android.tonemap.mode</a></li>
601 </ul>
602 </li>
603 <li>
604 <span class="toc_kind_header">static</span>
605 <ul class="toc_section">
606 <li><a href="#static_android.tonemap.maxCurvePoints">android.tonemap.maxCurvePoints</a></li>
607 </ul>
608 </li>
609 <li>
610 <span class="toc_kind_header">dynamic</span>
611 <ul class="toc_section">
612 <li><a href="#dynamic_android.tonemap.curveBlue">android.tonemap.curveBlue</a></li>
613 <li><a href="#dynamic_android.tonemap.curveGreen">android.tonemap.curveGreen</a></li>
614 <li><a href="#dynamic_android.tonemap.curveRed">android.tonemap.curveRed</a></li>
615 <li><a href="#dynamic_android.tonemap.mode">android.tonemap.mode</a></li>
616 </ul>
617 </li>
618 </ul> <!-- toc_section -->
619 </li>
620 <li>
621 <span class="toc_section_header"><a href="#section_led">led</a></span>
622 <ul class="toc_section">
623 <li>
624 <span class="toc_kind_header">controls</span>
625 <ul class="toc_section">
626 <li><a href="#controls_android.led.transmit">android.led.transmit</a></li>
627 </ul>
628 </li>
629 <li>
630 <span class="toc_kind_header">dynamic</span>
631 <ul class="toc_section">
632 <li><a href="#dynamic_android.led.transmit">android.led.transmit</a></li>
633 </ul>
634 </li>
635 <li>
636 <span class="toc_kind_header">static</span>
637 <ul class="toc_section">
638 <li><a href="#static_android.led.availableLeds">android.led.availableLeds</a></li>
639 </ul>
640 </li>
641 </ul> <!-- toc_section -->
642 </li>
643 <li>
644 <span class="toc_section_header"><a href="#section_info">info</a></span>
645 <ul class="toc_section">
646 <li>
647 <span class="toc_kind_header">static</span>
648 <ul class="toc_section">
649 <li><a href="#static_android.info.supportedHardwareLevel">android.info.supportedHardwareLevel</a></li>
650 </ul>
651 </li>
652 </ul> <!-- toc_section -->
653 </li>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]654 <li>
655 <span class="toc_section_header"><a href="#section_blackLevel">blackLevel</a></span>
656 <ul class="toc_section">
657 <li>
658 <span class="toc_kind_header">controls</span>
659 <ul class="toc_section">
660 <li><a href="#controls_android.blackLevel.lock">android.blackLevel.lock</a></li>
661 </ul>
662 </li>
663 <li>
664 <span class="toc_kind_header">dynamic</span>
665 <ul class="toc_section">
666 <li><a href="#dynamic_android.blackLevel.lock">android.blackLevel.lock</a></li>
667 </ul>
668 </li>
669 </ul> <!-- toc_section -->
670 </li>
Igor Murashkin5c1fc682014-01-16 17:51:36 -0800[diff] [blame]671 <li>
672 <span class="toc_section_header"><a href="#section_sync">sync</a></span>
673 <ul class="toc_section">
674 <li>
675 <span class="toc_kind_header">dynamic</span>
676 <ul class="toc_section">
677 <li><a href="#dynamic_android.sync.frameNumber">android.sync.frameNumber</a></li>
678 </ul>
679 </li>
680 <li>
681 <span class="toc_kind_header">static</span>
682 <ul class="toc_section">
683 <li><a href="#static_android.sync.maxLatency">android.sync.maxLatency</a></li>
684 </ul>
685 </li>
686 </ul> <!-- toc_section -->
687 </li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]688 </ul>
689
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]690
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]691 <h1>Properties</h1>
692 <table class="properties">
693
694 <thead class="thead_dummy">
695 <tr>
696 <th class="th_name">Property Name</th>
697 <th class="th_type">Type</th>
698 <th class="th_description">Description</th>
699 <th class="th_units">Units</th>
700 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]701 <th class="th_tags">Tags</th>
702 </tr>
703 </thead> <!-- so that the first occurrence of thead is not
704 above the first occurrence of tr -->
705<!-- <namespace name="android"> -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]706 <tr><td colspan="6" id="section_colorCorrection" class="section">colorCorrection</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]707
708
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]709 <tr><td colspan="6" class="kind">controls</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]710
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]711 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]712 <tr>
713 <th class="th_name">Property Name</th>
714 <th class="th_type">Type</th>
715 <th class="th_description">Description</th>
716 <th class="th_units">Units</th>
717 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]718 <th class="th_tags">Tags</th>
719 </tr>
720 </thead>
721
722 <tbody>
723
724
725
726
727
728
729
730
731
732
733 <tr class="entry" id="controls_android.colorCorrection.mode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]734 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]735 android.<wbr/>color<wbr/>Correction.<wbr/>mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]736 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]737 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]738 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]739
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]740 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]741
742 <ul class="entry_type_enum">
743 <li>
744 <span class="entry_type_enum_name">TRANSFORM_MATRIX</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]745 <span class="entry_type_enum_notes"><p>Use the <a href="#controls_android.colorCorrection.transform">android.<wbr/>color<wbr/>Correction.<wbr/>transform</a> matrix
Igor Murashkin43817ad2014-01-10 15:58:35 -0800[diff] [blame]746and <a href="#controls_android.colorCorrection.gains">android.<wbr/>color<wbr/>Correction.<wbr/>gains</a> to do color conversion.<wbr/></p>
747<p>All advanced white balance adjustments (not specified
748by our white balance pipeline) must be disabled.<wbr/></p>
749<p>If AWB is enabled with <code><a href="#controls_android.control.awbMode">android.<wbr/>control.<wbr/>awb<wbr/>Mode</a> != OFF</code>,<wbr/> then
750TRANSFORM_<wbr/>MATRIX is ignored.<wbr/> The camera device will override
751this value to either FAST or HIGH_<wbr/>QUALITY.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]752 </li>
753 <li>
754 <span class="entry_type_enum_name">FAST</span>
Igor Murashkin43817ad2014-01-10 15:58:35 -0800[diff] [blame]755 <span class="entry_type_enum_notes"><p>Must not slow down capture rate relative to sensor raw
756output.<wbr/></p>
757<p>Advanced white balance adjustments above and beyond
758the specified white balance pipeline may be applied.<wbr/></p>
759<p>If AWB is enabled with <code><a href="#controls_android.control.awbMode">android.<wbr/>control.<wbr/>awb<wbr/>Mode</a> != OFF</code>,<wbr/> then
760the camera device uses the last frame's AWB values
761(or defaults if AWB has never been run).<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]762 </li>
763 <li>
764 <span class="entry_type_enum_name">HIGH_QUALITY</span>
Igor Murashkin43817ad2014-01-10 15:58:35 -0800[diff] [blame]765 <span class="entry_type_enum_notes"><p>Capture rate (relative to sensor raw output)
766may be reduced by high quality.<wbr/></p>
767<p>Advanced white balance adjustments above and beyond
768the specified white balance pipeline may be applied.<wbr/></p>
769<p>If AWB is enabled with <code><a href="#controls_android.control.awbMode">android.<wbr/>control.<wbr/>awb<wbr/>Mode</a> != OFF</code>,<wbr/> then
770the camera device uses the last frame's AWB values
771(or defaults if AWB has never been run).<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]772 </li>
773 </ul>
774
775 </td> <!-- entry_type -->
776
777 <td class="entry_description">
Igor Murashkin43817ad2014-01-10 15:58:35 -0800[diff] [blame]778 <p>The mode control selects how the image data is converted from the
779sensor's native color into linear sRGB color.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]780 </td>
781
782 <td class="entry_units">
783 </td>
784
785 <td class="entry_range">
786 </td>
787
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]788 <td class="entry_tags">
789 </td>
790
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]791 </tr>
792 <tr class="entries_header">
793 <th class="th_details" colspan="5">Details</th>
794 </tr>
795 <tr class="entry_cont">
796 <td class="entry_details" colspan="5">
Igor Murashkin43817ad2014-01-10 15:58:35 -0800[diff] [blame]797 <p>When auto-white balance is enabled with <a href="#controls_android.control.awbMode">android.<wbr/>control.<wbr/>awb<wbr/>Mode</a>,<wbr/> this
798control is overridden by the AWB routine.<wbr/> When AWB is disabled,<wbr/> the
799application controls how the color mapping is performed.<wbr/></p>
800<p>We define the expected processing pipeline below.<wbr/> For consistency
801across devices,<wbr/> this is always the case with TRANSFORM_<wbr/>MATRIX.<wbr/></p>
802<p>When either FULL or HIGH_<wbr/>QUALITY is used,<wbr/> the camera device may
803do additional processing but <a href="#controls_android.colorCorrection.gains">android.<wbr/>color<wbr/>Correction.<wbr/>gains</a> and
804<a href="#controls_android.colorCorrection.transform">android.<wbr/>color<wbr/>Correction.<wbr/>transform</a> will still be provided by the
805camera device (in the results) and be roughly correct.<wbr/></p>
806<p>Switching to TRANSFORM_<wbr/>MATRIX and using the data provided from
807FAST or HIGH_<wbr/>QUALITY will yield a picture with the same white point
808as what was produced by the camera device in the earlier frame.<wbr/></p>
809<p>The expected processing pipeline is as follows:</p>
810<p><img alt="White balance processing pipeline" src="images/camera2/metadata/android.colorCorrection.mode/processing_pipeline.png"/></p>
811<p>The white balance is encoded by two values,<wbr/> a 4-channel white-balance
812gain vector (applied in the Bayer domain),<wbr/> and a 3x3 color transform
813matrix (applied after demosaic).<wbr/></p>
814<p>The 4-channel white-balance gains are defined as:</p>
815<pre><code><a href="#controls_android.colorCorrection.gains">android.<wbr/>color<wbr/>Correction.<wbr/>gains</a> = [ R G_<wbr/>even G_<wbr/>odd B ]
816</code></pre>
817<p>where <code>G_<wbr/>even</code> is the gain for green pixels on even rows of the
818output,<wbr/> and <code>G_<wbr/>odd</code> is the gain for green pixels on the odd rows.<wbr/>
819These may be identical for a given camera device implementation; if
820the camera device does not support a separate gain for even/<wbr/>odd green
821channels,<wbr/> it will use the <code>G_<wbr/>even</code> value,<wbr/> and write <code>G_<wbr/>odd</code> equal to
822<code>G_<wbr/>even</code> in the output result metadata.<wbr/></p>
823<p>The matrices for color transforms are defined as a 9-entry vector:</p>
824<pre><code><a href="#controls_android.colorCorrection.transform">android.<wbr/>color<wbr/>Correction.<wbr/>transform</a> = [ I0 I1 I2 I3 I4 I5 I6 I7 I8 ]
825</code></pre>
826<p>which define a transform from input sensor colors,<wbr/> <code>P_<wbr/>in = [ r g b ]</code>,<wbr/>
827to output linear sRGB,<wbr/> <code>P_<wbr/>out = [ r' g' b' ]</code>,<wbr/></p>
828<p>with colors as follows:</p>
829<pre><code>r' = I0r + I1g + I2b
830g' = I3r + I4g + I5b
831b' = I6r + I7g + I8b
832</code></pre>
833<p>Both the input and output value ranges must match.<wbr/> Overflow/<wbr/>underflow
834values are clipped to fit within the range.<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]835 </td>
836 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]837
838
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]839 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
840 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]841
842
843 <tr class="entry" id="controls_android.colorCorrection.transform">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]844 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]845 android.<wbr/>color<wbr/>Correction.<wbr/>transform
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]846 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]847 <td class="entry_type">
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]848 <span class="entry_type_name">rational</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]849 <span class="entry_type_container">x</span>
850
851 <span class="entry_type_array">
852 3 x 3
853 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]854 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]855 <div class="entry_type_notes">3x3 rational matrix in row-major order</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]856
857
858 </td> <!-- entry_type -->
859
860 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]861 <p>A color transform matrix to use to transform
862from sensor RGB color space to output linear sRGB color space</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]863 </td>
864
865 <td class="entry_units">
866 </td>
867
868 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]869 <p>Output values are expected to be in the range
870(0,<wbr/>1)</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]871 </td>
872
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]873 <td class="entry_tags">
874 </td>
875
876 </tr>
877 <tr class="entries_header">
878 <th class="th_details" colspan="5">Details</th>
879 </tr>
880 <tr class="entry_cont">
881 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]882 <p>This matrix is either set by HAL when the request
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]883<a href="#controls_android.colorCorrection.mode">android.<wbr/>color<wbr/>Correction.<wbr/>mode</a> is not TRANSFORM_<wbr/>MATRIX,<wbr/> or
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]884directly by the application in the request when the
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]885<a href="#controls_android.colorCorrection.mode">android.<wbr/>color<wbr/>Correction.<wbr/>mode</a> is TRANSFORM_<wbr/>MATRIX.<wbr/></p>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]886<p>In the latter case,<wbr/> the HAL may round the matrix to account
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]887for precision issues; the final rounded matrix should be
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]888reported back in this matrix result metadata.<wbr/></p>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]889 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]890 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]891
892
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]893 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
894 <!-- end of entry -->
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]895
896
897 <tr class="entry" id="controls_android.colorCorrection.gains">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]898 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]899 android.<wbr/>color<wbr/>Correction.<wbr/>gains
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]900 </td>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]901 <td class="entry_type">
902 <span class="entry_type_name">float</span>
903 <span class="entry_type_container">x</span>
904
905 <span class="entry_type_array">
906 4
907 </span>
908 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]909 <div class="entry_type_notes">A 1D array of floats for 4 color channel gains</div>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]910
911
912 </td> <!-- entry_type -->
913
914 <td class="entry_description">
Igor Murashkin43817ad2014-01-10 15:58:35 -0800[diff] [blame]915 <p>Gains applying to Bayer raw color channels for
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]916white-balance</p>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]917 </td>
918
919 <td class="entry_units">
920 </td>
921
922 <td class="entry_range">
923 </td>
924
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]925 <td class="entry_tags">
926 </td>
927
928 </tr>
929 <tr class="entries_header">
930 <th class="th_details" colspan="5">Details</th>
931 </tr>
932 <tr class="entry_cont">
933 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]934 <p>The 4-channel white-balance gains are defined in
Igor Murashkin43817ad2014-01-10 15:58:35 -0800[diff] [blame]935the order of <code>[R G_<wbr/>even G_<wbr/>odd B]</code>,<wbr/> where <code>G_<wbr/>even</code> is the gain
936for green pixels on even rows of the output,<wbr/> and <code>G_<wbr/>odd</code>
937is the gain for green pixels on the odd rows.<wbr/> if a HAL
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]938does not support a separate gain for even/<wbr/>odd green channels,<wbr/>
Igor Murashkin43817ad2014-01-10 15:58:35 -0800[diff] [blame]939it should use the <code>G_<wbr/>even</code> value,<wbr/> and write <code>G_<wbr/>odd</code> equal to
940<code>G_<wbr/>even</code> in the output result metadata.<wbr/></p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]941<p>This array is either set by HAL when the request
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]942<a href="#controls_android.colorCorrection.mode">android.<wbr/>color<wbr/>Correction.<wbr/>mode</a> is not TRANSFORM_<wbr/>MATRIX,<wbr/> or
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]943directly by the application in the request when the
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]944<a href="#controls_android.colorCorrection.mode">android.<wbr/>color<wbr/>Correction.<wbr/>mode</a> is TRANSFORM_<wbr/>MATRIX.<wbr/></p>
Igor Murashkin43817ad2014-01-10 15:58:35 -0800[diff] [blame]945<p>The output should be the gains actually applied by the HAL to
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]946the current frame.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]947 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]948 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]949
950
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]951 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
952 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]953
954
955
956 <!-- end of kind -->
957 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]958 <tr><td colspan="6" class="kind">dynamic</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]959
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]960 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]961 <tr>
962 <th class="th_name">Property Name</th>
963 <th class="th_type">Type</th>
964 <th class="th_description">Description</th>
965 <th class="th_units">Units</th>
966 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]967 <th class="th_tags">Tags</th>
968 </tr>
969 </thead>
970
971 <tbody>
972
973
974
975
976
977
978
979
980
981
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]982 <tr class="entry" id="dynamic_android.colorCorrection.transform">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]983 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]984 android.<wbr/>color<wbr/>Correction.<wbr/>transform
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]985 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]986 <td class="entry_type">
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]987 <span class="entry_type_name">rational</span>
988 <span class="entry_type_container">x</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]989
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]990 <span class="entry_type_array">
991 3 x 3
992 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]993 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]994 <div class="entry_type_notes">3x3 rational matrix in row-major order</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]995
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]996
997 </td> <!-- entry_type -->
998
999 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1000 <p>A color transform matrix to use to transform
1001from sensor RGB color space to output linear sRGB color space</p>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]1002 </td>
1003
1004 <td class="entry_units">
1005 </td>
1006
1007 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]1008 <p>Output values are expected to be in the range
1009(0,<wbr/>1)</p>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]1010 </td>
1011
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1012 <td class="entry_tags">
1013 </td>
1014
1015 </tr>
1016 <tr class="entries_header">
1017 <th class="th_details" colspan="5">Details</th>
1018 </tr>
1019 <tr class="entry_cont">
1020 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1021 <p>This matrix is either set by HAL when the request
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]1022<a href="#controls_android.colorCorrection.mode">android.<wbr/>color<wbr/>Correction.<wbr/>mode</a> is not TRANSFORM_<wbr/>MATRIX,<wbr/> or
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]1023directly by the application in the request when the
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]1024<a href="#controls_android.colorCorrection.mode">android.<wbr/>color<wbr/>Correction.<wbr/>mode</a> is TRANSFORM_<wbr/>MATRIX.<wbr/></p>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1025<p>In the latter case,<wbr/> the HAL may round the matrix to account
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]1026for precision issues; the final rounded matrix should be
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1027reported back in this matrix result metadata.<wbr/></p>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]1028 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1029 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1030
1031
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1032 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
1033 <!-- end of entry -->
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]1034
1035
1036 <tr class="entry" id="dynamic_android.colorCorrection.gains">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1037 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1038 android.<wbr/>color<wbr/>Correction.<wbr/>gains
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1039 </td>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]1040 <td class="entry_type">
1041 <span class="entry_type_name">float</span>
1042 <span class="entry_type_container">x</span>
1043
1044 <span class="entry_type_array">
1045 4
1046 </span>
1047 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1048 <div class="entry_type_notes">A 1D array of floats for 4 color channel gains</div>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]1049
1050
1051 </td> <!-- entry_type -->
1052
1053 <td class="entry_description">
Igor Murashkin43817ad2014-01-10 15:58:35 -0800[diff] [blame]1054 <p>Gains applying to Bayer raw color channels for
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1055white-balance</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1056 </td>
1057
1058 <td class="entry_units">
1059 </td>
1060
1061 <td class="entry_range">
1062 </td>
1063
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1064 <td class="entry_tags">
1065 </td>
1066
1067 </tr>
1068 <tr class="entries_header">
1069 <th class="th_details" colspan="5">Details</th>
1070 </tr>
1071 <tr class="entry_cont">
1072 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1073 <p>The 4-channel white-balance gains are defined in
Igor Murashkin43817ad2014-01-10 15:58:35 -0800[diff] [blame]1074the order of <code>[R G_<wbr/>even G_<wbr/>odd B]</code>,<wbr/> where <code>G_<wbr/>even</code> is the gain
1075for green pixels on even rows of the output,<wbr/> and <code>G_<wbr/>odd</code>
1076is the gain for green pixels on the odd rows.<wbr/> if a HAL
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1077does not support a separate gain for even/<wbr/>odd green channels,<wbr/>
Igor Murashkin43817ad2014-01-10 15:58:35 -0800[diff] [blame]1078it should use the <code>G_<wbr/>even</code> value,<wbr/> and write <code>G_<wbr/>odd</code> equal to
1079<code>G_<wbr/>even</code> in the output result metadata.<wbr/></p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]1080<p>This array is either set by HAL when the request
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]1081<a href="#controls_android.colorCorrection.mode">android.<wbr/>color<wbr/>Correction.<wbr/>mode</a> is not TRANSFORM_<wbr/>MATRIX,<wbr/> or
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]1082directly by the application in the request when the
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]1083<a href="#controls_android.colorCorrection.mode">android.<wbr/>color<wbr/>Correction.<wbr/>mode</a> is TRANSFORM_<wbr/>MATRIX.<wbr/></p>
Igor Murashkin43817ad2014-01-10 15:58:35 -0800[diff] [blame]1084<p>The output should be the gains actually applied by the HAL to
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1085the current frame.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1086 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1087 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1088
1089
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1090 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
1091 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1092
1093
1094
1095 <!-- end of kind -->
1096 </tbody>
1097
1098 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1099 <tr><td colspan="6" id="section_control" class="section">control</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1100
1101
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1102 <tr><td colspan="6" class="kind">controls</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1103
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]1104 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1105 <tr>
1106 <th class="th_name">Property Name</th>
1107 <th class="th_type">Type</th>
1108 <th class="th_description">Description</th>
1109 <th class="th_units">Units</th>
1110 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1111 <th class="th_tags">Tags</th>
1112 </tr>
1113 </thead>
1114
1115 <tbody>
1116
1117
1118
1119
1120
1121
1122
1123
1124
1125
1126 <tr class="entry" id="controls_android.control.aeAntibandingMode">
Eino-Ville Talvala19ce2c12013-12-30 12:03:45 -0800[diff] [blame]1127 <td class="entry_name" rowspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1128 android.<wbr/>control.<wbr/>ae<wbr/>Antibanding<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1129 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1130 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]1131 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1132
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]1133 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1134
1135 <ul class="entry_type_enum">
1136 <li>
1137 <span class="entry_type_enum_name">OFF</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]1138 <span class="entry_type_enum_notes"><p>The camera device will not adjust exposure duration to
1139avoid banding problems.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1140 </li>
1141 <li>
1142 <span class="entry_type_enum_name">50HZ</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]1143 <span class="entry_type_enum_notes"><p>The camera device will adjust exposure duration to
1144avoid banding problems with 50Hz illumination sources.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1145 </li>
1146 <li>
1147 <span class="entry_type_enum_name">60HZ</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]1148 <span class="entry_type_enum_notes"><p>The camera device will adjust exposure duration to
1149avoid banding problems with 60Hz illumination
1150sources.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1151 </li>
1152 <li>
1153 <span class="entry_type_enum_name">AUTO</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]1154 <span class="entry_type_enum_notes"><p>The camera device will automatically adapt its
1155antibanding routine to the current illumination
1156conditions.<wbr/> This is the default.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1157 </li>
1158 </ul>
1159
1160 </td> <!-- entry_type -->
1161
1162 <td class="entry_description">
Eino-Ville Talvala19ce2c12013-12-30 12:03:45 -0800[diff] [blame]1163 <p>The desired setting for the camera device's auto-exposure
1164algorithm's antibanding compensation.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1165 </td>
1166
1167 <td class="entry_units">
1168 </td>
1169
1170 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]1171 <p><a href="#static_android.control.aeAvailableAntibandingModes">android.<wbr/>control.<wbr/>ae<wbr/>Available<wbr/>Antibanding<wbr/>Modes</a></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1172 </td>
1173
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1174 <td class="entry_tags">
Eino-Ville Talvala19ce2c12013-12-30 12:03:45 -0800[diff] [blame]1175 <ul class="entry_tags">
1176 <li><a href="#tag_BC">BC</a></li>
1177 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1178 </td>
1179
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1180 </tr>
Eino-Ville Talvala19ce2c12013-12-30 12:03:45 -0800[diff] [blame]1181 <tr class="entries_header">
1182 <th class="th_details" colspan="5">Details</th>
1183 </tr>
1184 <tr class="entry_cont">
1185 <td class="entry_details" colspan="5">
1186 <p>Some kinds of lighting fixtures,<wbr/> such as some fluorescent
1187lights,<wbr/> flicker at the rate of the power supply frequency
1188(60Hz or 50Hz,<wbr/> depending on country).<wbr/> While this is
1189typically not noticeable to a person,<wbr/> it can be visible to
1190a camera device.<wbr/> If a camera sets its exposure time to the
1191wrong value,<wbr/> the flicker may become visible in the
1192viewfinder as flicker or in a final captured image,<wbr/> as a
1193set of variable-brightness bands across the image.<wbr/></p>
1194<p>Therefore,<wbr/> the auto-exposure routines of camera devices
1195include antibanding routines that ensure that the chosen
1196exposure value will not cause such banding.<wbr/> The choice of
1197exposure time depends on the rate of flicker,<wbr/> which the
1198camera device can detect automatically,<wbr/> or the expected
1199rate can be selected by the application using this
1200control.<wbr/></p>
1201<p>A given camera device may not support all of the possible
1202options for the antibanding mode.<wbr/> The
1203<a href="#static_android.control.aeAvailableAntibandingModes">android.<wbr/>control.<wbr/>ae<wbr/>Available<wbr/>Antibanding<wbr/>Modes</a> key contains
1204the available modes for a given camera device.<wbr/></p>
1205<p>The default mode is AUTO,<wbr/> which must be supported by all
1206camera devices.<wbr/></p>
1207<p>If manual exposure control is enabled (by setting
1208<a href="#controls_android.control.aeMode">android.<wbr/>control.<wbr/>ae<wbr/>Mode</a> or <a href="#controls_android.control.mode">android.<wbr/>control.<wbr/>mode</a> to OFF),<wbr/>
1209then this setting has no effect,<wbr/> and the application must
1210ensure it selects exposure times that do not cause banding
1211issues.<wbr/> The <a href="#dynamic_android.statistics.sceneFlicker">android.<wbr/>statistics.<wbr/>scene<wbr/>Flicker</a> key can assist
1212the application in this.<wbr/></p>
1213 </td>
1214 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1215
Eino-Ville Talvala19ce2c12013-12-30 12:03:45 -0800[diff] [blame]1216 <tr class="entries_header">
1217 <th class="th_details" colspan="5">HAL Implementation Details</th>
1218 </tr>
1219 <tr class="entry_cont">
1220 <td class="entry_details" colspan="5">
1221 <p>For all capture request templates,<wbr/> this field must be set
1222to AUTO.<wbr/> AUTO is the only mode that must supported;
1223OFF,<wbr/> 50HZ,<wbr/> 60HZ are all optional.<wbr/></p>
1224<p>If manual exposure control is enabled (by setting
1225<a href="#controls_android.control.aeMode">android.<wbr/>control.<wbr/>ae<wbr/>Mode</a> or <a href="#controls_android.control.mode">android.<wbr/>control.<wbr/>mode</a> to OFF),<wbr/>
1226then the exposure values provided by the application must not be
1227adjusted for antibanding.<wbr/></p>
1228 </td>
1229 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1230
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1231 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
1232 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1233
1234
1235 <tr class="entry" id="controls_android.control.aeExposureCompensation">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1236 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1237 android.<wbr/>control.<wbr/>ae<wbr/>Exposure<wbr/>Compensation
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1238 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1239 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]1240 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1241
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]1242 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1243
1244
1245 </td> <!-- entry_type -->
1246
1247 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1248 <p>Adjustment to AE target image
1249brightness</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1250 </td>
1251
1252 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1253 count of positive/<wbr/>negative EV steps
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1254 </td>
1255
1256 <td class="entry_range">
1257 </td>
1258
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1259 <td class="entry_tags">
1260 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]1261 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1262 </ul>
1263 </td>
1264
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1265 </tr>
1266 <tr class="entries_header">
1267 <th class="th_details" colspan="5">Details</th>
1268 </tr>
1269 <tr class="entry_cont">
1270 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1271 <p>For example,<wbr/> if EV step is 0.<wbr/>333,<wbr/> '6' will mean an
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1272exposure compensation of +2 EV; -3 will mean an exposure
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1273compensation of -1</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1274 </td>
1275 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1276
1277
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1278 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
1279 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1280
1281
1282 <tr class="entry" id="controls_android.control.aeLock">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1283 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1284 android.<wbr/>control.<wbr/>ae<wbr/>Lock
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1285 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1286 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]1287 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1288
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]1289 <span class="entry_type_visibility"> [public as boolean]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1290
1291 <ul class="entry_type_enum">
1292 <li>
Eino-Ville Talvala76548fe2013-01-11 13:57:19 -0800[diff] [blame]1293 <span class="entry_type_enum_name">OFF</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]1294 <span class="entry_type_enum_notes"><p>Autoexposure lock is disabled; the AE algorithm
1295is free to update its parameters.<wbr/></p></span>
Eino-Ville Talvala76548fe2013-01-11 13:57:19 -0800[diff] [blame]1296 </li>
1297 <li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1298 <span class="entry_type_enum_name">ON</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]1299 <span class="entry_type_enum_notes"><p>Autoexposure lock is enabled; the AE algorithm
1300must not update the exposure and sensitivity parameters
1301while the lock is active</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1302 </li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1303 </ul>
1304
1305 </td> <!-- entry_type -->
1306
1307 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1308 <p>Whether AE is currently locked to its latest
1309calculated values</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1310 </td>
1311
1312 <td class="entry_units">
1313 </td>
1314
1315 <td class="entry_range">
1316 </td>
1317
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1318 <td class="entry_tags">
1319 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]1320 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1321 </ul>
1322 </td>
1323
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1324 </tr>
1325 <tr class="entries_header">
1326 <th class="th_details" colspan="5">Details</th>
1327 </tr>
1328 <tr class="entry_cont">
1329 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1330 <p>Note that even when AE is locked,<wbr/> the flash may be
1331fired if the AE mode is ON_<wbr/>AUTO_<wbr/>FLASH /<wbr/> ON_<wbr/>ALWAYS_<wbr/>FLASH /<wbr/>
1332ON_<wbr/>AUTO_<wbr/>FLASH_<wbr/>REDEYE.<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1333 </td>
1334 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1335
1336
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1337 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
1338 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1339
1340
1341 <tr class="entry" id="controls_android.control.aeMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1342 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1343 android.<wbr/>control.<wbr/>ae<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1344 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1345 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]1346 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1347
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]1348 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1349
1350 <ul class="entry_type_enum">
1351 <li>
1352 <span class="entry_type_enum_name">OFF</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]1353 <span class="entry_type_enum_notes"><p>The camera device's autoexposure routine is disabled;
1354the application-selected <a href="#controls_android.sensor.exposureTime">android.<wbr/>sensor.<wbr/>exposure<wbr/>Time</a>,<wbr/>
1355<a href="#controls_android.sensor.sensitivity">android.<wbr/>sensor.<wbr/>sensitivity</a> and
1356<a href="#controls_android.sensor.frameDuration">android.<wbr/>sensor.<wbr/>frame<wbr/>Duration</a> are used by the camera
1357device,<wbr/> along with android.<wbr/>flash.<wbr/>* fields,<wbr/> if there's
1358a flash unit for this camera device.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1359 </li>
1360 <li>
1361 <span class="entry_type_enum_name">ON</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]1362 <span class="entry_type_enum_notes"><p>The camera device's autoexposure routine is active,<wbr/>
1363with no flash control.<wbr/> The application's values for
1364<a href="#controls_android.sensor.exposureTime">android.<wbr/>sensor.<wbr/>exposure<wbr/>Time</a>,<wbr/>
1365<a href="#controls_android.sensor.sensitivity">android.<wbr/>sensor.<wbr/>sensitivity</a>,<wbr/> and
1366<a href="#controls_android.sensor.frameDuration">android.<wbr/>sensor.<wbr/>frame<wbr/>Duration</a> are ignored.<wbr/> The
1367application has control over the various
1368android.<wbr/>flash.<wbr/>* fields.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1369 </li>
1370 <li>
1371 <span class="entry_type_enum_name">ON_AUTO_FLASH</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]1372 <span class="entry_type_enum_notes"><p>Like ON,<wbr/> except that the camera device also controls
1373the camera's flash unit,<wbr/> firing it in low-light
1374conditions.<wbr/> The flash may be fired during a
1375precapture sequence (triggered by
1376<a href="#controls_android.control.aePrecaptureTrigger">android.<wbr/>control.<wbr/>ae<wbr/>Precapture<wbr/>Trigger</a>) and may be fired
1377for captures for which the
1378<a href="#controls_android.control.captureIntent">android.<wbr/>control.<wbr/>capture<wbr/>Intent</a> field is set to
1379STILL_<wbr/>CAPTURE</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1380 </li>
1381 <li>
1382 <span class="entry_type_enum_name">ON_ALWAYS_FLASH</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]1383 <span class="entry_type_enum_notes"><p>Like ON,<wbr/> except that the camera device also controls
1384the camera's flash unit,<wbr/> always firing it for still
1385captures.<wbr/> The flash may be fired during a precapture
1386sequence (triggered by
1387<a href="#controls_android.control.aePrecaptureTrigger">android.<wbr/>control.<wbr/>ae<wbr/>Precapture<wbr/>Trigger</a>) and will always
1388be fired for captures for which the
1389<a href="#controls_android.control.captureIntent">android.<wbr/>control.<wbr/>capture<wbr/>Intent</a> field is set to
1390STILL_<wbr/>CAPTURE</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1391 </li>
1392 <li>
1393 <span class="entry_type_enum_name">ON_AUTO_FLASH_REDEYE</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]1394 <span class="entry_type_enum_notes"><p>Like ON_<wbr/>AUTO_<wbr/>FLASH,<wbr/> but with automatic red eye
1395reduction.<wbr/> If deemed necessary by the camera device,<wbr/>
1396a red eye reduction flash will fire during the
1397precapture sequence.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1398 </li>
1399 </ul>
1400
1401 </td> <!-- entry_type -->
1402
1403 <td class="entry_description">
Eino-Ville Talvala9fa0d902014-01-08 16:16:53 -0800[diff] [blame]1404 <p>The desired mode for the camera device's
1405auto-exposure routine.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1406 </td>
1407
1408 <td class="entry_units">
1409 </td>
1410
1411 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]1412 <p><a href="#static_android.control.aeAvailableModes">android.<wbr/>control.<wbr/>ae<wbr/>Available<wbr/>Modes</a></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1413 </td>
1414
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1415 <td class="entry_tags">
1416 <ul class="entry_tags">
1417 <li><a href="#tag_BC">BC</a></li>
1418 </ul>
1419 </td>
1420
1421 </tr>
1422 <tr class="entries_header">
1423 <th class="th_details" colspan="5">Details</th>
1424 </tr>
1425 <tr class="entry_cont">
1426 <td class="entry_details" colspan="5">
Eino-Ville Talvala9fa0d902014-01-08 16:16:53 -0800[diff] [blame]1427 <p>This control is only effective if <a href="#controls_android.control.mode">android.<wbr/>control.<wbr/>mode</a> is
1428AUTO.<wbr/></p>
1429<p>When set to any of the ON modes,<wbr/> the camera device's
1430auto-exposure routine is enabled,<wbr/> overriding the
1431application's selected exposure time,<wbr/> sensor sensitivity,<wbr/>
1432and frame duration (<a href="#controls_android.sensor.exposureTime">android.<wbr/>sensor.<wbr/>exposure<wbr/>Time</a>,<wbr/>
1433<a href="#controls_android.sensor.sensitivity">android.<wbr/>sensor.<wbr/>sensitivity</a>,<wbr/> and
1434<a href="#controls_android.sensor.frameDuration">android.<wbr/>sensor.<wbr/>frame<wbr/>Duration</a>).<wbr/> If one of the FLASH modes
1435is selected,<wbr/> the camera device's flash unit controls are
1436also overridden.<wbr/></p>
1437<p>The FLASH modes are only available if the camera device
1438has a flash unit (<a href="#static_android.flash.info.available">android.<wbr/>flash.<wbr/>info.<wbr/>available</a> is <code>true</code>).<wbr/></p>
1439<p>If flash TORCH mode is desired,<wbr/> this field must be set to
1440ON or OFF,<wbr/> and <a href="#controls_android.flash.mode">android.<wbr/>flash.<wbr/>mode</a> set to TORCH.<wbr/></p>
1441<p>When set to any of the ON modes,<wbr/> the values chosen by the
1442camera device auto-exposure routine for the overridden
1443fields for a given capture will be available in its
1444CaptureResult.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1445 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1446 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1447
1448
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1449 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
1450 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1451
1452
1453 <tr class="entry" id="controls_android.control.aeRegions">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1454 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1455 android.<wbr/>control.<wbr/>ae<wbr/>Regions
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1456 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1457 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]1458 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1459 <span class="entry_type_container">x</span>
1460
1461 <span class="entry_type_array">
1462 5 x area_count
1463 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]1464 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1465
1466
1467 </td> <!-- entry_type -->
1468
1469 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1470 <p>List of areas to use for
Ruben Brunk76e4c7d2014-01-31 11:05:30 -0800[diff] [blame]1471metering.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1472 </td>
1473
1474 <td class="entry_units">
1475 </td>
1476
1477 <td class="entry_range">
Ruben Brunk76e4c7d2014-01-31 11:05:30 -0800[diff] [blame]1478 <p><code>area_<wbr/>count &lt;= <a href="#static_android.control.maxRegions">android.<wbr/>control.<wbr/>max<wbr/>Regions</a>[0]</code></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1479 </td>
1480
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1481 <td class="entry_tags">
1482 <ul class="entry_tags">
1483 <li><a href="#tag_BC">BC</a></li>
1484 </ul>
1485 </td>
1486
1487 </tr>
1488 <tr class="entries_header">
1489 <th class="th_details" colspan="5">Details</th>
1490 </tr>
1491 <tr class="entry_cont">
1492 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1493 <p>Each area is a rectangle plus weight: xmin,<wbr/> ymin,<wbr/>
Ruben Brunk76e4c7d2014-01-31 11:05:30 -0800[diff] [blame]1494xmax,<wbr/> ymax,<wbr/> weight.<wbr/> The rectangle is defined to be inclusive of the
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1495specified coordinates.<wbr/></p>
1496<p>The coordinate system is based on the active pixel array,<wbr/>
1497with (0,<wbr/>0) being the top-left pixel in the active pixel array,<wbr/> and
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]1498(<a href="#static_android.sensor.info.activeArraySize">android.<wbr/>sensor.<wbr/>info.<wbr/>active<wbr/>Array<wbr/>Size</a>.<wbr/>width - 1,<wbr/>
1499<a href="#static_android.sensor.info.activeArraySize">android.<wbr/>sensor.<wbr/>info.<wbr/>active<wbr/>Array<wbr/>Size</a>.<wbr/>height - 1) being the
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1500bottom-right pixel in the active pixel array.<wbr/> The weight
1501should be nonnegative.<wbr/></p>
1502<p>If all regions have 0 weight,<wbr/> then no specific metering area
1503needs to be used by the HAL.<wbr/> If the metering region is
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]1504outside the current <a href="#controls_android.scaler.cropRegion">android.<wbr/>scaler.<wbr/>crop<wbr/>Region</a>,<wbr/> the HAL
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]1505should ignore the sections outside the region and output the
Ruben Brunk76e4c7d2014-01-31 11:05:30 -0800[diff] [blame]1506used sections in the frame metadata.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1507 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1508 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1509
1510
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1511 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
1512 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1513
1514
1515 <tr class="entry" id="controls_android.control.aeTargetFpsRange">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1516 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1517 android.<wbr/>control.<wbr/>ae<wbr/>Target<wbr/>Fps<wbr/>Range
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1518 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1519 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]1520 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1521 <span class="entry_type_container">x</span>
1522
1523 <span class="entry_type_array">
1524 2
1525 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]1526 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1527
1528
1529 </td> <!-- entry_type -->
1530
1531 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1532 <p>Range over which fps can be adjusted to
1533maintain exposure</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1534 </td>
1535
1536 <td class="entry_units">
1537 </td>
1538
1539 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]1540 <p><a href="#static_android.control.aeAvailableTargetFpsRanges">android.<wbr/>control.<wbr/>ae<wbr/>Available<wbr/>Target<wbr/>Fps<wbr/>Ranges</a></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1541 </td>
1542
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1543 <td class="entry_tags">
1544 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]1545 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1546 </ul>
1547 </td>
1548
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1549 </tr>
1550 <tr class="entries_header">
1551 <th class="th_details" colspan="5">Details</th>
1552 </tr>
1553 <tr class="entry_cont">
1554 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1555 <p>Only constrains AE algorithm,<wbr/> not manual control
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]1556of <a href="#controls_android.sensor.exposureTime">android.<wbr/>sensor.<wbr/>exposure<wbr/>Time</a></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1557 </td>
1558 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1559
1560
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1561 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
1562 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1563
1564
Eino-Ville Talvala3b4383a2013-03-18 09:42:48 -0700[diff] [blame]1565 <tr class="entry" id="controls_android.control.aePrecaptureTrigger">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1566 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1567 android.<wbr/>control.<wbr/>ae<wbr/>Precapture<wbr/>Trigger
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1568 </td>
Eino-Ville Talvala3b4383a2013-03-18 09:42:48 -0700[diff] [blame]1569 <td class="entry_type">
1570 <span class="entry_type_name entry_type_name_enum">byte</span>
1571
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]1572 <span class="entry_type_visibility"> [public]</span>
Eino-Ville Talvala3b4383a2013-03-18 09:42:48 -0700[diff] [blame]1573
1574 <ul class="entry_type_enum">
1575 <li>
1576 <span class="entry_type_enum_name">IDLE</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]1577 <span class="entry_type_enum_notes"><p>The trigger is idle.<wbr/></p></span>
Eino-Ville Talvala3b4383a2013-03-18 09:42:48 -0700[diff] [blame]1578 </li>
1579 <li>
1580 <span class="entry_type_enum_name">START</span>
Zhijun He92e698d2014-01-13 16:24:31 -0800[diff] [blame]1581 <span class="entry_type_enum_notes"><p>The precapture metering sequence will be started
1582by the camera device.<wbr/> The exact effect of the precapture
1583trigger depends on the current AE mode and state.<wbr/></p></span>
Eino-Ville Talvala3b4383a2013-03-18 09:42:48 -0700[diff] [blame]1584 </li>
1585 </ul>
1586
1587 </td> <!-- entry_type -->
1588
1589 <td class="entry_description">
Zhijun He92e698d2014-01-13 16:24:31 -0800[diff] [blame]1590 <p>Whether the camera device will trigger a precapture
1591metering sequence when it processes this request.<wbr/></p>
Eino-Ville Talvala3b4383a2013-03-18 09:42:48 -0700[diff] [blame]1592 </td>
1593
1594 <td class="entry_units">
1595 </td>
1596
1597 <td class="entry_range">
1598 </td>
1599
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1600 <td class="entry_tags">
1601 <ul class="entry_tags">
1602 <li><a href="#tag_BC">BC</a></li>
1603 </ul>
1604 </td>
1605
1606 </tr>
1607 <tr class="entries_header">
1608 <th class="th_details" colspan="5">Details</th>
1609 </tr>
1610 <tr class="entry_cont">
1611 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1612 <p>This entry is normally set to IDLE,<wbr/> or is not
1613included at all in the request settings.<wbr/> When included and
Zhijun He92e698d2014-01-13 16:24:31 -0800[diff] [blame]1614set to START,<wbr/> the camera device will trigger the autoexposure
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1615precapture metering sequence.<wbr/></p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]1616<p>The effect of AE precapture trigger depends on the current
Zhijun He92e698d2014-01-13 16:24:31 -0800[diff] [blame]1617AE mode and state; see <a href="#dynamic_android.control.aeState">android.<wbr/>control.<wbr/>ae<wbr/>State</a> for AE precapture
1618state transition details.<wbr/></p>
Eino-Ville Talvala3b4383a2013-03-18 09:42:48 -0700[diff] [blame]1619 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1620 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1621
1622
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1623 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
1624 <!-- end of entry -->
Eino-Ville Talvala3b4383a2013-03-18 09:42:48 -0700[diff] [blame]1625
1626
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1627 <tr class="entry" id="controls_android.control.afMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1628 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1629 android.<wbr/>control.<wbr/>af<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1630 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1631 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]1632 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1633
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]1634 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1635
1636 <ul class="entry_type_enum">
1637 <li>
1638 <span class="entry_type_enum_name">OFF</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]1639 <span class="entry_type_enum_notes"><p>The auto-focus routine does not control the lens;
1640<a href="#controls_android.lens.focusDistance">android.<wbr/>lens.<wbr/>focus<wbr/>Distance</a> is controlled by the
1641application</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1642 </li>
1643 <li>
1644 <span class="entry_type_enum_name">AUTO</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]1645 <span class="entry_type_enum_notes"><p>If lens is not fixed focus.<wbr/></p>
1646<p>Use <a href="#static_android.lens.info.minimumFocusDistance">android.<wbr/>lens.<wbr/>info.<wbr/>minimum<wbr/>Focus<wbr/>Distance</a> to determine if lens
1647is fixed-focus.<wbr/> In this mode,<wbr/> the lens does not move unless
1648the autofocus trigger action is called.<wbr/> When that trigger
1649is activated,<wbr/> AF must transition to ACTIVE_<wbr/>SCAN,<wbr/> then to
1650the outcome of the scan (FOCUSED or NOT_<wbr/>FOCUSED).<wbr/></p>
1651<p>Triggering AF_<wbr/>CANCEL resets the lens position to default,<wbr/>
1652and sets the AF state to INACTIVE.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1653 </li>
1654 <li>
1655 <span class="entry_type_enum_name">MACRO</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]1656 <span class="entry_type_enum_notes"><p>In this mode,<wbr/> the lens does not move unless the
1657autofocus trigger action is called.<wbr/></p>
1658<p>When that trigger is activated,<wbr/> AF must transition to
1659ACTIVE_<wbr/>SCAN,<wbr/> then to the outcome of the scan (FOCUSED or
1660NOT_<wbr/>FOCUSED).<wbr/> Triggering cancel AF resets the lens
1661position to default,<wbr/> and sets the AF state to
1662INACTIVE.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1663 </li>
1664 <li>
1665 <span class="entry_type_enum_name">CONTINUOUS_VIDEO</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]1666 <span class="entry_type_enum_notes"><p>In this mode,<wbr/> the AF algorithm modifies the lens
1667position continually to attempt to provide a
1668constantly-in-focus image stream.<wbr/></p>
1669<p>The focusing behavior should be suitable for good quality
1670video recording; typically this means slower focus
1671movement and no overshoots.<wbr/> When the AF trigger is not
1672involved,<wbr/> the AF algorithm should start in INACTIVE state,<wbr/>
1673and then transition into PASSIVE_<wbr/>SCAN and PASSIVE_<wbr/>FOCUSED
1674states as appropriate.<wbr/> When the AF trigger is activated,<wbr/>
1675the algorithm should immediately transition into
1676AF_<wbr/>FOCUSED or AF_<wbr/>NOT_<wbr/>FOCUSED as appropriate,<wbr/> and lock the
1677lens position until a cancel AF trigger is received.<wbr/></p>
1678<p>Once cancel is received,<wbr/> the algorithm should transition
1679back to INACTIVE and resume passive scan.<wbr/> Note that this
1680behavior is not identical to CONTINUOUS_<wbr/>PICTURE,<wbr/> since an
1681ongoing PASSIVE_<wbr/>SCAN must immediately be
1682canceled.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1683 </li>
1684 <li>
1685 <span class="entry_type_enum_name">CONTINUOUS_PICTURE</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]1686 <span class="entry_type_enum_notes"><p>In this mode,<wbr/> the AF algorithm modifies the lens
1687position continually to attempt to provide a
1688constantly-in-focus image stream.<wbr/></p>
1689<p>The focusing behavior should be suitable for still image
1690capture; typically this means focusing as fast as
1691possible.<wbr/> When the AF trigger is not involved,<wbr/> the AF
1692algorithm should start in INACTIVE state,<wbr/> and then
1693transition into PASSIVE_<wbr/>SCAN and PASSIVE_<wbr/>FOCUSED states as
1694appropriate as it attempts to maintain focus.<wbr/> When the AF
1695trigger is activated,<wbr/> the algorithm should finish its
1696PASSIVE_<wbr/>SCAN if active,<wbr/> and then transition into
1697AF_<wbr/>FOCUSED or AF_<wbr/>NOT_<wbr/>FOCUSED as appropriate,<wbr/> and lock the
1698lens position until a cancel AF trigger is received.<wbr/></p>
1699<p>When the AF cancel trigger is activated,<wbr/> the algorithm
1700should transition back to INACTIVE and then act as if it
1701has just been started.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1702 </li>
1703 <li>
1704 <span class="entry_type_enum_name">EDOF</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]1705 <span class="entry_type_enum_notes"><p>Extended depth of field (digital focus).<wbr/> AF
1706trigger is ignored,<wbr/> AF state should always be
1707INACTIVE.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1708 </li>
1709 </ul>
1710
1711 </td> <!-- entry_type -->
1712
1713 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1714 <p>Whether AF is currently enabled,<wbr/> and what
1715mode it is set to</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1716 </td>
1717
1718 <td class="entry_units">
1719 </td>
1720
1721 <td class="entry_range">
Zhijun He7787f7f2014-01-14 16:30:31 -0800[diff] [blame]1722 <p><a href="#static_android.control.afAvailableModes">android.<wbr/>control.<wbr/>af<wbr/>Available<wbr/>Modes</a></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1723 </td>
1724
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1725 <td class="entry_tags">
1726 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]1727 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1728 </ul>
1729 </td>
1730
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1731 </tr>
1732 <tr class="entries_header">
1733 <th class="th_details" colspan="5">Details</th>
1734 </tr>
1735 <tr class="entry_cont">
1736 <td class="entry_details" colspan="5">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]1737 <p>Only effective if <a href="#controls_android.control.mode">android.<wbr/>control.<wbr/>mode</a> = AUTO.<wbr/></p>
Zhijun Hef163fa92014-01-14 09:59:04 -0800[diff] [blame]1738<p>If the lens is controlled by the camera device auto-focus algorithm,<wbr/>
1739the camera device will report the current AF status in android.<wbr/>control.<wbr/>af<wbr/>State
1740in result metadata.<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1741 </td>
1742 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1743
1744
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1745 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
1746 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1747
1748
1749 <tr class="entry" id="controls_android.control.afRegions">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1750 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1751 android.<wbr/>control.<wbr/>af<wbr/>Regions
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1752 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1753 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]1754 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1755 <span class="entry_type_container">x</span>
1756
1757 <span class="entry_type_array">
1758 5 x area_count
1759 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]1760 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1761
1762
1763 </td> <!-- entry_type -->
1764
1765 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1766 <p>List of areas to use for focus
Ruben Brunk76e4c7d2014-01-31 11:05:30 -0800[diff] [blame]1767estimation.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1768 </td>
1769
1770 <td class="entry_units">
1771 </td>
1772
1773 <td class="entry_range">
Ruben Brunk76e4c7d2014-01-31 11:05:30 -0800[diff] [blame]1774 <p><code>area_<wbr/>count &lt;= <a href="#static_android.control.maxRegions">android.<wbr/>control.<wbr/>max<wbr/>Regions</a>[2]</code></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1775 </td>
1776
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1777 <td class="entry_tags">
1778 <ul class="entry_tags">
1779 <li><a href="#tag_BC">BC</a></li>
1780 </ul>
1781 </td>
1782
1783 </tr>
1784 <tr class="entries_header">
1785 <th class="th_details" colspan="5">Details</th>
1786 </tr>
1787 <tr class="entry_cont">
1788 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1789 <p>Each area is a rectangle plus weight: xmin,<wbr/> ymin,<wbr/>
Ruben Brunk76e4c7d2014-01-31 11:05:30 -0800[diff] [blame]1790xmax,<wbr/> ymax,<wbr/> weight.<wbr/> The rectangle is defined to be inclusive of the
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1791specified coordinates.<wbr/></p>
1792<p>The coordinate system is based on the active pixel array,<wbr/>
1793with (0,<wbr/>0) being the top-left pixel in the active pixel array,<wbr/> and
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]1794(<a href="#static_android.sensor.info.activeArraySize">android.<wbr/>sensor.<wbr/>info.<wbr/>active<wbr/>Array<wbr/>Size</a>.<wbr/>width - 1,<wbr/>
1795<a href="#static_android.sensor.info.activeArraySize">android.<wbr/>sensor.<wbr/>info.<wbr/>active<wbr/>Array<wbr/>Size</a>.<wbr/>height - 1) being the
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1796bottom-right pixel in the active pixel array.<wbr/> The weight
1797should be nonnegative.<wbr/></p>
1798<p>If all regions have 0 weight,<wbr/> then no specific focus area
1799needs to be used by the HAL.<wbr/> If the focusing region is
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]1800outside the current <a href="#controls_android.scaler.cropRegion">android.<wbr/>scaler.<wbr/>crop<wbr/>Region</a>,<wbr/> the HAL
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]1801should ignore the sections outside the region and output the
Ruben Brunk76e4c7d2014-01-31 11:05:30 -0800[diff] [blame]1802used sections in the frame metadata.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1803 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1804 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1805
1806
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1807 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
1808 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1809
1810
Eino-Ville Talvala3b4383a2013-03-18 09:42:48 -0700[diff] [blame]1811 <tr class="entry" id="controls_android.control.afTrigger">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1812 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1813 android.<wbr/>control.<wbr/>af<wbr/>Trigger
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1814 </td>
Eino-Ville Talvala3b4383a2013-03-18 09:42:48 -0700[diff] [blame]1815 <td class="entry_type">
1816 <span class="entry_type_name entry_type_name_enum">byte</span>
1817
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]1818 <span class="entry_type_visibility"> [public]</span>
Eino-Ville Talvala3b4383a2013-03-18 09:42:48 -0700[diff] [blame]1819
1820 <ul class="entry_type_enum">
1821 <li>
1822 <span class="entry_type_enum_name">IDLE</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]1823 <span class="entry_type_enum_notes"><p>The trigger is idle.<wbr/></p></span>
Eino-Ville Talvala3b4383a2013-03-18 09:42:48 -0700[diff] [blame]1824 </li>
1825 <li>
1826 <span class="entry_type_enum_name">START</span>
Zhijun He92e698d2014-01-13 16:24:31 -0800[diff] [blame]1827 <span class="entry_type_enum_notes"><p>Autofocus will trigger now.<wbr/></p></span>
Eino-Ville Talvala3b4383a2013-03-18 09:42:48 -0700[diff] [blame]1828 </li>
1829 <li>
1830 <span class="entry_type_enum_name">CANCEL</span>
Zhijun He92e698d2014-01-13 16:24:31 -0800[diff] [blame]1831 <span class="entry_type_enum_notes"><p>Autofocus will return to its initial
1832state,<wbr/> and cancel any currently active trigger.<wbr/></p></span>
Eino-Ville Talvala3b4383a2013-03-18 09:42:48 -0700[diff] [blame]1833 </li>
1834 </ul>
1835
1836 </td> <!-- entry_type -->
1837
1838 <td class="entry_description">
Zhijun He92e698d2014-01-13 16:24:31 -0800[diff] [blame]1839 <p>Whether the camera device will trigger autofocus for this request.<wbr/></p>
Eino-Ville Talvala3b4383a2013-03-18 09:42:48 -0700[diff] [blame]1840 </td>
1841
1842 <td class="entry_units">
1843 </td>
1844
1845 <td class="entry_range">
1846 </td>
1847
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1848 <td class="entry_tags">
1849 <ul class="entry_tags">
1850 <li><a href="#tag_BC">BC</a></li>
1851 </ul>
1852 </td>
1853
1854 </tr>
1855 <tr class="entries_header">
1856 <th class="th_details" colspan="5">Details</th>
1857 </tr>
1858 <tr class="entry_cont">
1859 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1860 <p>This entry is normally set to IDLE,<wbr/> or is not
1861included at all in the request settings.<wbr/></p>
Zhijun He92e698d2014-01-13 16:24:31 -0800[diff] [blame]1862<p>When included and set to START,<wbr/> the camera device will trigger the
1863autofocus algorithm.<wbr/> If autofocus is disabled,<wbr/> this trigger has no effect.<wbr/></p>
1864<p>When set to CANCEL,<wbr/> the camera device will cancel any active trigger,<wbr/>
1865and return to its initial AF state.<wbr/></p>
1866<p>See <a href="#dynamic_android.control.afState">android.<wbr/>control.<wbr/>af<wbr/>State</a> for what that means for each AF mode.<wbr/></p>
Eino-Ville Talvala3b4383a2013-03-18 09:42:48 -0700[diff] [blame]1867 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1868 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1869
1870
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1871 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
1872 <!-- end of entry -->
Eino-Ville Talvala3b4383a2013-03-18 09:42:48 -0700[diff] [blame]1873
1874
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1875 <tr class="entry" id="controls_android.control.awbLock">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1876 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1877 android.<wbr/>control.<wbr/>awb<wbr/>Lock
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1878 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1879 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]1880 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1881
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]1882 <span class="entry_type_visibility"> [public as boolean]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1883
1884 <ul class="entry_type_enum">
1885 <li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1886 <span class="entry_type_enum_name">OFF</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]1887 <span class="entry_type_enum_notes"><p>Auto-whitebalance lock is disabled; the AWB
1888algorithm is free to update its parameters if in AUTO
1889mode.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1890 </li>
Eino-Ville Talvala76548fe2013-01-11 13:57:19 -0800[diff] [blame]1891 <li>
1892 <span class="entry_type_enum_name">ON</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]1893 <span class="entry_type_enum_notes"><p>Auto-whitebalance lock is enabled; the AWB
1894algorithm must not update the exposure and sensitivity
1895parameters while the lock is active</p></span>
Eino-Ville Talvala76548fe2013-01-11 13:57:19 -0800[diff] [blame]1896 </li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1897 </ul>
1898
1899 </td> <!-- entry_type -->
1900
1901 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1902 <p>Whether AWB is currently locked to its
1903latest calculated values</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1904 </td>
1905
1906 <td class="entry_units">
1907 </td>
1908
1909 <td class="entry_range">
1910 </td>
1911
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1912 <td class="entry_tags">
1913 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]1914 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1915 </ul>
1916 </td>
1917
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1918 </tr>
1919 <tr class="entries_header">
1920 <th class="th_details" colspan="5">Details</th>
1921 </tr>
1922 <tr class="entry_cont">
1923 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1924 <p>Note that AWB lock is only meaningful for AUTO
1925mode; in other modes,<wbr/> AWB is already fixed to a specific
1926setting</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1927 </td>
1928 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1929
1930
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1931 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
1932 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1933
1934
1935 <tr class="entry" id="controls_android.control.awbMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1936 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1937 android.<wbr/>control.<wbr/>awb<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1938 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1939 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]1940 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1941
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]1942 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1943
1944 <ul class="entry_type_enum">
1945 <li>
1946 <span class="entry_type_enum_name">OFF</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]1947 <span class="entry_type_enum_notes"><p>The camera device's auto white balance routine is disabled;
1948the application-selected color transform matrix
1949(<a href="#controls_android.colorCorrection.transform">android.<wbr/>color<wbr/>Correction.<wbr/>transform</a>) and gains
1950(<a href="#controls_android.colorCorrection.gains">android.<wbr/>color<wbr/>Correction.<wbr/>gains</a>) are used by the camera
1951device for manual white balance control.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1952 </li>
1953 <li>
1954 <span class="entry_type_enum_name">AUTO</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]1955 <span class="entry_type_enum_notes"><p>The camera device's auto white balance routine is active;
1956the application's values for android.<wbr/>color<wbr/>Correction.<wbr/>transform
1957and <a href="#controls_android.colorCorrection.gains">android.<wbr/>color<wbr/>Correction.<wbr/>gains</a> are ignored.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1958 </li>
1959 <li>
1960 <span class="entry_type_enum_name">INCANDESCENT</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]1961 <span class="entry_type_enum_notes"><p>The camera device's auto white balance routine is disabled;
1962the camera device uses incandescent light as the assumed scene
1963illumination for white balance.<wbr/> While the exact white balance
1964transforms are up to the camera device,<wbr/> they will approximately
1965match the CIE standard illuminant A.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1966 </li>
1967 <li>
1968 <span class="entry_type_enum_name">FLUORESCENT</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]1969 <span class="entry_type_enum_notes"><p>The camera device's auto white balance routine is disabled;
1970the camera device uses fluorescent light as the assumed scene
1971illumination for white balance.<wbr/> While the exact white balance
1972transforms are up to the camera device,<wbr/> they will approximately
1973match the CIE standard illuminant F2.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1974 </li>
1975 <li>
1976 <span class="entry_type_enum_name">WARM_FLUORESCENT</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]1977 <span class="entry_type_enum_notes"><p>The camera device's auto white balance routine is disabled;
1978the camera device uses warm fluorescent light as the assumed scene
1979illumination for white balance.<wbr/> While the exact white balance
1980transforms are up to the camera device,<wbr/> they will approximately
1981match the CIE standard illuminant F4.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1982 </li>
1983 <li>
1984 <span class="entry_type_enum_name">DAYLIGHT</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]1985 <span class="entry_type_enum_notes"><p>The camera device's auto white balance routine is disabled;
1986the camera device uses daylight light as the assumed scene
1987illumination for white balance.<wbr/> While the exact white balance
1988transforms are up to the camera device,<wbr/> they will approximately
1989match the CIE standard illuminant D65.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1990 </li>
1991 <li>
1992 <span class="entry_type_enum_name">CLOUDY_DAYLIGHT</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]1993 <span class="entry_type_enum_notes"><p>The camera device's auto white balance routine is disabled;
1994the camera device uses cloudy daylight light as the assumed scene
1995illumination for white balance.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1996 </li>
1997 <li>
1998 <span class="entry_type_enum_name">TWILIGHT</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]1999 <span class="entry_type_enum_notes"><p>The camera device's auto white balance routine is disabled;
2000the camera device uses twilight light as the assumed scene
2001illumination for white balance.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2002 </li>
2003 <li>
2004 <span class="entry_type_enum_name">SHADE</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]2005 <span class="entry_type_enum_notes"><p>The camera device's auto white balance routine is disabled;
2006the camera device uses shade light as the assumed scene
2007illumination for white balance.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2008 </li>
2009 </ul>
2010
2011 </td> <!-- entry_type -->
2012
2013 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2014 <p>Whether AWB is currently setting the color
2015transform fields,<wbr/> and what its illumination target
2016is</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2017 </td>
2018
2019 <td class="entry_units">
2020 </td>
2021
2022 <td class="entry_range">
Zhijun He7787f7f2014-01-14 16:30:31 -0800[diff] [blame]2023 <p><a href="#static_android.control.awbAvailableModes">android.<wbr/>control.<wbr/>awb<wbr/>Available<wbr/>Modes</a></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2024 </td>
2025
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2026 <td class="entry_tags">
2027 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]2028 <li><a href="#tag_BC">BC</a></li>
2029 <li><a href="#tag_AWB">AWB</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2030 </ul>
2031 </td>
2032
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2033 </tr>
2034 <tr class="entries_header">
2035 <th class="th_details" colspan="5">Details</th>
2036 </tr>
2037 <tr class="entry_cont">
2038 <td class="entry_details" colspan="5">
Zhijun He7787f7f2014-01-14 16:30:31 -0800[diff] [blame]2039 <p>This control is only effective if <a href="#controls_android.control.mode">android.<wbr/>control.<wbr/>mode</a> is AUTO.<wbr/></p>
2040<p>When set to the ON mode,<wbr/> the camera device's auto white balance
2041routine is enabled,<wbr/> overriding the application's selected
2042<a href="#controls_android.colorCorrection.transform">android.<wbr/>color<wbr/>Correction.<wbr/>transform</a>,<wbr/> <a href="#controls_android.colorCorrection.gains">android.<wbr/>color<wbr/>Correction.<wbr/>gains</a> and
2043<a href="#controls_android.colorCorrection.mode">android.<wbr/>color<wbr/>Correction.<wbr/>mode</a>.<wbr/></p>
2044<p>When set to the OFF mode,<wbr/> the camera device's auto white balance
2045routine is disabled.<wbr/> The applicantion manually controls the white
2046balance by <a href="#controls_android.colorCorrection.transform">android.<wbr/>color<wbr/>Correction.<wbr/>transform</a>,<wbr/> android.<wbr/>color<wbr/>Correction.<wbr/>gains
2047and <a href="#controls_android.colorCorrection.mode">android.<wbr/>color<wbr/>Correction.<wbr/>mode</a>.<wbr/></p>
2048<p>When set to any other modes,<wbr/> the camera device's auto white balance
2049routine is disabled.<wbr/> The camera device uses each particular illumination
2050target for white balance adjustment.<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2051 </td>
2052 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2053
2054
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2055 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
2056 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2057
2058
2059 <tr class="entry" id="controls_android.control.awbRegions">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2060 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2061 android.<wbr/>control.<wbr/>awb<wbr/>Regions
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2062 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2063 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]2064 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2065 <span class="entry_type_container">x</span>
2066
2067 <span class="entry_type_array">
2068 5 x area_count
2069 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2070 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2071
2072
2073 </td> <!-- entry_type -->
2074
2075 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2076 <p>List of areas to use for illuminant
Ruben Brunk76e4c7d2014-01-31 11:05:30 -0800[diff] [blame]2077estimation.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2078 </td>
2079
2080 <td class="entry_units">
2081 </td>
2082
2083 <td class="entry_range">
Ruben Brunk76e4c7d2014-01-31 11:05:30 -0800[diff] [blame]2084 <p><code>area_<wbr/>count &lt;= <a href="#static_android.control.maxRegions">android.<wbr/>control.<wbr/>max<wbr/>Regions</a>[1]</code></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2085 </td>
2086
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2087 <td class="entry_tags">
2088 <ul class="entry_tags">
2089 <li><a href="#tag_BC">BC</a></li>
2090 </ul>
2091 </td>
2092
2093 </tr>
2094 <tr class="entries_header">
2095 <th class="th_details" colspan="5">Details</th>
2096 </tr>
2097 <tr class="entry_cont">
2098 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2099 <p>Only used in AUTO mode.<wbr/></p>
2100<p>Each area is a rectangle plus weight: xmin,<wbr/> ymin,<wbr/>
Ruben Brunk76e4c7d2014-01-31 11:05:30 -0800[diff] [blame]2101xmax,<wbr/> ymax,<wbr/> weight.<wbr/> The rectangle is defined to be inclusive of the
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2102specified coordinates.<wbr/></p>
2103<p>The coordinate system is based on the active pixel array,<wbr/>
2104with (0,<wbr/>0) being the top-left pixel in the active pixel array,<wbr/> and
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]2105(<a href="#static_android.sensor.info.activeArraySize">android.<wbr/>sensor.<wbr/>info.<wbr/>active<wbr/>Array<wbr/>Size</a>.<wbr/>width - 1,<wbr/>
2106<a href="#static_android.sensor.info.activeArraySize">android.<wbr/>sensor.<wbr/>info.<wbr/>active<wbr/>Array<wbr/>Size</a>.<wbr/>height - 1) being the
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2107bottom-right pixel in the active pixel array.<wbr/> The weight
2108should be nonnegative.<wbr/></p>
2109<p>If all regions have 0 weight,<wbr/> then no specific metering area
2110needs to be used by the HAL.<wbr/> If the metering region is
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]2111outside the current <a href="#controls_android.scaler.cropRegion">android.<wbr/>scaler.<wbr/>crop<wbr/>Region</a>,<wbr/> the HAL
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]2112should ignore the sections outside the region and output the
Ruben Brunk76e4c7d2014-01-31 11:05:30 -0800[diff] [blame]2113used sections in the frame metadata.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2114 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2115 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2116
2117
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2118 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
2119 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2120
2121
2122 <tr class="entry" id="controls_android.control.captureIntent">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2123 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2124 android.<wbr/>control.<wbr/>capture<wbr/>Intent
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2125 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2126 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]2127 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2128
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2129 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2130
2131 <ul class="entry_type_enum">
2132 <li>
2133 <span class="entry_type_enum_name">CUSTOM</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]2134 <span class="entry_type_enum_notes"><p>This request doesn't fall into the other
2135categories.<wbr/> Default to preview-like
2136behavior.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2137 </li>
2138 <li>
2139 <span class="entry_type_enum_name">PREVIEW</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]2140 <span class="entry_type_enum_notes"><p>This request is for a preview-like usecase.<wbr/> The
2141precapture trigger may be used to start off a metering
2142w/<wbr/>flash sequence</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2143 </li>
2144 <li>
2145 <span class="entry_type_enum_name">STILL_CAPTURE</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]2146 <span class="entry_type_enum_notes"><p>This request is for a still capture-type
2147usecase.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2148 </li>
2149 <li>
2150 <span class="entry_type_enum_name">VIDEO_RECORD</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]2151 <span class="entry_type_enum_notes"><p>This request is for a video recording
2152usecase.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2153 </li>
2154 <li>
2155 <span class="entry_type_enum_name">VIDEO_SNAPSHOT</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]2156 <span class="entry_type_enum_notes"><p>This request is for a video snapshot (still
2157image while recording video) usecase</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2158 </li>
2159 <li>
2160 <span class="entry_type_enum_name">ZERO_SHUTTER_LAG</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]2161 <span class="entry_type_enum_notes"><p>This request is for a ZSL usecase; the
2162application will stream full-resolution images and
2163reprocess one or several later for a final
2164capture</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2165 </li>
2166 </ul>
2167
2168 </td> <!-- entry_type -->
2169
2170 <td class="entry_description">
Zhijun Heea27bc32014-01-15 13:47:59 -0800[diff] [blame]2171 <p>Information to the camera device 3A (auto-exposure,<wbr/>
2172auto-focus,<wbr/> auto-white balance) routines about the purpose
2173of this capture,<wbr/> to help the camera device to decide optimal 3A
2174strategy.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2175 </td>
2176
2177 <td class="entry_units">
2178 </td>
2179
2180 <td class="entry_range">
Zhijun Heea27bc32014-01-15 13:47:59 -0800[diff] [blame]2181 <p>All must be supported</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2182 </td>
2183
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2184 <td class="entry_tags">
2185 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]2186 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2187 </ul>
2188 </td>
2189
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2190 </tr>
2191 <tr class="entries_header">
2192 <th class="th_details" colspan="5">Details</th>
2193 </tr>
2194 <tr class="entry_cont">
2195 <td class="entry_details" colspan="5">
Zhijun Heea27bc32014-01-15 13:47:59 -0800[diff] [blame]2196 <p>This control is only effective if <code><a href="#controls_android.control.mode">android.<wbr/>control.<wbr/>mode</a> != OFF</code>
2197and any 3A routine is active.<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2198 </td>
2199 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2200
2201
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2202 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
2203 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2204
2205
2206 <tr class="entry" id="controls_android.control.effectMode">
Ruben Brunkb28b35f2014-01-14 17:17:19 -0800[diff] [blame]2207 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2208 android.<wbr/>control.<wbr/>effect<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2209 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2210 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]2211 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2212
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2213 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2214
2215 <ul class="entry_type_enum">
2216 <li>
2217 <span class="entry_type_enum_name">OFF</span>
Ruben Brunkb28b35f2014-01-14 17:17:19 -0800[diff] [blame]2218 <span class="entry_type_enum_notes"><p>No color effect will be applied.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2219 </li>
2220 <li>
2221 <span class="entry_type_enum_name">MONO</span>
2222 <span class="entry_type_enum_optional">optional</span>
Ruben Brunkb28b35f2014-01-14 17:17:19 -0800[diff] [blame]2223 <span class="entry_type_enum_notes"><p>A "monocolor" effect where the image is mapped into
2224a single color.<wbr/> This will typically be grayscale.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2225 </li>
2226 <li>
2227 <span class="entry_type_enum_name">NEGATIVE</span>
2228 <span class="entry_type_enum_optional">optional</span>
Ruben Brunkb28b35f2014-01-14 17:17:19 -0800[diff] [blame]2229 <span class="entry_type_enum_notes"><p>A "photo-negative" effect where the image's colors
2230are inverted.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2231 </li>
2232 <li>
2233 <span class="entry_type_enum_name">SOLARIZE</span>
2234 <span class="entry_type_enum_optional">optional</span>
Ruben Brunkb28b35f2014-01-14 17:17:19 -0800[diff] [blame]2235 <span class="entry_type_enum_notes"><p>A "solarisation" effect (Sabattier effect) where the
2236image is wholly or partially reversed in
2237tone.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2238 </li>
2239 <li>
2240 <span class="entry_type_enum_name">SEPIA</span>
2241 <span class="entry_type_enum_optional">optional</span>
Ruben Brunkb28b35f2014-01-14 17:17:19 -0800[diff] [blame]2242 <span class="entry_type_enum_notes"><p>A "sepia" effect where the image is mapped into warm
2243gray,<wbr/> red,<wbr/> and brown tones.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2244 </li>
2245 <li>
2246 <span class="entry_type_enum_name">POSTERIZE</span>
2247 <span class="entry_type_enum_optional">optional</span>
Ruben Brunkb28b35f2014-01-14 17:17:19 -0800[diff] [blame]2248 <span class="entry_type_enum_notes"><p>A "posterization" effect where the image uses
2249discrete regions of tone rather than a continuous
2250gradient of tones.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2251 </li>
2252 <li>
2253 <span class="entry_type_enum_name">WHITEBOARD</span>
2254 <span class="entry_type_enum_optional">optional</span>
Ruben Brunkb28b35f2014-01-14 17:17:19 -0800[diff] [blame]2255 <span class="entry_type_enum_notes"><p>A "whiteboard" effect where the image is typically displayed
2256as regions of white,<wbr/> with black or grey details.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2257 </li>
2258 <li>
2259 <span class="entry_type_enum_name">BLACKBOARD</span>
2260 <span class="entry_type_enum_optional">optional</span>
Ruben Brunkb28b35f2014-01-14 17:17:19 -0800[diff] [blame]2261 <span class="entry_type_enum_notes"><p>A "blackboard" effect where the image is typically displayed
2262as regions of black,<wbr/> with white or grey details.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2263 </li>
2264 <li>
2265 <span class="entry_type_enum_name">AQUA</span>
2266 <span class="entry_type_enum_optional">optional</span>
Ruben Brunkb28b35f2014-01-14 17:17:19 -0800[diff] [blame]2267 <span class="entry_type_enum_notes"><p>An "aqua" effect where a blue hue is added to the image.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2268 </li>
2269 </ul>
2270
2271 </td> <!-- entry_type -->
2272
2273 <td class="entry_description">
Ruben Brunkb28b35f2014-01-14 17:17:19 -0800[diff] [blame]2274 <p>A special color effect to apply.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2275 </td>
2276
2277 <td class="entry_units">
2278 </td>
2279
2280 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]2281 <p><a href="#static_android.control.availableEffects">android.<wbr/>control.<wbr/>available<wbr/>Effects</a></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2282 </td>
2283
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2284 <td class="entry_tags">
2285 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]2286 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2287 </ul>
2288 </td>
2289
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2290 </tr>
Ruben Brunkb28b35f2014-01-14 17:17:19 -0800[diff] [blame]2291 <tr class="entries_header">
2292 <th class="th_details" colspan="5">Details</th>
2293 </tr>
2294 <tr class="entry_cont">
2295 <td class="entry_details" colspan="5">
2296 <p>When this mode is set,<wbr/> a color effect will be applied
2297to images produced by the camera device.<wbr/> The interpretation
2298and implementation of these color effects is left to the
2299implementor of the camera device,<wbr/> and should not be
2300depended on to be consistent (or present) across all
2301devices.<wbr/></p>
2302<p>A color effect will only be applied if
2303<a href="#controls_android.control.mode">android.<wbr/>control.<wbr/>mode</a> != OFF.<wbr/></p>
2304 </td>
2305 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2306
2307
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2308 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
2309 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2310
2311
2312 <tr class="entry" id="controls_android.control.mode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2313 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2314 android.<wbr/>control.<wbr/>mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2315 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2316 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]2317 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2318
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2319 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2320
2321 <ul class="entry_type_enum">
2322 <li>
2323 <span class="entry_type_enum_name">OFF</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]2324 <span class="entry_type_enum_notes"><p>Full application control of pipeline.<wbr/> All 3A
2325routines are disabled,<wbr/> no other settings in
2326android.<wbr/>control.<wbr/>* have any effect</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2327 </li>
2328 <li>
2329 <span class="entry_type_enum_name">AUTO</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]2330 <span class="entry_type_enum_notes"><p>Use settings for each individual 3A routine.<wbr/>
2331Manual control of capture parameters is disabled.<wbr/> All
2332controls in android.<wbr/>control.<wbr/>* besides sceneMode take
2333effect</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2334 </li>
2335 <li>
2336 <span class="entry_type_enum_name">USE_SCENE_MODE</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]2337 <span class="entry_type_enum_notes"><p>Use specific scene mode.<wbr/> Enabling this disables
2338control.<wbr/>aeMode,<wbr/> control.<wbr/>awbMode and control.<wbr/>afMode
2339controls; the HAL must ignore those settings while
2340USE_<wbr/>SCENE_<wbr/>MODE is active (except for FACE_<wbr/>PRIORITY
2341scene mode).<wbr/> Other control entries are still active.<wbr/>
2342This setting can only be used if availableSceneModes !=
2343UNSUPPORTED</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2344 </li>
2345 </ul>
2346
2347 </td> <!-- entry_type -->
2348
2349 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2350 <p>Overall mode of 3A control
2351routines</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2352 </td>
2353
2354 <td class="entry_units">
2355 </td>
2356
2357 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]2358 <p>all must be supported</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2359 </td>
2360
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2361 <td class="entry_tags">
2362 <ul class="entry_tags">
2363 <li><a href="#tag_BC">BC</a></li>
2364 </ul>
2365 </td>
2366
2367 </tr>
2368 <tr class="entries_header">
2369 <th class="th_details" colspan="5">Details</th>
2370 </tr>
2371 <tr class="entry_cont">
2372 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2373 <p>High-level 3A control.<wbr/> When set to OFF,<wbr/> all 3A control
Zhijun Hef90eeaf2014-01-16 12:13:35 -0800[diff] [blame]2374by the camera device is disabled.<wbr/> The application must set the fields for
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2375capture parameters itself.<wbr/></p>
2376<p>When set to AUTO,<wbr/> the individual algorithm controls in
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]2377android.<wbr/>control.<wbr/>* are in effect,<wbr/> such as <a href="#controls_android.control.afMode">android.<wbr/>control.<wbr/>af<wbr/>Mode</a>.<wbr/></p>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2378<p>When set to USE_<wbr/>SCENE_<wbr/>MODE,<wbr/> the individual controls in
Zhijun Hef90eeaf2014-01-16 12:13:35 -0800[diff] [blame]2379android.<wbr/>control.<wbr/>* are mostly disabled,<wbr/> and the camera device implements
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2380one of the scene mode settings (such as ACTION,<wbr/> SUNSET,<wbr/> or PARTY)
Zhijun Hef90eeaf2014-01-16 12:13:35 -0800[diff] [blame]2381as it wishes.<wbr/> The camera device scene mode 3A settings are provided by
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]2382<a href="#static_android.control.sceneModeOverrides">android.<wbr/>control.<wbr/>scene<wbr/>Mode<wbr/>Overrides</a>.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2383 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2384 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2385
2386
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2387 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
2388 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2389
2390
2391 <tr class="entry" id="controls_android.control.sceneMode">
Ruben Brunk9e28ea72014-01-14 18:55:29 -0800[diff] [blame]2392 <td class="entry_name" rowspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2393 android.<wbr/>control.<wbr/>scene<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2394 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2395 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]2396 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2397
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2398 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2399
2400 <ul class="entry_type_enum">
2401 <li>
Ruben Brunk9e28ea72014-01-14 18:55:29 -0800[diff] [blame]2402 <span class="entry_type_enum_name">DISABLED</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2403 <span class="entry_type_enum_value">0</span>
Ruben Brunk9e28ea72014-01-14 18:55:29 -0800[diff] [blame]2404 <span class="entry_type_enum_notes"><p>Indicates that no scene modes are set for a given capture request.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2405 </li>
2406 <li>
2407 <span class="entry_type_enum_name">FACE_PRIORITY</span>
Ruben Brunk9e28ea72014-01-14 18:55:29 -0800[diff] [blame]2408 <span class="entry_type_enum_notes"><p>If face detection support exists,<wbr/> use face
2409detection data for auto-focus,<wbr/> auto-white balance,<wbr/> and
2410auto-exposure routines.<wbr/> If face detection statistics are
2411disabled (i.<wbr/>e.<wbr/> <a href="#controls_android.statistics.faceDetectMode">android.<wbr/>statistics.<wbr/>face<wbr/>Detect<wbr/>Mode</a> is set to OFF),<wbr/>
2412this should still operate correctly (but will not return
2413face detection statistics to the framework).<wbr/></p>
2414<p>Unlike the other scene modes,<wbr/> <a href="#controls_android.control.aeMode">android.<wbr/>control.<wbr/>ae<wbr/>Mode</a>,<wbr/>
2415<a href="#controls_android.control.awbMode">android.<wbr/>control.<wbr/>awb<wbr/>Mode</a>,<wbr/> and android.<wbr/>control.<wbr/>af<wbr/>Mode
2416remain active when FACE_<wbr/>PRIORITY is set.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2417 </li>
2418 <li>
2419 <span class="entry_type_enum_name">ACTION</span>
2420 <span class="entry_type_enum_optional">optional</span>
Ruben Brunk9e28ea72014-01-14 18:55:29 -0800[diff] [blame]2421 <span class="entry_type_enum_notes"><p>Optimized for photos of quickly moving objects.<wbr/>
2422Similar to SPORTS.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2423 </li>
2424 <li>
2425 <span class="entry_type_enum_name">PORTRAIT</span>
2426 <span class="entry_type_enum_optional">optional</span>
Ruben Brunk9e28ea72014-01-14 18:55:29 -0800[diff] [blame]2427 <span class="entry_type_enum_notes"><p>Optimized for still photos of people.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2428 </li>
2429 <li>
2430 <span class="entry_type_enum_name">LANDSCAPE</span>
2431 <span class="entry_type_enum_optional">optional</span>
Ruben Brunk9e28ea72014-01-14 18:55:29 -0800[diff] [blame]2432 <span class="entry_type_enum_notes"><p>Optimized for photos of distant macroscopic objects.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2433 </li>
2434 <li>
2435 <span class="entry_type_enum_name">NIGHT</span>
2436 <span class="entry_type_enum_optional">optional</span>
Ruben Brunk9e28ea72014-01-14 18:55:29 -0800[diff] [blame]2437 <span class="entry_type_enum_notes"><p>Optimized for low-light settings.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2438 </li>
2439 <li>
2440 <span class="entry_type_enum_name">NIGHT_PORTRAIT</span>
2441 <span class="entry_type_enum_optional">optional</span>
Ruben Brunk9e28ea72014-01-14 18:55:29 -0800[diff] [blame]2442 <span class="entry_type_enum_notes"><p>Optimized for still photos of people in low-light
2443settings.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2444 </li>
2445 <li>
2446 <span class="entry_type_enum_name">THEATRE</span>
2447 <span class="entry_type_enum_optional">optional</span>
Ruben Brunk9e28ea72014-01-14 18:55:29 -0800[diff] [blame]2448 <span class="entry_type_enum_notes"><p>Optimized for dim,<wbr/> indoor settings where flash must
2449remain off.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2450 </li>
2451 <li>
2452 <span class="entry_type_enum_name">BEACH</span>
2453 <span class="entry_type_enum_optional">optional</span>
Ruben Brunk9e28ea72014-01-14 18:55:29 -0800[diff] [blame]2454 <span class="entry_type_enum_notes"><p>Optimized for bright,<wbr/> outdoor beach settings.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2455 </li>
2456 <li>
2457 <span class="entry_type_enum_name">SNOW</span>
2458 <span class="entry_type_enum_optional">optional</span>
Ruben Brunk9e28ea72014-01-14 18:55:29 -0800[diff] [blame]2459 <span class="entry_type_enum_notes"><p>Optimized for bright,<wbr/> outdoor settings containing snow.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2460 </li>
2461 <li>
2462 <span class="entry_type_enum_name">SUNSET</span>
2463 <span class="entry_type_enum_optional">optional</span>
Ruben Brunk9e28ea72014-01-14 18:55:29 -0800[diff] [blame]2464 <span class="entry_type_enum_notes"><p>Optimized for scenes of the setting sun.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2465 </li>
2466 <li>
2467 <span class="entry_type_enum_name">STEADYPHOTO</span>
2468 <span class="entry_type_enum_optional">optional</span>
Ruben Brunk9e28ea72014-01-14 18:55:29 -0800[diff] [blame]2469 <span class="entry_type_enum_notes"><p>Optimized to avoid blurry photos due to small amounts of
2470device motion (for example: due to hand shake).<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2471 </li>
2472 <li>
2473 <span class="entry_type_enum_name">FIREWORKS</span>
2474 <span class="entry_type_enum_optional">optional</span>
Ruben Brunk9e28ea72014-01-14 18:55:29 -0800[diff] [blame]2475 <span class="entry_type_enum_notes"><p>Optimized for nighttime photos of fireworks.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2476 </li>
2477 <li>
2478 <span class="entry_type_enum_name">SPORTS</span>
2479 <span class="entry_type_enum_optional">optional</span>
Ruben Brunk9e28ea72014-01-14 18:55:29 -0800[diff] [blame]2480 <span class="entry_type_enum_notes"><p>Optimized for photos of quickly moving people.<wbr/>
2481Similar to ACTION.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2482 </li>
2483 <li>
2484 <span class="entry_type_enum_name">PARTY</span>
2485 <span class="entry_type_enum_optional">optional</span>
Ruben Brunk9e28ea72014-01-14 18:55:29 -0800[diff] [blame]2486 <span class="entry_type_enum_notes"><p>Optimized for dim,<wbr/> indoor settings with multiple moving
2487people.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2488 </li>
2489 <li>
2490 <span class="entry_type_enum_name">CANDLELIGHT</span>
2491 <span class="entry_type_enum_optional">optional</span>
Ruben Brunk9e28ea72014-01-14 18:55:29 -0800[diff] [blame]2492 <span class="entry_type_enum_notes"><p>Optimized for dim settings where the main light source
2493is a flame.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2494 </li>
2495 <li>
2496 <span class="entry_type_enum_name">BARCODE</span>
2497 <span class="entry_type_enum_optional">optional</span>
Ruben Brunk9e28ea72014-01-14 18:55:29 -0800[diff] [blame]2498 <span class="entry_type_enum_notes"><p>Optimized for accurately capturing a photo of barcode
2499for use by camera applications that wish to read the
2500barcode value.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2501 </li>
2502 </ul>
2503
2504 </td> <!-- entry_type -->
2505
2506 <td class="entry_description">
Ruben Brunk9e28ea72014-01-14 18:55:29 -0800[diff] [blame]2507 <p>A camera mode optimized for conditions typical in a particular
2508capture setting.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2509 </td>
2510
2511 <td class="entry_units">
2512 </td>
2513
2514 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]2515 <p><a href="#static_android.control.availableSceneModes">android.<wbr/>control.<wbr/>available<wbr/>Scene<wbr/>Modes</a></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2516 </td>
2517
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2518 <td class="entry_tags">
2519 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]2520 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2521 </ul>
2522 </td>
2523
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2524 </tr>
Ruben Brunk9e28ea72014-01-14 18:55:29 -0800[diff] [blame]2525 <tr class="entries_header">
2526 <th class="th_details" colspan="5">Details</th>
2527 </tr>
2528 <tr class="entry_cont">
2529 <td class="entry_details" colspan="5">
2530 <p>This is the mode that that is active when
2531<code><a href="#controls_android.control.mode">android.<wbr/>control.<wbr/>mode</a> == USE_<wbr/>SCENE_<wbr/>MODE</code>.<wbr/> Aside from FACE_<wbr/>PRIORITY,<wbr/>
2532these modes will disable <a href="#controls_android.control.aeMode">android.<wbr/>control.<wbr/>ae<wbr/>Mode</a>,<wbr/>
2533<a href="#controls_android.control.awbMode">android.<wbr/>control.<wbr/>awb<wbr/>Mode</a>,<wbr/> and <a href="#controls_android.control.afMode">android.<wbr/>control.<wbr/>af<wbr/>Mode</a> while in use.<wbr/></p>
2534<p>The interpretation and implementation of these scene modes is left
2535to the implementor of the camera device.<wbr/> Their behavior will not be
2536consistent across all devices,<wbr/> and any given device may only implement
2537a subset of these modes.<wbr/></p>
2538 </td>
2539 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2540
Ruben Brunk9e28ea72014-01-14 18:55:29 -0800[diff] [blame]2541 <tr class="entries_header">
2542 <th class="th_details" colspan="5">HAL Implementation Details</th>
2543 </tr>
2544 <tr class="entry_cont">
2545 <td class="entry_details" colspan="5">
2546 <p>HAL implementations that include scene modes are expected to provide
2547the per-scene settings to use for <a href="#controls_android.control.aeMode">android.<wbr/>control.<wbr/>ae<wbr/>Mode</a>,<wbr/>
2548<a href="#controls_android.control.awbMode">android.<wbr/>control.<wbr/>awb<wbr/>Mode</a>,<wbr/> and <a href="#controls_android.control.afMode">android.<wbr/>control.<wbr/>af<wbr/>Mode</a> in
2549<a href="#static_android.control.sceneModeOverrides">android.<wbr/>control.<wbr/>scene<wbr/>Mode<wbr/>Overrides</a>.<wbr/></p>
2550 </td>
2551 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2552
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2553 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
2554 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2555
2556
2557 <tr class="entry" id="controls_android.control.videoStabilizationMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2558 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2559 android.<wbr/>control.<wbr/>video<wbr/>Stabilization<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2560 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2561 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]2562 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2563
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]2564 <span class="entry_type_visibility"> [public as boolean]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2565
2566 <ul class="entry_type_enum">
2567 <li>
2568 <span class="entry_type_enum_name">OFF</span>
2569 </li>
2570 <li>
2571 <span class="entry_type_enum_name">ON</span>
2572 </li>
2573 </ul>
2574
2575 </td> <!-- entry_type -->
2576
2577 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2578 <p>Whether video stabilization is
2579active</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2580 </td>
2581
2582 <td class="entry_units">
2583 </td>
2584
2585 <td class="entry_range">
2586 </td>
2587
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2588 <td class="entry_tags">
2589 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]2590 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2591 </ul>
2592 </td>
2593
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2594 </tr>
2595 <tr class="entries_header">
2596 <th class="th_details" colspan="5">Details</th>
2597 </tr>
2598 <tr class="entry_cont">
2599 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2600 <p>If enabled,<wbr/> video stabilization can modify the
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]2601<a href="#controls_android.scaler.cropRegion">android.<wbr/>scaler.<wbr/>crop<wbr/>Region</a> to keep the video stream
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2602stabilized</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2603 </td>
2604 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2605
2606
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2607 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
2608 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2609
2610
2611
2612 <!-- end of kind -->
2613 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2614 <tr><td colspan="6" class="kind">static</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2615
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2616 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2617 <tr>
2618 <th class="th_name">Property Name</th>
2619 <th class="th_type">Type</th>
2620 <th class="th_description">Description</th>
2621 <th class="th_units">Units</th>
2622 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2623 <th class="th_tags">Tags</th>
2624 </tr>
2625 </thead>
2626
2627 <tbody>
2628
2629
2630
2631
2632
2633
2634
2635
2636
2637
2638 <tr class="entry" id="static_android.control.aeAvailableAntibandingModes">
Eino-Ville Talvala19ce2c12013-12-30 12:03:45 -0800[diff] [blame]2639 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2640 android.<wbr/>control.<wbr/>ae<wbr/>Available<wbr/>Antibanding<wbr/>Modes
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2641 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2642 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]2643 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2644 <span class="entry_type_container">x</span>
2645
2646 <span class="entry_type_array">
2647 n
2648 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2649 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2650 <div class="entry_type_notes">list of enums</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2651
2652
2653 </td> <!-- entry_type -->
2654
2655 <td class="entry_description">
Eino-Ville Talvala19ce2c12013-12-30 12:03:45 -0800[diff] [blame]2656 <p>The set of auto-exposure antibanding modes that are
2657supported by this camera device.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2658 </td>
2659
2660 <td class="entry_units">
2661 </td>
2662
2663 <td class="entry_range">
2664 </td>
2665
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2666 <td class="entry_tags">
2667 </td>
2668
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2669 </tr>
Eino-Ville Talvala19ce2c12013-12-30 12:03:45 -0800[diff] [blame]2670 <tr class="entries_header">
2671 <th class="th_details" colspan="5">Details</th>
2672 </tr>
2673 <tr class="entry_cont">
2674 <td class="entry_details" colspan="5">
2675 <p>Not all of the auto-exposure anti-banding modes may be
2676supported by a given camera device.<wbr/> This field lists the
2677valid anti-banding modes that the application may request
2678for this camera device; they must include AUTO.<wbr/></p>
2679 </td>
2680 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2681
2682
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2683 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
2684 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2685
2686
2687 <tr class="entry" id="static_android.control.aeAvailableModes">
Eino-Ville Talvala9fa0d902014-01-08 16:16:53 -0800[diff] [blame]2688 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2689 android.<wbr/>control.<wbr/>ae<wbr/>Available<wbr/>Modes
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2690 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2691 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]2692 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2693 <span class="entry_type_container">x</span>
2694
2695 <span class="entry_type_array">
2696 n
2697 </span>
Eino-Ville Talvala9fa0d902014-01-08 16:16:53 -0800[diff] [blame]2698 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2699 <div class="entry_type_notes">list of enums</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2700
2701
2702 </td> <!-- entry_type -->
2703
2704 <td class="entry_description">
Eino-Ville Talvala9fa0d902014-01-08 16:16:53 -0800[diff] [blame]2705 <p>The set of auto-exposure modes that are supported by this
2706camera device.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2707 </td>
2708
2709 <td class="entry_units">
2710 </td>
2711
2712 <td class="entry_range">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2713 </td>
2714
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2715 <td class="entry_tags">
Eino-Ville Talvala9fa0d902014-01-08 16:16:53 -0800[diff] [blame]2716 <ul class="entry_tags">
2717 <li><a href="#tag_BC">BC</a></li>
2718 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2719 </td>
2720
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2721 </tr>
Eino-Ville Talvala9fa0d902014-01-08 16:16:53 -0800[diff] [blame]2722 <tr class="entries_header">
2723 <th class="th_details" colspan="5">Details</th>
2724 </tr>
2725 <tr class="entry_cont">
2726 <td class="entry_details" colspan="5">
2727 <p>Not all the auto-exposure modes may be supported by a
2728given camera device,<wbr/> especially if no flash unit is
2729available.<wbr/> This entry lists the valid modes for
2730<a href="#controls_android.control.aeMode">android.<wbr/>control.<wbr/>ae<wbr/>Mode</a> for this camera device.<wbr/></p>
2731<p>All camera devices support ON,<wbr/> and all camera devices with
2732flash units support ON_<wbr/>AUTO_<wbr/>FLASH and
2733ON_<wbr/>ALWAYS_<wbr/>FLASH.<wbr/></p>
2734<p>Full-capability camera devices always support OFF mode,<wbr/>
2735which enables application control of camera exposure time,<wbr/>
2736sensitivity,<wbr/> and frame duration.<wbr/></p>
2737 </td>
2738 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2739
2740
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2741 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
2742 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2743
2744
2745 <tr class="entry" id="static_android.control.aeAvailableTargetFpsRanges">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2746 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2747 android.<wbr/>control.<wbr/>ae<wbr/>Available<wbr/>Target<wbr/>Fps<wbr/>Ranges
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2748 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2749 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]2750 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2751 <span class="entry_type_container">x</span>
2752
2753 <span class="entry_type_array">
2754 2 x n
2755 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2756 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2757 <div class="entry_type_notes">list of pairs of frame rates</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2758
2759
2760 </td> <!-- entry_type -->
2761
2762 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2763 <p>List of frame rate ranges supported by the
2764AE algorithm/<wbr/>hardware</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2765 </td>
2766
2767 <td class="entry_units">
2768 </td>
2769
2770 <td class="entry_range">
2771 </td>
2772
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2773 <td class="entry_tags">
2774 </td>
2775
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2776 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2777
2778
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2779 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
2780 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2781
2782
2783 <tr class="entry" id="static_android.control.aeCompensationRange">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2784 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2785 android.<wbr/>control.<wbr/>ae<wbr/>Compensation<wbr/>Range
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2786 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2787 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]2788 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2789 <span class="entry_type_container">x</span>
2790
2791 <span class="entry_type_array">
2792 2
2793 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2794 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2795
2796
2797 </td> <!-- entry_type -->
2798
2799 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2800 <p>Maximum and minimum exposure compensation
2801setting,<wbr/> in counts of
2802android.<wbr/>control.<wbr/>ae<wbr/>Compensation<wbr/>Step<wbr/>Size</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2803 </td>
2804
2805 <td class="entry_units">
2806 </td>
2807
2808 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]2809 <p>At least (-2,<wbr/>2)/<wbr/>(exp compensation step
2810size)</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2811 </td>
2812
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2813 <td class="entry_tags">
2814 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]2815 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2816 </ul>
2817 </td>
2818
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2819 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2820
2821
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2822 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
2823 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2824
2825
2826 <tr class="entry" id="static_android.control.aeCompensationStep">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2827 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2828 android.<wbr/>control.<wbr/>ae<wbr/>Compensation<wbr/>Step
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2829 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2830 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]2831 <span class="entry_type_name">rational</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2832
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2833 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2834
2835
2836 </td> <!-- entry_type -->
2837
2838 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2839 <p>Smallest step by which exposure compensation
2840can be changed</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2841 </td>
2842
2843 <td class="entry_units">
2844 </td>
2845
2846 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]2847 <p>&lt;= 1/<wbr/>2</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2848 </td>
2849
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2850 <td class="entry_tags">
2851 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]2852 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2853 </ul>
2854 </td>
2855
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2856 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2857
2858
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2859 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
2860 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2861
2862
2863 <tr class="entry" id="static_android.control.afAvailableModes">
Zhijun Hef163fa92014-01-14 09:59:04 -0800[diff] [blame]2864 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2865 android.<wbr/>control.<wbr/>af<wbr/>Available<wbr/>Modes
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2866 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2867 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]2868 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2869 <span class="entry_type_container">x</span>
2870
2871 <span class="entry_type_array">
2872 n
2873 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2874 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2875 <div class="entry_type_notes">List of enums</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2876
2877
2878 </td> <!-- entry_type -->
2879
2880 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2881 <p>List of AF modes that can be
Zhijun Hef163fa92014-01-14 09:59:04 -0800[diff] [blame]2882selected with <a href="#controls_android.control.afMode">android.<wbr/>control.<wbr/>af<wbr/>Mode</a>.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2883 </td>
2884
2885 <td class="entry_units">
2886 </td>
2887
2888 <td class="entry_range">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2889 </td>
2890
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2891 <td class="entry_tags">
2892 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]2893 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2894 </ul>
2895 </td>
2896
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2897 </tr>
Zhijun Hef163fa92014-01-14 09:59:04 -0800[diff] [blame]2898 <tr class="entries_header">
2899 <th class="th_details" colspan="5">Details</th>
2900 </tr>
2901 <tr class="entry_cont">
2902 <td class="entry_details" colspan="5">
2903 <p>Not all the auto-focus modes may be supported by a
2904given camera device.<wbr/> This entry lists the valid modes for
2905<a href="#controls_android.control.afMode">android.<wbr/>control.<wbr/>af<wbr/>Mode</a> for this camera device.<wbr/></p>
2906<p>All camera devices will support OFF mode,<wbr/> and all camera devices with
2907adjustable focuser units (<code><a href="#static_android.lens.info.minimumFocusDistance">android.<wbr/>lens.<wbr/>info.<wbr/>minimum<wbr/>Focus<wbr/>Distance</a> &gt; 0</code>)
2908will support AUTO mode.<wbr/></p>
2909 </td>
2910 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2911
2912
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2913 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
2914 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2915
2916
2917 <tr class="entry" id="static_android.control.availableEffects">
Ruben Brunkb28b35f2014-01-14 17:17:19 -0800[diff] [blame]2918 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2919 android.<wbr/>control.<wbr/>available<wbr/>Effects
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2920 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2921 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]2922 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2923 <span class="entry_type_container">x</span>
2924
2925 <span class="entry_type_array">
2926 n
2927 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2928 <span class="entry_type_visibility"> [public]</span>
Ruben Brunkb28b35f2014-01-14 17:17:19 -0800[diff] [blame]2929 <div class="entry_type_notes">List of enums (android.<wbr/>control.<wbr/>effect<wbr/>Mode).<wbr/></div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2930
2931
2932 </td> <!-- entry_type -->
2933
2934 <td class="entry_description">
Ruben Brunkb28b35f2014-01-14 17:17:19 -0800[diff] [blame]2935 <p>List containing the subset of color effects
2936specified in <a href="#controls_android.control.effectMode">android.<wbr/>control.<wbr/>effect<wbr/>Mode</a> that is supported by
2937this device.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2938 </td>
2939
2940 <td class="entry_units">
2941 </td>
2942
2943 <td class="entry_range">
Ruben Brunkb28b35f2014-01-14 17:17:19 -0800[diff] [blame]2944 <p>Any subset of enums from those specified in
2945<a href="#controls_android.control.effectMode">android.<wbr/>control.<wbr/>effect<wbr/>Mode</a>.<wbr/> OFF must be included in any subset.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2946 </td>
2947
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2948 <td class="entry_tags">
2949 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]2950 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2951 </ul>
2952 </td>
2953
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2954 </tr>
Ruben Brunkb28b35f2014-01-14 17:17:19 -0800[diff] [blame]2955 <tr class="entries_header">
2956 <th class="th_details" colspan="5">Details</th>
2957 </tr>
2958 <tr class="entry_cont">
2959 <td class="entry_details" colspan="5">
2960 <p>This list contains the color effect modes that can be applied to
2961images produced by the camera device.<wbr/> Only modes that have
2962been fully implemented for the current device may be included here.<wbr/>
2963Implementations are not expected to be consistent across all devices.<wbr/>
2964If no color effect modes are available for a device,<wbr/> this should
2965simply be set to OFF.<wbr/></p>
2966<p>A color effect will only be applied if
2967<a href="#controls_android.control.mode">android.<wbr/>control.<wbr/>mode</a> != OFF.<wbr/></p>
2968 </td>
2969 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2970
2971
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2972 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
2973 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2974
2975
2976 <tr class="entry" id="static_android.control.availableSceneModes">
Ruben Brunkbf870fc2014-01-14 17:46:58 -0800[diff] [blame]2977 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2978 android.<wbr/>control.<wbr/>available<wbr/>Scene<wbr/>Modes
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2979 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2980 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]2981 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2982 <span class="entry_type_container">x</span>
2983
2984 <span class="entry_type_array">
2985 n
2986 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2987 <span class="entry_type_visibility"> [public]</span>
Ruben Brunkbf870fc2014-01-14 17:46:58 -0800[diff] [blame]2988 <div class="entry_type_notes">List of enums (android.<wbr/>control.<wbr/>scene<wbr/>Mode).<wbr/></div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2989
2990
2991 </td> <!-- entry_type -->
2992
2993 <td class="entry_description">
Ruben Brunkbf870fc2014-01-14 17:46:58 -0800[diff] [blame]2994 <p>List containing a subset of scene modes
2995specified in <a href="#controls_android.control.sceneMode">android.<wbr/>control.<wbr/>scene<wbr/>Mode</a>.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2996 </td>
2997
2998 <td class="entry_units">
2999 </td>
3000
3001 <td class="entry_range">
Ruben Brunkbf870fc2014-01-14 17:46:58 -0800[diff] [blame]3002 <p>Any subset of the enums specified in android.<wbr/>control.<wbr/>scene<wbr/>Mode
3003not including DISABLED,<wbr/> or solely DISABLED if no
3004scene modes are available.<wbr/> FACE_<wbr/>PRIORITY must be included
3005if face detection is supported (i.<wbr/>e.<wbr/><code><a href="#static_android.statistics.info.maxFaceCount">android.<wbr/>statistics.<wbr/>info.<wbr/>max<wbr/>Face<wbr/>Count</a> &gt; 0</code>).<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3006 </td>
3007
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3008 <td class="entry_tags">
3009 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]3010 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3011 </ul>
3012 </td>
3013
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3014 </tr>
Ruben Brunkbf870fc2014-01-14 17:46:58 -0800[diff] [blame]3015 <tr class="entries_header">
3016 <th class="th_details" colspan="5">Details</th>
3017 </tr>
3018 <tr class="entry_cont">
3019 <td class="entry_details" colspan="5">
3020 <p>This list contains scene modes that can be set for the camera device.<wbr/>
3021Only scene modes that have been fully implemented for the
3022camera device may be included here.<wbr/> Implementations are not expected
3023to be consistent across all devices.<wbr/> If no scene modes are supported
3024by the camera device,<wbr/> this will be set to <code>[DISABLED]</code>.<wbr/></p>
3025 </td>
3026 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3027
3028
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3029 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
3030 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3031
3032
3033 <tr class="entry" id="static_android.control.availableVideoStabilizationModes">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3034 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3035 android.<wbr/>control.<wbr/>available<wbr/>Video<wbr/>Stabilization<wbr/>Modes
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3036 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3037 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]3038 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3039 <span class="entry_type_container">x</span>
3040
3041 <span class="entry_type_array">
3042 n
3043 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3044 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3045 <div class="entry_type_notes">List of enums.<wbr/></div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3046
3047
3048 </td> <!-- entry_type -->
3049
3050 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3051 <p>List of video stabilization modes that can
3052be supported</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3053 </td>
3054
3055 <td class="entry_units">
3056 </td>
3057
3058 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]3059 <p>OFF must be included</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3060 </td>
3061
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3062 <td class="entry_tags">
3063 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]3064 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3065 </ul>
3066 </td>
3067
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3068 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3069
3070
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3071 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
3072 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3073
3074
3075 <tr class="entry" id="static_android.control.awbAvailableModes">
Zhijun He7787f7f2014-01-14 16:30:31 -0800[diff] [blame]3076 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3077 android.<wbr/>control.<wbr/>awb<wbr/>Available<wbr/>Modes
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3078 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3079 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]3080 <span class="entry_type_name">byte</span>
Alex Raya4251d92013-04-30 16:43:44 -0700[diff] [blame]3081 <span class="entry_type_container">x</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3082
Alex Raya4251d92013-04-30 16:43:44 -0700[diff] [blame]3083 <span class="entry_type_array">
3084 n
3085 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3086 <span class="entry_type_visibility"> [public]</span>
Zhijun He7787f7f2014-01-14 16:30:31 -0800[diff] [blame]3087 <div class="entry_type_notes">List of enums</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3088
3089
3090 </td> <!-- entry_type -->
3091
3092 <td class="entry_description">
Zhijun He7787f7f2014-01-14 16:30:31 -0800[diff] [blame]3093 <p>The set of auto-white-balance modes (<a href="#controls_android.control.awbMode">android.<wbr/>control.<wbr/>awb<wbr/>Mode</a>)
3094that are supported by this camera device.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3095 </td>
3096
3097 <td class="entry_units">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3098 </td>
3099
3100 <td class="entry_range">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3101 </td>
3102
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3103 <td class="entry_tags">
3104 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]3105 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3106 </ul>
3107 </td>
3108
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3109 </tr>
Zhijun He7787f7f2014-01-14 16:30:31 -0800[diff] [blame]3110 <tr class="entries_header">
3111 <th class="th_details" colspan="5">Details</th>
3112 </tr>
3113 <tr class="entry_cont">
3114 <td class="entry_details" colspan="5">
3115 <p>Not all the auto-white-balance modes may be supported by a
3116given camera device.<wbr/> This entry lists the valid modes for
3117<a href="#controls_android.control.awbMode">android.<wbr/>control.<wbr/>awb<wbr/>Mode</a> for this camera device.<wbr/></p>
3118<p>All camera devices will support ON mode.<wbr/></p>
3119<p>Full-capability camera devices will always support OFF mode,<wbr/>
3120which enables application control of white balance,<wbr/> by using
3121<a href="#controls_android.colorCorrection.transform">android.<wbr/>color<wbr/>Correction.<wbr/>transform</a> and <a href="#controls_android.colorCorrection.gains">android.<wbr/>color<wbr/>Correction.<wbr/>gains</a>(<a href="#controls_android.colorCorrection.mode">android.<wbr/>color<wbr/>Correction.<wbr/>mode</a> must be set to TRANSFORM_<wbr/>MATRIX).<wbr/></p>
3122 </td>
3123 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3124
3125
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3126 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
3127 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3128
3129
3130 <tr class="entry" id="static_android.control.maxRegions">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3131 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3132 android.<wbr/>control.<wbr/>max<wbr/>Regions
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3133 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3134 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]3135 <span class="entry_type_name">int32</span>
Ruben Brunk120eea42014-01-15 15:55:08 -0800[diff] [blame]3136 <span class="entry_type_container">x</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3137
Ruben Brunk120eea42014-01-15 15:55:08 -0800[diff] [blame]3138 <span class="entry_type_array">
3139 3
3140 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3141 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3142
3143
3144 </td> <!-- entry_type -->
3145
3146 <td class="entry_description">
Ruben Brunk120eea42014-01-15 15:55:08 -0800[diff] [blame]3147 <p>List of the maximum number of regions that can be used for metering in
3148auto-exposure (AE),<wbr/> auto-white balance (AWB),<wbr/> and auto-focus (AF);
3149this corresponds to the the maximum number of elements in
3150<a href="#controls_android.control.aeRegions">android.<wbr/>control.<wbr/>ae<wbr/>Regions</a>,<wbr/> <a href="#controls_android.control.awbRegions">android.<wbr/>control.<wbr/>awb<wbr/>Regions</a>,<wbr/>
3151and <a href="#controls_android.control.afRegions">android.<wbr/>control.<wbr/>af<wbr/>Regions</a>.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3152 </td>
3153
3154 <td class="entry_units">
3155 </td>
3156
3157 <td class="entry_range">
Ruben Brunk120eea42014-01-15 15:55:08 -0800[diff] [blame]3158 <p>Value must be &gt;= 0 for each element.<wbr/> For full-capability devices
3159this value must be &gt;= 1 for AE and AF.<wbr/> The order of the elements is:
3160<code>(AE,<wbr/> AWB,<wbr/> AF)</code>.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3161 </td>
3162
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3163 <td class="entry_tags">
3164 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]3165 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3166 </ul>
3167 </td>
3168
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3169 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3170
3171
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3172 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
3173 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3174
3175
3176 <tr class="entry" id="static_android.control.sceneModeOverrides">
Ruben Brunkcf77fe92014-01-14 19:31:21 -0800[diff] [blame]3177 <td class="entry_name" rowspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3178 android.<wbr/>control.<wbr/>scene<wbr/>Mode<wbr/>Overrides
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3179 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3180 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]3181 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3182 <span class="entry_type_container">x</span>
3183
3184 <span class="entry_type_array">
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3185 3 x length(availableSceneModes)
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3186 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3187 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3188
3189
3190 </td> <!-- entry_type -->
3191
3192 <td class="entry_description">
Ruben Brunkcf77fe92014-01-14 19:31:21 -0800[diff] [blame]3193 <p>Ordered list of auto-exposure,<wbr/> auto-white balance,<wbr/> and auto-focus
3194settings to use with each available scene mode.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3195 </td>
3196
3197 <td class="entry_units">
3198 </td>
3199
3200 <td class="entry_range">
Ruben Brunkcf77fe92014-01-14 19:31:21 -0800[diff] [blame]3201 <p>For each available scene mode,<wbr/> the list must contain three
3202entries containing the <a href="#controls_android.control.aeMode">android.<wbr/>control.<wbr/>ae<wbr/>Mode</a>,<wbr/>
3203<a href="#controls_android.control.awbMode">android.<wbr/>control.<wbr/>awb<wbr/>Mode</a>,<wbr/> and <a href="#controls_android.control.afMode">android.<wbr/>control.<wbr/>af<wbr/>Mode</a> values used
3204by the camera device.<wbr/> The entry order is <code>(aeMode,<wbr/> awbMode,<wbr/> afMode)</code>
3205where aeMode has the lowest index position.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3206 </td>
3207
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3208 <td class="entry_tags">
3209 <ul class="entry_tags">
3210 <li><a href="#tag_BC">BC</a></li>
3211 </ul>
3212 </td>
3213
3214 </tr>
3215 <tr class="entries_header">
3216 <th class="th_details" colspan="5">Details</th>
3217 </tr>
3218 <tr class="entry_cont">
3219 <td class="entry_details" colspan="5">
Ruben Brunkcf77fe92014-01-14 19:31:21 -0800[diff] [blame]3220 <p>When a scene mode is enabled,<wbr/> the camera device is expected
3221to override <a href="#controls_android.control.aeMode">android.<wbr/>control.<wbr/>ae<wbr/>Mode</a>,<wbr/> <a href="#controls_android.control.awbMode">android.<wbr/>control.<wbr/>awb<wbr/>Mode</a>,<wbr/>
3222and <a href="#controls_android.control.afMode">android.<wbr/>control.<wbr/>af<wbr/>Mode</a> with its preferred settings for
3223that scene mode.<wbr/></p>
3224<p>The order of this list matches that of availableSceneModes,<wbr/>
3225with 3 entries for each mode.<wbr/> The overrides listed
3226for FACE_<wbr/>PRIORITY are ignored,<wbr/> since for that
3227mode the application-set <a href="#controls_android.control.aeMode">android.<wbr/>control.<wbr/>ae<wbr/>Mode</a>,<wbr/>
3228<a href="#controls_android.control.awbMode">android.<wbr/>control.<wbr/>awb<wbr/>Mode</a>,<wbr/> and <a href="#controls_android.control.afMode">android.<wbr/>control.<wbr/>af<wbr/>Mode</a> values are
3229used instead,<wbr/> matching the behavior when android.<wbr/>control.<wbr/>mode
3230is set to AUTO.<wbr/> It is recommended that the FACE_<wbr/>PRIORITY
3231overrides should be set to 0.<wbr/></p>
3232<p>For example,<wbr/> if availableSceneModes contains
3233<code>(FACE_<wbr/>PRIORITY,<wbr/> ACTION,<wbr/> NIGHT)</code>,<wbr/> then the camera framework
3234expects sceneModeOverrides to have 9 entries formatted like:
3235<code>(0,<wbr/> 0,<wbr/> 0,<wbr/> ON_<wbr/>AUTO_<wbr/>FLASH,<wbr/> AUTO,<wbr/> CONTINUOUS_<wbr/>PICTURE,<wbr/>
3236ON_<wbr/>AUTO_<wbr/>FLASH,<wbr/> INCANDESCENT,<wbr/> AUTO)</code>.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3237 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3238 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3239
Ruben Brunkcf77fe92014-01-14 19:31:21 -0800[diff] [blame]3240 <tr class="entries_header">
3241 <th class="th_details" colspan="5">HAL Implementation Details</th>
3242 </tr>
3243 <tr class="entry_cont">
3244 <td class="entry_details" colspan="5">
3245 <p>To maintain backward compatibility,<wbr/> this list will be made available
3246in the static metadata of the camera service.<wbr/> The camera service will
3247use these values to set <a href="#controls_android.control.aeMode">android.<wbr/>control.<wbr/>ae<wbr/>Mode</a>,<wbr/>
3248<a href="#controls_android.control.awbMode">android.<wbr/>control.<wbr/>awb<wbr/>Mode</a>,<wbr/> and <a href="#controls_android.control.afMode">android.<wbr/>control.<wbr/>af<wbr/>Mode</a> when using a scene
3249mode other than FACE_<wbr/>PRIORITY.<wbr/></p>
3250 </td>
3251 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3252
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3253 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
3254 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3255
3256
3257
3258 <!-- end of kind -->
3259 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3260 <tr><td colspan="6" class="kind">dynamic</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3261
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3262 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3263 <tr>
3264 <th class="th_name">Property Name</th>
3265 <th class="th_type">Type</th>
3266 <th class="th_description">Description</th>
3267 <th class="th_units">Units</th>
3268 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3269 <th class="th_tags">Tags</th>
3270 </tr>
3271 </thead>
3272
3273 <tbody>
3274
3275
3276
3277
3278
3279
3280
3281
3282
3283
3284 <tr class="entry" id="dynamic_android.control.aePrecaptureId">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3285 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3286 android.<wbr/>control.<wbr/>ae<wbr/>Precapture<wbr/>Id
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3287 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3288 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]3289 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3290
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3291 <span class="entry_type_visibility"> [hidden]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3292
3293
3294 </td> <!-- entry_type -->
3295
3296 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3297 <p>The ID sent with the latest
3298CAMERA2_<wbr/>TRIGGER_<wbr/>PRECAPTURE_<wbr/>METERING call</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3299 </td>
3300
3301 <td class="entry_units">
3302 </td>
3303
3304 <td class="entry_range">
3305 </td>
3306
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3307 <td class="entry_tags">
3308 </td>
3309
3310 </tr>
3311 <tr class="entries_header">
3312 <th class="th_details" colspan="5">Details</th>
3313 </tr>
3314 <tr class="entry_cont">
3315 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3316 <p>Must be 0 if no
3317CAMERA2_<wbr/>TRIGGER_<wbr/>PRECAPTURE_<wbr/>METERING trigger received yet
3318by HAL.<wbr/> Always updated even if AE algorithm ignores the
3319trigger</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3320 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3321 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3322
3323
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3324 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
3325 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3326
3327
Eino-Ville Talvala9fa0d902014-01-08 16:16:53 -0800[diff] [blame]3328 <tr class="entry" id="dynamic_android.control.aeMode">
3329 <td class="entry_name" rowspan="3">
3330 android.<wbr/>control.<wbr/>ae<wbr/>Mode
3331 </td>
3332 <td class="entry_type">
3333 <span class="entry_type_name entry_type_name_enum">byte</span>
3334
3335 <span class="entry_type_visibility"> [public]</span>
3336
3337 <ul class="entry_type_enum">
3338 <li>
3339 <span class="entry_type_enum_name">OFF</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]3340 <span class="entry_type_enum_notes"><p>The camera device's autoexposure routine is disabled;
3341the application-selected <a href="#controls_android.sensor.exposureTime">android.<wbr/>sensor.<wbr/>exposure<wbr/>Time</a>,<wbr/>
3342<a href="#controls_android.sensor.sensitivity">android.<wbr/>sensor.<wbr/>sensitivity</a> and
3343<a href="#controls_android.sensor.frameDuration">android.<wbr/>sensor.<wbr/>frame<wbr/>Duration</a> are used by the camera
3344device,<wbr/> along with android.<wbr/>flash.<wbr/>* fields,<wbr/> if there's
3345a flash unit for this camera device.<wbr/></p></span>
Eino-Ville Talvala9fa0d902014-01-08 16:16:53 -0800[diff] [blame]3346 </li>
3347 <li>
3348 <span class="entry_type_enum_name">ON</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]3349 <span class="entry_type_enum_notes"><p>The camera device's autoexposure routine is active,<wbr/>
3350with no flash control.<wbr/> The application's values for
3351<a href="#controls_android.sensor.exposureTime">android.<wbr/>sensor.<wbr/>exposure<wbr/>Time</a>,<wbr/>
3352<a href="#controls_android.sensor.sensitivity">android.<wbr/>sensor.<wbr/>sensitivity</a>,<wbr/> and
3353<a href="#controls_android.sensor.frameDuration">android.<wbr/>sensor.<wbr/>frame<wbr/>Duration</a> are ignored.<wbr/> The
3354application has control over the various
3355android.<wbr/>flash.<wbr/>* fields.<wbr/></p></span>
Eino-Ville Talvala9fa0d902014-01-08 16:16:53 -0800[diff] [blame]3356 </li>
3357 <li>
3358 <span class="entry_type_enum_name">ON_AUTO_FLASH</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]3359 <span class="entry_type_enum_notes"><p>Like ON,<wbr/> except that the camera device also controls
3360the camera's flash unit,<wbr/> firing it in low-light
3361conditions.<wbr/> The flash may be fired during a
3362precapture sequence (triggered by
3363<a href="#controls_android.control.aePrecaptureTrigger">android.<wbr/>control.<wbr/>ae<wbr/>Precapture<wbr/>Trigger</a>) and may be fired
3364for captures for which the
3365<a href="#controls_android.control.captureIntent">android.<wbr/>control.<wbr/>capture<wbr/>Intent</a> field is set to
3366STILL_<wbr/>CAPTURE</p></span>
Eino-Ville Talvala9fa0d902014-01-08 16:16:53 -0800[diff] [blame]3367 </li>
3368 <li>
3369 <span class="entry_type_enum_name">ON_ALWAYS_FLASH</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]3370 <span class="entry_type_enum_notes"><p>Like ON,<wbr/> except that the camera device also controls
3371the camera's flash unit,<wbr/> always firing it for still
3372captures.<wbr/> The flash may be fired during a precapture
3373sequence (triggered by
3374<a href="#controls_android.control.aePrecaptureTrigger">android.<wbr/>control.<wbr/>ae<wbr/>Precapture<wbr/>Trigger</a>) and will always
3375be fired for captures for which the
3376<a href="#controls_android.control.captureIntent">android.<wbr/>control.<wbr/>capture<wbr/>Intent</a> field is set to
3377STILL_<wbr/>CAPTURE</p></span>
Eino-Ville Talvala9fa0d902014-01-08 16:16:53 -0800[diff] [blame]3378 </li>
3379 <li>
3380 <span class="entry_type_enum_name">ON_AUTO_FLASH_REDEYE</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]3381 <span class="entry_type_enum_notes"><p>Like ON_<wbr/>AUTO_<wbr/>FLASH,<wbr/> but with automatic red eye
3382reduction.<wbr/> If deemed necessary by the camera device,<wbr/>
3383a red eye reduction flash will fire during the
3384precapture sequence.<wbr/></p></span>
Eino-Ville Talvala9fa0d902014-01-08 16:16:53 -0800[diff] [blame]3385 </li>
3386 </ul>
3387
3388 </td> <!-- entry_type -->
3389
3390 <td class="entry_description">
3391 <p>The desired mode for the camera device's
3392auto-exposure routine.<wbr/></p>
3393 </td>
3394
3395 <td class="entry_units">
3396 </td>
3397
3398 <td class="entry_range">
3399 <p><a href="#static_android.control.aeAvailableModes">android.<wbr/>control.<wbr/>ae<wbr/>Available<wbr/>Modes</a></p>
3400 </td>
3401
3402 <td class="entry_tags">
3403 <ul class="entry_tags">
3404 <li><a href="#tag_BC">BC</a></li>
3405 </ul>
3406 </td>
3407
3408 </tr>
3409 <tr class="entries_header">
3410 <th class="th_details" colspan="5">Details</th>
3411 </tr>
3412 <tr class="entry_cont">
3413 <td class="entry_details" colspan="5">
3414 <p>This control is only effective if <a href="#controls_android.control.mode">android.<wbr/>control.<wbr/>mode</a> is
3415AUTO.<wbr/></p>
3416<p>When set to any of the ON modes,<wbr/> the camera device's
3417auto-exposure routine is enabled,<wbr/> overriding the
3418application's selected exposure time,<wbr/> sensor sensitivity,<wbr/>
3419and frame duration (<a href="#controls_android.sensor.exposureTime">android.<wbr/>sensor.<wbr/>exposure<wbr/>Time</a>,<wbr/>
3420<a href="#controls_android.sensor.sensitivity">android.<wbr/>sensor.<wbr/>sensitivity</a>,<wbr/> and
3421<a href="#controls_android.sensor.frameDuration">android.<wbr/>sensor.<wbr/>frame<wbr/>Duration</a>).<wbr/> If one of the FLASH modes
3422is selected,<wbr/> the camera device's flash unit controls are
3423also overridden.<wbr/></p>
3424<p>The FLASH modes are only available if the camera device
3425has a flash unit (<a href="#static_android.flash.info.available">android.<wbr/>flash.<wbr/>info.<wbr/>available</a> is <code>true</code>).<wbr/></p>
3426<p>If flash TORCH mode is desired,<wbr/> this field must be set to
3427ON or OFF,<wbr/> and <a href="#controls_android.flash.mode">android.<wbr/>flash.<wbr/>mode</a> set to TORCH.<wbr/></p>
3428<p>When set to any of the ON modes,<wbr/> the values chosen by the
3429camera device auto-exposure routine for the overridden
3430fields for a given capture will be available in its
3431CaptureResult.<wbr/></p>
3432 </td>
3433 </tr>
3434
3435
3436 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
3437 <!-- end of entry -->
3438
3439
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3440 <tr class="entry" id="dynamic_android.control.aeRegions">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3441 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3442 android.<wbr/>control.<wbr/>ae<wbr/>Regions
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3443 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3444 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]3445 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3446 <span class="entry_type_container">x</span>
3447
3448 <span class="entry_type_array">
3449 5 x area_count
3450 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3451 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3452
3453
3454 </td> <!-- entry_type -->
3455
3456 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3457 <p>List of areas to use for
Ruben Brunk76e4c7d2014-01-31 11:05:30 -0800[diff] [blame]3458metering.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3459 </td>
3460
3461 <td class="entry_units">
3462 </td>
3463
3464 <td class="entry_range">
Ruben Brunk76e4c7d2014-01-31 11:05:30 -0800[diff] [blame]3465 <p><code>area_<wbr/>count &lt;= <a href="#static_android.control.maxRegions">android.<wbr/>control.<wbr/>max<wbr/>Regions</a>[0]</code></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3466 </td>
3467
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3468 <td class="entry_tags">
3469 <ul class="entry_tags">
3470 <li><a href="#tag_BC">BC</a></li>
3471 </ul>
3472 </td>
3473
3474 </tr>
3475 <tr class="entries_header">
3476 <th class="th_details" colspan="5">Details</th>
3477 </tr>
3478 <tr class="entry_cont">
3479 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3480 <p>Each area is a rectangle plus weight: xmin,<wbr/> ymin,<wbr/>
Ruben Brunk76e4c7d2014-01-31 11:05:30 -0800[diff] [blame]3481xmax,<wbr/> ymax,<wbr/> weight.<wbr/> The rectangle is defined to be inclusive of the
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3482specified coordinates.<wbr/></p>
3483<p>The coordinate system is based on the active pixel array,<wbr/>
3484with (0,<wbr/>0) being the top-left pixel in the active pixel array,<wbr/> and
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]3485(<a href="#static_android.sensor.info.activeArraySize">android.<wbr/>sensor.<wbr/>info.<wbr/>active<wbr/>Array<wbr/>Size</a>.<wbr/>width - 1,<wbr/>
3486<a href="#static_android.sensor.info.activeArraySize">android.<wbr/>sensor.<wbr/>info.<wbr/>active<wbr/>Array<wbr/>Size</a>.<wbr/>height - 1) being the
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3487bottom-right pixel in the active pixel array.<wbr/> The weight
3488should be nonnegative.<wbr/></p>
3489<p>If all regions have 0 weight,<wbr/> then no specific metering area
3490needs to be used by the HAL.<wbr/> If the metering region is
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]3491outside the current <a href="#controls_android.scaler.cropRegion">android.<wbr/>scaler.<wbr/>crop<wbr/>Region</a>,<wbr/> the HAL
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]3492should ignore the sections outside the region and output the
Ruben Brunk76e4c7d2014-01-31 11:05:30 -0800[diff] [blame]3493used sections in the frame metadata.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3494 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3495 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3496
3497
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3498 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
3499 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3500
3501
3502 <tr class="entry" id="dynamic_android.control.aeState">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3503 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3504 android.<wbr/>control.<wbr/>ae<wbr/>State
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3505 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3506 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]3507 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3508
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3509 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3510
3511 <ul class="entry_type_enum">
3512 <li>
3513 <span class="entry_type_enum_name">INACTIVE</span>
Zhijun He92e698d2014-01-13 16:24:31 -0800[diff] [blame]3514 <span class="entry_type_enum_notes"><p>AE is off or recently reset.<wbr/> When a camera device is opened,<wbr/> it starts in
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]3515this state.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3516 </li>
3517 <li>
3518 <span class="entry_type_enum_name">SEARCHING</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]3519 <span class="entry_type_enum_notes"><p>AE doesn't yet have a good set of control values
Zhijun He92e698d2014-01-13 16:24:31 -0800[diff] [blame]3520for the current scene.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3521 </li>
3522 <li>
3523 <span class="entry_type_enum_name">CONVERGED</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]3524 <span class="entry_type_enum_notes"><p>AE has a good set of control values for the
Zhijun He92e698d2014-01-13 16:24:31 -0800[diff] [blame]3525current scene.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3526 </li>
3527 <li>
3528 <span class="entry_type_enum_name">LOCKED</span>
Zhijun He92e698d2014-01-13 16:24:31 -0800[diff] [blame]3529 <span class="entry_type_enum_notes"><p>AE has been locked.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3530 </li>
3531 <li>
3532 <span class="entry_type_enum_name">FLASH_REQUIRED</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]3533 <span class="entry_type_enum_notes"><p>AE has a good set of control values,<wbr/> but flash
3534needs to be fired for good quality still
Zhijun He92e698d2014-01-13 16:24:31 -0800[diff] [blame]3535capture.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3536 </li>
3537 <li>
3538 <span class="entry_type_enum_name">PRECAPTURE</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]3539 <span class="entry_type_enum_notes"><p>AE has been asked to do a precapture sequence
Zhijun He92e698d2014-01-13 16:24:31 -0800[diff] [blame]3540(through the <a href="#controls_android.control.aePrecaptureTrigger">android.<wbr/>control.<wbr/>ae<wbr/>Precapture<wbr/>Trigger</a> START),<wbr/>
3541and is currently executing it.<wbr/> Once PRECAPTURE
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]3542completes,<wbr/> AE will transition to CONVERGED or
Zhijun He92e698d2014-01-13 16:24:31 -0800[diff] [blame]3543FLASH_<wbr/>REQUIRED as appropriate.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3544 </li>
3545 </ul>
3546
3547 </td> <!-- entry_type -->
3548
3549 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3550 <p>Current state of AE algorithm</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3551 </td>
3552
3553 <td class="entry_units">
3554 </td>
3555
3556 <td class="entry_range">
3557 </td>
3558
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3559 <td class="entry_tags">
3560 </td>
3561
3562 </tr>
3563 <tr class="entries_header">
3564 <th class="th_details" colspan="5">Details</th>
3565 </tr>
3566 <tr class="entry_cont">
3567 <td class="entry_details" colspan="5">
Zhijun He92e698d2014-01-13 16:24:31 -0800[diff] [blame]3568 <p>Switching between or enabling AE modes (<a href="#controls_android.control.aeMode">android.<wbr/>control.<wbr/>ae<wbr/>Mode</a>) always
3569resets the AE state to INACTIVE.<wbr/> Similarly,<wbr/> switching between <a href="#controls_android.control.mode">android.<wbr/>control.<wbr/>mode</a>,<wbr/>
3570or <a href="#controls_android.control.sceneMode">android.<wbr/>control.<wbr/>scene<wbr/>Mode</a> if <code><a href="#controls_android.control.mode">android.<wbr/>control.<wbr/>mode</a> == USE_<wbr/>SCENE_<wbr/>MODE</code> resets all
3571the algorithm states to INACTIVE.<wbr/></p>
3572<p>The camera device can do several state transitions between two results,<wbr/> if it is
3573allowed by the state transition table.<wbr/> For example: INACTIVE may never actually be
3574seen in a result.<wbr/></p>
3575<p>The state in the result is the state for this image (in sync with this image): if
3576AE state becomes CONVERGED,<wbr/> then the image data associated with this result should
3577be good to use.<wbr/></p>
3578<p>Below are state transition tables for different AE modes.<wbr/></p>
3579<table>
3580<thead>
3581<tr>
3582<th align="center">State</th>
3583<th align="center">Transition Cause</th>
3584<th align="center">New State</th>
3585<th align="center">Notes</th>
3586</tr>
3587</thead>
3588<tbody>
3589<tr>
3590<td align="center">INACTIVE</td>
3591<td align="center"></td>
3592<td align="center">INACTIVE</td>
3593<td align="center">Camera device auto exposure algorithm is disabled</td>
3594</tr>
3595</tbody>
3596</table>
3597<p>When <a href="#controls_android.control.aeMode">android.<wbr/>control.<wbr/>ae<wbr/>Mode</a> is AE_<wbr/>MODE_<wbr/>ON_<wbr/>*:</p>
3598<table>
3599<thead>
3600<tr>
3601<th align="center">State</th>
3602<th align="center">Transition Cause</th>
3603<th align="center">New State</th>
3604<th align="center">Notes</th>
3605</tr>
3606</thead>
3607<tbody>
3608<tr>
3609<td align="center">INACTIVE</td>
3610<td align="center">Camera device initiates AE scan</td>
3611<td align="center">SEARCHING</td>
3612<td align="center">Values changing</td>
3613</tr>
3614<tr>
3615<td align="center">INACTIVE</td>
3616<td align="center"><a href="#controls_android.control.aeLock">android.<wbr/>control.<wbr/>ae<wbr/>Lock</a> is ON</td>
3617<td align="center">LOCKED</td>
3618<td align="center">Values locked</td>
3619</tr>
3620<tr>
3621<td align="center">SEARCHING</td>
3622<td align="center">Camera device finishes AE scan</td>
3623<td align="center">CONVERGED</td>
3624<td align="center">Good values,<wbr/> not changing</td>
3625</tr>
3626<tr>
3627<td align="center">SEARCHING</td>
3628<td align="center">Camera device finishes AE scan</td>
3629<td align="center">FLASH_<wbr/>REQUIRED</td>
3630<td align="center">Converged but too dark w/<wbr/>o flash</td>
3631</tr>
3632<tr>
3633<td align="center">SEARCHING</td>
3634<td align="center"><a href="#controls_android.control.aeLock">android.<wbr/>control.<wbr/>ae<wbr/>Lock</a> is ON</td>
3635<td align="center">LOCKED</td>
3636<td align="center">Values locked</td>
3637</tr>
3638<tr>
3639<td align="center">CONVERGED</td>
3640<td align="center">Camera device initiates AE scan</td>
3641<td align="center">SEARCHING</td>
3642<td align="center">Values changing</td>
3643</tr>
3644<tr>
3645<td align="center">CONVERGED</td>
3646<td align="center"><a href="#controls_android.control.aeLock">android.<wbr/>control.<wbr/>ae<wbr/>Lock</a> is ON</td>
3647<td align="center">LOCKED</td>
3648<td align="center">Values locked</td>
3649</tr>
3650<tr>
3651<td align="center">FLASH_<wbr/>REQUIRED</td>
3652<td align="center">Camera device initiates AE scan</td>
3653<td align="center">SEARCHING</td>
3654<td align="center">Values changing</td>
3655</tr>
3656<tr>
3657<td align="center">FLASH_<wbr/>REQUIRED</td>
3658<td align="center"><a href="#controls_android.control.aeLock">android.<wbr/>control.<wbr/>ae<wbr/>Lock</a> is ON</td>
3659<td align="center">LOCKED</td>
3660<td align="center">Values locked</td>
3661</tr>
3662<tr>
3663<td align="center">LOCKED</td>
3664<td align="center"><a href="#controls_android.control.aeLock">android.<wbr/>control.<wbr/>ae<wbr/>Lock</a> is OFF</td>
3665<td align="center">SEARCHING</td>
3666<td align="center">Values not good after unlock</td>
3667</tr>
3668<tr>
3669<td align="center">LOCKED</td>
3670<td align="center"><a href="#controls_android.control.aeLock">android.<wbr/>control.<wbr/>ae<wbr/>Lock</a> is OFF</td>
3671<td align="center">CONVERGED</td>
3672<td align="center">Values good after unlock</td>
3673</tr>
3674<tr>
3675<td align="center">LOCKED</td>
3676<td align="center"><a href="#controls_android.control.aeLock">android.<wbr/>control.<wbr/>ae<wbr/>Lock</a> is OFF</td>
3677<td align="center">FLASH_<wbr/>REQUIRED</td>
3678<td align="center">Exposure good,<wbr/> but too dark</td>
3679</tr>
3680<tr>
3681<td align="center">PRECAPTURE</td>
3682<td align="center">Sequence done.<wbr/> <a href="#controls_android.control.aeLock">android.<wbr/>control.<wbr/>ae<wbr/>Lock</a> is OFF</td>
3683<td align="center">CONVERGED</td>
3684<td align="center">Ready for high-quality capture</td>
3685</tr>
3686<tr>
3687<td align="center">PRECAPTURE</td>
3688<td align="center">Sequence done.<wbr/> <a href="#controls_android.control.aeLock">android.<wbr/>control.<wbr/>ae<wbr/>Lock</a> is ON</td>
3689<td align="center">LOCKED</td>
3690<td align="center">Ready for high-quality capture</td>
3691</tr>
3692<tr>
3693<td align="center">Any state</td>
3694<td align="center"><a href="#controls_android.control.aePrecaptureTrigger">android.<wbr/>control.<wbr/>ae<wbr/>Precapture<wbr/>Trigger</a> is START</td>
3695<td align="center">PRECAPTURE</td>
3696<td align="center">Start AE precapture metering sequence</td>
3697</tr>
3698</tbody>
3699</table>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3700 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3701 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3702
3703
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3704 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
3705 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3706
3707
3708 <tr class="entry" id="dynamic_android.control.afMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3709 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3710 android.<wbr/>control.<wbr/>af<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3711 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3712 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]3713 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3714
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3715 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3716
3717 <ul class="entry_type_enum">
3718 <li>
3719 <span class="entry_type_enum_name">OFF</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]3720 <span class="entry_type_enum_notes"><p>The auto-focus routine does not control the lens;
3721<a href="#controls_android.lens.focusDistance">android.<wbr/>lens.<wbr/>focus<wbr/>Distance</a> is controlled by the
3722application</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3723 </li>
3724 <li>
3725 <span class="entry_type_enum_name">AUTO</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]3726 <span class="entry_type_enum_notes"><p>If lens is not fixed focus.<wbr/></p>
3727<p>Use <a href="#static_android.lens.info.minimumFocusDistance">android.<wbr/>lens.<wbr/>info.<wbr/>minimum<wbr/>Focus<wbr/>Distance</a> to determine if lens
3728is fixed-focus.<wbr/> In this mode,<wbr/> the lens does not move unless
3729the autofocus trigger action is called.<wbr/> When that trigger
3730is activated,<wbr/> AF must transition to ACTIVE_<wbr/>SCAN,<wbr/> then to
3731the outcome of the scan (FOCUSED or NOT_<wbr/>FOCUSED).<wbr/></p>
3732<p>Triggering AF_<wbr/>CANCEL resets the lens position to default,<wbr/>
3733and sets the AF state to INACTIVE.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3734 </li>
3735 <li>
3736 <span class="entry_type_enum_name">MACRO</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]3737 <span class="entry_type_enum_notes"><p>In this mode,<wbr/> the lens does not move unless the
3738autofocus trigger action is called.<wbr/></p>
3739<p>When that trigger is activated,<wbr/> AF must transition to
3740ACTIVE_<wbr/>SCAN,<wbr/> then to the outcome of the scan (FOCUSED or
3741NOT_<wbr/>FOCUSED).<wbr/> Triggering cancel AF resets the lens
3742position to default,<wbr/> and sets the AF state to
3743INACTIVE.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3744 </li>
3745 <li>
3746 <span class="entry_type_enum_name">CONTINUOUS_VIDEO</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]3747 <span class="entry_type_enum_notes"><p>In this mode,<wbr/> the AF algorithm modifies the lens
3748position continually to attempt to provide a
3749constantly-in-focus image stream.<wbr/></p>
3750<p>The focusing behavior should be suitable for good quality
3751video recording; typically this means slower focus
3752movement and no overshoots.<wbr/> When the AF trigger is not
3753involved,<wbr/> the AF algorithm should start in INACTIVE state,<wbr/>
3754and then transition into PASSIVE_<wbr/>SCAN and PASSIVE_<wbr/>FOCUSED
3755states as appropriate.<wbr/> When the AF trigger is activated,<wbr/>
3756the algorithm should immediately transition into
3757AF_<wbr/>FOCUSED or AF_<wbr/>NOT_<wbr/>FOCUSED as appropriate,<wbr/> and lock the
3758lens position until a cancel AF trigger is received.<wbr/></p>
3759<p>Once cancel is received,<wbr/> the algorithm should transition
3760back to INACTIVE and resume passive scan.<wbr/> Note that this
3761behavior is not identical to CONTINUOUS_<wbr/>PICTURE,<wbr/> since an
3762ongoing PASSIVE_<wbr/>SCAN must immediately be
3763canceled.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3764 </li>
3765 <li>
3766 <span class="entry_type_enum_name">CONTINUOUS_PICTURE</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]3767 <span class="entry_type_enum_notes"><p>In this mode,<wbr/> the AF algorithm modifies the lens
3768position continually to attempt to provide a
3769constantly-in-focus image stream.<wbr/></p>
3770<p>The focusing behavior should be suitable for still image
3771capture; typically this means focusing as fast as
3772possible.<wbr/> When the AF trigger is not involved,<wbr/> the AF
3773algorithm should start in INACTIVE state,<wbr/> and then
3774transition into PASSIVE_<wbr/>SCAN and PASSIVE_<wbr/>FOCUSED states as
3775appropriate as it attempts to maintain focus.<wbr/> When the AF
3776trigger is activated,<wbr/> the algorithm should finish its
3777PASSIVE_<wbr/>SCAN if active,<wbr/> and then transition into
3778AF_<wbr/>FOCUSED or AF_<wbr/>NOT_<wbr/>FOCUSED as appropriate,<wbr/> and lock the
3779lens position until a cancel AF trigger is received.<wbr/></p>
3780<p>When the AF cancel trigger is activated,<wbr/> the algorithm
3781should transition back to INACTIVE and then act as if it
3782has just been started.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3783 </li>
3784 <li>
3785 <span class="entry_type_enum_name">EDOF</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]3786 <span class="entry_type_enum_notes"><p>Extended depth of field (digital focus).<wbr/> AF
3787trigger is ignored,<wbr/> AF state should always be
3788INACTIVE.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3789 </li>
3790 </ul>
3791
3792 </td> <!-- entry_type -->
3793
3794 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3795 <p>Whether AF is currently enabled,<wbr/> and what
3796mode it is set to</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3797 </td>
3798
3799 <td class="entry_units">
3800 </td>
3801
3802 <td class="entry_range">
Zhijun He7787f7f2014-01-14 16:30:31 -0800[diff] [blame]3803 <p><a href="#static_android.control.afAvailableModes">android.<wbr/>control.<wbr/>af<wbr/>Available<wbr/>Modes</a></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3804 </td>
3805
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3806 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]3807 <ul class="entry_tags">
3808 <li><a href="#tag_BC">BC</a></li>
3809 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3810 </td>
3811
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3812 </tr>
3813 <tr class="entries_header">
3814 <th class="th_details" colspan="5">Details</th>
3815 </tr>
3816 <tr class="entry_cont">
3817 <td class="entry_details" colspan="5">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]3818 <p>Only effective if <a href="#controls_android.control.mode">android.<wbr/>control.<wbr/>mode</a> = AUTO.<wbr/></p>
Zhijun Hef163fa92014-01-14 09:59:04 -0800[diff] [blame]3819<p>If the lens is controlled by the camera device auto-focus algorithm,<wbr/>
3820the camera device will report the current AF status in android.<wbr/>control.<wbr/>af<wbr/>State
3821in result metadata.<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3822 </td>
3823 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3824
3825
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3826 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
3827 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3828
3829
3830 <tr class="entry" id="dynamic_android.control.afRegions">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3831 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3832 android.<wbr/>control.<wbr/>af<wbr/>Regions
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3833 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3834 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]3835 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3836 <span class="entry_type_container">x</span>
3837
3838 <span class="entry_type_array">
3839 5 x area_count
3840 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3841 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3842
3843
3844 </td> <!-- entry_type -->
3845
3846 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3847 <p>List of areas to use for focus
Ruben Brunk76e4c7d2014-01-31 11:05:30 -0800[diff] [blame]3848estimation.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3849 </td>
3850
3851 <td class="entry_units">
3852 </td>
3853
3854 <td class="entry_range">
Ruben Brunk76e4c7d2014-01-31 11:05:30 -0800[diff] [blame]3855 <p><code>area_<wbr/>count &lt;= <a href="#static_android.control.maxRegions">android.<wbr/>control.<wbr/>max<wbr/>Regions</a>[2]</code></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3856 </td>
3857
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3858 <td class="entry_tags">
3859 <ul class="entry_tags">
3860 <li><a href="#tag_BC">BC</a></li>
3861 </ul>
3862 </td>
3863
3864 </tr>
3865 <tr class="entries_header">
3866 <th class="th_details" colspan="5">Details</th>
3867 </tr>
3868 <tr class="entry_cont">
3869 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3870 <p>Each area is a rectangle plus weight: xmin,<wbr/> ymin,<wbr/>
Ruben Brunk76e4c7d2014-01-31 11:05:30 -0800[diff] [blame]3871xmax,<wbr/> ymax,<wbr/> weight.<wbr/> The rectangle is defined to be inclusive of the
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3872specified coordinates.<wbr/></p>
3873<p>The coordinate system is based on the active pixel array,<wbr/>
3874with (0,<wbr/>0) being the top-left pixel in the active pixel array,<wbr/> and
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]3875(<a href="#static_android.sensor.info.activeArraySize">android.<wbr/>sensor.<wbr/>info.<wbr/>active<wbr/>Array<wbr/>Size</a>.<wbr/>width - 1,<wbr/>
3876<a href="#static_android.sensor.info.activeArraySize">android.<wbr/>sensor.<wbr/>info.<wbr/>active<wbr/>Array<wbr/>Size</a>.<wbr/>height - 1) being the
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3877bottom-right pixel in the active pixel array.<wbr/> The weight
3878should be nonnegative.<wbr/></p>
3879<p>If all regions have 0 weight,<wbr/> then no specific focus area
3880needs to be used by the HAL.<wbr/> If the focusing region is
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]3881outside the current <a href="#controls_android.scaler.cropRegion">android.<wbr/>scaler.<wbr/>crop<wbr/>Region</a>,<wbr/> the HAL
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]3882should ignore the sections outside the region and output the
Ruben Brunk76e4c7d2014-01-31 11:05:30 -0800[diff] [blame]3883used sections in the frame metadata.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3884 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3885 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3886
3887
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3888 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
3889 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3890
3891
3892 <tr class="entry" id="dynamic_android.control.afState">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3893 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3894 android.<wbr/>control.<wbr/>af<wbr/>State
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3895 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3896 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]3897 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3898
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3899 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3900
3901 <ul class="entry_type_enum">
3902 <li>
3903 <span class="entry_type_enum_name">INACTIVE</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]3904 <span class="entry_type_enum_notes"><p>AF off or has not yet tried to scan/<wbr/>been asked
3905to scan.<wbr/> When a camera device is opened,<wbr/> it starts in
3906this state.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3907 </li>
3908 <li>
3909 <span class="entry_type_enum_name">PASSIVE_SCAN</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]3910 <span class="entry_type_enum_notes"><p>if CONTINUOUS_<wbr/>* modes are supported.<wbr/> AF is
3911currently doing an AF scan initiated by a continuous
3912autofocus mode</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3913 </li>
3914 <li>
3915 <span class="entry_type_enum_name">PASSIVE_FOCUSED</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]3916 <span class="entry_type_enum_notes"><p>if CONTINUOUS_<wbr/>* modes are supported.<wbr/> AF currently
3917believes it is in focus,<wbr/> but may restart scanning at
3918any time.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3919 </li>
3920 <li>
3921 <span class="entry_type_enum_name">ACTIVE_SCAN</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]3922 <span class="entry_type_enum_notes"><p>if AUTO or MACRO modes are supported.<wbr/> AF is doing
3923an AF scan because it was triggered by AF
3924trigger</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3925 </li>
3926 <li>
3927 <span class="entry_type_enum_name">FOCUSED_LOCKED</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]3928 <span class="entry_type_enum_notes"><p>if any AF mode besides OFF is supported.<wbr/> AF
3929believes it is focused correctly and is
3930locked</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3931 </li>
3932 <li>
3933 <span class="entry_type_enum_name">NOT_FOCUSED_LOCKED</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]3934 <span class="entry_type_enum_notes"><p>if any AF mode besides OFF is supported.<wbr/> AF has
3935failed to focus successfully and is
3936locked</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3937 </li>
Eino-Ville Talvala492ba7c2013-09-20 17:24:00 -0700[diff] [blame]3938 <li>
3939 <span class="entry_type_enum_name">PASSIVE_UNFOCUSED</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]3940 <span class="entry_type_enum_notes"><p>if CONTINUOUS_<wbr/>* modes are supported.<wbr/> AF finished a
3941passive scan without finding focus,<wbr/> and may restart
3942scanning at any time.<wbr/></p></span>
Eino-Ville Talvala492ba7c2013-09-20 17:24:00 -0700[diff] [blame]3943 </li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3944 </ul>
3945
3946 </td> <!-- entry_type -->
3947
3948 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3949 <p>Current state of AF algorithm</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3950 </td>
3951
3952 <td class="entry_units">
3953 </td>
3954
3955 <td class="entry_range">
3956 </td>
3957
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3958 <td class="entry_tags">
3959 </td>
3960
3961 </tr>
3962 <tr class="entries_header">
3963 <th class="th_details" colspan="5">Details</th>
3964 </tr>
3965 <tr class="entry_cont">
3966 <td class="entry_details" colspan="5">
Zhijun He92e698d2014-01-13 16:24:31 -0800[diff] [blame]3967 <p>Switching between or enabling AF modes (<a href="#controls_android.control.afMode">android.<wbr/>control.<wbr/>af<wbr/>Mode</a>) always
3968resets the AF state to INACTIVE.<wbr/> Similarly,<wbr/> switching between <a href="#controls_android.control.mode">android.<wbr/>control.<wbr/>mode</a>,<wbr/>
3969or <a href="#controls_android.control.sceneMode">android.<wbr/>control.<wbr/>scene<wbr/>Mode</a> if <code><a href="#controls_android.control.mode">android.<wbr/>control.<wbr/>mode</a> == USE_<wbr/>SCENE_<wbr/>MODE</code> resets all
3970the algorithm states to INACTIVE.<wbr/></p>
3971<p>The camera device can do several state transitions between two results,<wbr/> if it is
3972allowed by the state transition table.<wbr/> For example: INACTIVE may never actually be
3973seen in a result.<wbr/></p>
3974<p>The state in the result is the state for this image (in sync with this image): if
3975AF state becomes FOCUSED,<wbr/> then the image data associated with this result should
3976be sharp.<wbr/></p>
3977<p>Below are state transition tables for different AF modes.<wbr/></p>
3978<p>When <a href="#controls_android.control.afMode">android.<wbr/>control.<wbr/>af<wbr/>Mode</a> is AF_<wbr/>MODE_<wbr/>OFF or AF_<wbr/>MODE_<wbr/>EDOF:</p>
3979<table>
3980<thead>
3981<tr>
3982<th align="center">State</th>
3983<th align="center">Transition Cause</th>
3984<th align="center">New State</th>
3985<th align="center">Notes</th>
3986</tr>
3987</thead>
3988<tbody>
3989<tr>
3990<td align="center">INACTIVE</td>
3991<td align="center"></td>
3992<td align="center">INACTIVE</td>
3993<td align="center">Never changes</td>
3994</tr>
3995</tbody>
3996</table>
3997<p>When <a href="#controls_android.control.afMode">android.<wbr/>control.<wbr/>af<wbr/>Mode</a> is AF_<wbr/>MODE_<wbr/>AUTO or AF_<wbr/>MODE_<wbr/>MACRO:</p>
3998<table>
3999<thead>
4000<tr>
4001<th align="center">State</th>
4002<th align="center">Transition Cause</th>
4003<th align="center">New State</th>
4004<th align="center">Notes</th>
4005</tr>
4006</thead>
4007<tbody>
4008<tr>
4009<td align="center">INACTIVE</td>
4010<td align="center">AF_<wbr/>TRIGGER</td>
4011<td align="center">ACTIVE_<wbr/>SCAN</td>
4012<td align="center">Start AF sweep,<wbr/> Lens now moving</td>
4013</tr>
4014<tr>
4015<td align="center">ACTIVE_<wbr/>SCAN</td>
4016<td align="center">AF sweep done</td>
4017<td align="center">FOCUSED_<wbr/>LOCKED</td>
4018<td align="center">Focused,<wbr/> Lens now locked</td>
4019</tr>
4020<tr>
4021<td align="center">ACTIVE_<wbr/>SCAN</td>
4022<td align="center">AF sweep done</td>
4023<td align="center">NOT_<wbr/>FOCUSED_<wbr/>LOCKED</td>
4024<td align="center">Not focused,<wbr/> Lens now locked</td>
4025</tr>
4026<tr>
4027<td align="center">ACTIVE_<wbr/>SCAN</td>
4028<td align="center">AF_<wbr/>CANCEL</td>
4029<td align="center">INACTIVE</td>
4030<td align="center">Cancel/<wbr/>reset AF,<wbr/> Lens now locked</td>
4031</tr>
4032<tr>
4033<td align="center">FOCUSED_<wbr/>LOCKED</td>
4034<td align="center">AF_<wbr/>CANCEL</td>
4035<td align="center">INACTIVE</td>
4036<td align="center">Cancel/<wbr/>reset AF</td>
4037</tr>
4038<tr>
4039<td align="center">FOCUSED_<wbr/>LOCKED</td>
4040<td align="center">AF_<wbr/>TRIGGER</td>
4041<td align="center">ACTIVE_<wbr/>SCAN</td>
4042<td align="center">Start new sweep,<wbr/> Lens now moving</td>
4043</tr>
4044<tr>
4045<td align="center">NOT_<wbr/>FOCUSED_<wbr/>LOCKED</td>
4046<td align="center">AF_<wbr/>CANCEL</td>
4047<td align="center">INACTIVE</td>
4048<td align="center">Cancel/<wbr/>reset AF</td>
4049</tr>
4050<tr>
4051<td align="center">NOT_<wbr/>FOCUSED_<wbr/>LOCKED</td>
4052<td align="center">AF_<wbr/>TRIGGER</td>
4053<td align="center">ACTIVE_<wbr/>SCAN</td>
4054<td align="center">Start new sweep,<wbr/> Lens now moving</td>
4055</tr>
4056<tr>
4057<td align="center">Any state</td>
4058<td align="center">Mode change</td>
4059<td align="center">INACTIVE</td>
4060<td align="center"></td>
4061</tr>
4062</tbody>
4063</table>
4064<p>When <a href="#controls_android.control.afMode">android.<wbr/>control.<wbr/>af<wbr/>Mode</a> is AF_<wbr/>MODE_<wbr/>CONTINUOUS_<wbr/>VIDEO:</p>
4065<table>
4066<thead>
4067<tr>
4068<th align="center">State</th>
4069<th align="center">Transition Cause</th>
4070<th align="center">New State</th>
4071<th align="center">Notes</th>
4072</tr>
4073</thead>
4074<tbody>
4075<tr>
4076<td align="center">INACTIVE</td>
4077<td align="center">Camera device initiates new scan</td>
4078<td align="center">PASSIVE_<wbr/>SCAN</td>
4079<td align="center">Start AF scan,<wbr/> Lens now moving</td>
4080</tr>
4081<tr>
4082<td align="center">INACTIVE</td>
4083<td align="center">AF_<wbr/>TRIGGER</td>
4084<td align="center">NOT_<wbr/>FOCUSED_<wbr/>LOCKED</td>
4085<td align="center">AF state query,<wbr/> Lens now locked</td>
4086</tr>
4087<tr>
4088<td align="center">PASSIVE_<wbr/>SCAN</td>
4089<td align="center">Camera device completes current scan</td>
4090<td align="center">PASSIVE_<wbr/>FOCUSED</td>
4091<td align="center">End AF scan,<wbr/> Lens now locked</td>
4092</tr>
4093<tr>
4094<td align="center">PASSIVE_<wbr/>SCAN</td>
4095<td align="center">Camera device fails current scan</td>
4096<td align="center">PASSIVE_<wbr/>UNFOCUSED</td>
4097<td align="center">End AF scan,<wbr/> Lens now locked</td>
4098</tr>
4099<tr>
4100<td align="center">PASSIVE_<wbr/>SCAN</td>
4101<td align="center">AF_<wbr/>TRIGGER</td>
4102<td align="center">FOCUSED_<wbr/>LOCKED</td>
4103<td align="center">Immediate trans.<wbr/> If focus is good,<wbr/> Lens now locked</td>
4104</tr>
4105<tr>
4106<td align="center">PASSIVE_<wbr/>SCAN</td>
4107<td align="center">AF_<wbr/>TRIGGER</td>
4108<td align="center">NOT_<wbr/>FOCUSED_<wbr/>LOCKED</td>
4109<td align="center">Immediate trans.<wbr/> if focus is bad,<wbr/> Lens now locked</td>
4110</tr>
4111<tr>
4112<td align="center">PASSIVE_<wbr/>SCAN</td>
4113<td align="center">AF_<wbr/>CANCEL</td>
4114<td align="center">INACTIVE</td>
4115<td align="center">Reset lens position,<wbr/> Lens now locked</td>
4116</tr>
4117<tr>
4118<td align="center">PASSIVE_<wbr/>FOCUSED</td>
4119<td align="center">Camera device initiates new scan</td>
4120<td align="center">PASSIVE_<wbr/>SCAN</td>
4121<td align="center">Start AF scan,<wbr/> Lens now moving</td>
4122</tr>
4123<tr>
4124<td align="center">PASSIVE_<wbr/>UNFOCUSED</td>
4125<td align="center">Camera device initiates new scan</td>
4126<td align="center">PASSIVE_<wbr/>SCAN</td>
4127<td align="center">Start AF scan,<wbr/> Lens now moving</td>
4128</tr>
4129<tr>
4130<td align="center">PASSIVE_<wbr/>FOCUSED</td>
4131<td align="center">AF_<wbr/>TRIGGER</td>
4132<td align="center">FOCUSED_<wbr/>LOCKED</td>
4133<td align="center">Immediate trans.<wbr/> Lens now locked</td>
4134</tr>
4135<tr>
4136<td align="center">PASSIVE_<wbr/>UNFOCUSED</td>
4137<td align="center">AF_<wbr/>TRIGGER</td>
4138<td align="center">NOT_<wbr/>FOCUSED_<wbr/>LOCKED</td>
4139<td align="center">Immediate trans.<wbr/> Lens now locked</td>
4140</tr>
4141<tr>
4142<td align="center">FOCUSED_<wbr/>LOCKED</td>
4143<td align="center">AF_<wbr/>TRIGGER</td>
4144<td align="center">FOCUSED_<wbr/>LOCKED</td>
4145<td align="center">No effect</td>
4146</tr>
4147<tr>
4148<td align="center">FOCUSED_<wbr/>LOCKED</td>
4149<td align="center">AF_<wbr/>CANCEL</td>
4150<td align="center">INACTIVE</td>
4151<td align="center">Restart AF scan</td>
4152</tr>
4153<tr>
4154<td align="center">NOT_<wbr/>FOCUSED_<wbr/>LOCKED</td>
4155<td align="center">AF_<wbr/>TRIGGER</td>
4156<td align="center">NOT_<wbr/>FOCUSED_<wbr/>LOCKED</td>
4157<td align="center">No effect</td>
4158</tr>
4159<tr>
4160<td align="center">NOT_<wbr/>FOCUSED_<wbr/>LOCKED</td>
4161<td align="center">AF_<wbr/>CANCEL</td>
4162<td align="center">INACTIVE</td>
4163<td align="center">Restart AF scan</td>
4164</tr>
4165</tbody>
4166</table>
4167<p>When <a href="#controls_android.control.afMode">android.<wbr/>control.<wbr/>af<wbr/>Mode</a> is AF_<wbr/>MODE_<wbr/>CONTINUOUS_<wbr/>PICTURE:</p>
4168<table>
4169<thead>
4170<tr>
4171<th align="center">State</th>
4172<th align="center">Transition Cause</th>
4173<th align="center">New State</th>
4174<th align="center">Notes</th>
4175</tr>
4176</thead>
4177<tbody>
4178<tr>
4179<td align="center">INACTIVE</td>
4180<td align="center">Camera device initiates new scan</td>
4181<td align="center">PASSIVE_<wbr/>SCAN</td>
4182<td align="center">Start AF scan,<wbr/> Lens now moving</td>
4183</tr>
4184<tr>
4185<td align="center">INACTIVE</td>
4186<td align="center">AF_<wbr/>TRIGGER</td>
4187<td align="center">NOT_<wbr/>FOCUSED_<wbr/>LOCKED</td>
4188<td align="center">AF state query,<wbr/> Lens now locked</td>
4189</tr>
4190<tr>
4191<td align="center">PASSIVE_<wbr/>SCAN</td>
4192<td align="center">Camera device completes current scan</td>
4193<td align="center">PASSIVE_<wbr/>FOCUSED</td>
4194<td align="center">End AF scan,<wbr/> Lens now locked</td>
4195</tr>
4196<tr>
4197<td align="center">PASSIVE_<wbr/>SCAN</td>
4198<td align="center">Camera device fails current scan</td>
4199<td align="center">PASSIVE_<wbr/>UNFOCUSED</td>
4200<td align="center">End AF scan,<wbr/> Lens now locked</td>
4201</tr>
4202<tr>
4203<td align="center">PASSIVE_<wbr/>SCAN</td>
4204<td align="center">AF_<wbr/>TRIGGER</td>
4205<td align="center">FOCUSED_<wbr/>LOCKED</td>
4206<td align="center">Eventual trans.<wbr/> once focus good,<wbr/> Lens now locked</td>
4207</tr>
4208<tr>
4209<td align="center">PASSIVE_<wbr/>SCAN</td>
4210<td align="center">AF_<wbr/>TRIGGER</td>
4211<td align="center">NOT_<wbr/>FOCUSED_<wbr/>LOCKED</td>
4212<td align="center">Eventual trans.<wbr/> if cannot focus,<wbr/> Lens now locked</td>
4213</tr>
4214<tr>
4215<td align="center">PASSIVE_<wbr/>SCAN</td>
4216<td align="center">AF_<wbr/>CANCEL</td>
4217<td align="center">INACTIVE</td>
4218<td align="center">Reset lens position,<wbr/> Lens now locked</td>
4219</tr>
4220<tr>
4221<td align="center">PASSIVE_<wbr/>FOCUSED</td>
4222<td align="center">Camera device initiates new scan</td>
4223<td align="center">PASSIVE_<wbr/>SCAN</td>
4224<td align="center">Start AF scan,<wbr/> Lens now moving</td>
4225</tr>
4226<tr>
4227<td align="center">PASSIVE_<wbr/>UNFOCUSED</td>
4228<td align="center">Camera device initiates new scan</td>
4229<td align="center">PASSIVE_<wbr/>SCAN</td>
4230<td align="center">Start AF scan,<wbr/> Lens now moving</td>
4231</tr>
4232<tr>
4233<td align="center">PASSIVE_<wbr/>FOCUSED</td>
4234<td align="center">AF_<wbr/>TRIGGER</td>
4235<td align="center">FOCUSED_<wbr/>LOCKED</td>
4236<td align="center">Immediate trans.<wbr/> Lens now locked</td>
4237</tr>
4238<tr>
4239<td align="center">PASSIVE_<wbr/>UNFOCUSED</td>
4240<td align="center">AF_<wbr/>TRIGGER</td>
4241<td align="center">NOT_<wbr/>FOCUSED_<wbr/>LOCKED</td>
4242<td align="center">Immediate trans.<wbr/> Lens now locked</td>
4243</tr>
4244<tr>
4245<td align="center">FOCUSED_<wbr/>LOCKED</td>
4246<td align="center">AF_<wbr/>TRIGGER</td>
4247<td align="center">FOCUSED_<wbr/>LOCKED</td>
4248<td align="center">No effect</td>
4249</tr>
4250<tr>
4251<td align="center">FOCUSED_<wbr/>LOCKED</td>
4252<td align="center">AF_<wbr/>CANCEL</td>
4253<td align="center">INACTIVE</td>
4254<td align="center">Restart AF scan</td>
4255</tr>
4256<tr>
4257<td align="center">NOT_<wbr/>FOCUSED_<wbr/>LOCKED</td>
4258<td align="center">AF_<wbr/>TRIGGER</td>
4259<td align="center">NOT_<wbr/>FOCUSED_<wbr/>LOCKED</td>
4260<td align="center">No effect</td>
4261</tr>
4262<tr>
4263<td align="center">NOT_<wbr/>FOCUSED_<wbr/>LOCKED</td>
4264<td align="center">AF_<wbr/>CANCEL</td>
4265<td align="center">INACTIVE</td>
4266<td align="center">Restart AF scan</td>
4267</tr>
4268</tbody>
4269</table>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4270 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4271 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4272
4273
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4274 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
4275 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4276
4277
4278 <tr class="entry" id="dynamic_android.control.afTriggerId">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4279 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4280 android.<wbr/>control.<wbr/>af<wbr/>Trigger<wbr/>Id
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4281 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4282 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4283 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4284
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4285 <span class="entry_type_visibility"> [hidden]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4286
4287
4288 </td> <!-- entry_type -->
4289
4290 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4291 <p>The ID sent with the latest
4292CAMERA2_<wbr/>TRIGGER_<wbr/>AUTOFOCUS call</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4293 </td>
4294
4295 <td class="entry_units">
4296 </td>
4297
4298 <td class="entry_range">
4299 </td>
4300
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4301 <td class="entry_tags">
4302 </td>
4303
4304 </tr>
4305 <tr class="entries_header">
4306 <th class="th_details" colspan="5">Details</th>
4307 </tr>
4308 <tr class="entry_cont">
4309 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4310 <p>Must be 0 if no CAMERA2_<wbr/>TRIGGER_<wbr/>AUTOFOCUS trigger
4311received yet by HAL.<wbr/> Always updated even if AF algorithm
4312ignores the trigger</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4313 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4314 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4315
4316
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4317 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
4318 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4319
4320
4321 <tr class="entry" id="dynamic_android.control.awbMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4322 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4323 android.<wbr/>control.<wbr/>awb<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4324 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4325 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4326 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4327
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4328 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4329
4330 <ul class="entry_type_enum">
4331 <li>
4332 <span class="entry_type_enum_name">OFF</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]4333 <span class="entry_type_enum_notes"><p>The camera device's auto white balance routine is disabled;
4334the application-selected color transform matrix
4335(<a href="#controls_android.colorCorrection.transform">android.<wbr/>color<wbr/>Correction.<wbr/>transform</a>) and gains
4336(<a href="#controls_android.colorCorrection.gains">android.<wbr/>color<wbr/>Correction.<wbr/>gains</a>) are used by the camera
4337device for manual white balance control.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4338 </li>
4339 <li>
4340 <span class="entry_type_enum_name">AUTO</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]4341 <span class="entry_type_enum_notes"><p>The camera device's auto white balance routine is active;
4342the application's values for android.<wbr/>color<wbr/>Correction.<wbr/>transform
4343and <a href="#controls_android.colorCorrection.gains">android.<wbr/>color<wbr/>Correction.<wbr/>gains</a> are ignored.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4344 </li>
4345 <li>
4346 <span class="entry_type_enum_name">INCANDESCENT</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]4347 <span class="entry_type_enum_notes"><p>The camera device's auto white balance routine is disabled;
4348the camera device uses incandescent light as the assumed scene
4349illumination for white balance.<wbr/> While the exact white balance
4350transforms are up to the camera device,<wbr/> they will approximately
4351match the CIE standard illuminant A.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4352 </li>
4353 <li>
4354 <span class="entry_type_enum_name">FLUORESCENT</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]4355 <span class="entry_type_enum_notes"><p>The camera device's auto white balance routine is disabled;
4356the camera device uses fluorescent light as the assumed scene
4357illumination for white balance.<wbr/> While the exact white balance
4358transforms are up to the camera device,<wbr/> they will approximately
4359match the CIE standard illuminant F2.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4360 </li>
4361 <li>
4362 <span class="entry_type_enum_name">WARM_FLUORESCENT</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]4363 <span class="entry_type_enum_notes"><p>The camera device's auto white balance routine is disabled;
4364the camera device uses warm fluorescent light as the assumed scene
4365illumination for white balance.<wbr/> While the exact white balance
4366transforms are up to the camera device,<wbr/> they will approximately
4367match the CIE standard illuminant F4.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4368 </li>
4369 <li>
4370 <span class="entry_type_enum_name">DAYLIGHT</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]4371 <span class="entry_type_enum_notes"><p>The camera device's auto white balance routine is disabled;
4372the camera device uses daylight light as the assumed scene
4373illumination for white balance.<wbr/> While the exact white balance
4374transforms are up to the camera device,<wbr/> they will approximately
4375match the CIE standard illuminant D65.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4376 </li>
4377 <li>
4378 <span class="entry_type_enum_name">CLOUDY_DAYLIGHT</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]4379 <span class="entry_type_enum_notes"><p>The camera device's auto white balance routine is disabled;
4380the camera device uses cloudy daylight light as the assumed scene
4381illumination for white balance.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4382 </li>
4383 <li>
4384 <span class="entry_type_enum_name">TWILIGHT</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]4385 <span class="entry_type_enum_notes"><p>The camera device's auto white balance routine is disabled;
4386the camera device uses twilight light as the assumed scene
4387illumination for white balance.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4388 </li>
4389 <li>
4390 <span class="entry_type_enum_name">SHADE</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]4391 <span class="entry_type_enum_notes"><p>The camera device's auto white balance routine is disabled;
4392the camera device uses shade light as the assumed scene
4393illumination for white balance.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4394 </li>
4395 </ul>
4396
4397 </td> <!-- entry_type -->
4398
4399 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4400 <p>Whether AWB is currently setting the color
4401transform fields,<wbr/> and what its illumination target
4402is</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4403 </td>
4404
4405 <td class="entry_units">
4406 </td>
4407
4408 <td class="entry_range">
Zhijun He7787f7f2014-01-14 16:30:31 -0800[diff] [blame]4409 <p><a href="#static_android.control.awbAvailableModes">android.<wbr/>control.<wbr/>awb<wbr/>Available<wbr/>Modes</a></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4410 </td>
4411
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4412 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]4413 <ul class="entry_tags">
4414 <li><a href="#tag_BC">BC</a></li>
4415 <li><a href="#tag_AWB">AWB</a></li>
4416 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4417 </td>
4418
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4419 </tr>
4420 <tr class="entries_header">
4421 <th class="th_details" colspan="5">Details</th>
4422 </tr>
4423 <tr class="entry_cont">
4424 <td class="entry_details" colspan="5">
Zhijun He7787f7f2014-01-14 16:30:31 -0800[diff] [blame]4425 <p>This control is only effective if <a href="#controls_android.control.mode">android.<wbr/>control.<wbr/>mode</a> is AUTO.<wbr/></p>
4426<p>When set to the ON mode,<wbr/> the camera device's auto white balance
4427routine is enabled,<wbr/> overriding the application's selected
4428<a href="#controls_android.colorCorrection.transform">android.<wbr/>color<wbr/>Correction.<wbr/>transform</a>,<wbr/> <a href="#controls_android.colorCorrection.gains">android.<wbr/>color<wbr/>Correction.<wbr/>gains</a> and
4429<a href="#controls_android.colorCorrection.mode">android.<wbr/>color<wbr/>Correction.<wbr/>mode</a>.<wbr/></p>
4430<p>When set to the OFF mode,<wbr/> the camera device's auto white balance
4431routine is disabled.<wbr/> The applicantion manually controls the white
4432balance by <a href="#controls_android.colorCorrection.transform">android.<wbr/>color<wbr/>Correction.<wbr/>transform</a>,<wbr/> android.<wbr/>color<wbr/>Correction.<wbr/>gains
4433and <a href="#controls_android.colorCorrection.mode">android.<wbr/>color<wbr/>Correction.<wbr/>mode</a>.<wbr/></p>
4434<p>When set to any other modes,<wbr/> the camera device's auto white balance
4435routine is disabled.<wbr/> The camera device uses each particular illumination
4436target for white balance adjustment.<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4437 </td>
4438 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4439
4440
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4441 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
4442 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4443
4444
4445 <tr class="entry" id="dynamic_android.control.awbRegions">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4446 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4447 android.<wbr/>control.<wbr/>awb<wbr/>Regions
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4448 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4449 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4450 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4451 <span class="entry_type_container">x</span>
4452
4453 <span class="entry_type_array">
4454 5 x area_count
4455 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4456 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4457
4458
4459 </td> <!-- entry_type -->
4460
4461 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4462 <p>List of areas to use for illuminant
Ruben Brunk76e4c7d2014-01-31 11:05:30 -0800[diff] [blame]4463estimation.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4464 </td>
4465
4466 <td class="entry_units">
4467 </td>
4468
4469 <td class="entry_range">
Ruben Brunk76e4c7d2014-01-31 11:05:30 -0800[diff] [blame]4470 <p><code>area_<wbr/>count &lt;= <a href="#static_android.control.maxRegions">android.<wbr/>control.<wbr/>max<wbr/>Regions</a>[1]</code></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4471 </td>
4472
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4473 <td class="entry_tags">
4474 <ul class="entry_tags">
4475 <li><a href="#tag_BC">BC</a></li>
4476 </ul>
4477 </td>
4478
4479 </tr>
4480 <tr class="entries_header">
4481 <th class="th_details" colspan="5">Details</th>
4482 </tr>
4483 <tr class="entry_cont">
4484 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4485 <p>Only used in AUTO mode.<wbr/></p>
4486<p>Each area is a rectangle plus weight: xmin,<wbr/> ymin,<wbr/>
Ruben Brunk76e4c7d2014-01-31 11:05:30 -0800[diff] [blame]4487xmax,<wbr/> ymax,<wbr/> weight.<wbr/> The rectangle is defined to be inclusive of the
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4488specified coordinates.<wbr/></p>
4489<p>The coordinate system is based on the active pixel array,<wbr/>
4490with (0,<wbr/>0) being the top-left pixel in the active pixel array,<wbr/> and
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]4491(<a href="#static_android.sensor.info.activeArraySize">android.<wbr/>sensor.<wbr/>info.<wbr/>active<wbr/>Array<wbr/>Size</a>.<wbr/>width - 1,<wbr/>
4492<a href="#static_android.sensor.info.activeArraySize">android.<wbr/>sensor.<wbr/>info.<wbr/>active<wbr/>Array<wbr/>Size</a>.<wbr/>height - 1) being the
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4493bottom-right pixel in the active pixel array.<wbr/> The weight
4494should be nonnegative.<wbr/></p>
4495<p>If all regions have 0 weight,<wbr/> then no specific metering area
4496needs to be used by the HAL.<wbr/> If the metering region is
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]4497outside the current <a href="#controls_android.scaler.cropRegion">android.<wbr/>scaler.<wbr/>crop<wbr/>Region</a>,<wbr/> the HAL
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]4498should ignore the sections outside the region and output the
Ruben Brunk76e4c7d2014-01-31 11:05:30 -0800[diff] [blame]4499used sections in the frame metadata.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4500 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4501 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4502
4503
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4504 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
4505 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4506
4507
4508 <tr class="entry" id="dynamic_android.control.awbState">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4509 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4510 android.<wbr/>control.<wbr/>awb<wbr/>State
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4511 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4512 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4513 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4514
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4515 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4516
4517 <ul class="entry_type_enum">
4518 <li>
4519 <span class="entry_type_enum_name">INACTIVE</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]4520 <span class="entry_type_enum_notes"><p>AWB is not in auto mode.<wbr/> When a camera device is opened,<wbr/> it
4521starts in this state.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4522 </li>
4523 <li>
4524 <span class="entry_type_enum_name">SEARCHING</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]4525 <span class="entry_type_enum_notes"><p>AWB doesn't yet have a good set of control
Zhijun He92e698d2014-01-13 16:24:31 -0800[diff] [blame]4526values for the current scene.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4527 </li>
4528 <li>
4529 <span class="entry_type_enum_name">CONVERGED</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]4530 <span class="entry_type_enum_notes"><p>AWB has a good set of control values for the
Zhijun He92e698d2014-01-13 16:24:31 -0800[diff] [blame]4531current scene.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4532 </li>
4533 <li>
4534 <span class="entry_type_enum_name">LOCKED</span>
Zhijun He92e698d2014-01-13 16:24:31 -0800[diff] [blame]4535 <span class="entry_type_enum_notes"><p>AWB has been locked.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4536 </li>
4537 </ul>
4538
4539 </td> <!-- entry_type -->
4540
4541 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4542 <p>Current state of AWB algorithm</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4543 </td>
4544
4545 <td class="entry_units">
4546 </td>
4547
4548 <td class="entry_range">
4549 </td>
4550
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4551 <td class="entry_tags">
4552 </td>
4553
4554 </tr>
4555 <tr class="entries_header">
4556 <th class="th_details" colspan="5">Details</th>
4557 </tr>
4558 <tr class="entry_cont">
4559 <td class="entry_details" colspan="5">
Zhijun He92e698d2014-01-13 16:24:31 -0800[diff] [blame]4560 <p>Switching between or enabling AWB modes (<a href="#controls_android.control.awbMode">android.<wbr/>control.<wbr/>awb<wbr/>Mode</a>) always
4561resets the AWB state to INACTIVE.<wbr/> Similarly,<wbr/> switching between <a href="#controls_android.control.mode">android.<wbr/>control.<wbr/>mode</a>,<wbr/>
4562or <a href="#controls_android.control.sceneMode">android.<wbr/>control.<wbr/>scene<wbr/>Mode</a> if <code><a href="#controls_android.control.mode">android.<wbr/>control.<wbr/>mode</a> == USE_<wbr/>SCENE_<wbr/>MODE</code> resets all
4563the algorithm states to INACTIVE.<wbr/></p>
4564<p>The camera device can do several state transitions between two results,<wbr/> if it is
4565allowed by the state transition table.<wbr/> So INACTIVE may never actually be seen in
4566a result.<wbr/></p>
4567<p>The state in the result is the state for this image (in sync with this image): if
4568AWB state becomes CONVERGED,<wbr/> then the image data associated with this result should
4569be good to use.<wbr/></p>
4570<p>Below are state transition tables for different AWB modes.<wbr/></p>
4571<p>When <code><a href="#controls_android.control.awbMode">android.<wbr/>control.<wbr/>awb<wbr/>Mode</a> != AWB_<wbr/>MODE_<wbr/>AUTO</code>:</p>
4572<table>
4573<thead>
4574<tr>
4575<th align="center">State</th>
4576<th align="center">Transition Cause</th>
4577<th align="center">New State</th>
4578<th align="center">Notes</th>
4579</tr>
4580</thead>
4581<tbody>
4582<tr>
4583<td align="center">INACTIVE</td>
4584<td align="center"></td>
4585<td align="center">INACTIVE</td>
4586<td align="center">Camera device auto white balance algorithm is disabled</td>
4587</tr>
4588</tbody>
4589</table>
4590<p>When <a href="#controls_android.control.awbMode">android.<wbr/>control.<wbr/>awb<wbr/>Mode</a> is AWB_<wbr/>MODE_<wbr/>AUTO:</p>
4591<table>
4592<thead>
4593<tr>
4594<th align="center">State</th>
4595<th align="center">Transition Cause</th>
4596<th align="center">New State</th>
4597<th align="center">Notes</th>
4598</tr>
4599</thead>
4600<tbody>
4601<tr>
4602<td align="center">INACTIVE</td>
4603<td align="center">Camera device initiates AWB scan</td>
4604<td align="center">SEARCHING</td>
4605<td align="center">Values changing</td>
4606</tr>
4607<tr>
4608<td align="center">INACTIVE</td>
4609<td align="center"><a href="#controls_android.control.awbLock">android.<wbr/>control.<wbr/>awb<wbr/>Lock</a> is ON</td>
4610<td align="center">LOCKED</td>
4611<td align="center">Values locked</td>
4612</tr>
4613<tr>
4614<td align="center">SEARCHING</td>
4615<td align="center">Camera device finishes AWB scan</td>
4616<td align="center">CONVERGED</td>
4617<td align="center">Good values,<wbr/> not changing</td>
4618</tr>
4619<tr>
4620<td align="center">SEARCHING</td>
4621<td align="center"><a href="#controls_android.control.awbLock">android.<wbr/>control.<wbr/>awb<wbr/>Lock</a> is ON</td>
4622<td align="center">LOCKED</td>
4623<td align="center">Values locked</td>
4624</tr>
4625<tr>
4626<td align="center">CONVERGED</td>
4627<td align="center">Camera device initiates AWB scan</td>
4628<td align="center">SEARCHING</td>
4629<td align="center">Values changing</td>
4630</tr>
4631<tr>
4632<td align="center">CONVERGED</td>
4633<td align="center"><a href="#controls_android.control.awbLock">android.<wbr/>control.<wbr/>awb<wbr/>Lock</a> is ON</td>
4634<td align="center">LOCKED</td>
4635<td align="center">Values locked</td>
4636</tr>
4637<tr>
4638<td align="center">LOCKED</td>
4639<td align="center"><a href="#controls_android.control.awbLock">android.<wbr/>control.<wbr/>awb<wbr/>Lock</a> is OFF</td>
4640<td align="center">SEARCHING</td>
4641<td align="center">Values not good after unlock</td>
4642</tr>
4643<tr>
4644<td align="center">LOCKED</td>
4645<td align="center"><a href="#controls_android.control.awbLock">android.<wbr/>control.<wbr/>awb<wbr/>Lock</a> is OFF</td>
4646<td align="center">CONVERGED</td>
4647<td align="center">Values good after unlock</td>
4648</tr>
4649</tbody>
4650</table>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4651 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4652 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4653
4654
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4655 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
4656 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4657
4658
4659 <tr class="entry" id="dynamic_android.control.mode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4660 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4661 android.<wbr/>control.<wbr/>mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4662 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4663 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4664 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4665
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4666 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4667
4668 <ul class="entry_type_enum">
4669 <li>
4670 <span class="entry_type_enum_name">OFF</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]4671 <span class="entry_type_enum_notes"><p>Full application control of pipeline.<wbr/> All 3A
4672routines are disabled,<wbr/> no other settings in
4673android.<wbr/>control.<wbr/>* have any effect</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4674 </li>
4675 <li>
4676 <span class="entry_type_enum_name">AUTO</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]4677 <span class="entry_type_enum_notes"><p>Use settings for each individual 3A routine.<wbr/>
4678Manual control of capture parameters is disabled.<wbr/> All
4679controls in android.<wbr/>control.<wbr/>* besides sceneMode take
4680effect</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4681 </li>
4682 <li>
4683 <span class="entry_type_enum_name">USE_SCENE_MODE</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]4684 <span class="entry_type_enum_notes"><p>Use specific scene mode.<wbr/> Enabling this disables
4685control.<wbr/>aeMode,<wbr/> control.<wbr/>awbMode and control.<wbr/>afMode
4686controls; the HAL must ignore those settings while
4687USE_<wbr/>SCENE_<wbr/>MODE is active (except for FACE_<wbr/>PRIORITY
4688scene mode).<wbr/> Other control entries are still active.<wbr/>
4689This setting can only be used if availableSceneModes !=
4690UNSUPPORTED</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4691 </li>
4692 </ul>
4693
4694 </td> <!-- entry_type -->
4695
4696 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4697 <p>Overall mode of 3A control
4698routines</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4699 </td>
4700
4701 <td class="entry_units">
4702 </td>
4703
4704 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]4705 <p>all must be supported</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4706 </td>
4707
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4708 <td class="entry_tags">
4709 <ul class="entry_tags">
4710 <li><a href="#tag_BC">BC</a></li>
4711 </ul>
4712 </td>
4713
4714 </tr>
4715 <tr class="entries_header">
4716 <th class="th_details" colspan="5">Details</th>
4717 </tr>
4718 <tr class="entry_cont">
4719 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4720 <p>High-level 3A control.<wbr/> When set to OFF,<wbr/> all 3A control
Zhijun Hef90eeaf2014-01-16 12:13:35 -0800[diff] [blame]4721by the camera device is disabled.<wbr/> The application must set the fields for
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4722capture parameters itself.<wbr/></p>
4723<p>When set to AUTO,<wbr/> the individual algorithm controls in
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]4724android.<wbr/>control.<wbr/>* are in effect,<wbr/> such as <a href="#controls_android.control.afMode">android.<wbr/>control.<wbr/>af<wbr/>Mode</a>.<wbr/></p>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4725<p>When set to USE_<wbr/>SCENE_<wbr/>MODE,<wbr/> the individual controls in
Zhijun Hef90eeaf2014-01-16 12:13:35 -0800[diff] [blame]4726android.<wbr/>control.<wbr/>* are mostly disabled,<wbr/> and the camera device implements
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4727one of the scene mode settings (such as ACTION,<wbr/> SUNSET,<wbr/> or PARTY)
Zhijun Hef90eeaf2014-01-16 12:13:35 -0800[diff] [blame]4728as it wishes.<wbr/> The camera device scene mode 3A settings are provided by
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]4729<a href="#static_android.control.sceneModeOverrides">android.<wbr/>control.<wbr/>scene<wbr/>Mode<wbr/>Overrides</a>.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4730 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4731 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4732
4733
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4734 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
4735 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4736
4737
4738
4739 <!-- end of kind -->
4740 </tbody>
4741
4742 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4743 <tr><td colspan="6" id="section_demosaic" class="section">demosaic</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4744
4745
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4746 <tr><td colspan="6" class="kind">controls</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4747
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4748 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4749 <tr>
4750 <th class="th_name">Property Name</th>
4751 <th class="th_type">Type</th>
4752 <th class="th_description">Description</th>
4753 <th class="th_units">Units</th>
4754 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4755 <th class="th_tags">Tags</th>
4756 </tr>
4757 </thead>
4758
4759 <tbody>
4760
4761
4762
4763
4764
4765
4766
4767
4768
4769
4770 <tr class="entry" id="controls_android.demosaic.mode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4771 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4772 android.<wbr/>demosaic.<wbr/>mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4773 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4774 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4775 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4776
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4777 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4778
4779 <ul class="entry_type_enum">
4780 <li>
4781 <span class="entry_type_enum_name">FAST</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]4782 <span class="entry_type_enum_notes"><p>Minimal or no slowdown of frame rate compared to
4783Bayer RAW output</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4784 </li>
4785 <li>
4786 <span class="entry_type_enum_name">HIGH_QUALITY</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]4787 <span class="entry_type_enum_notes"><p>High-quality may reduce output frame
4788rate</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4789 </li>
4790 </ul>
4791
4792 </td> <!-- entry_type -->
4793
4794 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4795 <p>Controls the quality of the demosaicing
4796processing</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4797 </td>
4798
4799 <td class="entry_units">
4800 </td>
4801
4802 <td class="entry_range">
4803 </td>
4804
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4805 <td class="entry_tags">
4806 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]4807 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4808 </ul>
4809 </td>
4810
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4811 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4812
4813
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4814 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
4815 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4816
4817
4818
4819 <!-- end of kind -->
4820 </tbody>
4821
4822 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4823 <tr><td colspan="6" id="section_edge" class="section">edge</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4824
4825
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4826 <tr><td colspan="6" class="kind">controls</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4827
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4828 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4829 <tr>
4830 <th class="th_name">Property Name</th>
4831 <th class="th_type">Type</th>
4832 <th class="th_description">Description</th>
4833 <th class="th_units">Units</th>
4834 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4835 <th class="th_tags">Tags</th>
4836 </tr>
4837 </thead>
4838
4839 <tbody>
4840
4841
4842
4843
4844
4845
4846
4847
4848
4849
4850 <tr class="entry" id="controls_android.edge.mode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4851 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4852 android.<wbr/>edge.<wbr/>mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4853 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4854 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4855 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4856
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4857 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4858
4859 <ul class="entry_type_enum">
4860 <li>
4861 <span class="entry_type_enum_name">OFF</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]4862 <span class="entry_type_enum_notes"><p>No edge enhancement is applied</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4863 </li>
4864 <li>
4865 <span class="entry_type_enum_name">FAST</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]4866 <span class="entry_type_enum_notes"><p>Must not slow down frame rate relative to sensor
4867output</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4868 </li>
4869 <li>
4870 <span class="entry_type_enum_name">HIGH_QUALITY</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]4871 <span class="entry_type_enum_notes"><p>Frame rate may be reduced by high
4872quality</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4873 </li>
4874 </ul>
4875
4876 </td> <!-- entry_type -->
4877
4878 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4879 <p>Operation mode for edge
4880enhancement</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4881 </td>
4882
4883 <td class="entry_units">
4884 </td>
4885
4886 <td class="entry_range">
4887 </td>
4888
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4889 <td class="entry_tags">
4890 </td>
4891
4892 </tr>
4893 <tr class="entries_header">
4894 <th class="th_details" colspan="5">Details</th>
4895 </tr>
4896 <tr class="entry_cont">
4897 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4898 <p>Edge/<wbr/>sharpness/<wbr/>detail enhancement.<wbr/> OFF means no
4899enhancement will be applied by the HAL.<wbr/></p>
Zhijun Hef90eeaf2014-01-16 12:13:35 -0800[diff] [blame]4900<p>FAST/<wbr/>HIGH_<wbr/>QUALITY both mean camera device determined enhancement
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4901will be applied.<wbr/> HIGH_<wbr/>QUALITY mode indicates that the
Zhijun Hef90eeaf2014-01-16 12:13:35 -0800[diff] [blame]4902camera device will use the highest-quality enhancement algorithms,<wbr/>
4903even if it slows down capture rate.<wbr/> FAST means the camera device will
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4904not slow down capture rate when applying edge enhancement.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4905 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4906 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4907
4908
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4909 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
4910 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4911
4912
4913 <tr class="entry" id="controls_android.edge.strength">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4914 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4915 android.<wbr/>edge.<wbr/>strength
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4916 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4917 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4918 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4919
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4920 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4921
4922
4923 </td> <!-- entry_type -->
4924
4925 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4926 <p>Control the amount of edge enhancement
4927applied to the images</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4928 </td>
4929
4930 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4931 1-10; 10 is maximum sharpening
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4932 </td>
4933
4934 <td class="entry_range">
4935 </td>
4936
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4937 <td class="entry_tags">
4938 </td>
4939
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4940 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4941
4942
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4943 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
4944 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4945
4946
4947
4948 <!-- end of kind -->
4949 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4950 <tr><td colspan="6" class="kind">dynamic</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4951
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4952 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4953 <tr>
4954 <th class="th_name">Property Name</th>
4955 <th class="th_type">Type</th>
4956 <th class="th_description">Description</th>
4957 <th class="th_units">Units</th>
4958 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4959 <th class="th_tags">Tags</th>
4960 </tr>
4961 </thead>
4962
4963 <tbody>
4964
4965
4966
4967
4968
4969
4970
4971
4972
4973
4974 <tr class="entry" id="dynamic_android.edge.mode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4975 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4976 android.<wbr/>edge.<wbr/>mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4977 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4978 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4979 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4980
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4981 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4982
4983 <ul class="entry_type_enum">
4984 <li>
4985 <span class="entry_type_enum_name">OFF</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]4986 <span class="entry_type_enum_notes"><p>No edge enhancement is applied</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4987 </li>
4988 <li>
4989 <span class="entry_type_enum_name">FAST</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]4990 <span class="entry_type_enum_notes"><p>Must not slow down frame rate relative to sensor
4991output</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4992 </li>
4993 <li>
4994 <span class="entry_type_enum_name">HIGH_QUALITY</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]4995 <span class="entry_type_enum_notes"><p>Frame rate may be reduced by high
4996quality</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4997 </li>
4998 </ul>
4999
5000 </td> <!-- entry_type -->
5001
5002 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5003 <p>Operation mode for edge
5004enhancement</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5005 </td>
5006
5007 <td class="entry_units">
5008 </td>
5009
5010 <td class="entry_range">
5011 </td>
5012
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5013 <td class="entry_tags">
5014 </td>
5015
5016 </tr>
5017 <tr class="entries_header">
5018 <th class="th_details" colspan="5">Details</th>
5019 </tr>
5020 <tr class="entry_cont">
5021 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5022 <p>Edge/<wbr/>sharpness/<wbr/>detail enhancement.<wbr/> OFF means no
5023enhancement will be applied by the HAL.<wbr/></p>
Zhijun Hef90eeaf2014-01-16 12:13:35 -0800[diff] [blame]5024<p>FAST/<wbr/>HIGH_<wbr/>QUALITY both mean camera device determined enhancement
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5025will be applied.<wbr/> HIGH_<wbr/>QUALITY mode indicates that the
Zhijun Hef90eeaf2014-01-16 12:13:35 -0800[diff] [blame]5026camera device will use the highest-quality enhancement algorithms,<wbr/>
5027even if it slows down capture rate.<wbr/> FAST means the camera device will
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5028not slow down capture rate when applying edge enhancement.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5029 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5030 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5031
5032
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5033 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5034 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5035
5036
5037
5038 <!-- end of kind -->
5039 </tbody>
5040
5041 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5042 <tr><td colspan="6" id="section_flash" class="section">flash</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5043
5044
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5045 <tr><td colspan="6" class="kind">controls</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5046
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5047 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5048 <tr>
5049 <th class="th_name">Property Name</th>
5050 <th class="th_type">Type</th>
5051 <th class="th_description">Description</th>
5052 <th class="th_units">Units</th>
5053 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5054 <th class="th_tags">Tags</th>
5055 </tr>
5056 </thead>
5057
5058 <tbody>
5059
5060
5061
5062
5063
5064
5065
5066
5067
5068
5069 <tr class="entry" id="controls_android.flash.firingPower">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5070 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5071 android.<wbr/>flash.<wbr/>firing<wbr/>Power
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5072 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5073 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5074 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5075
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5076 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5077
5078
5079 </td> <!-- entry_type -->
5080
5081 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5082 <p>Power for flash firing/<wbr/>torch</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5083 </td>
5084
5085 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5086 10 is max power; 0 is no flash.<wbr/> Linear
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5087 </td>
5088
5089 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]5090 <p>0 - 10</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5091 </td>
5092
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5093 <td class="entry_tags">
5094 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5095 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5096 </ul>
5097 </td>
5098
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5099 </tr>
5100 <tr class="entries_header">
5101 <th class="th_details" colspan="5">Details</th>
5102 </tr>
5103 <tr class="entry_cont">
5104 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5105 <p>Power for snapshot may use a different scale than
5106for torch mode.<wbr/> Only one entry for torch mode will be
5107used</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5108 </td>
5109 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5110
5111
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5112 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5113 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5114
5115
5116 <tr class="entry" id="controls_android.flash.firingTime">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5117 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5118 android.<wbr/>flash.<wbr/>firing<wbr/>Time
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5119 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5120 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5121 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5122
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5123 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5124
5125
5126 </td> <!-- entry_type -->
5127
5128 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5129 <p>Firing time of flash relative to start of
5130exposure</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5131 </td>
5132
5133 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5134 nanoseconds
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5135 </td>
5136
5137 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]5138 <p>0-(exposure time-flash duration)</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5139 </td>
5140
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5141 <td class="entry_tags">
5142 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5143 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5144 </ul>
5145 </td>
5146
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5147 </tr>
5148 <tr class="entries_header">
5149 <th class="th_details" colspan="5">Details</th>
5150 </tr>
5151 <tr class="entry_cont">
5152 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5153 <p>Clamped to (0,<wbr/> exposure time - flash
5154duration).<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5155 </td>
5156 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5157
5158
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5159 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5160 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5161
5162
5163 <tr class="entry" id="controls_android.flash.mode">
Zhijun Heea27bc32014-01-15 13:47:59 -0800[diff] [blame]5164 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5165 android.<wbr/>flash.<wbr/>mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5166 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5167 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5168 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5169
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5170 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5171
5172 <ul class="entry_type_enum">
5173 <li>
5174 <span class="entry_type_enum_name">OFF</span>
Zhijun Heea27bc32014-01-15 13:47:59 -0800[diff] [blame]5175 <span class="entry_type_enum_notes"><p>Do not fire the flash for this capture.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5176 </li>
5177 <li>
5178 <span class="entry_type_enum_name">SINGLE</span>
Zhijun Heea27bc32014-01-15 13:47:59 -0800[diff] [blame]5179 <span class="entry_type_enum_notes"><p>If the flash is available and charged,<wbr/> fire flash
5180for this capture based on <a href="#controls_android.flash.firingPower">android.<wbr/>flash.<wbr/>firing<wbr/>Power</a> and
5181<a href="#controls_android.flash.firingTime">android.<wbr/>flash.<wbr/>firing<wbr/>Time</a>.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5182 </li>
5183 <li>
5184 <span class="entry_type_enum_name">TORCH</span>
Zhijun Heea27bc32014-01-15 13:47:59 -0800[diff] [blame]5185 <span class="entry_type_enum_notes"><p>Transition flash to continuously on.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5186 </li>
5187 </ul>
5188
5189 </td> <!-- entry_type -->
5190
5191 <td class="entry_description">
Zhijun Heea27bc32014-01-15 13:47:59 -0800[diff] [blame]5192 <p>The desired mode for for the camera device's flash control.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5193 </td>
5194
5195 <td class="entry_units">
5196 </td>
5197
5198 <td class="entry_range">
5199 </td>
5200
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5201 <td class="entry_tags">
5202 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5203 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5204 </ul>
5205 </td>
5206
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5207 </tr>
Zhijun Heea27bc32014-01-15 13:47:59 -0800[diff] [blame]5208 <tr class="entries_header">
5209 <th class="th_details" colspan="5">Details</th>
5210 </tr>
5211 <tr class="entry_cont">
5212 <td class="entry_details" colspan="5">
5213 <p>This control is only effective when flash unit is available
Zhijun Hebdc94c42014-01-21 18:28:30 -0800[diff] [blame]5214(<code><a href="#static_android.flash.info.available">android.<wbr/>flash.<wbr/>info.<wbr/>available</a> == true</code>).<wbr/></p>
Zhijun Heea27bc32014-01-15 13:47:59 -0800[diff] [blame]5215<p>When this control is used,<wbr/> the <a href="#controls_android.control.aeMode">android.<wbr/>control.<wbr/>ae<wbr/>Mode</a> must be set to ON or OFF.<wbr/>
5216Otherwise,<wbr/> the camera device auto-exposure related flash control (ON_<wbr/>AUTO_<wbr/>FLASH,<wbr/>
5217ON_<wbr/>ALWAYS_<wbr/>FLASH,<wbr/> or ON_<wbr/>AUTO_<wbr/>FLASH_<wbr/>REDEYE) will override this control.<wbr/></p>
5218<p>When set to OFF,<wbr/> the camera device will not fire flash for this capture.<wbr/></p>
5219<p>When set to SINGLE,<wbr/> the camera device will fire flash regardless of the camera
5220device's auto-exposure routine's result.<wbr/> When used in still capture case,<wbr/> this
5221control should be used along with AE precapture metering sequence
5222(<a href="#controls_android.control.aePrecaptureTrigger">android.<wbr/>control.<wbr/>ae<wbr/>Precapture<wbr/>Trigger</a>),<wbr/> otherwise,<wbr/> the image may be incorrectly exposed.<wbr/></p>
5223<p>When set to TORCH,<wbr/> the flash will be on continuously.<wbr/> This mode can be used
5224for use cases such as preview,<wbr/> auto-focus assist,<wbr/> still capture,<wbr/> or video recording.<wbr/></p>
Zhijun He5169ce12014-01-24 16:48:25 -0800[diff] [blame]5225<p>The flash status will be reported by <a href="#dynamic_android.flash.state">android.<wbr/>flash.<wbr/>state</a> in the capture result metadata.<wbr/></p>
Zhijun Heea27bc32014-01-15 13:47:59 -0800[diff] [blame]5226 </td>
5227 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5228
5229
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5230 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5231 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5232
5233
5234
5235 <!-- end of kind -->
5236 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5237 <tr><td colspan="6" class="kind">static</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5238
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5239 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5240 <tr>
5241 <th class="th_name">Property Name</th>
5242 <th class="th_type">Type</th>
5243 <th class="th_description">Description</th>
5244 <th class="th_units">Units</th>
5245 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5246 <th class="th_tags">Tags</th>
5247 </tr>
5248 </thead>
5249
5250 <tbody>
5251
5252
5253
5254
5255
5256
5257
5258
5259
5260
5261
5262
5263 <tr class="entry" id="static_android.flash.info.available">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5264 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5265 android.<wbr/>flash.<wbr/>info.<wbr/>available
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5266 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5267 <td class="entry_type">
Zhijun He5169ce12014-01-24 16:48:25 -0800[diff] [blame]5268 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5269
Zhijun He5169ce12014-01-24 16:48:25 -0800[diff] [blame]5270 <span class="entry_type_visibility"> [public as boolean]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5271
Zhijun He5169ce12014-01-24 16:48:25 -0800[diff] [blame]5272 <ul class="entry_type_enum">
5273 <li>
5274 <span class="entry_type_enum_name">FALSE</span>
5275 </li>
5276 <li>
5277 <span class="entry_type_enum_name">TRUE</span>
5278 </li>
5279 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5280
5281 </td> <!-- entry_type -->
5282
5283 <td class="entry_description">
Zhijun He5169ce12014-01-24 16:48:25 -0800[diff] [blame]5284 <p>Whether this camera device has a
5285flash.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5286 </td>
5287
5288 <td class="entry_units">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5289 </td>
5290
5291 <td class="entry_range">
5292 </td>
5293
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5294 <td class="entry_tags">
5295 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5296 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5297 </ul>
5298 </td>
5299
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5300 </tr>
5301 <tr class="entries_header">
5302 <th class="th_details" colspan="5">Details</th>
5303 </tr>
5304 <tr class="entry_cont">
5305 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5306 <p>If no flash,<wbr/> none of the flash controls do
Zhijun He5169ce12014-01-24 16:48:25 -0800[diff] [blame]5307anything.<wbr/> All other metadata should return 0.<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5308 </td>
5309 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5310
5311
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5312 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5313 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5314
5315
5316 <tr class="entry" id="static_android.flash.info.chargeDuration">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5317 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5318 android.<wbr/>flash.<wbr/>info.<wbr/>charge<wbr/>Duration
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5319 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5320 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5321 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5322
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5323 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5324
5325
5326 </td> <!-- entry_type -->
5327
5328 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5329 <p>Time taken before flash can fire
5330again</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5331 </td>
5332
5333 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5334 nanoseconds
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5335 </td>
5336
5337 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]5338 <p>0-1e9</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5339 </td>
5340
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5341 <td class="entry_tags">
5342 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5343 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5344 </ul>
5345 </td>
5346
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5347 </tr>
5348 <tr class="entries_header">
5349 <th class="th_details" colspan="5">Details</th>
5350 </tr>
5351 <tr class="entry_cont">
5352 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5353 <p>1 second too long/<wbr/>too short for recharge? Should
5354this be power-dependent?</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5355 </td>
5356 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5357
5358
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5359 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5360 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5361
5362
5363
5364
5365
5366 <tr class="entry" id="static_android.flash.colorTemperature">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5367 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5368 android.<wbr/>flash.<wbr/>color<wbr/>Temperature
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5369 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5370 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5371 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5372
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5373 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5374
5375
5376 </td> <!-- entry_type -->
5377
5378 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5379 <p>The x,<wbr/>y whitepoint of the
5380flash</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5381 </td>
5382
5383 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5384 pair of floats
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5385 </td>
5386
5387 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]5388 <p>0-1 for both</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5389 </td>
5390
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5391 <td class="entry_tags">
5392 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5393 <li><a href="#tag_ADV">ADV</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5394 </ul>
5395 </td>
5396
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5397 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5398
5399
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5400 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5401 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5402
5403
5404 <tr class="entry" id="static_android.flash.maxEnergy">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5405 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5406 android.<wbr/>flash.<wbr/>max<wbr/>Energy
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5407 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5408 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5409 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5410
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5411 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5412
5413
5414 </td> <!-- entry_type -->
5415
5416 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5417 <p>Max energy output of the flash for a full
5418power single flash</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5419 </td>
5420
5421 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5422 lumen-seconds
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5423 </td>
5424
5425 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame]5426 <p>&gt;= 0</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5427 </td>
5428
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5429 <td class="entry_tags">
5430 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5431 <li><a href="#tag_ADV">ADV</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5432 </ul>
5433 </td>
5434
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5435 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5436
5437
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5438 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5439 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5440
5441
5442
5443 <!-- end of kind -->
5444 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5445 <tr><td colspan="6" class="kind">dynamic</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5446
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5447 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5448 <tr>
5449 <th class="th_name">Property Name</th>
5450 <th class="th_type">Type</th>
5451 <th class="th_description">Description</th>
5452 <th class="th_units">Units</th>
5453 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5454 <th class="th_tags">Tags</th>
5455 </tr>
5456 </thead>
5457
5458 <tbody>
5459
5460
5461
5462
5463
5464
5465
5466
5467
5468
5469 <tr class="entry" id="dynamic_android.flash.firingPower">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5470 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5471 android.<wbr/>flash.<wbr/>firing<wbr/>Power
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5472 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5473 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5474 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5475
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5476 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5477
5478
5479 </td> <!-- entry_type -->
5480
5481 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5482 <p>Power for flash firing/<wbr/>torch</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5483 </td>
5484
5485 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5486 10 is max power; 0 is no flash.<wbr/> Linear
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5487 </td>
5488
5489 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]5490 <p>0 - 10</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5491 </td>
5492
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5493 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5494 <ul class="entry_tags">
5495 <li><a href="#tag_V1">V1</a></li>
5496 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5497 </td>
5498
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5499 </tr>
5500 <tr class="entries_header">
5501 <th class="th_details" colspan="5">Details</th>
5502 </tr>
5503 <tr class="entry_cont">
5504 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5505 <p>Power for snapshot may use a different scale than
5506for torch mode.<wbr/> Only one entry for torch mode will be
5507used</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5508 </td>
5509 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5510
5511
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5512 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5513 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5514
5515
5516 <tr class="entry" id="dynamic_android.flash.firingTime">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5517 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5518 android.<wbr/>flash.<wbr/>firing<wbr/>Time
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5519 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5520 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5521 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5522
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5523 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5524
5525
5526 </td> <!-- entry_type -->
5527
5528 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5529 <p>Firing time of flash relative to start of
5530exposure</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5531 </td>
5532
5533 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5534 nanoseconds
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5535 </td>
5536
5537 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]5538 <p>0-(exposure time-flash duration)</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5539 </td>
5540
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5541 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5542 <ul class="entry_tags">
5543 <li><a href="#tag_V1">V1</a></li>
5544 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5545 </td>
5546
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5547 </tr>
5548 <tr class="entries_header">
5549 <th class="th_details" colspan="5">Details</th>
5550 </tr>
5551 <tr class="entry_cont">
5552 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5553 <p>Clamped to (0,<wbr/> exposure time - flash
5554duration).<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5555 </td>
5556 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5557
5558
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5559 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5560 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5561
5562
5563 <tr class="entry" id="dynamic_android.flash.mode">
Zhijun Heea27bc32014-01-15 13:47:59 -0800[diff] [blame]5564 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5565 android.<wbr/>flash.<wbr/>mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5566 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5567 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5568 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5569
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5570 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5571
5572 <ul class="entry_type_enum">
5573 <li>
5574 <span class="entry_type_enum_name">OFF</span>
Zhijun Heea27bc32014-01-15 13:47:59 -0800[diff] [blame]5575 <span class="entry_type_enum_notes"><p>Do not fire the flash for this capture.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5576 </li>
5577 <li>
5578 <span class="entry_type_enum_name">SINGLE</span>
Zhijun Heea27bc32014-01-15 13:47:59 -0800[diff] [blame]5579 <span class="entry_type_enum_notes"><p>If the flash is available and charged,<wbr/> fire flash
5580for this capture based on <a href="#controls_android.flash.firingPower">android.<wbr/>flash.<wbr/>firing<wbr/>Power</a> and
5581<a href="#controls_android.flash.firingTime">android.<wbr/>flash.<wbr/>firing<wbr/>Time</a>.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5582 </li>
5583 <li>
5584 <span class="entry_type_enum_name">TORCH</span>
Zhijun Heea27bc32014-01-15 13:47:59 -0800[diff] [blame]5585 <span class="entry_type_enum_notes"><p>Transition flash to continuously on.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5586 </li>
5587 </ul>
5588
5589 </td> <!-- entry_type -->
5590
5591 <td class="entry_description">
Zhijun Heea27bc32014-01-15 13:47:59 -0800[diff] [blame]5592 <p>The desired mode for for the camera device's flash control.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5593 </td>
5594
5595 <td class="entry_units">
5596 </td>
5597
5598 <td class="entry_range">
5599 </td>
5600
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5601 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5602 <ul class="entry_tags">
5603 <li><a href="#tag_BC">BC</a></li>
5604 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5605 </td>
5606
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5607 </tr>
Zhijun Heea27bc32014-01-15 13:47:59 -0800[diff] [blame]5608 <tr class="entries_header">
5609 <th class="th_details" colspan="5">Details</th>
5610 </tr>
5611 <tr class="entry_cont">
5612 <td class="entry_details" colspan="5">
5613 <p>This control is only effective when flash unit is available
Zhijun Hebdc94c42014-01-21 18:28:30 -0800[diff] [blame]5614(<code><a href="#static_android.flash.info.available">android.<wbr/>flash.<wbr/>info.<wbr/>available</a> == true</code>).<wbr/></p>
Zhijun Heea27bc32014-01-15 13:47:59 -0800[diff] [blame]5615<p>When this control is used,<wbr/> the <a href="#controls_android.control.aeMode">android.<wbr/>control.<wbr/>ae<wbr/>Mode</a> must be set to ON or OFF.<wbr/>
5616Otherwise,<wbr/> the camera device auto-exposure related flash control (ON_<wbr/>AUTO_<wbr/>FLASH,<wbr/>
5617ON_<wbr/>ALWAYS_<wbr/>FLASH,<wbr/> or ON_<wbr/>AUTO_<wbr/>FLASH_<wbr/>REDEYE) will override this control.<wbr/></p>
5618<p>When set to OFF,<wbr/> the camera device will not fire flash for this capture.<wbr/></p>
5619<p>When set to SINGLE,<wbr/> the camera device will fire flash regardless of the camera
5620device's auto-exposure routine's result.<wbr/> When used in still capture case,<wbr/> this
5621control should be used along with AE precapture metering sequence
5622(<a href="#controls_android.control.aePrecaptureTrigger">android.<wbr/>control.<wbr/>ae<wbr/>Precapture<wbr/>Trigger</a>),<wbr/> otherwise,<wbr/> the image may be incorrectly exposed.<wbr/></p>
5623<p>When set to TORCH,<wbr/> the flash will be on continuously.<wbr/> This mode can be used
5624for use cases such as preview,<wbr/> auto-focus assist,<wbr/> still capture,<wbr/> or video recording.<wbr/></p>
Zhijun He5169ce12014-01-24 16:48:25 -0800[diff] [blame]5625<p>The flash status will be reported by <a href="#dynamic_android.flash.state">android.<wbr/>flash.<wbr/>state</a> in the capture result metadata.<wbr/></p>
Zhijun Heea27bc32014-01-15 13:47:59 -0800[diff] [blame]5626 </td>
5627 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5628
5629
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5630 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5631 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5632
5633
5634 <tr class="entry" id="dynamic_android.flash.state">
Zhijun He5169ce12014-01-24 16:48:25 -0800[diff] [blame]5635 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5636 android.<wbr/>flash.<wbr/>state
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5637 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5638 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5639 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5640
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5641 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5642
5643 <ul class="entry_type_enum">
5644 <li>
5645 <span class="entry_type_enum_name">UNAVAILABLE</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]5646 <span class="entry_type_enum_notes"><p>No flash on camera</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5647 </li>
5648 <li>
5649 <span class="entry_type_enum_name">CHARGING</span>
Zhijun He5169ce12014-01-24 16:48:25 -0800[diff] [blame]5650 <span class="entry_type_enum_notes"><p>if <a href="#static_android.flash.info.available">android.<wbr/>flash.<wbr/>info.<wbr/>available</a> is true Flash is
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]5651charging and cannot be fired</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5652 </li>
5653 <li>
5654 <span class="entry_type_enum_name">READY</span>
Zhijun He5169ce12014-01-24 16:48:25 -0800[diff] [blame]5655 <span class="entry_type_enum_notes"><p>if <a href="#static_android.flash.info.available">android.<wbr/>flash.<wbr/>info.<wbr/>available</a> is true Flash is
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]5656ready to fire</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5657 </li>
5658 <li>
5659 <span class="entry_type_enum_name">FIRED</span>
Zhijun He5169ce12014-01-24 16:48:25 -0800[diff] [blame]5660 <span class="entry_type_enum_notes"><p>if <a href="#static_android.flash.info.available">android.<wbr/>flash.<wbr/>info.<wbr/>available</a> is true Flash fired
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]5661for this capture</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5662 </li>
5663 </ul>
5664
5665 </td> <!-- entry_type -->
5666
5667 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5668 <p>Current state of the flash
Zhijun He5169ce12014-01-24 16:48:25 -0800[diff] [blame]5669unit.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5670 </td>
5671
5672 <td class="entry_units">
5673 </td>
5674
5675 <td class="entry_range">
5676 </td>
5677
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5678 <td class="entry_tags">
5679 </td>
5680
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5681 </tr>
Zhijun He5169ce12014-01-24 16:48:25 -0800[diff] [blame]5682 <tr class="entries_header">
5683 <th class="th_details" colspan="5">Details</th>
5684 </tr>
5685 <tr class="entry_cont">
5686 <td class="entry_details" colspan="5">
5687 <p>When the camera device doesn't have flash unit
5688(i.<wbr/>e.<wbr/> <code><a href="#static_android.flash.info.available">android.<wbr/>flash.<wbr/>info.<wbr/>available</a> == false</code>),<wbr/> this state will always be UNAVAILABLE.<wbr/>
5689Other states indicate the current flash status.<wbr/></p>
5690 </td>
5691 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5692
5693
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5694 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5695 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5696
5697
5698
5699 <!-- end of kind -->
5700 </tbody>
5701
5702 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5703 <tr><td colspan="6" id="section_geometric" class="section">geometric</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5704
5705
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5706 <tr><td colspan="6" class="kind">controls</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5707
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5708 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5709 <tr>
5710 <th class="th_name">Property Name</th>
5711 <th class="th_type">Type</th>
5712 <th class="th_description">Description</th>
5713 <th class="th_units">Units</th>
5714 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5715 <th class="th_tags">Tags</th>
5716 </tr>
5717 </thead>
5718
5719 <tbody>
5720
5721
5722
5723
5724
5725
5726
5727
5728
5729
5730 <tr class="entry" id="controls_android.geometric.mode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5731 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5732 android.<wbr/>geometric.<wbr/>mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5733 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5734 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5735 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5736
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5737 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5738
5739 <ul class="entry_type_enum">
5740 <li>
5741 <span class="entry_type_enum_name">OFF</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]5742 <span class="entry_type_enum_notes"><p>No geometric correction is
5743applied</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5744 </li>
5745 <li>
5746 <span class="entry_type_enum_name">FAST</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]5747 <span class="entry_type_enum_notes"><p>Must not slow down frame rate relative to raw
5748bayer output</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5749 </li>
5750 <li>
5751 <span class="entry_type_enum_name">HIGH_QUALITY</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]5752 <span class="entry_type_enum_notes"><p>Frame rate may be reduced by high
5753quality</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5754 </li>
5755 </ul>
5756
5757 </td> <!-- entry_type -->
5758
5759 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5760 <p>Operating mode of geometric
5761correction</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5762 </td>
5763
5764 <td class="entry_units">
5765 </td>
5766
5767 <td class="entry_range">
5768 </td>
5769
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5770 <td class="entry_tags">
5771 </td>
5772
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5773 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5774
5775
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5776 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5777 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5778
5779
5780 <tr class="entry" id="controls_android.geometric.strength">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5781 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5782 android.<wbr/>geometric.<wbr/>strength
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5783 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5784 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5785 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5786
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5787 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5788
5789
5790 </td> <!-- entry_type -->
5791
5792 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5793 <p>Control the amount of shading correction
5794applied to the images</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5795 </td>
5796
5797 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5798 unitless: 1-10; 10 is full shading
5799 compensation
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5800 </td>
5801
5802 <td class="entry_range">
5803 </td>
5804
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5805 <td class="entry_tags">
5806 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5807 <li><a href="#tag_ADV">ADV</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5808 </ul>
5809 </td>
5810
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5811 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5812
5813
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5814 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5815 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5816
5817
5818
5819 <!-- end of kind -->
5820 </tbody>
5821
5822 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5823 <tr><td colspan="6" id="section_hotPixel" class="section">hotPixel</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5824
5825
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5826 <tr><td colspan="6" class="kind">controls</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5827
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5828 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5829 <tr>
5830 <th class="th_name">Property Name</th>
5831 <th class="th_type">Type</th>
5832 <th class="th_description">Description</th>
5833 <th class="th_units">Units</th>
5834 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5835 <th class="th_tags">Tags</th>
5836 </tr>
5837 </thead>
5838
5839 <tbody>
5840
5841
5842
5843
5844
5845
5846
5847
5848
5849
5850 <tr class="entry" id="controls_android.hotPixel.mode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5851 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5852 android.<wbr/>hot<wbr/>Pixel.<wbr/>mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5853 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5854 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5855 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5856
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5857 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5858
5859 <ul class="entry_type_enum">
5860 <li>
5861 <span class="entry_type_enum_name">OFF</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]5862 <span class="entry_type_enum_notes"><p>No hot pixel correction can be
5863applied</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5864 </li>
5865 <li>
5866 <span class="entry_type_enum_name">FAST</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]5867 <span class="entry_type_enum_notes"><p>Frame rate must not be reduced compared to raw
5868Bayer output</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5869 </li>
5870 <li>
5871 <span class="entry_type_enum_name">HIGH_QUALITY</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]5872 <span class="entry_type_enum_notes"><p>Frame rate may be reduced by high
5873quality</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5874 </li>
5875 </ul>
5876
5877 </td> <!-- entry_type -->
5878
5879 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5880 <p>Set operational mode for hot pixel
5881correction</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5882 </td>
5883
5884 <td class="entry_units">
5885 </td>
5886
5887 <td class="entry_range">
5888 </td>
5889
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5890 <td class="entry_tags">
5891 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5892 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5893 </ul>
5894 </td>
5895
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5896 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5897
5898
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5899 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5900 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5901
5902
5903
5904 <!-- end of kind -->
5905 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5906 <tr><td colspan="6" class="kind">static</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5907
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5908 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5909 <tr>
5910 <th class="th_name">Property Name</th>
5911 <th class="th_type">Type</th>
5912 <th class="th_description">Description</th>
5913 <th class="th_units">Units</th>
5914 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5915 <th class="th_tags">Tags</th>
5916 </tr>
5917 </thead>
5918
5919 <tbody>
5920
5921
5922
5923
5924
5925
5926
5927
5928
5929
5930
5931
5932 <tr class="entry" id="static_android.hotPixel.info.map">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5933 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5934 android.<wbr/>hot<wbr/>Pixel.<wbr/>info.<wbr/>map
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5935 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5936 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5937 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5938 <span class="entry_type_container">x</span>
5939
5940 <span class="entry_type_array">
5941 2 x n
5942 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5943 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5944 <div class="entry_type_notes">list of coordinates based on android.<wbr/>sensor.<wbr/>pixel<wbr/>Array<wbr/>Size</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5945
5946
5947 </td> <!-- entry_type -->
5948
5949 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5950 <p>Location of hot/<wbr/>defective pixels on
5951sensor</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5952 </td>
5953
5954 <td class="entry_units">
5955 </td>
5956
5957 <td class="entry_range">
5958 </td>
5959
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5960 <td class="entry_tags">
5961 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5962 <li><a href="#tag_ADV">ADV</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5963 </ul>
5964 </td>
5965
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5966 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5967
5968
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5969 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5970 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5971
5972
5973
5974
5975
5976
5977 <!-- end of kind -->
5978 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5979 <tr><td colspan="6" class="kind">dynamic</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5980
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5981 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5982 <tr>
5983 <th class="th_name">Property Name</th>
5984 <th class="th_type">Type</th>
5985 <th class="th_description">Description</th>
5986 <th class="th_units">Units</th>
5987 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5988 <th class="th_tags">Tags</th>
5989 </tr>
5990 </thead>
5991
5992 <tbody>
5993
5994
5995
5996
5997
5998
5999
6000
6001
6002
6003 <tr class="entry" id="dynamic_android.hotPixel.mode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6004 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6005 android.<wbr/>hot<wbr/>Pixel.<wbr/>mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6006 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6007 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6008 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6009
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6010 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6011
6012 <ul class="entry_type_enum">
6013 <li>
6014 <span class="entry_type_enum_name">OFF</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]6015 <span class="entry_type_enum_notes"><p>No hot pixel correction can be
6016applied</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6017 </li>
6018 <li>
6019 <span class="entry_type_enum_name">FAST</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]6020 <span class="entry_type_enum_notes"><p>Frame rate must not be reduced compared to raw
6021Bayer output</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6022 </li>
6023 <li>
6024 <span class="entry_type_enum_name">HIGH_QUALITY</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]6025 <span class="entry_type_enum_notes"><p>Frame rate may be reduced by high
6026quality</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6027 </li>
6028 </ul>
6029
6030 </td> <!-- entry_type -->
6031
6032 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6033 <p>Set operational mode for hot pixel
6034correction</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6035 </td>
6036
6037 <td class="entry_units">
6038 </td>
6039
6040 <td class="entry_range">
6041 </td>
6042
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6043 <td class="entry_tags">
6044 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6045 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6046 </ul>
6047 </td>
6048
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6049 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6050
6051
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6052 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6053 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6054
6055
6056
6057 <!-- end of kind -->
6058 </tbody>
6059
6060 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6061 <tr><td colspan="6" id="section_jpeg" class="section">jpeg</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6062
6063
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6064 <tr><td colspan="6" class="kind">controls</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6065
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6066 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6067 <tr>
6068 <th class="th_name">Property Name</th>
6069 <th class="th_type">Type</th>
6070 <th class="th_description">Description</th>
6071 <th class="th_units">Units</th>
6072 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6073 <th class="th_tags">Tags</th>
6074 </tr>
6075 </thead>
6076
6077 <tbody>
6078
6079
6080
6081
6082
6083
6084
6085
6086
6087
6088 <tr class="entry" id="controls_android.jpeg.gpsCoordinates">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6089 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6090 android.<wbr/>jpeg.<wbr/>gps<wbr/>Coordinates
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6091 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6092 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6093 <span class="entry_type_name">double</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6094 <span class="entry_type_container">x</span>
6095
6096 <span class="entry_type_array">
6097 3
6098 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6099 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6100 <div class="entry_type_notes">latitude,<wbr/> longitude,<wbr/> altitude.<wbr/> First two in degrees,<wbr/> the third in meters</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6101
6102
6103 </td> <!-- entry_type -->
6104
6105 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6106 <p>GPS coordinates to include in output JPEG
6107EXIF</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6108 </td>
6109
6110 <td class="entry_units">
6111 </td>
6112
6113 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]6114 <p>(-180 - 180],<wbr/> [-90,<wbr/>90],<wbr/> [-inf,<wbr/> inf]</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6115 </td>
6116
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6117 <td class="entry_tags">
6118 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6119 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6120 </ul>
6121 </td>
6122
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6123 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6124
6125
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6126 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6127 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6128
6129
6130 <tr class="entry" id="controls_android.jpeg.gpsProcessingMethod">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6131 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6132 android.<wbr/>jpeg.<wbr/>gps<wbr/>Processing<wbr/>Method
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6133 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6134 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6135 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6136
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]6137 <span class="entry_type_visibility"> [public as string]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6138
6139
6140 </td> <!-- entry_type -->
6141
6142 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6143 <p>32 characters describing GPS algorithm to
6144include in EXIF</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6145 </td>
6146
6147 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6148 UTF-8 null-terminated string
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6149 </td>
6150
6151 <td class="entry_range">
6152 </td>
6153
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6154 <td class="entry_tags">
6155 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6156 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6157 </ul>
6158 </td>
6159
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6160 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6161
6162
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6163 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6164 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6165
6166
6167 <tr class="entry" id="controls_android.jpeg.gpsTimestamp">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6168 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6169 android.<wbr/>jpeg.<wbr/>gps<wbr/>Timestamp
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6170 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6171 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6172 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6173
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6174 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6175
6176
6177 </td> <!-- entry_type -->
6178
6179 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6180 <p>Time GPS fix was made to include in
6181EXIF</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6182 </td>
6183
6184 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6185 UTC in seconds since January 1,<wbr/> 1970
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6186 </td>
6187
6188 <td class="entry_range">
6189 </td>
6190
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6191 <td class="entry_tags">
6192 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6193 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6194 </ul>
6195 </td>
6196
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6197 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6198
6199
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6200 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6201 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6202
6203
6204 <tr class="entry" id="controls_android.jpeg.orientation">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6205 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6206 android.<wbr/>jpeg.<wbr/>orientation
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6207 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6208 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6209 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6210
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6211 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6212
6213
6214 </td> <!-- entry_type -->
6215
6216 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6217 <p>Orientation of JPEG image to
6218write</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6219 </td>
6220
6221 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6222 Degrees in multiples of 90
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6223 </td>
6224
6225 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]6226 <p>0,<wbr/> 90,<wbr/> 180,<wbr/> 270</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6227 </td>
6228
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6229 <td class="entry_tags">
6230 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6231 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6232 </ul>
6233 </td>
6234
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6235 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6236
6237
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6238 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6239 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6240
6241
6242 <tr class="entry" id="controls_android.jpeg.quality">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6243 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6244 android.<wbr/>jpeg.<wbr/>quality
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6245 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6246 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6247 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6248
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6249 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6250
6251
6252 </td> <!-- entry_type -->
6253
6254 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6255 <p>Compression quality of the final JPEG
6256image</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6257 </td>
6258
6259 <td class="entry_units">
6260 </td>
6261
6262 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]6263 <p>1-100; larger is higher quality</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6264 </td>
6265
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6266 <td class="entry_tags">
6267 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6268 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6269 </ul>
6270 </td>
6271
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6272 </tr>
6273 <tr class="entries_header">
6274 <th class="th_details" colspan="5">Details</th>
6275 </tr>
6276 <tr class="entry_cont">
6277 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6278 <p>85-95 is typical usage range</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6279 </td>
6280 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6281
6282
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6283 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6284 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6285
6286
6287 <tr class="entry" id="controls_android.jpeg.thumbnailQuality">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6288 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6289 android.<wbr/>jpeg.<wbr/>thumbnail<wbr/>Quality
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6290 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6291 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6292 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6293
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6294 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6295
6296
6297 </td> <!-- entry_type -->
6298
6299 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6300 <p>Compression quality of JPEG
6301thumbnail</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6302 </td>
6303
6304 <td class="entry_units">
6305 </td>
6306
6307 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]6308 <p>1-100; larger is higher quality</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6309 </td>
6310
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6311 <td class="entry_tags">
6312 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6313 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6314 </ul>
6315 </td>
6316
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6317 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6318
6319
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6320 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6321 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6322
6323
6324 <tr class="entry" id="controls_android.jpeg.thumbnailSize">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6325 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6326 android.<wbr/>jpeg.<wbr/>thumbnail<wbr/>Size
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6327 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6328 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6329 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6330 <span class="entry_type_container">x</span>
6331
6332 <span class="entry_type_array">
6333 2
6334 </span>
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]6335 <span class="entry_type_visibility"> [public as size]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6336
6337
6338 </td> <!-- entry_type -->
6339
6340 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6341 <p>Resolution of embedded JPEG thumbnail</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6342 </td>
6343
6344 <td class="entry_units">
6345 </td>
6346
6347 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]6348 <p>Size must be one of the size from <a href="#static_android.jpeg.availableThumbnailSizes">android.<wbr/>jpeg.<wbr/>available<wbr/>Thumbnail<wbr/>Sizes</a></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6349 </td>
6350
6351 <td class="entry_tags">
6352 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6353 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6354 </ul>
6355 </td>
6356
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6357 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6358 <tr class="entries_header">
6359 <th class="th_details" colspan="5">Details</th>
6360 </tr>
6361 <tr class="entry_cont">
6362 <td class="entry_details" colspan="5">
Zhijun Hef90eeaf2014-01-16 12:13:35 -0800[diff] [blame]6363 <p>When set to (0,<wbr/> 0) value,<wbr/> the JPEG EXIF will not contain thumbnail,<wbr/>
6364but the captured JPEG will still be a valid image.<wbr/></p>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6365<p>When a jpeg image capture is issued,<wbr/> the thumbnail size selected should have
6366the same aspect ratio as the jpeg image.<wbr/></p>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6367 </td>
6368 </tr>
6369
6370
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6371 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6372 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6373
6374
6375
6376 <!-- end of kind -->
6377 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6378 <tr><td colspan="6" class="kind">static</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6379
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6380 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6381 <tr>
6382 <th class="th_name">Property Name</th>
6383 <th class="th_type">Type</th>
6384 <th class="th_description">Description</th>
6385 <th class="th_units">Units</th>
6386 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6387 <th class="th_tags">Tags</th>
6388 </tr>
6389 </thead>
6390
6391 <tbody>
6392
6393
6394
6395
6396
6397
6398
6399
6400
6401
6402 <tr class="entry" id="static_android.jpeg.availableThumbnailSizes">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6403 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6404 android.<wbr/>jpeg.<wbr/>available<wbr/>Thumbnail<wbr/>Sizes
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6405 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6406 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6407 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6408 <span class="entry_type_container">x</span>
6409
6410 <span class="entry_type_array">
6411 2 x n
6412 </span>
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]6413 <span class="entry_type_visibility"> [public as size]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6414
6415
6416 </td> <!-- entry_type -->
6417
6418 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6419 <p>Supported resolutions for the JPEG thumbnail</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6420 </td>
6421
6422 <td class="entry_units">
6423 </td>
6424
6425 <td class="entry_range">
Zhijun Hef90eeaf2014-01-16 12:13:35 -0800[diff] [blame]6426 <p>Will include at least one valid resolution,<wbr/> plus
6427(0,<wbr/>0) for no thumbnail generation,<wbr/> and each size will be distinct.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6428 </td>
6429
6430 <td class="entry_tags">
6431 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6432 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6433 </ul>
6434 </td>
6435
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6436 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6437 <tr class="entries_header">
6438 <th class="th_details" colspan="5">Details</th>
6439 </tr>
6440 <tr class="entry_cont">
6441 <td class="entry_details" colspan="5">
Zhijun Hef90eeaf2014-01-16 12:13:35 -0800[diff] [blame]6442 <p>Below condiditions will be satisfied for this size list:</p>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6443<ul>
Zhijun Hef90eeaf2014-01-16 12:13:35 -0800[diff] [blame]6444<li>The sizes will be sorted by increasing pixel area (width x height).<wbr/>
6445If several resolutions have the same area,<wbr/> they will be sorted by increasing width.<wbr/></li>
6446<li>The aspect ratio of the largest thumbnail size will be same as the
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]6447aspect ratio of largest size in <a href="#static_android.scaler.availableJpegSizes">android.<wbr/>scaler.<wbr/>available<wbr/>Jpeg<wbr/>Sizes</a>.<wbr/>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6448The largest size is defined as the size that has the largest pixel area
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6449in a given size list.<wbr/></li>
Zhijun Hef90eeaf2014-01-16 12:13:35 -0800[diff] [blame]6450<li>Each size in <a href="#static_android.scaler.availableJpegSizes">android.<wbr/>scaler.<wbr/>available<wbr/>Jpeg<wbr/>Sizes</a> will have at least
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6451one corresponding size that has the same aspect ratio in availableThumbnailSizes,<wbr/>
6452and vice versa.<wbr/></li>
Zhijun Hef90eeaf2014-01-16 12:13:35 -0800[diff] [blame]6453<li>All non (0,<wbr/> 0) sizes will have non-zero widths and heights.<wbr/></li>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6454</ul>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6455 </td>
6456 </tr>
6457
6458
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6459 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6460 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6461
6462
6463 <tr class="entry" id="static_android.jpeg.maxSize">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6464 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6465 android.<wbr/>jpeg.<wbr/>max<wbr/>Size
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6466 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6467 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6468 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6469
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6470 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6471
6472
6473 </td> <!-- entry_type -->
6474
6475 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6476 <p>Maximum size in bytes for the compressed
6477JPEG buffer</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6478 </td>
6479
6480 <td class="entry_units">
6481 </td>
6482
6483 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]6484 <p>Must be large enough to fit any JPEG produced by
6485the camera</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6486 </td>
6487
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6488 <td class="entry_tags">
6489 </td>
6490
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6491 </tr>
6492 <tr class="entries_header">
6493 <th class="th_details" colspan="5">Details</th>
6494 </tr>
6495 <tr class="entry_cont">
6496 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6497 <p>This is used for sizing the gralloc buffers for
6498JPEG</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6499 </td>
6500 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6501
6502
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6503 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6504 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6505
6506
6507
6508 <!-- end of kind -->
6509 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6510 <tr><td colspan="6" class="kind">dynamic</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6511
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6512 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6513 <tr>
6514 <th class="th_name">Property Name</th>
6515 <th class="th_type">Type</th>
6516 <th class="th_description">Description</th>
6517 <th class="th_units">Units</th>
6518 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6519 <th class="th_tags">Tags</th>
6520 </tr>
6521 </thead>
6522
6523 <tbody>
6524
6525
6526
6527
6528
6529
6530
6531
6532
6533
6534 <tr class="entry" id="dynamic_android.jpeg.gpsCoordinates">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6535 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6536 android.<wbr/>jpeg.<wbr/>gps<wbr/>Coordinates
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6537 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6538 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6539 <span class="entry_type_name">double</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6540 <span class="entry_type_container">x</span>
6541
6542 <span class="entry_type_array">
6543 3
6544 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6545 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6546 <div class="entry_type_notes">latitude,<wbr/> longitude,<wbr/> altitude.<wbr/> First two in degrees,<wbr/> the third in meters</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6547
6548
6549 </td> <!-- entry_type -->
6550
6551 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6552 <p>GPS coordinates to include in output JPEG
6553EXIF</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6554 </td>
6555
6556 <td class="entry_units">
6557 </td>
6558
6559 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]6560 <p>(-180 - 180],<wbr/> [-90,<wbr/>90],<wbr/> [-inf,<wbr/> inf]</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6561 </td>
6562
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6563 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6564 <ul class="entry_tags">
6565 <li><a href="#tag_BC">BC</a></li>
6566 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6567 </td>
6568
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6569 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6570
6571
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6572 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6573 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6574
6575
6576 <tr class="entry" id="dynamic_android.jpeg.gpsProcessingMethod">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6577 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6578 android.<wbr/>jpeg.<wbr/>gps<wbr/>Processing<wbr/>Method
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6579 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6580 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6581 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6582
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]6583 <span class="entry_type_visibility"> [public as string]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6584
6585
6586 </td> <!-- entry_type -->
6587
6588 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6589 <p>32 characters describing GPS algorithm to
6590include in EXIF</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6591 </td>
6592
6593 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6594 UTF-8 null-terminated string
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6595 </td>
6596
6597 <td class="entry_range">
6598 </td>
6599
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6600 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6601 <ul class="entry_tags">
6602 <li><a href="#tag_BC">BC</a></li>
6603 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6604 </td>
6605
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6606 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6607
6608
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6609 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6610 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6611
6612
6613 <tr class="entry" id="dynamic_android.jpeg.gpsTimestamp">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6614 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6615 android.<wbr/>jpeg.<wbr/>gps<wbr/>Timestamp
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6616 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6617 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6618 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6619
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6620 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6621
6622
6623 </td> <!-- entry_type -->
6624
6625 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6626 <p>Time GPS fix was made to include in
6627EXIF</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6628 </td>
6629
6630 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6631 UTC in seconds since January 1,<wbr/> 1970
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6632 </td>
6633
6634 <td class="entry_range">
6635 </td>
6636
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6637 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6638 <ul class="entry_tags">
6639 <li><a href="#tag_BC">BC</a></li>
6640 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6641 </td>
6642
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6643 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6644
6645
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6646 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6647 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6648
6649
6650 <tr class="entry" id="dynamic_android.jpeg.orientation">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6651 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6652 android.<wbr/>jpeg.<wbr/>orientation
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6653 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6654 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6655 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6656
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6657 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6658
6659
6660 </td> <!-- entry_type -->
6661
6662 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6663 <p>Orientation of JPEG image to
6664write</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6665 </td>
6666
6667 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6668 Degrees in multiples of 90
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6669 </td>
6670
6671 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]6672 <p>0,<wbr/> 90,<wbr/> 180,<wbr/> 270</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6673 </td>
6674
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6675 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6676 <ul class="entry_tags">
6677 <li><a href="#tag_BC">BC</a></li>
6678 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6679 </td>
6680
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6681 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6682
6683
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6684 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6685 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6686
6687
6688 <tr class="entry" id="dynamic_android.jpeg.quality">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6689 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6690 android.<wbr/>jpeg.<wbr/>quality
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6691 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6692 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6693 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6694
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6695 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6696
6697
6698 </td> <!-- entry_type -->
6699
6700 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6701 <p>Compression quality of the final JPEG
6702image</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6703 </td>
6704
6705 <td class="entry_units">
6706 </td>
6707
6708 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]6709 <p>1-100; larger is higher quality</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6710 </td>
6711
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6712 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6713 <ul class="entry_tags">
6714 <li><a href="#tag_BC">BC</a></li>
6715 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6716 </td>
6717
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6718 </tr>
6719 <tr class="entries_header">
6720 <th class="th_details" colspan="5">Details</th>
6721 </tr>
6722 <tr class="entry_cont">
6723 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6724 <p>85-95 is typical usage range</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6725 </td>
6726 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6727
6728
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6729 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6730 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6731
6732
6733 <tr class="entry" id="dynamic_android.jpeg.size">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6734 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6735 android.<wbr/>jpeg.<wbr/>size
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6736 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6737 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6738 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6739
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6740 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6741
6742
6743 </td> <!-- entry_type -->
6744
6745 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6746 <p>The size of the compressed JPEG image,<wbr/> in
6747bytes</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6748 </td>
6749
6750 <td class="entry_units">
6751 </td>
6752
6753 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame]6754 <p>&gt;= 0</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6755 </td>
6756
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6757 <td class="entry_tags">
6758 </td>
6759
6760 </tr>
6761 <tr class="entries_header">
6762 <th class="th_details" colspan="5">Details</th>
6763 </tr>
6764 <tr class="entry_cont">
6765 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6766 <p>If no JPEG output is produced for the request,<wbr/>
6767this must be 0.<wbr/></p>
6768<p>Otherwise,<wbr/> this describes the real size of the compressed
6769JPEG image placed in the output stream.<wbr/> More specifically,<wbr/>
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]6770if <a href="#static_android.jpeg.maxSize">android.<wbr/>jpeg.<wbr/>max<wbr/>Size</a> = 1000000,<wbr/> and a specific capture
6771has <a href="#dynamic_android.jpeg.size">android.<wbr/>jpeg.<wbr/>size</a> = 500000,<wbr/> then the output buffer from
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6772the JPEG stream will be 1000000 bytes,<wbr/> of which the first
6773500000 make up the real data.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6774 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6775 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6776
6777
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6778 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6779 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6780
6781
6782 <tr class="entry" id="dynamic_android.jpeg.thumbnailQuality">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6783 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6784 android.<wbr/>jpeg.<wbr/>thumbnail<wbr/>Quality
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6785 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6786 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6787 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6788
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6789 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6790
6791
6792 </td> <!-- entry_type -->
6793
6794 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6795 <p>Compression quality of JPEG
6796thumbnail</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6797 </td>
6798
6799 <td class="entry_units">
6800 </td>
6801
6802 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]6803 <p>1-100; larger is higher quality</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6804 </td>
6805
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6806 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6807 <ul class="entry_tags">
6808 <li><a href="#tag_BC">BC</a></li>
6809 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6810 </td>
6811
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6812 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6813
6814
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6815 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6816 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6817
6818
6819 <tr class="entry" id="dynamic_android.jpeg.thumbnailSize">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6820 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6821 android.<wbr/>jpeg.<wbr/>thumbnail<wbr/>Size
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6822 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6823 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6824 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6825 <span class="entry_type_container">x</span>
6826
6827 <span class="entry_type_array">
6828 2
6829 </span>
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]6830 <span class="entry_type_visibility"> [public as size]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6831
6832
6833 </td> <!-- entry_type -->
6834
6835 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6836 <p>Resolution of embedded JPEG thumbnail</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6837 </td>
6838
6839 <td class="entry_units">
6840 </td>
6841
6842 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]6843 <p>Size must be one of the size from <a href="#static_android.jpeg.availableThumbnailSizes">android.<wbr/>jpeg.<wbr/>available<wbr/>Thumbnail<wbr/>Sizes</a></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6844 </td>
6845
6846 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6847 <ul class="entry_tags">
6848 <li><a href="#tag_BC">BC</a></li>
6849 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6850 </td>
6851
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6852 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6853 <tr class="entries_header">
6854 <th class="th_details" colspan="5">Details</th>
6855 </tr>
6856 <tr class="entry_cont">
6857 <td class="entry_details" colspan="5">
Zhijun Hef90eeaf2014-01-16 12:13:35 -0800[diff] [blame]6858 <p>When set to (0,<wbr/> 0) value,<wbr/> the JPEG EXIF will not contain thumbnail,<wbr/>
6859but the captured JPEG will still be a valid image.<wbr/></p>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6860<p>When a jpeg image capture is issued,<wbr/> the thumbnail size selected should have
6861the same aspect ratio as the jpeg image.<wbr/></p>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6862 </td>
6863 </tr>
6864
6865
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6866 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6867 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6868
6869
6870
6871 <!-- end of kind -->
6872 </tbody>
6873
6874 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6875 <tr><td colspan="6" id="section_lens" class="section">lens</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6876
6877
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6878 <tr><td colspan="6" class="kind">controls</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6879
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6880 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6881 <tr>
6882 <th class="th_name">Property Name</th>
6883 <th class="th_type">Type</th>
6884 <th class="th_description">Description</th>
6885 <th class="th_units">Units</th>
6886 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6887 <th class="th_tags">Tags</th>
6888 </tr>
6889 </thead>
6890
6891 <tbody>
6892
6893
6894
6895
6896
6897
6898
6899
6900
6901
6902 <tr class="entry" id="controls_android.lens.aperture">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6903 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6904 android.<wbr/>lens.<wbr/>aperture
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6905 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6906 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6907 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6908
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6909 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6910
6911
6912 </td> <!-- entry_type -->
6913
6914 <td class="entry_description">
Zhijun He1b58d382014-01-10 10:22:53 -0800[diff] [blame]6915 <p>The ratio of lens focal length to the effective
6916aperture diameter.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6917 </td>
6918
6919 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6920 f-number (f/<wbr/>NNN)
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6921 </td>
6922
6923 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]6924 <p><a href="#static_android.lens.info.availableApertures">android.<wbr/>lens.<wbr/>info.<wbr/>available<wbr/>Apertures</a></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6925 </td>
6926
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6927 <td class="entry_tags">
6928 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6929 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6930 </ul>
6931 </td>
6932
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6933 </tr>
6934 <tr class="entries_header">
6935 <th class="th_details" colspan="5">Details</th>
6936 </tr>
6937 <tr class="entry_cont">
6938 <td class="entry_details" colspan="5">
Zhijun He1b58d382014-01-10 10:22:53 -0800[diff] [blame]6939 <p>This will only be supported on the camera devices that
6940have variable aperture lens.<wbr/> The aperture value can only be
6941one of the values listed in <a href="#static_android.lens.info.availableApertures">android.<wbr/>lens.<wbr/>info.<wbr/>available<wbr/>Apertures</a>.<wbr/></p>
6942<p>When this is supported and <a href="#controls_android.control.aeMode">android.<wbr/>control.<wbr/>ae<wbr/>Mode</a> is OFF,<wbr/>
6943this can be set along with <a href="#controls_android.sensor.exposureTime">android.<wbr/>sensor.<wbr/>exposure<wbr/>Time</a>,<wbr/>
6944<a href="#controls_android.sensor.sensitivity">android.<wbr/>sensor.<wbr/>sensitivity</a>,<wbr/> and android.<wbr/>sensor.<wbr/>frame<wbr/>Duration
6945to achieve manual exposure control.<wbr/></p>
6946<p>The requested aperture value may take several frames to reach the
6947requested value; the camera device will report the current (intermediate)
Zhijun He5169ce12014-01-24 16:48:25 -0800[diff] [blame]6948aperture size in capture result metadata while the aperture is changing.<wbr/>
6949While the aperture is still changing,<wbr/> <a href="#dynamic_android.lens.state">android.<wbr/>lens.<wbr/>state</a> will be set to MOVING.<wbr/></p>
Zhijun He1b58d382014-01-10 10:22:53 -0800[diff] [blame]6950<p>When this is supported and <a href="#controls_android.control.aeMode">android.<wbr/>control.<wbr/>ae<wbr/>Mode</a> is one of
6951the ON modes,<wbr/> this will be overridden by the camera device
6952auto-exposure algorithm,<wbr/> the overridden values are then provided
6953back to the user in the corresponding result.<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6954 </td>
6955 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6956
6957
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6958 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6959 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6960
6961
6962 <tr class="entry" id="controls_android.lens.filterDensity">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6963 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6964 android.<wbr/>lens.<wbr/>filter<wbr/>Density
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6965 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6966 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6967 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6968
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6969 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6970
6971
6972 </td> <!-- entry_type -->
6973
6974 <td class="entry_description">
Ruben Brunk83eb3032014-01-15 16:12:07 -0800[diff] [blame]6975 <p>State of lens neutral density filter(s).<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6976 </td>
6977
6978 <td class="entry_units">
Ruben Brunk83eb3032014-01-15 16:12:07 -0800[diff] [blame]6979 Steps of Exposure Value (EV).<wbr/>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6980 </td>
6981
6982 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]6983 <p><a href="#static_android.lens.info.availableFilterDensities">android.<wbr/>lens.<wbr/>info.<wbr/>available<wbr/>Filter<wbr/>Densities</a></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6984 </td>
6985
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6986 <td class="entry_tags">
6987 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6988 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6989 </ul>
6990 </td>
6991
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6992 </tr>
6993 <tr class="entries_header">
6994 <th class="th_details" colspan="5">Details</th>
6995 </tr>
6996 <tr class="entry_cont">
6997 <td class="entry_details" colspan="5">
Ruben Brunk83eb3032014-01-15 16:12:07 -0800[diff] [blame]6998 <p>This will not be supported on most camera devices.<wbr/> On devices
6999where this is supported,<wbr/> this may only be set to one of the
7000values included in <a href="#static_android.lens.info.availableFilterDensities">android.<wbr/>lens.<wbr/>info.<wbr/>available<wbr/>Filter<wbr/>Densities</a>.<wbr/></p>
7001<p>Lens filters are typically used to lower the amount of light the
7002sensor is exposed to (measured in steps of EV).<wbr/> As used here,<wbr/> an EV
7003step is the standard logarithmic representation,<wbr/> which are
7004non-negative,<wbr/> and inversely proportional to the amount of light
7005hitting the sensor.<wbr/> For example,<wbr/> setting this to 0 would result
7006in no reduction of the incoming light,<wbr/> and setting this to 2 would
7007mean that the filter is set to reduce incoming light by two stops
7008(allowing 1/<wbr/>4 of the prior amount of light to the sensor).<wbr/></p>
Zhijun He5169ce12014-01-24 16:48:25 -0800[diff] [blame]7009<p>It may take several frames before the lens filter density changes
7010to the requested value.<wbr/> While the filter density is still changing,<wbr/>
7011<a href="#dynamic_android.lens.state">android.<wbr/>lens.<wbr/>state</a> will be set to MOVING.<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7012 </td>
7013 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7014
7015
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7016 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7017 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7018
7019
7020 <tr class="entry" id="controls_android.lens.focalLength">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7021 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7022 android.<wbr/>lens.<wbr/>focal<wbr/>Length
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7023 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7024 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7025 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7026
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7027 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7028
7029
7030 </td> <!-- entry_type -->
7031
7032 <td class="entry_description">
Ruben Brunkac9bbb92014-01-15 18:39:35 -0800[diff] [blame]7033 <p>The current lens focal length; used for optical zoom.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7034 </td>
7035
7036 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7037 focal length in mm
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7038 </td>
7039
7040 <td class="entry_range">
Ruben Brunkac9bbb92014-01-15 18:39:35 -0800[diff] [blame]7041 <p><a href="#static_android.lens.info.availableFocalLengths">android.<wbr/>lens.<wbr/>info.<wbr/>available<wbr/>Focal<wbr/>Lengths</a></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7042 </td>
7043
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7044 <td class="entry_tags">
7045 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]7046 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7047 </ul>
7048 </td>
7049
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7050 </tr>
7051 <tr class="entries_header">
7052 <th class="th_details" colspan="5">Details</th>
7053 </tr>
7054 <tr class="entry_cont">
7055 <td class="entry_details" colspan="5">
Ruben Brunkac9bbb92014-01-15 18:39:35 -0800[diff] [blame]7056 <p>This setting controls the physical focal length of the camera
7057device's lens.<wbr/> Changing the focal length changes the field of
7058view of the camera device,<wbr/> and is usually used for optical zoom.<wbr/></p>
7059<p>Like <a href="#controls_android.lens.focusDistance">android.<wbr/>lens.<wbr/>focus<wbr/>Distance</a> and <a href="#controls_android.lens.aperture">android.<wbr/>lens.<wbr/>aperture</a>,<wbr/> this
7060setting won't be applied instantaneously,<wbr/> and it may take several
Zhijun He5169ce12014-01-24 16:48:25 -0800[diff] [blame]7061frames before the lens can change to the requested focal length.<wbr/>
Ruben Brunkac9bbb92014-01-15 18:39:35 -0800[diff] [blame]7062While the focal length is still changing,<wbr/> <a href="#dynamic_android.lens.state">android.<wbr/>lens.<wbr/>state</a> will
7063be set to MOVING.<wbr/></p>
7064<p>This is expected not to be supported on most devices.<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7065 </td>
7066 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7067
7068
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7069 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7070 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7071
7072
7073 <tr class="entry" id="controls_android.lens.focusDistance">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7074 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7075 android.<wbr/>lens.<wbr/>focus<wbr/>Distance
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7076 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7077 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7078 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7079
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7080 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7081
7082
7083 </td> <!-- entry_type -->
7084
7085 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7086 <p>Distance to plane of sharpest focus,<wbr/>
7087measured from frontmost surface of the lens</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7088 </td>
7089
7090 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7091 diopters (1/<wbr/>m)
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7092 </td>
7093
7094 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame]7095 <p>&gt;= 0</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7096 </td>
7097
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7098 <td class="entry_tags">
7099 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]7100 <li><a href="#tag_BC">BC</a></li>
7101 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7102 </ul>
7103 </td>
7104
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7105 </tr>
7106 <tr class="entries_header">
7107 <th class="th_details" colspan="5">Details</th>
7108 </tr>
7109 <tr class="entry_cont">
7110 <td class="entry_details" colspan="5">
Zhijun He5169ce12014-01-24 16:48:25 -0800[diff] [blame]7111 <p>0 means infinity focus.<wbr/> Used value will be clamped
7112to [0,<wbr/> <a href="#static_android.lens.info.minimumFocusDistance">android.<wbr/>lens.<wbr/>info.<wbr/>minimum<wbr/>Focus<wbr/>Distance</a>].<wbr/></p>
7113<p>Like <a href="#controls_android.lens.focalLength">android.<wbr/>lens.<wbr/>focal<wbr/>Length</a>,<wbr/> this setting won't be applied
7114instantaneously,<wbr/> and it may take several frames before the lens
7115can move to the requested focus distance.<wbr/> While the lens is still moving,<wbr/>
7116<a href="#dynamic_android.lens.state">android.<wbr/>lens.<wbr/>state</a> will be set to MOVING.<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7117 </td>
7118 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7119
7120
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7121 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7122 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7123
7124
7125 <tr class="entry" id="controls_android.lens.opticalStabilizationMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7126 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7127 android.<wbr/>lens.<wbr/>optical<wbr/>Stabilization<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7128 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7129 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7130 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7131
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7132 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7133
7134 <ul class="entry_type_enum">
7135 <li>
7136 <span class="entry_type_enum_name">OFF</span>
Ruben Brunk218639c2014-01-15 18:09:41 -0800[diff] [blame]7137 <span class="entry_type_enum_notes"><p>Optical stabilization is unavailable.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7138 </li>
7139 <li>
7140 <span class="entry_type_enum_name">ON</span>
7141 <span class="entry_type_enum_optional">optional</span>
Ruben Brunk218639c2014-01-15 18:09:41 -0800[diff] [blame]7142 <span class="entry_type_enum_notes"><p>Optical stabilization is enabled.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7143 </li>
7144 </ul>
7145
7146 </td> <!-- entry_type -->
7147
7148 <td class="entry_description">
Ruben Brunk218639c2014-01-15 18:09:41 -0800[diff] [blame]7149 <p>Sets whether the camera device uses optical image stabilization (OIS)
7150when capturing images.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7151 </td>
7152
7153 <td class="entry_units">
7154 </td>
7155
7156 <td class="entry_range">
Ruben Brunk218639c2014-01-15 18:09:41 -0800[diff] [blame]7157 <p><a href="#static_android.lens.info.availableOpticalStabilization">android.<wbr/>lens.<wbr/>info.<wbr/>available<wbr/>Optical<wbr/>Stabilization</a></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7158 </td>
7159
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7160 <td class="entry_tags">
7161 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]7162 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7163 </ul>
7164 </td>
7165
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7166 </tr>
7167 <tr class="entries_header">
7168 <th class="th_details" colspan="5">Details</th>
7169 </tr>
7170 <tr class="entry_cont">
7171 <td class="entry_details" colspan="5">
Ruben Brunk218639c2014-01-15 18:09:41 -0800[diff] [blame]7172 <p>OIS is used to compensate for motion blur due to small movements of
7173the camera during capture.<wbr/> Unlike digital image stabilization,<wbr/> OIS makes
7174use of mechanical elements to stabilize the camera sensor,<wbr/> and thus
7175allows for longer exposure times before camera shake becomes
7176apparent.<wbr/></p>
7177<p>This is not expected to be supported on most devices.<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7178 </td>
7179 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7180
7181
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7182 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7183 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7184
7185
7186
7187 <!-- end of kind -->
7188 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7189 <tr><td colspan="6" class="kind">static</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7190
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7191 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7192 <tr>
7193 <th class="th_name">Property Name</th>
7194 <th class="th_type">Type</th>
7195 <th class="th_description">Description</th>
7196 <th class="th_units">Units</th>
7197 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7198 <th class="th_tags">Tags</th>
7199 </tr>
7200 </thead>
7201
7202 <tbody>
7203
7204
7205
7206
7207
7208
7209
7210
7211
7212
7213
7214
7215 <tr class="entry" id="static_android.lens.info.availableApertures">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7216 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7217 android.<wbr/>lens.<wbr/>info.<wbr/>available<wbr/>Apertures
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7218 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7219 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7220 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7221 <span class="entry_type_container">x</span>
7222
7223 <span class="entry_type_array">
7224 n
7225 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7226 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7227
7228
7229 </td> <!-- entry_type -->
7230
7231 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7232 <p>List of supported aperture
Zhijun He1b58d382014-01-10 10:22:53 -0800[diff] [blame]7233values.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7234 </td>
7235
7236 <td class="entry_units">
7237 </td>
7238
7239 <td class="entry_range">
Zhijun He5169ce12014-01-24 16:48:25 -0800[diff] [blame]7240 <p>one entry required,<wbr/> &gt; 0</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7241 </td>
7242
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7243 <td class="entry_tags">
7244 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]7245 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7246 </ul>
7247 </td>
7248
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7249 </tr>
7250 <tr class="entries_header">
7251 <th class="th_details" colspan="5">Details</th>
7252 </tr>
7253 <tr class="entry_cont">
7254 <td class="entry_details" colspan="5">
Zhijun He1b58d382014-01-10 10:22:53 -0800[diff] [blame]7255 <p>If the camera device doesn't support variable apertures,<wbr/>
7256listed value will be the fixed aperture.<wbr/></p>
7257<p>If the camera device supports variable apertures,<wbr/> the aperture value
7258in this list will be sorted in ascending order.<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7259 </td>
7260 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7261
7262
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7263 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7264 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7265
7266
7267 <tr class="entry" id="static_android.lens.info.availableFilterDensities">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7268 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7269 android.<wbr/>lens.<wbr/>info.<wbr/>available<wbr/>Filter<wbr/>Densities
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7270 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7271 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7272 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7273 <span class="entry_type_container">x</span>
7274
7275 <span class="entry_type_array">
7276 n
7277 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7278 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7279
7280
7281 </td> <!-- entry_type -->
7282
7283 <td class="entry_description">
Ruben Brunk83eb3032014-01-15 16:12:07 -0800[diff] [blame]7284 <p>List of supported neutral density filter values for
7285<a href="#controls_android.lens.filterDensity">android.<wbr/>lens.<wbr/>filter<wbr/>Density</a>.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7286 </td>
7287
7288 <td class="entry_units">
7289 </td>
7290
7291 <td class="entry_range">
Ruben Brunk83eb3032014-01-15 16:12:07 -0800[diff] [blame]7292 <p>At least one value is required.<wbr/> Values must be &gt;= 0.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7293 </td>
7294
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7295 <td class="entry_tags">
7296 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]7297 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7298 </ul>
7299 </td>
7300
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7301 </tr>
7302 <tr class="entries_header">
7303 <th class="th_details" colspan="5">Details</th>
7304 </tr>
7305 <tr class="entry_cont">
7306 <td class="entry_details" colspan="5">
Ruben Brunk83eb3032014-01-15 16:12:07 -0800[diff] [blame]7307 <p>If changing <a href="#controls_android.lens.filterDensity">android.<wbr/>lens.<wbr/>filter<wbr/>Density</a> is not supported,<wbr/>
7308availableFilterDensities must contain only 0.<wbr/> Otherwise,<wbr/> this
7309list contains only the exact filter density values available on
7310this camera device.<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7311 </td>
7312 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7313
7314
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7315 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7316 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7317
7318
7319 <tr class="entry" id="static_android.lens.info.availableFocalLengths">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7320 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7321 android.<wbr/>lens.<wbr/>info.<wbr/>available<wbr/>Focal<wbr/>Lengths
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7322 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7323 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7324 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7325 <span class="entry_type_container">x</span>
7326
7327 <span class="entry_type_array">
7328 n
7329 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7330 <span class="entry_type_visibility"> [public]</span>
Ruben Brunkac9bbb92014-01-15 18:39:35 -0800[diff] [blame]7331 <div class="entry_type_notes">The list of available focal lengths</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7332
7333
7334 </td> <!-- entry_type -->
7335
7336 <td class="entry_description">
Ruben Brunkac9bbb92014-01-15 18:39:35 -0800[diff] [blame]7337 <p>The available focal lengths for this device for use with
7338<a href="#controls_android.lens.focalLength">android.<wbr/>lens.<wbr/>focal<wbr/>Length</a>.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7339 </td>
7340
7341 <td class="entry_units">
7342 </td>
7343
7344 <td class="entry_range">
Ruben Brunkac9bbb92014-01-15 18:39:35 -0800[diff] [blame]7345 <p>Each value in this list must be &gt; 0.<wbr/> This list must
7346contain at least one value.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7347 </td>
7348
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7349 <td class="entry_tags">
7350 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]7351 <li><a href="#tag_BC">BC</a></li>
7352 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7353 </ul>
7354 </td>
7355
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7356 </tr>
7357 <tr class="entries_header">
7358 <th class="th_details" colspan="5">Details</th>
7359 </tr>
7360 <tr class="entry_cont">
7361 <td class="entry_details" colspan="5">
Ruben Brunkac9bbb92014-01-15 18:39:35 -0800[diff] [blame]7362 <p>If optical zoom is not supported,<wbr/> this will only report
7363a single value corresponding to the static focal length of the
7364device.<wbr/> Otherwise,<wbr/> this will report every focal length supported
7365by the device.<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7366 </td>
7367 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7368
7369
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7370 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7371 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7372
7373
7374 <tr class="entry" id="static_android.lens.info.availableOpticalStabilization">
Ruben Brunk218639c2014-01-15 18:09:41 -0800[diff] [blame]7375 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7376 android.<wbr/>lens.<wbr/>info.<wbr/>available<wbr/>Optical<wbr/>Stabilization
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7377 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7378 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7379 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7380 <span class="entry_type_container">x</span>
7381
7382 <span class="entry_type_array">
7383 n
7384 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7385 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7386 <div class="entry_type_notes">list of enums</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7387
7388
7389 </td> <!-- entry_type -->
7390
7391 <td class="entry_description">
Ruben Brunk218639c2014-01-15 18:09:41 -0800[diff] [blame]7392 <p>List containing a subset of the optical image
7393stabilization (OIS) modes specified in
7394<a href="#controls_android.lens.opticalStabilizationMode">android.<wbr/>lens.<wbr/>optical<wbr/>Stabilization<wbr/>Mode</a>.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7395 </td>
7396
7397 <td class="entry_units">
7398 </td>
7399
7400 <td class="entry_range">
7401 </td>
7402
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7403 <td class="entry_tags">
7404 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]7405 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7406 </ul>
7407 </td>
7408
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7409 </tr>
Ruben Brunk218639c2014-01-15 18:09:41 -0800[diff] [blame]7410 <tr class="entries_header">
7411 <th class="th_details" colspan="5">Details</th>
7412 </tr>
7413 <tr class="entry_cont">
7414 <td class="entry_details" colspan="5">
7415 <p>If OIS is not implemented for a given camera device,<wbr/> this should
7416contain only OFF.<wbr/></p>
7417 </td>
7418 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7419
7420
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7421 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7422 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7423
7424
7425 <tr class="entry" id="static_android.lens.info.geometricCorrectionMap">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7426 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7427 android.<wbr/>lens.<wbr/>info.<wbr/>geometric<wbr/>Correction<wbr/>Map
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7428 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7429 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7430 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7431 <span class="entry_type_container">x</span>
7432
7433 <span class="entry_type_array">
7434 2 x 3 x n x m
7435 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7436 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7437 <div class="entry_type_notes">2D array of destination coordinate pairs for uniform grid points in source image,<wbr/> per color channel.<wbr/> Size in the range of 2x3x40x30</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7438
7439
7440 </td> <!-- entry_type -->
7441
7442 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7443 <p>A low-resolution map for correction of
7444geometric distortions and chromatic aberrations,<wbr/> per
7445color channel</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7446 </td>
7447
7448 <td class="entry_units">
7449 </td>
7450
7451 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]7452 <p>N,<wbr/> M &gt;= 2</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7453 </td>
7454
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7455 <td class="entry_tags">
7456 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]7457 <li><a href="#tag_DNG">DNG</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7458 </ul>
7459 </td>
7460
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7461 </tr>
7462 <tr class="entries_header">
7463 <th class="th_details" colspan="5">Details</th>
7464 </tr>
7465 <tr class="entry_cont">
7466 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7467 <p>[DNG wants a function instead].<wbr/> What's easiest
7468for implementers? With an array size (M,<wbr/> N),<wbr/> entry (i,<wbr/>
7469j) provides the destination for pixel (i/<wbr/>(M-1) * width,<wbr/>
7470j/<wbr/>(N-1) * height).<wbr/> Data is row-major,<wbr/> with each array
7471entry being ( (X,<wbr/> Y)_<wbr/>r,<wbr/> (X,<wbr/> Y)_<wbr/>g,<wbr/> (X,<wbr/> Y)_<wbr/>b ) )</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7472 </td>
7473 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7474
7475
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7476 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7477 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7478
7479
7480 <tr class="entry" id="static_android.lens.info.geometricCorrectionMapSize">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7481 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7482 android.<wbr/>lens.<wbr/>info.<wbr/>geometric<wbr/>Correction<wbr/>Map<wbr/>Size
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7483 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7484 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7485 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7486 <span class="entry_type_container">x</span>
7487
7488 <span class="entry_type_array">
7489 2
7490 </span>
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]7491 <span class="entry_type_visibility"> [system as size]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7492 <div class="entry_type_notes">width and height of geometric correction map</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7493
7494
7495 </td> <!-- entry_type -->
7496
7497 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7498 <p>Dimensions of geometric correction
7499map</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7500 </td>
7501
7502 <td class="entry_units">
7503 </td>
7504
7505 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]7506 <p>Both values &gt;= 2</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7507 </td>
7508
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7509 <td class="entry_tags">
7510 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]7511 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7512 </ul>
7513 </td>
7514
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7515 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7516
7517
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7518 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7519 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7520
7521
7522 <tr class="entry" id="static_android.lens.info.hyperfocalDistance">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7523 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7524 android.<wbr/>lens.<wbr/>info.<wbr/>hyperfocal<wbr/>Distance
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7525 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7526 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7527 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7528
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7529 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7530
7531
7532 </td> <!-- entry_type -->
7533
7534 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7535 <p>Hyperfocal distance for this lens; set to
75360 if fixed focus</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7537 </td>
7538
7539 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7540 diopters
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7541 </td>
7542
7543 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame]7544 <p>&gt;= 0</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7545 </td>
7546
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7547 <td class="entry_tags">
7548 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]7549 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7550 </ul>
7551 </td>
7552
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7553 </tr>
7554 <tr class="entries_header">
7555 <th class="th_details" colspan="5">Details</th>
7556 </tr>
7557 <tr class="entry_cont">
7558 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7559 <p>The hyperfocal distance is used for the old
7560API's 'fixed' setting</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7561 </td>
7562 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7563
7564
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7565 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7566 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7567
7568
7569 <tr class="entry" id="static_android.lens.info.minimumFocusDistance">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7570 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7571 android.<wbr/>lens.<wbr/>info.<wbr/>minimum<wbr/>Focus<wbr/>Distance
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7572 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7573 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7574 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7575
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7576 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7577
7578
7579 </td> <!-- entry_type -->
7580
7581 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7582 <p>Shortest distance from frontmost surface
7583of the lens that can be focused correctly</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7584 </td>
7585
7586 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7587 diopters
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7588 </td>
7589
7590 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame]7591 <p>&gt;= 0</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7592 </td>
7593
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7594 <td class="entry_tags">
7595 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]7596 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7597 </ul>
7598 </td>
7599
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7600 </tr>
7601 <tr class="entries_header">
7602 <th class="th_details" colspan="5">Details</th>
7603 </tr>
7604 <tr class="entry_cont">
7605 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7606 <p>If the lens is fixed-focus,<wbr/> this should be
76070</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7608 </td>
7609 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7610
7611
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7612 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7613 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7614
7615
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7616 <tr class="entry" id="static_android.lens.info.shadingMapSize">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7617 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7618 android.<wbr/>lens.<wbr/>info.<wbr/>shading<wbr/>Map<wbr/>Size
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7619 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7620 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7621 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7622 <span class="entry_type_container">x</span>
7623
7624 <span class="entry_type_array">
7625 2
7626 </span>
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]7627 <span class="entry_type_visibility"> [public as size]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7628 <div class="entry_type_notes">width and height of lens shading map provided by the HAL.<wbr/> (N x M)</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7629
7630
7631 </td> <!-- entry_type -->
7632
7633 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7634 <p>Dimensions of lens shading map.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7635 </td>
7636
7637 <td class="entry_units">
7638 </td>
7639
7640 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]7641 <p>Both values &gt;= 1</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7642 </td>
7643
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7644 <td class="entry_tags">
7645 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]7646 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7647 </ul>
7648 </td>
7649
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7650 </tr>
7651 <tr class="entries_header">
7652 <th class="th_details" colspan="5">Details</th>
7653 </tr>
7654 <tr class="entry_cont">
7655 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7656 <p>The map should be on the order of 30-40 rows and columns,<wbr/> and
7657must be smaller than 64x64.<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7658 </td>
7659 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7660
7661
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7662 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7663 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7664
7665
7666
7667
7668
7669 <tr class="entry" id="static_android.lens.facing">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7670 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7671 android.<wbr/>lens.<wbr/>facing
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7672 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7673 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7674 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7675
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7676 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7677
7678 <ul class="entry_type_enum">
7679 <li>
7680 <span class="entry_type_enum_name">FRONT</span>
7681 </li>
7682 <li>
7683 <span class="entry_type_enum_name">BACK</span>
7684 </li>
7685 </ul>
7686
7687 </td> <!-- entry_type -->
7688
7689 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7690 <p>Direction the camera faces relative to
7691device screen</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7692 </td>
7693
7694 <td class="entry_units">
7695 </td>
7696
7697 <td class="entry_range">
7698 </td>
7699
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7700 <td class="entry_tags">
7701 </td>
7702
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7703 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7704
7705
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7706 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7707 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7708
7709
7710 <tr class="entry" id="static_android.lens.opticalAxisAngle">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7711 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7712 android.<wbr/>lens.<wbr/>optical<wbr/>Axis<wbr/>Angle
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7713 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7714 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7715 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7716 <span class="entry_type_container">x</span>
7717
7718 <span class="entry_type_array">
7719 2
7720 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7721 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7722 <div class="entry_type_notes">degrees.<wbr/> First defines the angle of separation between the perpendicular to the screen and the camera optical axis.<wbr/> The second then defines the clockwise rotation of the optical axis from native device up.<wbr/></div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7723
7724
7725 </td> <!-- entry_type -->
7726
7727 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7728 <p>Relative angle of camera optical axis to the
7729perpendicular axis from the display</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7730 </td>
7731
7732 <td class="entry_units">
7733 </td>
7734
7735 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]7736 <p>[0-90) for first angle,<wbr/> [0-360) for second</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7737 </td>
7738
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7739 <td class="entry_tags">
7740 <ul class="entry_tags">
7741 <li><a href="#tag_ADV">ADV</a></li>
7742 </ul>
7743 </td>
7744
7745 </tr>
7746 <tr class="entries_header">
7747 <th class="th_details" colspan="5">Details</th>
7748 </tr>
7749 <tr class="entry_cont">
7750 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7751 <p>Examples:</p>
7752<p>(0,<wbr/>0) means that the camera optical axis
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]7753is perpendicular to the display surface;</p>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7754<p>(45,<wbr/>0) means that the camera points 45 degrees up when
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]7755device is held upright;</p>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7756<p>(45,<wbr/>90) means the camera points 45 degrees to the right when
7757the device is held upright.<wbr/></p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]7758<p>Use FACING field to determine perpendicular outgoing
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7759direction</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7760 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7761 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7762
7763
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7764 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7765 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7766
7767
7768 <tr class="entry" id="static_android.lens.position">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7769 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7770 android.<wbr/>lens.<wbr/>position
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7771 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7772 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7773 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7774 <span class="entry_type_container">x</span>
7775
7776 <span class="entry_type_array">
7777 3, location in mm, in the sensor coordinate
7778 system
7779 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7780 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7781
7782
7783 </td> <!-- entry_type -->
7784
7785 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7786 <p>Coordinates of camera optical axis on
7787device</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7788 </td>
7789
7790 <td class="entry_units">
7791 </td>
7792
7793 <td class="entry_range">
7794 </td>
7795
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7796 <td class="entry_tags">
7797 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]7798 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7799 </ul>
7800 </td>
7801
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7802 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7803
7804
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7805 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7806 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7807
7808
7809
7810 <!-- end of kind -->
7811 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7812 <tr><td colspan="6" class="kind">dynamic</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7813
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7814 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7815 <tr>
7816 <th class="th_name">Property Name</th>
7817 <th class="th_type">Type</th>
7818 <th class="th_description">Description</th>
7819 <th class="th_units">Units</th>
7820 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7821 <th class="th_tags">Tags</th>
7822 </tr>
7823 </thead>
7824
7825 <tbody>
7826
7827
7828
7829
7830
7831
7832
7833
7834
7835
7836 <tr class="entry" id="dynamic_android.lens.aperture">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7837 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7838 android.<wbr/>lens.<wbr/>aperture
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7839 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7840 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7841 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7842
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7843 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7844
7845
7846 </td> <!-- entry_type -->
7847
7848 <td class="entry_description">
Zhijun He1b58d382014-01-10 10:22:53 -0800[diff] [blame]7849 <p>The ratio of lens focal length to the effective
7850aperture diameter.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7851 </td>
7852
7853 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7854 f-number (f/<wbr/>NNN)
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7855 </td>
7856
7857 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]7858 <p><a href="#static_android.lens.info.availableApertures">android.<wbr/>lens.<wbr/>info.<wbr/>available<wbr/>Apertures</a></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7859 </td>
7860
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7861 <td class="entry_tags">
7862 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]7863 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7864 </ul>
7865 </td>
7866
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7867 </tr>
7868 <tr class="entries_header">
7869 <th class="th_details" colspan="5">Details</th>
7870 </tr>
7871 <tr class="entry_cont">
7872 <td class="entry_details" colspan="5">
Zhijun He1b58d382014-01-10 10:22:53 -0800[diff] [blame]7873 <p>This will only be supported on the camera devices that
7874have variable aperture lens.<wbr/> The aperture value can only be
7875one of the values listed in <a href="#static_android.lens.info.availableApertures">android.<wbr/>lens.<wbr/>info.<wbr/>available<wbr/>Apertures</a>.<wbr/></p>
7876<p>When this is supported and <a href="#controls_android.control.aeMode">android.<wbr/>control.<wbr/>ae<wbr/>Mode</a> is OFF,<wbr/>
7877this can be set along with <a href="#controls_android.sensor.exposureTime">android.<wbr/>sensor.<wbr/>exposure<wbr/>Time</a>,<wbr/>
7878<a href="#controls_android.sensor.sensitivity">android.<wbr/>sensor.<wbr/>sensitivity</a>,<wbr/> and android.<wbr/>sensor.<wbr/>frame<wbr/>Duration
7879to achieve manual exposure control.<wbr/></p>
7880<p>The requested aperture value may take several frames to reach the
7881requested value; the camera device will report the current (intermediate)
Zhijun He5169ce12014-01-24 16:48:25 -0800[diff] [blame]7882aperture size in capture result metadata while the aperture is changing.<wbr/>
7883While the aperture is still changing,<wbr/> <a href="#dynamic_android.lens.state">android.<wbr/>lens.<wbr/>state</a> will be set to MOVING.<wbr/></p>
Zhijun He1b58d382014-01-10 10:22:53 -0800[diff] [blame]7884<p>When this is supported and <a href="#controls_android.control.aeMode">android.<wbr/>control.<wbr/>ae<wbr/>Mode</a> is one of
7885the ON modes,<wbr/> this will be overridden by the camera device
7886auto-exposure algorithm,<wbr/> the overridden values are then provided
7887back to the user in the corresponding result.<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7888 </td>
7889 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7890
7891
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7892 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7893 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7894
7895
7896 <tr class="entry" id="dynamic_android.lens.filterDensity">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7897 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7898 android.<wbr/>lens.<wbr/>filter<wbr/>Density
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7899 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7900 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7901 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7902
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7903 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7904
7905
7906 </td> <!-- entry_type -->
7907
7908 <td class="entry_description">
Ruben Brunk83eb3032014-01-15 16:12:07 -0800[diff] [blame]7909 <p>State of lens neutral density filter(s).<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7910 </td>
7911
7912 <td class="entry_units">
Ruben Brunk83eb3032014-01-15 16:12:07 -0800[diff] [blame]7913 Steps of Exposure Value (EV).<wbr/>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7914 </td>
7915
7916 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]7917 <p><a href="#static_android.lens.info.availableFilterDensities">android.<wbr/>lens.<wbr/>info.<wbr/>available<wbr/>Filter<wbr/>Densities</a></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7918 </td>
7919
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7920 <td class="entry_tags">
7921 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]7922 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7923 </ul>
7924 </td>
7925
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7926 </tr>
7927 <tr class="entries_header">
7928 <th class="th_details" colspan="5">Details</th>
7929 </tr>
7930 <tr class="entry_cont">
7931 <td class="entry_details" colspan="5">
Ruben Brunk83eb3032014-01-15 16:12:07 -0800[diff] [blame]7932 <p>This will not be supported on most camera devices.<wbr/> On devices
7933where this is supported,<wbr/> this may only be set to one of the
7934values included in <a href="#static_android.lens.info.availableFilterDensities">android.<wbr/>lens.<wbr/>info.<wbr/>available<wbr/>Filter<wbr/>Densities</a>.<wbr/></p>
7935<p>Lens filters are typically used to lower the amount of light the
7936sensor is exposed to (measured in steps of EV).<wbr/> As used here,<wbr/> an EV
7937step is the standard logarithmic representation,<wbr/> which are
7938non-negative,<wbr/> and inversely proportional to the amount of light
7939hitting the sensor.<wbr/> For example,<wbr/> setting this to 0 would result
7940in no reduction of the incoming light,<wbr/> and setting this to 2 would
7941mean that the filter is set to reduce incoming light by two stops
7942(allowing 1/<wbr/>4 of the prior amount of light to the sensor).<wbr/></p>
Zhijun He5169ce12014-01-24 16:48:25 -0800[diff] [blame]7943<p>It may take several frames before the lens filter density changes
7944to the requested value.<wbr/> While the filter density is still changing,<wbr/>
7945<a href="#dynamic_android.lens.state">android.<wbr/>lens.<wbr/>state</a> will be set to MOVING.<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7946 </td>
7947 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7948
7949
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7950 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7951 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7952
7953
7954 <tr class="entry" id="dynamic_android.lens.focalLength">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7955 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7956 android.<wbr/>lens.<wbr/>focal<wbr/>Length
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7957 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7958 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7959 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7960
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7961 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7962
7963
7964 </td> <!-- entry_type -->
7965
7966 <td class="entry_description">
Ruben Brunkac9bbb92014-01-15 18:39:35 -0800[diff] [blame]7967 <p>The current lens focal length; used for optical zoom.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7968 </td>
7969
7970 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7971 focal length in mm
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7972 </td>
7973
7974 <td class="entry_range">
Ruben Brunkac9bbb92014-01-15 18:39:35 -0800[diff] [blame]7975 <p><a href="#static_android.lens.info.availableFocalLengths">android.<wbr/>lens.<wbr/>info.<wbr/>available<wbr/>Focal<wbr/>Lengths</a></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7976 </td>
7977
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7978 <td class="entry_tags">
7979 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]7980 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7981 </ul>
7982 </td>
7983
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7984 </tr>
7985 <tr class="entries_header">
7986 <th class="th_details" colspan="5">Details</th>
7987 </tr>
7988 <tr class="entry_cont">
7989 <td class="entry_details" colspan="5">
Ruben Brunkac9bbb92014-01-15 18:39:35 -0800[diff] [blame]7990 <p>This setting controls the physical focal length of the camera
7991device's lens.<wbr/> Changing the focal length changes the field of
7992view of the camera device,<wbr/> and is usually used for optical zoom.<wbr/></p>
7993<p>Like <a href="#controls_android.lens.focusDistance">android.<wbr/>lens.<wbr/>focus<wbr/>Distance</a> and <a href="#controls_android.lens.aperture">android.<wbr/>lens.<wbr/>aperture</a>,<wbr/> this
7994setting won't be applied instantaneously,<wbr/> and it may take several
Zhijun He5169ce12014-01-24 16:48:25 -0800[diff] [blame]7995frames before the lens can change to the requested focal length.<wbr/>
Ruben Brunkac9bbb92014-01-15 18:39:35 -0800[diff] [blame]7996While the focal length is still changing,<wbr/> <a href="#dynamic_android.lens.state">android.<wbr/>lens.<wbr/>state</a> will
7997be set to MOVING.<wbr/></p>
7998<p>This is expected not to be supported on most devices.<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7999 </td>
8000 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8001
8002
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8003 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8004 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8005
8006
8007 <tr class="entry" id="dynamic_android.lens.focusDistance">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8008 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8009 android.<wbr/>lens.<wbr/>focus<wbr/>Distance
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8010 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8011 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8012 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8013
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8014 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8015
8016
8017 </td> <!-- entry_type -->
8018
8019 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8020 <p>Distance to plane of sharpest focus,<wbr/>
8021measured from frontmost surface of the lens</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8022 </td>
8023
8024 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8025 diopters (1/<wbr/>m)
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8026 </td>
8027
8028 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame]8029 <p>&gt;= 0</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8030 </td>
8031
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8032 <td class="entry_tags">
8033 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]8034 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8035 </ul>
8036 </td>
8037
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8038 </tr>
8039 <tr class="entries_header">
8040 <th class="th_details" colspan="5">Details</th>
8041 </tr>
8042 <tr class="entry_cont">
8043 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8044 <p>Should be zero for fixed-focus cameras</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8045 </td>
8046 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8047
8048
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8049 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8050 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8051
8052
8053 <tr class="entry" id="dynamic_android.lens.focusRange">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8054 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8055 android.<wbr/>lens.<wbr/>focus<wbr/>Range
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8056 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8057 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8058 <span class="entry_type_name">float</span>
Zhijun He50451ad2013-09-26 10:27:47 -0700[diff] [blame]8059 <span class="entry_type_container">x</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8060
Zhijun He50451ad2013-09-26 10:27:47 -0700[diff] [blame]8061 <span class="entry_type_array">
8062 2
8063 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8064 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8065 <div class="entry_type_notes">Range of scene distances that are in focus</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8066
8067
8068 </td> <!-- entry_type -->
8069
8070 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8071 <p>The range of scene distances that are in
8072sharp focus (depth of field)</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8073 </td>
8074
8075 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8076 pair of focus distances in diopters: (near,<wbr/>
8077 far)
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8078 </td>
8079
8080 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame]8081 <p>&gt;=0</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8082 </td>
8083
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8084 <td class="entry_tags">
8085 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]8086 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8087 </ul>
8088 </td>
8089
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8090 </tr>
8091 <tr class="entries_header">
8092 <th class="th_details" colspan="5">Details</th>
8093 </tr>
8094 <tr class="entry_cont">
8095 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8096 <p>If variable focus not supported,<wbr/> can still report
8097fixed depth of field range</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8098 </td>
8099 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8100
8101
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8102 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8103 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8104
8105
8106 <tr class="entry" id="dynamic_android.lens.opticalStabilizationMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8107 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8108 android.<wbr/>lens.<wbr/>optical<wbr/>Stabilization<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8109 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8110 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8111 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8112
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8113 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8114
8115 <ul class="entry_type_enum">
8116 <li>
8117 <span class="entry_type_enum_name">OFF</span>
Ruben Brunk218639c2014-01-15 18:09:41 -0800[diff] [blame]8118 <span class="entry_type_enum_notes"><p>Optical stabilization is unavailable.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8119 </li>
8120 <li>
8121 <span class="entry_type_enum_name">ON</span>
8122 <span class="entry_type_enum_optional">optional</span>
Ruben Brunk218639c2014-01-15 18:09:41 -0800[diff] [blame]8123 <span class="entry_type_enum_notes"><p>Optical stabilization is enabled.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8124 </li>
8125 </ul>
8126
8127 </td> <!-- entry_type -->
8128
8129 <td class="entry_description">
Ruben Brunk218639c2014-01-15 18:09:41 -0800[diff] [blame]8130 <p>Sets whether the camera device uses optical image stabilization (OIS)
8131when capturing images.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8132 </td>
8133
8134 <td class="entry_units">
8135 </td>
8136
8137 <td class="entry_range">
Ruben Brunk218639c2014-01-15 18:09:41 -0800[diff] [blame]8138 <p><a href="#static_android.lens.info.availableOpticalStabilization">android.<wbr/>lens.<wbr/>info.<wbr/>available<wbr/>Optical<wbr/>Stabilization</a></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8139 </td>
8140
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8141 <td class="entry_tags">
8142 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]8143 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8144 </ul>
8145 </td>
8146
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8147 </tr>
8148 <tr class="entries_header">
8149 <th class="th_details" colspan="5">Details</th>
8150 </tr>
8151 <tr class="entry_cont">
8152 <td class="entry_details" colspan="5">
Ruben Brunk218639c2014-01-15 18:09:41 -0800[diff] [blame]8153 <p>OIS is used to compensate for motion blur due to small movements of
8154the camera during capture.<wbr/> Unlike digital image stabilization,<wbr/> OIS makes
8155use of mechanical elements to stabilize the camera sensor,<wbr/> and thus
8156allows for longer exposure times before camera shake becomes
8157apparent.<wbr/></p>
8158<p>This is not expected to be supported on most devices.<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8159 </td>
8160 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8161
8162
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8163 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8164 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8165
8166
8167 <tr class="entry" id="dynamic_android.lens.state">
Zhijun He5169ce12014-01-24 16:48:25 -0800[diff] [blame]8168 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8169 android.<wbr/>lens.<wbr/>state
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8170 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8171 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8172 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8173
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8174 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8175
8176 <ul class="entry_type_enum">
8177 <li>
8178 <span class="entry_type_enum_name">STATIONARY</span>
Zhijun He5169ce12014-01-24 16:48:25 -0800[diff] [blame]8179 <span class="entry_type_enum_notes"><p>The lens parameters (<a href="#controls_android.lens.focalLength">android.<wbr/>lens.<wbr/>focal<wbr/>Length</a>,<wbr/> android.<wbr/>lens.<wbr/>focus<wbr/>Distance
8180android.<wbr/>lens.<wbr/>filter<wbr/>Density and <a href="#controls_android.lens.aperture">android.<wbr/>lens.<wbr/>aperture</a>) are not changing.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8181 </li>
Igor Murashkin0e323a12013-09-06 11:50:48 -0700[diff] [blame]8182 <li>
8183 <span class="entry_type_enum_name">MOVING</span>
Zhijun He5169ce12014-01-24 16:48:25 -0800[diff] [blame]8184 <span class="entry_type_enum_notes"><p>Any of the lens parameters (<a href="#controls_android.lens.focalLength">android.<wbr/>lens.<wbr/>focal<wbr/>Length</a>,<wbr/> android.<wbr/>lens.<wbr/>focus<wbr/>Distance
8185android.<wbr/>lens.<wbr/>filter<wbr/>Density or <a href="#controls_android.lens.aperture">android.<wbr/>lens.<wbr/>aperture</a>) is changing.<wbr/></p></span>
Igor Murashkin0e323a12013-09-06 11:50:48 -0700[diff] [blame]8186 </li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8187 </ul>
8188
8189 </td> <!-- entry_type -->
8190
8191 <td class="entry_description">
Zhijun He5169ce12014-01-24 16:48:25 -0800[diff] [blame]8192 <p>Current lens status.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8193 </td>
8194
8195 <td class="entry_units">
8196 </td>
8197
8198 <td class="entry_range">
8199 </td>
8200
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8201 <td class="entry_tags">
8202 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]8203 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8204 </ul>
8205 </td>
8206
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8207 </tr>
Zhijun He5169ce12014-01-24 16:48:25 -0800[diff] [blame]8208 <tr class="entries_header">
8209 <th class="th_details" colspan="5">Details</th>
8210 </tr>
8211 <tr class="entry_cont">
8212 <td class="entry_details" colspan="5">
8213 <p>For lens parameters <a href="#controls_android.lens.focalLength">android.<wbr/>lens.<wbr/>focal<wbr/>Length</a>,<wbr/> <a href="#controls_android.lens.focusDistance">android.<wbr/>lens.<wbr/>focus<wbr/>Distance</a>,<wbr/>
8214<a href="#controls_android.lens.filterDensity">android.<wbr/>lens.<wbr/>filter<wbr/>Density</a> and <a href="#controls_android.lens.aperture">android.<wbr/>lens.<wbr/>aperture</a>,<wbr/> when changes are requested,<wbr/>
8215they may take several frames to reach the requested values.<wbr/> This state indicates
8216the current status of the lens parameters.<wbr/></p>
8217<p>When the state is STATIONARY,<wbr/> the lens parameters are not changing.<wbr/> This could be
8218either because the parameters are all fixed,<wbr/> or because the lens has had enough
8219time to reach the most recently-requested values.<wbr/>
8220If all these lens parameters are not changable for a camera device,<wbr/> as listed below:</p>
8221<ul>
8222<li>Fixed focus (<code><a href="#static_android.lens.info.minimumFocusDistance">android.<wbr/>lens.<wbr/>info.<wbr/>minimum<wbr/>Focus<wbr/>Distance</a> == 0</code>),<wbr/> which means
8223<a href="#controls_android.lens.focusDistance">android.<wbr/>lens.<wbr/>focus<wbr/>Distance</a> parameter will always be 0.<wbr/></li>
8224<li>Fixed focal length (<a href="#static_android.lens.info.availableFocalLengths">android.<wbr/>lens.<wbr/>info.<wbr/>available<wbr/>Focal<wbr/>Lengths</a> contains single value),<wbr/>
8225which means the optical zoom is not supported.<wbr/></li>
8226<li>No ND filter (<a href="#static_android.lens.info.availableFilterDensities">android.<wbr/>lens.<wbr/>info.<wbr/>available<wbr/>Filter<wbr/>Densities</a> contains only 0).<wbr/></li>
8227<li>Fixed aperture (<a href="#static_android.lens.info.availableApertures">android.<wbr/>lens.<wbr/>info.<wbr/>available<wbr/>Apertures</a> contains single value).<wbr/></li>
8228</ul>
8229<p>Then this state will always be STATIONARY.<wbr/></p>
8230<p>When the state is MOVING,<wbr/> it indicates that at least one of the lens parameters
8231is changing.<wbr/></p>
8232 </td>
8233 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8234
8235
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8236 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8237 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8238
8239
8240
8241 <!-- end of kind -->
8242 </tbody>
8243
8244 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8245 <tr><td colspan="6" id="section_noiseReduction" class="section">noiseReduction</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8246
8247
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8248 <tr><td colspan="6" class="kind">controls</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8249
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8250 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8251 <tr>
8252 <th class="th_name">Property Name</th>
8253 <th class="th_type">Type</th>
8254 <th class="th_description">Description</th>
8255 <th class="th_units">Units</th>
8256 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8257 <th class="th_tags">Tags</th>
8258 </tr>
8259 </thead>
8260
8261 <tbody>
8262
8263
8264
8265
8266
8267
8268
8269
8270
8271
8272 <tr class="entry" id="controls_android.noiseReduction.mode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8273 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8274 android.<wbr/>noise<wbr/>Reduction.<wbr/>mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8275 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8276 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8277 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8278
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8279 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8280
8281 <ul class="entry_type_enum">
8282 <li>
8283 <span class="entry_type_enum_name">OFF</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]8284 <span class="entry_type_enum_notes"><p>No noise reduction is applied</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8285 </li>
8286 <li>
8287 <span class="entry_type_enum_name">FAST</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]8288 <span class="entry_type_enum_notes"><p>Must not slow down frame rate relative to sensor
8289output</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8290 </li>
8291 <li>
8292 <span class="entry_type_enum_name">HIGH_QUALITY</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]8293 <span class="entry_type_enum_notes"><p>May slow down frame rate to provide highest
8294quality</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8295 </li>
8296 </ul>
8297
8298 </td> <!-- entry_type -->
8299
8300 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8301 <p>Mode of operation for the noise reduction
8302algorithm</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8303 </td>
8304
8305 <td class="entry_units">
8306 </td>
8307
8308 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]8309 <p>android.<wbr/>noise<wbr/>Reduction.<wbr/>available<wbr/>Modes</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8310 </td>
8311
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8312 <td class="entry_tags">
8313 <ul class="entry_tags">
8314 <li><a href="#tag_V1">V1</a></li>
8315 </ul>
8316 </td>
8317
8318 </tr>
8319 <tr class="entries_header">
8320 <th class="th_details" colspan="5">Details</th>
8321 </tr>
8322 <tr class="entry_cont">
8323 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8324 <p>Noise filtering control.<wbr/> OFF means no noise reduction
8325will be applied by the HAL.<wbr/></p>
Zhijun Hef90eeaf2014-01-16 12:13:35 -0800[diff] [blame]8326<p>FAST/<wbr/>HIGH_<wbr/>QUALITY both mean camera device determined noise filtering
8327will be applied.<wbr/> HIGH_<wbr/>QUALITY mode indicates that the camera device
8328will use the highest-quality noise filtering algorithms,<wbr/>
8329even if it slows down capture rate.<wbr/> FAST means the camera device should not
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8330slow down capture rate when applying noise filtering.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8331 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8332 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8333
8334
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8335 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8336 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8337
8338
8339 <tr class="entry" id="controls_android.noiseReduction.strength">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8340 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8341 android.<wbr/>noise<wbr/>Reduction.<wbr/>strength
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8342 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8343 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8344 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8345
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8346 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8347
8348
8349 </td> <!-- entry_type -->
8350
8351 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8352 <p>Control the amount of noise reduction
8353applied to the images</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8354 </td>
8355
8356 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8357 1-10; 10 is max noise reduction
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8358 </td>
8359
8360 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]8361 <p>1 - 10</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8362 </td>
8363
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8364 <td class="entry_tags">
8365 </td>
8366
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8367 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8368
8369
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8370 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8371 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8372
8373
8374
8375 <!-- end of kind -->
8376 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8377 <tr><td colspan="6" class="kind">dynamic</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8378
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8379 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8380 <tr>
8381 <th class="th_name">Property Name</th>
8382 <th class="th_type">Type</th>
8383 <th class="th_description">Description</th>
8384 <th class="th_units">Units</th>
8385 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8386 <th class="th_tags">Tags</th>
8387 </tr>
8388 </thead>
8389
8390 <tbody>
8391
8392
8393
8394
8395
8396
8397
8398
8399
8400
8401 <tr class="entry" id="dynamic_android.noiseReduction.mode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8402 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8403 android.<wbr/>noise<wbr/>Reduction.<wbr/>mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8404 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8405 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8406 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8407
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8408 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8409
8410 <ul class="entry_type_enum">
8411 <li>
8412 <span class="entry_type_enum_name">OFF</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]8413 <span class="entry_type_enum_notes"><p>No noise reduction is applied</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8414 </li>
8415 <li>
8416 <span class="entry_type_enum_name">FAST</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]8417 <span class="entry_type_enum_notes"><p>Must not slow down frame rate relative to sensor
8418output</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8419 </li>
8420 <li>
8421 <span class="entry_type_enum_name">HIGH_QUALITY</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]8422 <span class="entry_type_enum_notes"><p>May slow down frame rate to provide highest
8423quality</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8424 </li>
8425 </ul>
8426
8427 </td> <!-- entry_type -->
8428
8429 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8430 <p>Mode of operation for the noise reduction
8431algorithm</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8432 </td>
8433
8434 <td class="entry_units">
8435 </td>
8436
8437 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]8438 <p>android.<wbr/>noise<wbr/>Reduction.<wbr/>available<wbr/>Modes</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8439 </td>
8440
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8441 <td class="entry_tags">
8442 <ul class="entry_tags">
8443 <li><a href="#tag_V1">V1</a></li>
8444 </ul>
8445 </td>
8446
8447 </tr>
8448 <tr class="entries_header">
8449 <th class="th_details" colspan="5">Details</th>
8450 </tr>
8451 <tr class="entry_cont">
8452 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8453 <p>Noise filtering control.<wbr/> OFF means no noise reduction
8454will be applied by the HAL.<wbr/></p>
Zhijun Hef90eeaf2014-01-16 12:13:35 -0800[diff] [blame]8455<p>FAST/<wbr/>HIGH_<wbr/>QUALITY both mean camera device determined noise filtering
8456will be applied.<wbr/> HIGH_<wbr/>QUALITY mode indicates that the camera device
8457will use the highest-quality noise filtering algorithms,<wbr/>
8458even if it slows down capture rate.<wbr/> FAST means the camera device should not
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8459slow down capture rate when applying noise filtering.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8460 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8461 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8462
8463
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8464 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8465 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8466
8467
8468
8469 <!-- end of kind -->
8470 </tbody>
8471
8472 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8473 <tr><td colspan="6" id="section_quirks" class="section">quirks</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8474
8475
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8476 <tr><td colspan="6" class="kind">static</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8477
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8478 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8479 <tr>
8480 <th class="th_name">Property Name</th>
8481 <th class="th_type">Type</th>
8482 <th class="th_description">Description</th>
8483 <th class="th_units">Units</th>
8484 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8485 <th class="th_tags">Tags</th>
8486 </tr>
8487 </thead>
8488
8489 <tbody>
8490
8491
8492
8493
8494
8495
8496
8497
8498
8499
8500 <tr class="entry" id="static_android.quirks.meteringCropRegion">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8501 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8502 android.<wbr/>quirks.<wbr/>metering<wbr/>Crop<wbr/>Region
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8503 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8504 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8505 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8506
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8507 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8508
8509
8510 </td> <!-- entry_type -->
8511
8512 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8513 <p>If set to 1,<wbr/> the camera service does not
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]8514scale 'normalized' coordinates with respect to the crop
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8515region.<wbr/> This applies to metering input (a{e,<wbr/>f,<wbr/>wb}Region
8516and output (face rectangles).<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8517 </td>
8518
8519 <td class="entry_units">
8520 </td>
8521
8522 <td class="entry_range">
Zhijun Hefb4701f2014-02-04 11:32:24 -0800[diff] [blame]8523 <p><strong>Deprecated</strong>.<wbr/> Do not use.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8524 </td>
8525
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8526 <td class="entry_tags">
8527 </td>
8528
8529 </tr>
8530 <tr class="entries_header">
8531 <th class="th_details" colspan="5">Details</th>
8532 </tr>
8533 <tr class="entry_cont">
8534 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8535 <p>Normalized coordinates refer to those in the
8536(-1000,<wbr/>1000) range mentioned in the
8537android.<wbr/>hardware.<wbr/>Camera API.<wbr/></p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]8538<p>HAL implementations should instead always use and emit
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8539sensor array-relative coordinates for all region data.<wbr/> Does
8540not need to be listed in static metadata.<wbr/> Support will be
8541removed in future versions of camera service.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8542 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8543 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8544
8545
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8546 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8547 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8548
8549
8550 <tr class="entry" id="static_android.quirks.triggerAfWithAuto">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8551 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8552 android.<wbr/>quirks.<wbr/>trigger<wbr/>Af<wbr/>With<wbr/>Auto
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8553 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8554 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8555 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8556
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8557 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8558
8559
8560 </td> <!-- entry_type -->
8561
8562 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8563 <p>If set to 1,<wbr/> then the camera service always
8564switches to FOCUS_<wbr/>MODE_<wbr/>AUTO before issuing a AF
8565trigger.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8566 </td>
8567
8568 <td class="entry_units">
8569 </td>
8570
8571 <td class="entry_range">
Zhijun Hefb4701f2014-02-04 11:32:24 -0800[diff] [blame]8572 <p><strong>Deprecated</strong>.<wbr/> Do not use.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8573 </td>
8574
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8575 <td class="entry_tags">
8576 </td>
8577
8578 </tr>
8579 <tr class="entries_header">
8580 <th class="th_details" colspan="5">Details</th>
8581 </tr>
8582 <tr class="entry_cont">
8583 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8584 <p>HAL implementations should implement AF trigger
8585modes for AUTO,<wbr/> MACRO,<wbr/> CONTINUOUS_<wbr/>FOCUS,<wbr/> and
8586CONTINUOUS_<wbr/>PICTURE modes instead of using this flag.<wbr/> Does
8587not need to be listed in static metadata.<wbr/> Support will be
8588removed in future versions of camera service</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8589 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8590 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8591
8592
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8593 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8594 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8595
8596
8597 <tr class="entry" id="static_android.quirks.useZslFormat">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8598 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8599 android.<wbr/>quirks.<wbr/>use<wbr/>Zsl<wbr/>Format
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8600 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8601 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8602 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8603
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8604 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8605
8606
8607 </td> <!-- entry_type -->
8608
8609 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8610 <p>If set to 1,<wbr/> the camera service uses
8611CAMERA2_<wbr/>PIXEL_<wbr/>FORMAT_<wbr/>ZSL instead of
8612HAL_<wbr/>PIXEL_<wbr/>FORMAT_<wbr/>IMPLEMENTATION_<wbr/>DEFINED for the zero
8613shutter lag stream</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8614 </td>
8615
8616 <td class="entry_units">
8617 </td>
8618
8619 <td class="entry_range">
Zhijun Hefb4701f2014-02-04 11:32:24 -0800[diff] [blame]8620 <p><strong>Deprecated</strong>.<wbr/> Do not use.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8621 </td>
8622
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8623 <td class="entry_tags">
8624 </td>
8625
8626 </tr>
8627 <tr class="entries_header">
8628 <th class="th_details" colspan="5">Details</th>
8629 </tr>
8630 <tr class="entry_cont">
8631 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8632 <p>HAL implementations should use gralloc usage flags
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]8633to determine that a stream will be used for
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8634zero-shutter-lag,<wbr/> instead of relying on an explicit
8635format setting.<wbr/> Does not need to be listed in static
8636metadata.<wbr/> Support will be removed in future versions of
8637camera service.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8638 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8639 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8640
8641
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8642 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8643 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8644
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]8645
8646 <tr class="entry" id="static_android.quirks.usePartialResult">
Igor Murashkin7761a222014-01-27 16:06:38 -0800[diff] [blame]8647 <td class="entry_name" rowspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8648 android.<wbr/>quirks.<wbr/>use<wbr/>Partial<wbr/>Result
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8649 </td>
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]8650 <td class="entry_type">
8651 <span class="entry_type_name">byte</span>
8652
Eino-Ville Talvala52a64a52013-11-07 14:43:43 -0800[diff] [blame]8653 <span class="entry_type_visibility"> [hidden]</span>
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]8654
8655
8656 </td> <!-- entry_type -->
8657
8658 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8659 <p>If set to 1,<wbr/> the HAL will always split result
8660metadata for a single capture into multiple buffers,<wbr/>
8661returned using multiple process_<wbr/>capture_<wbr/>result calls.<wbr/></p>
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]8662 </td>
8663
8664 <td class="entry_units">
8665 </td>
8666
8667 <td class="entry_range">
Igor Murashkin7761a222014-01-27 16:06:38 -0800[diff] [blame]8668 <p><strong>Deprecated</strong>.<wbr/> Do not use.<wbr/></p>
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]8669 </td>
8670
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8671 <td class="entry_tags">
8672 </td>
8673
8674 </tr>
8675 <tr class="entries_header">
8676 <th class="th_details" colspan="5">Details</th>
8677 </tr>
8678 <tr class="entry_cont">
8679 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8680 <p>Does not need to be listed in static
8681metadata.<wbr/> Support for partial results will be reworked in
8682future versions of camera service.<wbr/> This quirk will stop
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]8683working at that point; DO NOT USE without careful
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8684consideration of future support.<wbr/></p>
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]8685 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8686 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8687
Igor Murashkin7761a222014-01-27 16:06:38 -0800[diff] [blame]8688 <tr class="entries_header">
8689 <th class="th_details" colspan="5">HAL Implementation Details</th>
8690 </tr>
8691 <tr class="entry_cont">
8692 <td class="entry_details" colspan="5">
8693 <p>Refer to <code>camera3_<wbr/>capture_<wbr/>result::partial_<wbr/>result</code>
8694for information on how to implement partial results.<wbr/></p>
8695 </td>
8696 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8697
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8698 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8699 <!-- end of entry -->
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]8700
8701
8702
8703 <!-- end of kind -->
8704 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8705 <tr><td colspan="6" class="kind">dynamic</td></tr>
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]8706
8707 <thead class="entries_header">
8708 <tr>
8709 <th class="th_name">Property Name</th>
8710 <th class="th_type">Type</th>
8711 <th class="th_description">Description</th>
8712 <th class="th_units">Units</th>
8713 <th class="th_range">Range</th>
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]8714 <th class="th_tags">Tags</th>
8715 </tr>
8716 </thead>
8717
8718 <tbody>
8719
8720
8721
8722
8723
8724
8725
8726
8727
8728
8729 <tr class="entry" id="dynamic_android.quirks.partialResult">
Igor Murashkin7761a222014-01-27 16:06:38 -0800[diff] [blame]8730 <td class="entry_name" rowspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8731 android.<wbr/>quirks.<wbr/>partial<wbr/>Result
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8732 </td>
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]8733 <td class="entry_type">
8734 <span class="entry_type_name entry_type_name_enum">byte</span>
8735
Eino-Ville Talvala52a64a52013-11-07 14:43:43 -0800[diff] [blame]8736 <span class="entry_type_visibility"> [hidden as boolean]</span>
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]8737
8738 <ul class="entry_type_enum">
8739 <li>
8740 <span class="entry_type_enum_name">FINAL</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]8741 <span class="entry_type_enum_notes"><p>The last or only metadata result buffer
8742for this capture.<wbr/></p></span>
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]8743 </li>
8744 <li>
8745 <span class="entry_type_enum_name">PARTIAL</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]8746 <span class="entry_type_enum_notes"><p>A partial buffer of result metadata for this
8747capture.<wbr/> More result buffers for this capture will be sent
8748by the HAL,<wbr/> the last of which will be marked
8749FINAL.<wbr/></p></span>
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]8750 </li>
8751 </ul>
8752
8753 </td> <!-- entry_type -->
8754
8755 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8756 <p>Whether a result given to the framework is the
8757final one for the capture,<wbr/> or only a partial that contains a
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]8758subset of the full set of dynamic metadata
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8759values.<wbr/></p>
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]8760 </td>
8761
8762 <td class="entry_units">
8763 </td>
8764
8765 <td class="entry_range">
Igor Murashkin7761a222014-01-27 16:06:38 -0800[diff] [blame]8766 <p><strong>Deprecated</strong>.<wbr/> Do not use.<wbr/> Optional.<wbr/> Default value is FINAL.<wbr/></p>
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]8767 </td>
8768
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8769 <td class="entry_tags">
8770 </td>
8771
8772 </tr>
8773 <tr class="entries_header">
8774 <th class="th_details" colspan="5">Details</th>
8775 </tr>
8776 <tr class="entry_cont">
8777 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8778 <p>The entries in the result metadata buffers for a
8779single capture may not overlap,<wbr/> except for this entry.<wbr/> The
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]8780FINAL buffers must retain FIFO ordering relative to the
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8781requests that generate them,<wbr/> so the FINAL buffer for frame 3 must
8782always be sent to the framework after the FINAL buffer for frame 2,<wbr/> and
8783before the FINAL buffer for frame 4.<wbr/> PARTIAL buffers may be returned
8784in any order relative to other frames,<wbr/> but all PARTIAL buffers for a given
8785capture must arrive before the FINAL buffer for that capture.<wbr/> This entry may
8786only be used by the HAL if quirks.<wbr/>usePartialResult is set to 1.<wbr/></p>
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]8787 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8788 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8789
Igor Murashkin7761a222014-01-27 16:06:38 -0800[diff] [blame]8790 <tr class="entries_header">
8791 <th class="th_details" colspan="5">HAL Implementation Details</th>
8792 </tr>
8793 <tr class="entry_cont">
8794 <td class="entry_details" colspan="5">
8795 <p>Refer to <code>camera3_<wbr/>capture_<wbr/>result::partial_<wbr/>result</code>
8796for information on how to implement partial results.<wbr/></p>
8797 </td>
8798 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8799
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8800 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8801 <!-- end of entry -->
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]8802
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8803
8804
8805 <!-- end of kind -->
8806 </tbody>
8807
8808 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8809 <tr><td colspan="6" id="section_request" class="section">request</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8810
8811
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8812 <tr><td colspan="6" class="kind">controls</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8813
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8814 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8815 <tr>
8816 <th class="th_name">Property Name</th>
8817 <th class="th_type">Type</th>
8818 <th class="th_description">Description</th>
8819 <th class="th_units">Units</th>
8820 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8821 <th class="th_tags">Tags</th>
8822 </tr>
8823 </thead>
8824
8825 <tbody>
8826
8827
8828
8829
8830
8831
8832
8833
8834
8835
8836 <tr class="entry" id="controls_android.request.frameCount">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8837 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8838 android.<wbr/>request.<wbr/>frame<wbr/>Count
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8839 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8840 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8841 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8842
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8843 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8844
8845
8846 </td> <!-- entry_type -->
8847
8848 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8849 <p>A frame counter set by the framework.<wbr/> Must
8850be maintained unchanged in output frame.<wbr/> This value monotonically
8851increases with every new result (that is,<wbr/> each new result has a unique
8852frameCount value).<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8853 </td>
8854
8855 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8856 incrementing integer
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8857 </td>
8858
8859 <td class="entry_range">
Zhijun Hefb4701f2014-02-04 11:32:24 -0800[diff] [blame]8860 <p><strong>Deprecated</strong>.<wbr/> Do not use.<wbr/> Any int.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8861 </td>
8862
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8863 <td class="entry_tags">
8864 </td>
8865
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8866 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8867
8868
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8869 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8870 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8871
8872
8873 <tr class="entry" id="controls_android.request.id">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8874 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8875 android.<wbr/>request.<wbr/>id
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8876 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8877 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8878 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8879
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8880 <span class="entry_type_visibility"> [hidden]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8881
8882
8883 </td> <!-- entry_type -->
8884
8885 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8886 <p>An application-specified ID for the current
8887request.<wbr/> Must be maintained unchanged in output
8888frame</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8889 </td>
8890
8891 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8892 arbitrary integer assigned by application
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8893 </td>
8894
8895 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]8896 <p>Any int</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8897 </td>
8898
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8899 <td class="entry_tags">
8900 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]8901 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8902 </ul>
8903 </td>
8904
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8905 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8906
8907
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8908 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8909 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8910
8911
8912 <tr class="entry" id="controls_android.request.inputStreams">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8913 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8914 android.<wbr/>request.<wbr/>input<wbr/>Streams
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8915 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8916 <td class="entry_type">
Zhijun Hee36cdbe2013-09-06 14:28:37 -0700[diff] [blame]8917 <span class="entry_type_name">int32</span>
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]8918 <span class="entry_type_container">x</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8919
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]8920 <span class="entry_type_array">
8921 n
8922 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8923 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8924
8925
8926 </td> <!-- entry_type -->
8927
8928 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8929 <p>List which camera reprocess stream is used
8930for the source of reprocessing data.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8931 </td>
8932
8933 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8934 List of camera reprocess stream IDs
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8935 </td>
8936
8937 <td class="entry_range">
Zhijun Hefb4701f2014-02-04 11:32:24 -0800[diff] [blame]8938 <p><strong>Deprecated</strong>.<wbr/> Do not use.<wbr/></p>
8939<p>Typically,<wbr/> only one entry allowed,<wbr/> must be a valid reprocess stream ID.<wbr/></p>
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]8940<p>If android.<wbr/>jpeg.<wbr/>needs<wbr/>Thumbnail is set,<wbr/> then multiple
8941reprocess streams may be included in a single request; they
8942must be different scaled versions of the same image.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8943 </td>
8944
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8945 <td class="entry_tags">
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]8946 <ul class="entry_tags">
8947 <li><a href="#tag_HAL2">HAL2</a></li>
8948 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8949 </td>
8950
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8951 </tr>
8952 <tr class="entries_header">
8953 <th class="th_details" colspan="5">Details</th>
8954 </tr>
8955 <tr class="entry_cont">
8956 <td class="entry_details" colspan="5">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]8957 <p>Only meaningful when <a href="#controls_android.request.type">android.<wbr/>request.<wbr/>type</a> ==
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8958REPROCESS.<wbr/> Ignored otherwise</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8959 </td>
8960 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8961
8962
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8963 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8964 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8965
8966
8967 <tr class="entry" id="controls_android.request.metadataMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8968 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8969 android.<wbr/>request.<wbr/>metadata<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8970 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8971 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8972 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8973
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8974 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8975
8976 <ul class="entry_type_enum">
8977 <li>
8978 <span class="entry_type_enum_name">NONE</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]8979 <span class="entry_type_enum_notes"><p>No metadata should be produced on output,<wbr/> except
8980for application-bound buffer data.<wbr/> If no
8981application-bound streams exist,<wbr/> no frame should be
8982placed in the output frame queue.<wbr/> If such streams
8983exist,<wbr/> a frame should be placed on the output queue
8984with null metadata but with the necessary output buffer
8985information.<wbr/> Timestamp information should still be
8986included with any output stream buffers</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8987 </li>
8988 <li>
8989 <span class="entry_type_enum_name">FULL</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]8990 <span class="entry_type_enum_notes"><p>All metadata should be produced.<wbr/> Statistics will
8991only be produced if they are separately
8992enabled</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8993 </li>
8994 </ul>
8995
8996 </td> <!-- entry_type -->
8997
8998 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8999 <p>How much metadata to produce on
9000output</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9001 </td>
9002
9003 <td class="entry_units">
9004 </td>
9005
9006 <td class="entry_range">
9007 </td>
9008
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9009 <td class="entry_tags">
9010 </td>
9011
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9012 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9013
9014
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9015 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9016 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9017
9018
9019 <tr class="entry" id="controls_android.request.outputStreams">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9020 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9021 android.<wbr/>request.<wbr/>output<wbr/>Streams
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9022 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9023 <td class="entry_type">
Zhijun Hee36cdbe2013-09-06 14:28:37 -0700[diff] [blame]9024 <span class="entry_type_name">int32</span>
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]9025 <span class="entry_type_container">x</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9026
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]9027 <span class="entry_type_array">
9028 n
9029 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9030 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9031
9032
9033 </td> <!-- entry_type -->
9034
9035 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9036 <p>Lists which camera output streams image data
9037from this capture must be sent to</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9038 </td>
9039
9040 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9041 List of camera stream IDs
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9042 </td>
9043
9044 <td class="entry_range">
Zhijun Hefb4701f2014-02-04 11:32:24 -0800[diff] [blame]9045 <p><strong>Deprecated</strong>.<wbr/> Do not use.<wbr/> List must only include streams that have been
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]9046created</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9047 </td>
9048
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9049 <td class="entry_tags">
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]9050 <ul class="entry_tags">
9051 <li><a href="#tag_HAL2">HAL2</a></li>
9052 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9053 </td>
9054
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9055 </tr>
9056 <tr class="entries_header">
9057 <th class="th_details" colspan="5">Details</th>
9058 </tr>
9059 <tr class="entry_cont">
9060 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9061 <p>If no output streams are listed,<wbr/> then the image
9062data should simply be discarded.<wbr/> The image data must
9063still be captured for metadata and statistics production,<wbr/>
9064and the lens and flash must operate as requested.<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9065 </td>
9066 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9067
9068
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9069 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9070 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9071
9072
9073 <tr class="entry" id="controls_android.request.type">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9074 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9075 android.<wbr/>request.<wbr/>type
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9076 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9077 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9078 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9079
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9080 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9081
9082 <ul class="entry_type_enum">
9083 <li>
9084 <span class="entry_type_enum_name">CAPTURE</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]9085 <span class="entry_type_enum_notes"><p>Capture a new image from the imaging hardware,<wbr/>
9086and process it according to the
9087settings</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9088 </li>
9089 <li>
9090 <span class="entry_type_enum_name">REPROCESS</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]9091 <span class="entry_type_enum_notes"><p>Process previously captured data; the
9092android.<wbr/>request.<wbr/>input<wbr/>Stream parameter determines the
9093source reprocessing stream.<wbr/> TODO: Mark dynamic metadata
9094needed for reprocessing with [RP]</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9095 </li>
9096 </ul>
9097
9098 </td> <!-- entry_type -->
9099
9100 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9101 <p>The type of the request; either CAPTURE or
9102REPROCESS.<wbr/> For HAL3,<wbr/> this tag is redundant.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9103 </td>
9104
9105 <td class="entry_units">
9106 </td>
9107
9108 <td class="entry_range">
9109 </td>
9110
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9111 <td class="entry_tags">
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]9112 <ul class="entry_tags">
9113 <li><a href="#tag_HAL2">HAL2</a></li>
9114 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9115 </td>
9116
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9117 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9118
9119
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9120 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9121 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9122
9123
9124
9125 <!-- end of kind -->
9126 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9127 <tr><td colspan="6" class="kind">static</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9128
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9129 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9130 <tr>
9131 <th class="th_name">Property Name</th>
9132 <th class="th_type">Type</th>
9133 <th class="th_description">Description</th>
9134 <th class="th_units">Units</th>
9135 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9136 <th class="th_tags">Tags</th>
9137 </tr>
9138 </thead>
9139
9140 <tbody>
9141
9142
9143
9144
9145
9146
9147
9148
9149
9150
9151 <tr class="entry" id="static_android.request.maxNumOutputStreams">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9152 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9153 android.<wbr/>request.<wbr/>max<wbr/>Num<wbr/>Output<wbr/>Streams
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9154 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9155 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9156 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9157 <span class="entry_type_container">x</span>
9158
9159 <span class="entry_type_array">
9160 3
9161 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9162 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9163
9164
9165 </td> <!-- entry_type -->
9166
9167 <td class="entry_description">
Zhijun He12744b22014-01-22 15:58:57 -0800[diff] [blame^]9168 <p>The maximum numbers of different types of output streams
9169that can be configured and used simultaneously by a camera device.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9170 </td>
9171
9172 <td class="entry_units">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9173 </td>
9174
9175 <td class="entry_range">
Zhijun He12744b22014-01-22 15:58:57 -0800[diff] [blame^]9176 <p>&gt;= 1 for JPEG-compressed format streams.<wbr/></p>
9177<p>&gt;= 0 for Raw format streams.<wbr/></p>
9178<p>&gt;= 3 for processed,<wbr/> uncompressed format streams.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9179 </td>
9180
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9181 <td class="entry_tags">
9182 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9183 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9184 </ul>
9185 </td>
9186
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9187 </tr>
9188 <tr class="entries_header">
9189 <th class="th_details" colspan="5">Details</th>
9190 </tr>
9191 <tr class="entry_cont">
9192 <td class="entry_details" colspan="5">
Zhijun He12744b22014-01-22 15:58:57 -0800[diff] [blame^]9193 <p>This is a 3 element tuple that contains the max number of output simultaneous
9194streams for raw sensor,<wbr/> processed (and uncompressed),<wbr/> and JPEG formats respectively.<wbr/>
9195For example,<wbr/> if max raw sensor format output stream number is 1,<wbr/> max YUV streams
9196number is 3,<wbr/> and max JPEG stream number is 2,<wbr/> then this tuple should be <code>(1,<wbr/> 3,<wbr/> 2)</code>.<wbr/></p>
9197<p>This lists the upper bound of the number of output streams supported by
9198the camera device.<wbr/> Using more streams simultaneously may require more hardware and
9199CPU resources that will consume more power.<wbr/> The image format for a output stream can
9200be any supported format provided by <a href="#static_android.scaler.availableFormats">android.<wbr/>scaler.<wbr/>available<wbr/>Formats</a>.<wbr/> The formats
9201defined in <a href="#static_android.scaler.availableFormats">android.<wbr/>scaler.<wbr/>available<wbr/>Formats</a> can be catergorized into the 3 stream types
9202as below:</p>
9203<ul>
9204<li>JPEG-compressed format: BLOB.<wbr/></li>
9205<li>Raw formats: RAW_<wbr/>SENSOR and RAW_<wbr/>OPAQUE.<wbr/></li>
9206<li>processed,<wbr/> uncompressed formats: YCb<wbr/>Cr_<wbr/>420_<wbr/>888,<wbr/> YCr<wbr/>Cb_<wbr/>420_<wbr/>SP,<wbr/> YV12.<wbr/></li>
9207</ul>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9208 </td>
9209 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9210
9211
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9212 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9213 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9214
9215
9216 <tr class="entry" id="static_android.request.maxNumReprocessStreams">
Zhijun He12744b22014-01-22 15:58:57 -0800[diff] [blame^]9217 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9218 android.<wbr/>request.<wbr/>max<wbr/>Num<wbr/>Reprocess<wbr/>Streams
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9219 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9220 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9221 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9222 <span class="entry_type_container">x</span>
9223
9224 <span class="entry_type_array">
9225 1
9226 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9227 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9228
9229
9230 </td> <!-- entry_type -->
9231
9232 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9233 <p>How many reprocessing streams of any type
Zhijun He12744b22014-01-22 15:58:57 -0800[diff] [blame^]9234can be allocated at the same time.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9235 </td>
9236
9237 <td class="entry_units">
9238 </td>
9239
9240 <td class="entry_range">
Zhijun He12744b22014-01-22 15:58:57 -0800[diff] [blame^]9241 <p>&gt;= 0</p>
9242 </td>
9243
9244 <td class="entry_tags">
9245 <ul class="entry_tags">
9246 <li><a href="#tag_HAL2">HAL2</a></li>
9247 </ul>
9248 </td>
9249
9250 </tr>
9251 <tr class="entries_header">
9252 <th class="th_details" colspan="5">Details</th>
9253 </tr>
9254 <tr class="entry_cont">
9255 <td class="entry_details" colspan="5">
9256 <p><strong>Deprecated</strong>.<wbr/> Only used by HAL2.<wbr/>x.<wbr/></p>
9257<p>When set to 0,<wbr/> it means no reprocess stream is supported.<wbr/></p>
9258 </td>
9259 </tr>
9260
9261
9262 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9263 <!-- end of entry -->
9264
9265
9266 <tr class="entry" id="static_android.request.maxNumInputStreams">
9267 <td class="entry_name" rowspan="3">
9268 android.<wbr/>request.<wbr/>max<wbr/>Num<wbr/>Input<wbr/>Streams
9269 </td>
9270 <td class="entry_type">
9271 <span class="entry_type_name">int32</span>
9272
9273 <span class="entry_type_visibility"> [public]</span>
9274
9275
9276 </td> <!-- entry_type -->
9277
9278 <td class="entry_description">
9279 <p>The maximum numbers of any type of input streams
9280that can be configured and used simultaneously by a camera device.<wbr/></p>
9281 </td>
9282
9283 <td class="entry_units">
9284 </td>
9285
9286 <td class="entry_range">
9287 <p>&gt;= 0 for LIMITED mode device (<code><a href="#static_android.info.supportedHardwareLevel">android.<wbr/>info.<wbr/>supported<wbr/>Hardware<wbr/>Level</a> == LIMITED</code>).<wbr/>
9288&gt;= 1 for FULL mode device (<code><a href="#static_android.info.supportedHardwareLevel">android.<wbr/>info.<wbr/>supported<wbr/>Hardware<wbr/>Level</a> == FULL</code>).<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9289 </td>
9290
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9291 <td class="entry_tags">
9292 </td>
9293
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9294 </tr>
Zhijun He12744b22014-01-22 15:58:57 -0800[diff] [blame^]9295 <tr class="entries_header">
9296 <th class="th_details" colspan="5">Details</th>
9297 </tr>
9298 <tr class="entry_cont">
9299 <td class="entry_details" colspan="5">
9300 <p>When set to 0,<wbr/> it means no input stream is supported.<wbr/></p>
9301<p>The image format for a input stream can be any supported format provided
9302by android.<wbr/>scaler.<wbr/>available<wbr/>Input<wbr/>Formats.<wbr/> When using an input stream,<wbr/> there must be
9303at least one output stream configured to to receive the reprocessed images.<wbr/></p>
9304<p>For example,<wbr/> for Zero Shutter Lag (ZSL) still capture use case,<wbr/> the input
9305stream image format will be RAW_<wbr/>OPAQUE,<wbr/> the associated output stream image format
9306should be JPEG.<wbr/></p>
9307 </td>
9308 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9309
9310
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9311 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9312 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9313
Igor Murashkina46e02f2014-01-09 17:43:38 -0800[diff] [blame]9314
9315 <tr class="entry" id="static_android.request.pipelineMaxDepth">
9316 <td class="entry_name" rowspan="5">
9317 android.<wbr/>request.<wbr/>pipeline<wbr/>Max<wbr/>Depth
9318 </td>
9319 <td class="entry_type">
9320 <span class="entry_type_name">byte</span>
9321
9322 <span class="entry_type_visibility"> [public]</span>
9323
9324
9325 </td> <!-- entry_type -->
9326
9327 <td class="entry_description">
9328 <p>Specifies the number of maximum pipeline stages a frame
9329has to go through from when it's exposed to when it's available
9330to the framework.<wbr/></p>
9331 </td>
9332
9333 <td class="entry_units">
9334 </td>
9335
9336 <td class="entry_range">
9337 </td>
9338
9339 <td class="entry_tags">
9340 </td>
9341
9342 </tr>
9343 <tr class="entries_header">
9344 <th class="th_details" colspan="5">Details</th>
9345 </tr>
9346 <tr class="entry_cont">
9347 <td class="entry_details" colspan="5">
9348 <p>A typical minimum value for this is 2 (one stage to expose,<wbr/>
9349one stage to readout) from the sensor.<wbr/> The ISP then usually adds
9350its own stages to do custom HW processing.<wbr/> Further stages may be
9351added by SW processing.<wbr/></p>
9352<p>Depending on what settings are used (e.<wbr/>g.<wbr/> YUV,<wbr/> JPEG) and what
9353processing is enabled (e.<wbr/>g.<wbr/> face detection),<wbr/> the actual pipeline
9354depth (specified by <a href="#dynamic_android.request.pipelineDepth">android.<wbr/>request.<wbr/>pipeline<wbr/>Depth</a>) may be less than
9355the max pipeline depth.<wbr/></p>
9356<p>A pipeline depth of X stages is equivalent to a pipeline latency of
9357X frame intervals.<wbr/></p>
9358<p>This value will be 8 or less.<wbr/></p>
9359 </td>
9360 </tr>
9361
9362 <tr class="entries_header">
9363 <th class="th_details" colspan="5">HAL Implementation Details</th>
9364 </tr>
9365 <tr class="entry_cont">
9366 <td class="entry_details" colspan="5">
9367 <p>This value should be 4 or less.<wbr/></p>
9368 </td>
9369 </tr>
9370
9371 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9372 <!-- end of entry -->
9373
Igor Murashkin2e291102014-01-10 14:18:30 -0800[diff] [blame]9374
9375 <tr class="entry" id="static_android.request.partialResultCount">
9376 <td class="entry_name" rowspan="3">
9377 android.<wbr/>request.<wbr/>partial<wbr/>Result<wbr/>Count
9378 </td>
9379 <td class="entry_type">
9380 <span class="entry_type_name">int32</span>
9381
9382 <span class="entry_type_visibility"> [public]</span>
9383
9384
9385 </td> <!-- entry_type -->
9386
9387 <td class="entry_description">
9388 <p>Optional.<wbr/> Defaults to 1.<wbr/> Defines how many sub-components
9389a result will be composed of.<wbr/></p>
9390 </td>
9391
9392 <td class="entry_units">
9393 </td>
9394
9395 <td class="entry_range">
9396 <p>&gt;= 1</p>
9397 </td>
9398
9399 <td class="entry_tags">
9400 </td>
9401
9402 </tr>
9403 <tr class="entries_header">
9404 <th class="th_details" colspan="5">Details</th>
9405 </tr>
9406 <tr class="entry_cont">
9407 <td class="entry_details" colspan="5">
9408 <p>In order to combat the pipeline latency,<wbr/> partial results
9409may be delivered to the application layer from the camera device as
9410soon as they are available.<wbr/></p>
9411<p>A value of 1 means that partial results are not supported.<wbr/></p>
9412<p>A typical use case for this might be: after requesting an AF lock the
9413new AF state might be available 50% of the way through the pipeline.<wbr/>
9414The camera device could then immediately dispatch this state via a
9415partial result to the framework/<wbr/>application layer,<wbr/> and the rest of
9416the metadata via later partial results.<wbr/></p>
9417 </td>
9418 </tr>
9419
9420
9421 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9422 <!-- end of entry -->
9423
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9424
9425
9426 <!-- end of kind -->
9427 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9428 <tr><td colspan="6" class="kind">dynamic</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9429
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9430 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9431 <tr>
9432 <th class="th_name">Property Name</th>
9433 <th class="th_type">Type</th>
9434 <th class="th_description">Description</th>
9435 <th class="th_units">Units</th>
9436 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9437 <th class="th_tags">Tags</th>
9438 </tr>
9439 </thead>
9440
9441 <tbody>
9442
9443
9444
9445
9446
9447
9448
9449
9450
9451
9452 <tr class="entry" id="dynamic_android.request.frameCount">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9453 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9454 android.<wbr/>request.<wbr/>frame<wbr/>Count
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9455 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9456 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9457 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9458
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9459 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9460
9461
9462 </td> <!-- entry_type -->
9463
9464 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9465 <p>A frame counter set by the framework.<wbr/> This value monotonically
9466increases with every new result (that is,<wbr/> each new result has a unique
9467frameCount value).<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9468 </td>
9469
9470 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9471 count of frames
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9472 </td>
9473
9474 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame]9475 <p>&gt; 0</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9476 </td>
9477
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9478 <td class="entry_tags">
9479 </td>
9480
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9481 </tr>
9482 <tr class="entries_header">
9483 <th class="th_details" colspan="5">Details</th>
9484 </tr>
9485 <tr class="entry_cont">
9486 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9487 <p>Reset on release()</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9488 </td>
9489 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9490
9491
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9492 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9493 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9494
9495
9496 <tr class="entry" id="dynamic_android.request.id">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9497 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9498 android.<wbr/>request.<wbr/>id
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9499 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9500 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9501 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9502
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9503 <span class="entry_type_visibility"> [hidden]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9504
9505
9506 </td> <!-- entry_type -->
9507
9508 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9509 <p>An application-specified ID for the current
9510request.<wbr/> Must be maintained unchanged in output
9511frame</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9512 </td>
9513
9514 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9515 arbitrary integer assigned by application
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9516 </td>
9517
9518 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]9519 <p>Any int</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9520 </td>
9521
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9522 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9523 <ul class="entry_tags">
9524 <li><a href="#tag_V1">V1</a></li>
9525 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9526 </td>
9527
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9528 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9529
9530
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9531 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9532 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9533
9534
9535 <tr class="entry" id="dynamic_android.request.metadataMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9536 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9537 android.<wbr/>request.<wbr/>metadata<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9538 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9539 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9540 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9541
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9542 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9543
9544 <ul class="entry_type_enum">
9545 <li>
9546 <span class="entry_type_enum_name">NONE</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]9547 <span class="entry_type_enum_notes"><p>No metadata should be produced on output,<wbr/> except
9548for application-bound buffer data.<wbr/> If no
9549application-bound streams exist,<wbr/> no frame should be
9550placed in the output frame queue.<wbr/> If such streams
9551exist,<wbr/> a frame should be placed on the output queue
9552with null metadata but with the necessary output buffer
9553information.<wbr/> Timestamp information should still be
9554included with any output stream buffers</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9555 </li>
9556 <li>
9557 <span class="entry_type_enum_name">FULL</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]9558 <span class="entry_type_enum_notes"><p>All metadata should be produced.<wbr/> Statistics will
9559only be produced if they are separately
9560enabled</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9561 </li>
9562 </ul>
9563
9564 </td> <!-- entry_type -->
9565
9566 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9567 <p>How much metadata to produce on
9568output</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9569 </td>
9570
9571 <td class="entry_units">
9572 </td>
9573
9574 <td class="entry_range">
9575 </td>
9576
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9577 <td class="entry_tags">
9578 </td>
9579
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9580 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9581
9582
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9583 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9584 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9585
9586
9587 <tr class="entry" id="dynamic_android.request.outputStreams">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9588 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9589 android.<wbr/>request.<wbr/>output<wbr/>Streams
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9590 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9591 <td class="entry_type">
Zhijun Hee36cdbe2013-09-06 14:28:37 -0700[diff] [blame]9592 <span class="entry_type_name">int32</span>
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]9593 <span class="entry_type_container">x</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9594
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]9595 <span class="entry_type_array">
9596 n
9597 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9598 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9599
9600
9601 </td> <!-- entry_type -->
9602
9603 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9604 <p>Lists which camera output streams image data
9605from this capture must be sent to</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9606 </td>
9607
9608 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9609 List of camera stream IDs
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9610 </td>
9611
9612 <td class="entry_range">
Zhijun Hefb4701f2014-02-04 11:32:24 -0800[diff] [blame]9613 <p><strong>Deprecated</strong>.<wbr/> Do not use.<wbr/> List must only include streams that have been
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]9614created</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9615 </td>
9616
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9617 <td class="entry_tags">
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]9618 <ul class="entry_tags">
9619 <li><a href="#tag_HAL2">HAL2</a></li>
9620 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9621 </td>
9622
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9623 </tr>
9624 <tr class="entries_header">
9625 <th class="th_details" colspan="5">Details</th>
9626 </tr>
9627 <tr class="entry_cont">
9628 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9629 <p>If no output streams are listed,<wbr/> then the image
9630data should simply be discarded.<wbr/> The image data must
9631still be captured for metadata and statistics production,<wbr/>
9632and the lens and flash must operate as requested.<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9633 </td>
9634 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9635
9636
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9637 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9638 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9639
Igor Murashkina46e02f2014-01-09 17:43:38 -0800[diff] [blame]9640
9641 <tr class="entry" id="dynamic_android.request.pipelineDepth">
9642 <td class="entry_name" rowspan="5">
9643 android.<wbr/>request.<wbr/>pipeline<wbr/>Depth
9644 </td>
9645 <td class="entry_type">
9646 <span class="entry_type_name">byte</span>
9647
9648 <span class="entry_type_visibility"> [public]</span>
9649
9650
9651 </td> <!-- entry_type -->
9652
9653 <td class="entry_description">
9654 <p>Specifies the number of pipeline stages the frame went
9655through from when it was exposed to when the final completed result
9656was available to the framework.<wbr/></p>
9657 </td>
9658
9659 <td class="entry_units">
9660 </td>
9661
9662 <td class="entry_range">
9663 <p>&lt;= <a href="#static_android.request.pipelineMaxDepth">android.<wbr/>request.<wbr/>pipeline<wbr/>Max<wbr/>Depth</a></p>
9664 </td>
9665
9666 <td class="entry_tags">
9667 </td>
9668
9669 </tr>
9670 <tr class="entries_header">
9671 <th class="th_details" colspan="5">Details</th>
9672 </tr>
9673 <tr class="entry_cont">
9674 <td class="entry_details" colspan="5">
9675 <p>Depending on what settings are used in the request,<wbr/> and
9676what streams are configured,<wbr/> the data may undergo less processing,<wbr/>
9677and some pipeline stages skipped.<wbr/></p>
9678<p>See <a href="#static_android.request.pipelineMaxDepth">android.<wbr/>request.<wbr/>pipeline<wbr/>Max<wbr/>Depth</a> for more details.<wbr/></p>
9679 </td>
9680 </tr>
9681
9682 <tr class="entries_header">
9683 <th class="th_details" colspan="5">HAL Implementation Details</th>
9684 </tr>
9685 <tr class="entry_cont">
9686 <td class="entry_details" colspan="5">
9687 <p>This value must always represent the accurate count of how many
9688pipeline stages were actually used.<wbr/></p>
9689 </td>
9690 </tr>
9691
9692 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9693 <!-- end of entry -->
9694
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9695
9696
9697 <!-- end of kind -->
9698 </tbody>
9699
9700 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9701 <tr><td colspan="6" id="section_scaler" class="section">scaler</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9702
9703
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9704 <tr><td colspan="6" class="kind">controls</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9705
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9706 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9707 <tr>
9708 <th class="th_name">Property Name</th>
9709 <th class="th_type">Type</th>
9710 <th class="th_description">Description</th>
9711 <th class="th_units">Units</th>
9712 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9713 <th class="th_tags">Tags</th>
9714 </tr>
9715 </thead>
9716
9717 <tbody>
9718
9719
9720
9721
9722
9723
9724
9725
9726
9727
9728 <tr class="entry" id="controls_android.scaler.cropRegion">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9729 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9730 android.<wbr/>scaler.<wbr/>crop<wbr/>Region
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9731 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9732 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9733 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9734 <span class="entry_type_container">x</span>
9735
9736 <span class="entry_type_array">
Eino-Ville Talvalae04ec6e2013-04-16 15:35:18 -0700[diff] [blame]9737 4
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9738 </span>
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]9739 <span class="entry_type_visibility"> [public as rectangle]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9740
9741
9742 </td> <!-- entry_type -->
9743
9744 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9745 <p>(x,<wbr/> y,<wbr/> width,<wbr/> height).<wbr/></p>
9746<p>A rectangle with the top-level corner of (x,<wbr/>y) and size
9747(width,<wbr/> height).<wbr/> The region of the sensor that is used for
9748output.<wbr/> Each stream must use this rectangle to produce its
9749output,<wbr/> cropping to a smaller region if necessary to
9750maintain the stream's aspect ratio.<wbr/></p>
9751<p>HAL2.<wbr/>x uses only (x,<wbr/> y,<wbr/> width)</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9752 </td>
9753
9754 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9755 (x,<wbr/>y) of top-left corner,<wbr/> width and height of region
9756 in pixels; (0,<wbr/>0) is top-left corner of
9757 android.<wbr/>sensor.<wbr/>active<wbr/>Array<wbr/>Size
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9758 </td>
9759
9760 <td class="entry_range">
9761 </td>
9762
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9763 <td class="entry_tags">
9764 <ul class="entry_tags">
9765 <li><a href="#tag_BC">BC</a></li>
9766 </ul>
9767 </td>
9768
9769 </tr>
9770 <tr class="entries_header">
9771 <th class="th_details" colspan="5">Details</th>
9772 </tr>
9773 <tr class="entry_cont">
9774 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9775 <p>Any additional per-stream cropping must be done to
9776maximize the final pixel area of the stream.<wbr/></p>
9777<p>For example,<wbr/> if the crop region is set to a 4:3 aspect
9778ratio,<wbr/> then 4:3 streams should use the exact crop
9779region.<wbr/> 16:9 streams should further crop vertically
9780(letterbox).<wbr/></p>
9781<p>Conversely,<wbr/> if the crop region is set to a 16:9,<wbr/> then 4:3
9782outputs should crop horizontally (pillarbox),<wbr/> and 16:9
9783streams should match exactly.<wbr/> These additional crops must
9784be centered within the crop region.<wbr/></p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]9785<p>The output streams must maintain square pixels at all
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9786times,<wbr/> no matter what the relative aspect ratios of the
9787crop region and the stream are.<wbr/> Negative values for
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]9788corner are allowed for raw output if full pixel array is
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9789larger than active pixel array.<wbr/> Width and height may be
9790rounded to nearest larger supportable width,<wbr/> especially
9791for raw output,<wbr/> where only a few fixed scales may be
9792possible.<wbr/> The width and height of the crop region cannot
9793be set to be smaller than floor( activeArraySize.<wbr/>width /<wbr/>
9794android.<wbr/>scaler.<wbr/>max<wbr/>Digital<wbr/>Zoom ) and floor(
9795activeArraySize.<wbr/>height /<wbr/> android.<wbr/>scaler.<wbr/>max<wbr/>Digital<wbr/>Zoom),<wbr/>
9796respectively.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9797 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9798 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9799
9800
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9801 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9802 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9803
9804
9805
9806 <!-- end of kind -->
9807 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9808 <tr><td colspan="6" class="kind">static</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9809
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9810 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9811 <tr>
9812 <th class="th_name">Property Name</th>
9813 <th class="th_type">Type</th>
9814 <th class="th_description">Description</th>
9815 <th class="th_units">Units</th>
9816 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9817 <th class="th_tags">Tags</th>
9818 </tr>
9819 </thead>
9820
9821 <tbody>
9822
9823
9824
9825
9826
9827
9828
9829
9830
9831
9832 <tr class="entry" id="static_android.scaler.availableFormats">
Zhijun Heb8317e22014-01-16 09:47:07 -0800[diff] [blame]9833 <td class="entry_name" rowspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9834 android.<wbr/>scaler.<wbr/>available<wbr/>Formats
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9835 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9836 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9837 <span class="entry_type_name entry_type_name_enum">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9838 <span class="entry_type_container">x</span>
9839
9840 <span class="entry_type_array">
9841 n
9842 </span>
Eino-Ville Talvalad4e240a2013-08-08 12:56:37 -0700[diff] [blame]9843 <span class="entry_type_visibility"> [public as imageFormat]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9844
9845 <ul class="entry_type_enum">
9846 <li>
9847 <span class="entry_type_enum_name">RAW_SENSOR</span>
Zhijun Heb8317e22014-01-16 09:47:07 -0800[diff] [blame]9848 <span class="entry_type_enum_optional">optional</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9849 <span class="entry_type_enum_value">0x20</span>
9850 </li>
9851 <li>
9852 <span class="entry_type_enum_name">YV12</span>
Zhijun Heb8317e22014-01-16 09:47:07 -0800[diff] [blame]9853 <span class="entry_type_enum_optional">optional</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9854 <span class="entry_type_enum_value">0x32315659</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]9855 <span class="entry_type_enum_notes"><p>YCrCb 4:2:0 Planar</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9856 </li>
9857 <li>
Zhijun Hec2eebff2013-05-16 17:49:35 -0700[diff] [blame]9858 <span class="entry_type_enum_name">YCrCb_420_SP</span>
Zhijun Heb8317e22014-01-16 09:47:07 -0800[diff] [blame]9859 <span class="entry_type_enum_optional">optional</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9860 <span class="entry_type_enum_value">0x11</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]9861 <span class="entry_type_enum_notes"><p>NV21</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9862 </li>
9863 <li>
Zhijun Hec2eebff2013-05-16 17:49:35 -0700[diff] [blame]9864 <span class="entry_type_enum_name">IMPLEMENTATION_DEFINED</span>
9865 <span class="entry_type_enum_value">0x22</span>
Zhijun Heb8317e22014-01-16 09:47:07 -0800[diff] [blame]9866 <span class="entry_type_enum_notes"><p>System internal format,<wbr/> not application-accessible</p></span>
Zhijun Hec2eebff2013-05-16 17:49:35 -0700[diff] [blame]9867 </li>
9868 <li>
9869 <span class="entry_type_enum_name">YCbCr_420_888</span>
9870 <span class="entry_type_enum_value">0x23</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]9871 <span class="entry_type_enum_notes"><p>Flexible YUV420 Format</p></span>
Zhijun Hec2eebff2013-05-16 17:49:35 -0700[diff] [blame]9872 </li>
9873 <li>
9874 <span class="entry_type_enum_name">BLOB</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9875 <span class="entry_type_enum_value">0x21</span>
Zhijun Heb8317e22014-01-16 09:47:07 -0800[diff] [blame]9876 <span class="entry_type_enum_notes"><p>JPEG format</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9877 </li>
9878 </ul>
9879
9880 </td> <!-- entry_type -->
9881
9882 <td class="entry_description">
Zhijun Heb8317e22014-01-16 09:47:07 -0800[diff] [blame]9883 <p>The list of image formats that are supported by this
9884camera device.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9885 </td>
9886
9887 <td class="entry_units">
9888 </td>
9889
9890 <td class="entry_range">
9891 </td>
9892
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9893 <td class="entry_tags">
9894 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9895 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9896 </ul>
9897 </td>
9898
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9899 </tr>
Zhijun Heb8317e22014-01-16 09:47:07 -0800[diff] [blame]9900 <tr class="entries_header">
9901 <th class="th_details" colspan="5">Details</th>
9902 </tr>
9903 <tr class="entry_cont">
9904 <td class="entry_details" colspan="5">
9905 <p>All camera devices will support JPEG and YUV_<wbr/>420_<wbr/>888 formats.<wbr/></p>
9906<p>When set to YUV_<wbr/>420_<wbr/>888,<wbr/> application can access the YUV420 data directly.<wbr/></p>
9907 </td>
9908 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9909
Zhijun Heb8317e22014-01-16 09:47:07 -0800[diff] [blame]9910 <tr class="entries_header">
9911 <th class="th_details" colspan="5">HAL Implementation Details</th>
9912 </tr>
9913 <tr class="entry_cont">
9914 <td class="entry_details" colspan="5">
9915 <p>These format values are from HAL_<wbr/>PIXEL_<wbr/>FORMAT_<wbr/>* in
9916system/<wbr/>core/<wbr/>include/<wbr/>system/<wbr/>graphics.<wbr/>h.<wbr/></p>
9917<p>When IMPLEMENTATION_<wbr/>DEFINED is used,<wbr/> the platform
9918gralloc module will select a format based on the usage flags provided
9919by the camera HAL device and the other endpoint of the stream.<wbr/> It is
9920usually used by preview and recording streams,<wbr/> where the application doesn't
9921need access the image data.<wbr/></p>
9922<p>YCb<wbr/>Cr_<wbr/>420_<wbr/>888 format must be supported by the HAL.<wbr/> When an image stream
9923needs CPU/<wbr/>application direct access,<wbr/> this format will be used.<wbr/></p>
9924<p>The BLOB format must be supported by the HAL.<wbr/> This is used for the JPEG stream.<wbr/></p>
9925 </td>
9926 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9927
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9928 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9929 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9930
9931
9932 <tr class="entry" id="static_android.scaler.availableJpegMinDurations">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9933 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9934 android.<wbr/>scaler.<wbr/>available<wbr/>Jpeg<wbr/>Min<wbr/>Durations
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9935 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9936 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9937 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9938 <span class="entry_type_container">x</span>
9939
9940 <span class="entry_type_array">
9941 n
9942 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9943 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9944
9945
9946 </td> <!-- entry_type -->
9947
9948 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9949 <p>The minimum frame duration that is supported
Igor Murashkin10f4e0f2014-01-13 17:22:58 -0800[diff] [blame]9950for each resolution in <a href="#static_android.scaler.availableJpegSizes">android.<wbr/>scaler.<wbr/>available<wbr/>Jpeg<wbr/>Sizes</a>.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9951 </td>
9952
9953 <td class="entry_units">
Igor Murashkin10f4e0f2014-01-13 17:22:58 -0800[diff] [blame]9954 ns
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9955 </td>
9956
9957 <td class="entry_range">
9958 </td>
9959
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9960 <td class="entry_tags">
9961 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9962 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9963 </ul>
9964 </td>
9965
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9966 </tr>
9967 <tr class="entries_header">
9968 <th class="th_details" colspan="5">Details</th>
9969 </tr>
9970 <tr class="entry_cont">
9971 <td class="entry_details" colspan="5">
Igor Murashkin10f4e0f2014-01-13 17:22:58 -0800[diff] [blame]9972 <p>This corresponds to the minimum steady-state frame duration when only
9973that JPEG stream is active and captured in a burst,<wbr/> with all
9974processing (typically in android.<wbr/>*.<wbr/>mode) set to FAST.<wbr/></p>
9975<p>When multiple streams are configured,<wbr/> the minimum
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9976frame duration will be &gt;= max(individual stream min
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9977durations)</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9978 </td>
9979 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9980
9981
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9982 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9983 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9984
9985
9986 <tr class="entry" id="static_android.scaler.availableJpegSizes">
Zhijun Heb8317e22014-01-16 09:47:07 -0800[diff] [blame]9987 <td class="entry_name" rowspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9988 android.<wbr/>scaler.<wbr/>available<wbr/>Jpeg<wbr/>Sizes
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9989 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9990 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9991 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9992 <span class="entry_type_container">x</span>
9993
9994 <span class="entry_type_array">
9995 n x 2
9996 </span>
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]9997 <span class="entry_type_visibility"> [public as size]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9998
9999
10000 </td> <!-- entry_type -->
10001
10002 <td class="entry_description">
Zhijun Heb8317e22014-01-16 09:47:07 -0800[diff] [blame]10003 <p>The JPEG resolutions that are supported by this camera device.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10004 </td>
10005
10006 <td class="entry_units">
10007 </td>
10008
10009 <td class="entry_range">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10010 </td>
10011
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10012 <td class="entry_tags">
10013 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]10014 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10015 </ul>
10016 </td>
10017
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10018 </tr>
Zhijun Heb8317e22014-01-16 09:47:07 -0800[diff] [blame]10019 <tr class="entries_header">
10020 <th class="th_details" colspan="5">Details</th>
10021 </tr>
10022 <tr class="entry_cont">
10023 <td class="entry_details" colspan="5">
10024 <p>The resolutions are listed as <code>(width,<wbr/> height)</code> pairs.<wbr/> All camera devices will support
10025sensor maximum resolution (defined by <a href="#static_android.sensor.info.activeArraySize">android.<wbr/>sensor.<wbr/>info.<wbr/>active<wbr/>Array<wbr/>Size</a>).<wbr/></p>
10026 </td>
10027 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10028
Zhijun Heb8317e22014-01-16 09:47:07 -0800[diff] [blame]10029 <tr class="entries_header">
10030 <th class="th_details" colspan="5">HAL Implementation Details</th>
10031 </tr>
10032 <tr class="entry_cont">
10033 <td class="entry_details" colspan="5">
10034 <p>The HAL must include sensor maximum resolution
10035(defined by <a href="#static_android.sensor.info.activeArraySize">android.<wbr/>sensor.<wbr/>info.<wbr/>active<wbr/>Array<wbr/>Size</a>),<wbr/>
10036and should include half/<wbr/>quarter of sensor maximum resolution.<wbr/></p>
10037 </td>
10038 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10039
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10040 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10041 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10042
10043
10044 <tr class="entry" id="static_android.scaler.availableMaxDigitalZoom">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10045 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10046 android.<wbr/>scaler.<wbr/>available<wbr/>Max<wbr/>Digital<wbr/>Zoom
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10047 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10048 <td class="entry_type">
Igor Murashkinf11a4df2013-05-07 10:00:46 -0700[diff] [blame]10049 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10050
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10051 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10052
10053
10054 </td> <!-- entry_type -->
10055
10056 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10057 <p>The maximum ratio between active area width
10058and crop region width,<wbr/> or between active area height and
10059crop region height,<wbr/> if the crop region height is larger
10060than width</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10061 </td>
10062
10063 <td class="entry_units">
10064 </td>
10065
10066 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame]10067 <p>&gt;=1</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10068 </td>
10069
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10070 <td class="entry_tags">
Igor Murashkinf11a4df2013-05-07 10:00:46 -0700[diff] [blame]10071 <ul class="entry_tags">
10072 <li><a href="#tag_BC">BC</a></li>
10073 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10074 </td>
10075
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10076 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10077
10078
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10079 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10080 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10081
10082
10083 <tr class="entry" id="static_android.scaler.availableProcessedMinDurations">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10084 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10085 android.<wbr/>scaler.<wbr/>available<wbr/>Processed<wbr/>Min<wbr/>Durations
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10086 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10087 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10088 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10089 <span class="entry_type_container">x</span>
10090
10091 <span class="entry_type_array">
10092 n
10093 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10094 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10095
10096
10097 </td> <!-- entry_type -->
10098
10099 <td class="entry_description">
Igor Murashkin10f4e0f2014-01-13 17:22:58 -0800[diff] [blame]10100 <p>For each available processed output size (defined in
10101<a href="#static_android.scaler.availableProcessedSizes">android.<wbr/>scaler.<wbr/>available<wbr/>Processed<wbr/>Sizes</a>),<wbr/> this property lists the
10102minimum supportable frame duration for that size.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10103 </td>
10104
10105 <td class="entry_units">
Igor Murashkin10f4e0f2014-01-13 17:22:58 -0800[diff] [blame]10106 ns
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10107 </td>
10108
10109 <td class="entry_range">
10110 </td>
10111
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10112 <td class="entry_tags">
10113 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]10114 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10115 </ul>
10116 </td>
10117
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10118 </tr>
10119 <tr class="entries_header">
10120 <th class="th_details" colspan="5">Details</th>
10121 </tr>
10122 <tr class="entry_cont">
10123 <td class="entry_details" colspan="5">
Igor Murashkin10f4e0f2014-01-13 17:22:58 -0800[diff] [blame]10124 <p>This should correspond to the frame duration when only that processed
10125stream is active,<wbr/> with all processing (typically in android.<wbr/>*.<wbr/>mode)
10126set to FAST.<wbr/></p>
10127<p>When multiple streams are configured,<wbr/> the minimum frame duration will
10128be &gt;= max(individual stream min durations).<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10129 </td>
10130 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10131
10132
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10133 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10134 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10135
10136
10137 <tr class="entry" id="static_android.scaler.availableProcessedSizes">
Zhijun Heb8317e22014-01-16 09:47:07 -0800[diff] [blame]10138 <td class="entry_name" rowspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10139 android.<wbr/>scaler.<wbr/>available<wbr/>Processed<wbr/>Sizes
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10140 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10141 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10142 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10143 <span class="entry_type_container">x</span>
10144
10145 <span class="entry_type_array">
10146 n x 2
10147 </span>
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]10148 <span class="entry_type_visibility"> [public as size]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10149
10150
10151 </td> <!-- entry_type -->
10152
10153 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10154 <p>The resolutions available for use with
10155processed output streams,<wbr/> such as YV12,<wbr/> NV12,<wbr/> and
10156platform opaque YUV/<wbr/>RGB streams to the GPU or video
Zhijun Heb8317e22014-01-16 09:47:07 -0800[diff] [blame]10157encoders.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10158 </td>
10159
10160 <td class="entry_units">
10161 </td>
10162
10163 <td class="entry_range">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10164 </td>
10165
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10166 <td class="entry_tags">
10167 <ul class="entry_tags">
10168 <li><a href="#tag_BC">BC</a></li>
10169 </ul>
10170 </td>
10171
10172 </tr>
10173 <tr class="entries_header">
10174 <th class="th_details" colspan="5">Details</th>
10175 </tr>
10176 <tr class="entry_cont">
10177 <td class="entry_details" colspan="5">
Zhijun Heb8317e22014-01-16 09:47:07 -0800[diff] [blame]10178 <p>The resolutions are listed as <code>(width,<wbr/> height)</code> pairs.<wbr/></p>
10179<p>For a given use case,<wbr/> the actual maximum supported resolution
10180may be lower than what is listed here,<wbr/> depending on the destination
10181Surface for the image data.<wbr/> For example,<wbr/> for recording video,<wbr/>
10182the video encoder chosen may have a maximum size limit (e.<wbr/>g.<wbr/> 1080p)
10183smaller than what the camera (e.<wbr/>g.<wbr/> maximum resolution is 3264x2448)
10184can provide.<wbr/></p>
10185<p>Please reference the documentation for the image data destination to
10186check if it limits the maximum size for image data.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10187 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10188 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10189
Zhijun Heb8317e22014-01-16 09:47:07 -0800[diff] [blame]10190 <tr class="entries_header">
10191 <th class="th_details" colspan="5">HAL Implementation Details</th>
10192 </tr>
10193 <tr class="entry_cont">
10194 <td class="entry_details" colspan="5">
10195 <p>For FULL capability devices (<code><a href="#static_android.info.supportedHardwareLevel">android.<wbr/>info.<wbr/>supported<wbr/>Hardware<wbr/>Level</a> == FULL</code>),<wbr/>
10196the HAL must include all JPEG sizes listed in android.<wbr/>scaler.<wbr/>available<wbr/>Jpeg<wbr/>Sizes
10197and each below resolution if it is smaller than or equal to the sensor
10198maximum resolution (if they are not listed in JPEG sizes already):</p>
10199<ul>
10200<li>240p (320 x 240)</li>
10201<li>480p (640 x 480)</li>
10202<li>720p (1280 x 720)</li>
10203<li>1080p (1920 x 1080)</li>
10204</ul>
10205<p>For LIMITED capability devices (<code><a href="#static_android.info.supportedHardwareLevel">android.<wbr/>info.<wbr/>supported<wbr/>Hardware<wbr/>Level</a> == LIMITED</code>),<wbr/>
10206the HAL only has to list up to the maximum video size supported by the devices.<wbr/></p>
10207 </td>
10208 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10209
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10210 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10211 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10212
10213
10214 <tr class="entry" id="static_android.scaler.availableRawMinDurations">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10215 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10216 android.<wbr/>scaler.<wbr/>available<wbr/>Raw<wbr/>Min<wbr/>Durations
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10217 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10218 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10219 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10220 <span class="entry_type_container">x</span>
10221
10222 <span class="entry_type_array">
10223 n
10224 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10225 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10226
10227
10228 </td> <!-- entry_type -->
10229
10230 <td class="entry_description">
Zhijun Hebdc94c42014-01-21 18:28:30 -0800[diff] [blame]10231 <p>For each available raw output size (defined in
Igor Murashkin10f4e0f2014-01-13 17:22:58 -0800[diff] [blame]10232<a href="#static_android.scaler.availableRawSizes">android.<wbr/>scaler.<wbr/>available<wbr/>Raw<wbr/>Sizes</a>),<wbr/> this property lists the minimum
10233supportable frame duration for that size.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10234 </td>
10235
10236 <td class="entry_units">
Igor Murashkin10f4e0f2014-01-13 17:22:58 -0800[diff] [blame]10237 ns
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10238 </td>
10239
10240 <td class="entry_range">
10241 </td>
10242
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10243 <td class="entry_tags">
10244 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]10245 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10246 </ul>
10247 </td>
10248
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10249 </tr>
10250 <tr class="entries_header">
10251 <th class="th_details" colspan="5">Details</th>
10252 </tr>
10253 <tr class="entry_cont">
10254 <td class="entry_details" colspan="5">
Igor Murashkin10f4e0f2014-01-13 17:22:58 -0800[diff] [blame]10255 <p>Should correspond to the frame duration when only the raw stream is
10256active.<wbr/></p>
10257<p>When multiple streams are configured,<wbr/> the minimum
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10258frame duration will be &gt;= max(individual stream min
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10259durations)</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10260 </td>
10261 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10262
10263
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10264 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10265 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10266
10267
10268 <tr class="entry" id="static_android.scaler.availableRawSizes">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10269 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10270 android.<wbr/>scaler.<wbr/>available<wbr/>Raw<wbr/>Sizes
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10271 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10272 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10273 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10274 <span class="entry_type_container">x</span>
10275
10276 <span class="entry_type_array">
10277 n x 2
10278 </span>
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]10279 <span class="entry_type_visibility"> [system as size]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10280
10281
10282 </td> <!-- entry_type -->
10283
10284 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10285 <p>The resolutions available for use with raw
10286sensor output streams,<wbr/> listed as width,<wbr/>
10287height</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10288 </td>
10289
10290 <td class="entry_units">
10291 </td>
10292
10293 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]10294 <p>Must include: - sensor maximum resolution</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10295 </td>
10296
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10297 <td class="entry_tags">
10298 </td>
10299
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10300 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10301
10302
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10303 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10304 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10305
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10306
10307
10308 <!-- end of kind -->
10309 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10310 <tr><td colspan="6" class="kind">dynamic</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10311
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10312 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10313 <tr>
10314 <th class="th_name">Property Name</th>
10315 <th class="th_type">Type</th>
10316 <th class="th_description">Description</th>
10317 <th class="th_units">Units</th>
10318 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10319 <th class="th_tags">Tags</th>
10320 </tr>
10321 </thead>
10322
10323 <tbody>
10324
10325
10326
10327
10328
10329
10330
10331
10332
10333
10334 <tr class="entry" id="dynamic_android.scaler.cropRegion">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10335 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10336 android.<wbr/>scaler.<wbr/>crop<wbr/>Region
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10337 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10338 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10339 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10340 <span class="entry_type_container">x</span>
10341
10342 <span class="entry_type_array">
Eino-Ville Talvalae04ec6e2013-04-16 15:35:18 -0700[diff] [blame]10343 4
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10344 </span>
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]10345 <span class="entry_type_visibility"> [public as rectangle]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10346
10347
10348 </td> <!-- entry_type -->
10349
10350 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10351 <p>(x,<wbr/> y,<wbr/> width,<wbr/> height).<wbr/></p>
10352<p>A rectangle with the top-level corner of (x,<wbr/>y) and size
10353(width,<wbr/> height).<wbr/> The region of the sensor that is used for
10354output.<wbr/> Each stream must use this rectangle to produce its
10355output,<wbr/> cropping to a smaller region if necessary to
10356maintain the stream's aspect ratio.<wbr/></p>
10357<p>HAL2.<wbr/>x uses only (x,<wbr/> y,<wbr/> width)</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10358 </td>
10359
10360 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10361 (x,<wbr/>y) of top-left corner,<wbr/> width and height of region
10362 in pixels; (0,<wbr/>0) is top-left corner of
10363 android.<wbr/>sensor.<wbr/>active<wbr/>Array<wbr/>Size
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10364 </td>
10365
10366 <td class="entry_range">
10367 </td>
10368
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10369 <td class="entry_tags">
10370 <ul class="entry_tags">
10371 <li><a href="#tag_BC">BC</a></li>
10372 </ul>
10373 </td>
10374
10375 </tr>
10376 <tr class="entries_header">
10377 <th class="th_details" colspan="5">Details</th>
10378 </tr>
10379 <tr class="entry_cont">
10380 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10381 <p>Any additional per-stream cropping must be done to
10382maximize the final pixel area of the stream.<wbr/></p>
10383<p>For example,<wbr/> if the crop region is set to a 4:3 aspect
10384ratio,<wbr/> then 4:3 streams should use the exact crop
10385region.<wbr/> 16:9 streams should further crop vertically
10386(letterbox).<wbr/></p>
10387<p>Conversely,<wbr/> if the crop region is set to a 16:9,<wbr/> then 4:3
10388outputs should crop horizontally (pillarbox),<wbr/> and 16:9
10389streams should match exactly.<wbr/> These additional crops must
10390be centered within the crop region.<wbr/></p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]10391<p>The output streams must maintain square pixels at all
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10392times,<wbr/> no matter what the relative aspect ratios of the
10393crop region and the stream are.<wbr/> Negative values for
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]10394corner are allowed for raw output if full pixel array is
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10395larger than active pixel array.<wbr/> Width and height may be
10396rounded to nearest larger supportable width,<wbr/> especially
10397for raw output,<wbr/> where only a few fixed scales may be
10398possible.<wbr/> The width and height of the crop region cannot
10399be set to be smaller than floor( activeArraySize.<wbr/>width /<wbr/>
10400android.<wbr/>scaler.<wbr/>max<wbr/>Digital<wbr/>Zoom ) and floor(
10401activeArraySize.<wbr/>height /<wbr/> android.<wbr/>scaler.<wbr/>max<wbr/>Digital<wbr/>Zoom),<wbr/>
10402respectively.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10403 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10404 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10405
10406
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10407 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10408 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10409
10410
10411
10412 <!-- end of kind -->
10413 </tbody>
10414
10415 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10416 <tr><td colspan="6" id="section_sensor" class="section">sensor</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10417
10418
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10419 <tr><td colspan="6" class="kind">controls</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10420
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10421 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10422 <tr>
10423 <th class="th_name">Property Name</th>
10424 <th class="th_type">Type</th>
10425 <th class="th_description">Description</th>
10426 <th class="th_units">Units</th>
10427 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10428 <th class="th_tags">Tags</th>
10429 </tr>
10430 </thead>
10431
10432 <tbody>
10433
10434
10435
10436
10437
10438
10439
10440
10441
10442
10443 <tr class="entry" id="controls_android.sensor.exposureTime">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10444 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10445 android.<wbr/>sensor.<wbr/>exposure<wbr/>Time
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10446 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10447 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10448 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10449
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10450 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10451
10452
10453 </td> <!-- entry_type -->
10454
10455 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10456 <p>Duration each pixel is exposed to
10457light.<wbr/></p>
10458<p>If the sensor can't expose this exact duration,<wbr/> it should shorten the
10459duration exposed to the nearest possible value (rather than expose longer).<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10460 </td>
10461
10462 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10463 nanoseconds
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10464 </td>
10465
10466 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]10467 <p><a href="#static_android.sensor.info.exposureTimeRange">android.<wbr/>sensor.<wbr/>info.<wbr/>exposure<wbr/>Time<wbr/>Range</a></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10468 </td>
10469
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10470 <td class="entry_tags">
10471 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]10472 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10473 </ul>
10474 </td>
10475
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10476 </tr>
10477 <tr class="entries_header">
10478 <th class="th_details" colspan="5">Details</th>
10479 </tr>
10480 <tr class="entry_cont">
10481 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10482 <p>1/<wbr/>10000 - 30 sec range.<wbr/> No bulb mode</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10483 </td>
10484 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10485
10486
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10487 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10488 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10489
10490
10491 <tr class="entry" id="controls_android.sensor.frameDuration">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10492 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10493 android.<wbr/>sensor.<wbr/>frame<wbr/>Duration
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10494 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10495 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10496 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10497
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10498 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10499
10500
10501 </td> <!-- entry_type -->
10502
10503 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10504 <p>Duration from start of frame exposure to
Igor Murashkin10f4e0f2014-01-13 17:22:58 -0800[diff] [blame]10505start of next frame exposure.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10506 </td>
10507
10508 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10509 nanoseconds
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10510 </td>
10511
10512 <td class="entry_range">
Igor Murashkin10f4e0f2014-01-13 17:22:58 -0800[diff] [blame]10513 <p>See <a href="#static_android.sensor.info.maxFrameDuration">android.<wbr/>sensor.<wbr/>info.<wbr/>max<wbr/>Frame<wbr/>Duration</a>,<wbr/>
10514android.<wbr/>scaler.<wbr/>available*Min<wbr/>Durations.<wbr/> The duration
10515is capped to <code>max(duration,<wbr/> exposureTime + overhead)</code>.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10516 </td>
10517
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10518 <td class="entry_tags">
10519 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]10520 <li><a href="#tag_V1">V1</a></li>
10521 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10522 </ul>
10523 </td>
10524
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10525 </tr>
10526 <tr class="entries_header">
10527 <th class="th_details" colspan="5">Details</th>
10528 </tr>
10529 <tr class="entry_cont">
10530 <td class="entry_details" colspan="5">
Igor Murashkin10f4e0f2014-01-13 17:22:58 -0800[diff] [blame]10531 <p>The maximum frame rate that can be supported by a camera subsystem is
10532a function of many factors:</p>
10533<ul>
10534<li>Requested resolutions of output image streams</li>
10535<li>Availability of binning /<wbr/> skipping modes on the imager</li>
10536<li>The bandwidth of the imager interface</li>
10537<li>The bandwidth of the various ISP processing blocks</li>
10538</ul>
10539<p>Since these factors can vary greatly between different ISPs and
10540sensors,<wbr/> the camera abstraction tries to represent the bandwidth
10541restrictions with as simple a model as possible.<wbr/></p>
10542<p>The model presented has the following characteristics:</p>
10543<ul>
10544<li>The image sensor is always configured to output the smallest
10545resolution possible given the application's requested output stream
10546sizes.<wbr/> The smallest resolution is defined as being at least as large
10547as the largest requested output stream size; the camera pipeline must
10548never digitally upsample sensor data when the crop region covers the
10549whole sensor.<wbr/> In general,<wbr/> this means that if only small output stream
10550resolutions are configured,<wbr/> the sensor can provide a higher frame
10551rate.<wbr/></li>
10552<li>Since any request may use any or all the currently configured
10553output streams,<wbr/> the sensor and ISP must be configured to support
10554scaling a single capture to all the streams at the same time.<wbr/> This
10555means the camera pipeline must be ready to produce the largest
10556requested output size without any delay.<wbr/> Therefore,<wbr/> the overall
10557frame rate of a given configured stream set is governed only by the
10558largest requested stream resolution.<wbr/></li>
10559<li>Using more than one output stream in a request does not affect the
10560frame duration.<wbr/></li>
10561<li>JPEG streams act like processed YUV streams in requests for which
10562they are not included; in requests in which they are directly
10563referenced,<wbr/> they act as JPEG streams.<wbr/> This is because supporting a
10564JPEG stream requires the underlying YUV data to always be ready for
10565use by a JPEG encoder,<wbr/> but the encoder will only be used (and impact
10566frame duration) on requests that actually reference a JPEG stream.<wbr/></li>
10567<li>The JPEG processor can run concurrently to the rest of the camera
10568pipeline,<wbr/> but cannot process more than 1 capture at a time.<wbr/></li>
10569</ul>
10570<p>The necessary information for the application,<wbr/> given the model above,<wbr/>
10571is provided via the android.<wbr/>scaler.<wbr/>available*Min<wbr/>Durations fields.<wbr/>
10572These are used to determine the maximum frame rate /<wbr/> minimum frame
10573duration that is possible for a given stream configuration.<wbr/></p>
10574<p>Specifically,<wbr/> the application can use the following rules to
10575determine the minimum frame duration it can request from the HAL
10576device:</p>
10577<ol>
10578<li>Given the application's currently configured set of output
10579streams,<wbr/> <code>S</code>,<wbr/> divide them into three sets: streams in a JPEG format
10580<code>SJ</code>,<wbr/> streams in a raw sensor format <code>SR</code>,<wbr/> and the rest ('processed')
10581<code>SP</code>.<wbr/></li>
10582<li>For each subset of streams,<wbr/> find the largest resolution (by pixel
10583count) in the subset.<wbr/> This gives (at most) three resolutions <code>RJ</code>,<wbr/>
10584<code>RR</code>,<wbr/> and <code>RP</code>.<wbr/></li>
10585<li>If <code>RJ</code> is greater than <code>RP</code>,<wbr/> set <code>RP</code> equal to <code>RJ</code>.<wbr/> If there is
10586no exact match for <code>RP == RJ</code> (in particular there isn't an available
10587processed resolution at the same size as <code>RJ</code>),<wbr/> then set <code>RP</code> equal
10588to the smallest processed resolution that is larger than <code>RJ</code>.<wbr/> If
10589there are no processed resolutions larger than <code>RJ</code>,<wbr/> then set <code>RJ</code> to
10590the processed resolution closest to <code>RJ</code>.<wbr/></li>
10591<li>If <code>RP</code> is greater than <code>RR</code>,<wbr/> set <code>RR</code> equal to <code>RP</code>.<wbr/> If there is
10592no exact match for <code>RR == RP</code> (in particular there isn't an available
10593raw resolution at the same size as <code>RP</code>),<wbr/> then set <code>RR</code> equal to
10594or to the smallest raw resolution that is larger than <code>RP</code>.<wbr/> If
10595there are no raw resolutions larger than <code>RP</code>,<wbr/> then set <code>RR</code> to
10596the raw resolution closest to <code>RP</code>.<wbr/></li>
10597<li>Look up the matching minimum frame durations in the property lists
10598<a href="#static_android.scaler.availableJpegMinDurations">android.<wbr/>scaler.<wbr/>available<wbr/>Jpeg<wbr/>Min<wbr/>Durations</a>,<wbr/>
10599<a href="#static_android.scaler.availableRawMinDurations">android.<wbr/>scaler.<wbr/>available<wbr/>Raw<wbr/>Min<wbr/>Durations</a>,<wbr/> and
10600<a href="#static_android.scaler.availableProcessedMinDurations">android.<wbr/>scaler.<wbr/>available<wbr/>Processed<wbr/>Min<wbr/>Durations</a>.<wbr/> This gives three
10601minimum frame durations <code>FJ</code>,<wbr/> <code>FR</code>,<wbr/> and <code>FP</code>.<wbr/></li>
10602<li>If a stream of requests do not use a JPEG stream,<wbr/> then the minimum
10603supported frame duration for each request is <code>max(FR,<wbr/> FP)</code>.<wbr/></li>
10604<li>If a stream of requests all use the JPEG stream,<wbr/> then the minimum
10605supported frame duration for each request is <code>max(FR,<wbr/> FP,<wbr/> FJ)</code>.<wbr/></li>
10606<li>If a mix of JPEG-using and non-JPEG-using requests is submitted by
10607the application,<wbr/> then the HAL will have to delay JPEG-using requests
10608whenever the JPEG encoder is still busy processing an older capture.<wbr/>
10609This will happen whenever a JPEG-using request starts capture less
10610than <code>FJ</code> <em>ns</em> after a previous JPEG-using request.<wbr/> The minimum
10611supported frame duration will vary between the values calculated in
10612#6 and #7.<wbr/></li>
10613</ol>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10614 </td>
10615 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10616
10617
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10618 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10619 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10620
10621
10622 <tr class="entry" id="controls_android.sensor.sensitivity">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10623 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10624 android.<wbr/>sensor.<wbr/>sensitivity
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10625 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10626 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10627 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10628
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10629 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10630
10631
10632 </td> <!-- entry_type -->
10633
10634 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10635 <p>Gain applied to image data.<wbr/> Must be
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]10636implemented through analog gain only if set to values
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10637below 'maximum analog sensitivity'.<wbr/></p>
10638<p>If the sensor can't apply this exact gain,<wbr/> it should lessen the
10639gain to the nearest possible value (rather than gain more).<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10640 </td>
10641
10642 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10643 ISO arithmetic units
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10644 </td>
10645
10646 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]10647 <p><a href="#static_android.sensor.info.sensitivityRange">android.<wbr/>sensor.<wbr/>info.<wbr/>sensitivity<wbr/>Range</a></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10648 </td>
10649
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10650 <td class="entry_tags">
10651 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]10652 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10653 </ul>
10654 </td>
10655
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10656 </tr>
10657 <tr class="entries_header">
10658 <th class="th_details" colspan="5">Details</th>
10659 </tr>
10660 <tr class="entry_cont">
10661 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10662 <p>ISO 12232:2006 REI method</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10663 </td>
10664 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10665
10666
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10667 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10668 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10669
Igor Murashkina46e02f2014-01-09 17:43:38 -0800[diff] [blame]10670
10671 <tr class="entry" id="controls_android.sensor.testPatternData">
10672 <td class="entry_name" rowspan="5">
10673 android.<wbr/>sensor.<wbr/>test<wbr/>Pattern<wbr/>Data
10674 </td>
10675 <td class="entry_type">
10676 <span class="entry_type_name">int32</span>
10677 <span class="entry_type_container">x</span>
10678
10679 <span class="entry_type_array">
10680 4
10681 </span>
10682 <span class="entry_type_visibility"> [public]</span>
10683
10684
10685 </td> <!-- entry_type -->
10686
10687 <td class="entry_description">
10688 <p>A pixel <code>[R,<wbr/> G_<wbr/>even,<wbr/> G_<wbr/>odd,<wbr/> B]</code> that supplies the test pattern
10689when <a href="#controls_android.sensor.testPatternMode">android.<wbr/>sensor.<wbr/>test<wbr/>Pattern<wbr/>Mode</a> is SOLID_<wbr/>COLOR.<wbr/></p>
10690 </td>
10691
10692 <td class="entry_units">
10693 </td>
10694
10695 <td class="entry_range">
10696 <p>Optional.<wbr/>
10697Must be supported if <a href="#static_android.sensor.availableTestPatternModes">android.<wbr/>sensor.<wbr/>available<wbr/>Test<wbr/>Pattern<wbr/>Modes</a> contains
10698SOLID_<wbr/>COLOR.<wbr/></p>
10699 </td>
10700
10701 <td class="entry_tags">
10702 </td>
10703
10704 </tr>
10705 <tr class="entries_header">
10706 <th class="th_details" colspan="5">Details</th>
10707 </tr>
10708 <tr class="entry_cont">
10709 <td class="entry_details" colspan="5">
10710 <p>Each color channel is treated as an unsigned 32-bit integer.<wbr/>
10711The camera device then uses the most significant X bits
10712that correspond to how many bits are in its Bayer raw sensor
10713output.<wbr/></p>
10714<p>For example,<wbr/> a sensor with RAW10 Bayer output would use the
1071510 most significant bits from each color channel.<wbr/></p>
10716 </td>
10717 </tr>
10718
10719 <tr class="entries_header">
10720 <th class="th_details" colspan="5">HAL Implementation Details</th>
10721 </tr>
10722 <tr class="entry_cont">
10723 <td class="entry_details" colspan="5">
10724
10725 </td>
10726 </tr>
10727
10728 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10729 <!-- end of entry -->
10730
10731
10732 <tr class="entry" id="controls_android.sensor.testPatternMode">
10733 <td class="entry_name" rowspan="5">
10734 android.<wbr/>sensor.<wbr/>test<wbr/>Pattern<wbr/>Mode
10735 </td>
10736 <td class="entry_type">
10737 <span class="entry_type_name entry_type_name_enum">int32</span>
10738
10739 <span class="entry_type_visibility"> [public]</span>
10740
10741 <ul class="entry_type_enum">
10742 <li>
10743 <span class="entry_type_enum_name">OFF</span>
10744 <span class="entry_type_enum_notes"><p>Default.<wbr/> No test pattern mode is used,<wbr/> and the camera
10745device returns captures from the image sensor.<wbr/></p></span>
10746 </li>
10747 <li>
10748 <span class="entry_type_enum_name">SOLID_COLOR</span>
10749 <span class="entry_type_enum_notes"><p>Each pixel in <code>[R,<wbr/> G_<wbr/>even,<wbr/> G_<wbr/>odd,<wbr/> B]</code> is replaced by its
10750respective color channel provided in
10751<a href="#controls_android.sensor.testPatternData">android.<wbr/>sensor.<wbr/>test<wbr/>Pattern<wbr/>Data</a>.<wbr/></p>
10752<p>For example:</p>
10753<pre><code>android.<wbr/>testPatternData = [0,<wbr/> 0xFFFFFFFF,<wbr/> 0xFFFFFFFF,<wbr/> 0]
10754</code></pre>
10755<p>All green pixels are 100% green.<wbr/> All red/<wbr/>blue pixels are black.<wbr/></p>
10756<pre><code>android.<wbr/>testPatternData = [0xFFFFFFFF,<wbr/> 0,<wbr/> 0xFFFFFFFF,<wbr/> 0]
10757</code></pre>
10758<p>All red pixels are 100% red.<wbr/> Only the odd green pixels
10759are 100% green.<wbr/> All blue pixels are 100% black.<wbr/></p></span>
10760 </li>
10761 <li>
10762 <span class="entry_type_enum_name">COLOR_BARS</span>
10763 <span class="entry_type_enum_notes"><p>All pixel data is replaced with an 8-bar color pattern.<wbr/></p>
10764<p>The vertical bars (left-to-right) are as follows:</p>
10765<ul>
10766<li>100% white</li>
10767<li>yellow</li>
10768<li>cyan</li>
10769<li>green</li>
10770<li>magenta</li>
10771<li>red</li>
10772<li>blue</li>
10773<li>black</li>
10774</ul>
10775<p>In general the image would look like the following:</p>
10776<pre><code>W Y C G M R B K
10777W Y C G M R B K
10778W Y C G M R B K
10779W Y C G M R B K
10780W Y C G M R B K
10781.<wbr/> .<wbr/> .<wbr/> .<wbr/> .<wbr/> .<wbr/> .<wbr/> .<wbr/>
10782.<wbr/> .<wbr/> .<wbr/> .<wbr/> .<wbr/> .<wbr/> .<wbr/> .<wbr/>
10783.<wbr/> .<wbr/> .<wbr/> .<wbr/> .<wbr/> .<wbr/> .<wbr/> .<wbr/>
10784
10785(B = Blue,<wbr/> K = Black)
10786</code></pre>
10787<p>Each bar should take up 1/<wbr/>8 of the sensor pixel array width.<wbr/>
10788When this is not possible,<wbr/> the bar size should be rounded
10789down to the nearest integer and the pattern can repeat
10790on the right side.<wbr/></p>
10791<p>Each bar's height must always take up the full sensor
10792pixel array height.<wbr/></p>
10793<p>Each pixel in this test pattern must be set to either
107940% intensity or 100% intensity.<wbr/></p></span>
10795 </li>
10796 <li>
10797 <span class="entry_type_enum_name">COLOR_BARS_FADE_TO_GRAY</span>
10798 <span class="entry_type_enum_notes"><p>The test pattern is similar to COLOR_<wbr/>BARS,<wbr/> except that
10799each bar should start at its specified color at the top,<wbr/>
10800and fade to gray at the bottom.<wbr/></p>
10801<p>Furthermore each bar is further subdivided into a left and
10802right half.<wbr/> The left half should have a smooth gradient,<wbr/>
10803and the right half should have a quantized gradient.<wbr/></p>
10804<p>In particular,<wbr/> the right half's should consist of blocks of the
10805same color for 1/<wbr/>16th active sensor pixel array width.<wbr/></p>
10806<p>The least significant bits in the quantized gradient should
10807be copied from the most significant bits of the smooth gradient.<wbr/></p>
10808<p>The height of each bar should always be a multiple of 128.<wbr/>
10809When this is not the case,<wbr/> the pattern should repeat at the bottom
10810of the image.<wbr/></p></span>
10811 </li>
10812 <li>
10813 <span class="entry_type_enum_name">PN9</span>
10814 <span class="entry_type_enum_notes"><p>All pixel data is replaced by a pseudo-random sequence
10815generated from a PN9 512-bit sequence (typically implemented
10816in hardware with a linear feedback shift register).<wbr/></p>
10817<p>The generator should be reset at the beginning of each frame,<wbr/>
10818and thus each subsequent raw frame with this test pattern should
10819be exactly the same as the last.<wbr/></p></span>
10820 </li>
10821 <li>
10822 <span class="entry_type_enum_name">CUSTOM1</span>
10823 <span class="entry_type_enum_value">256</span>
10824 <span class="entry_type_enum_notes"><p>The first custom test pattern.<wbr/> All custom patterns that are
10825available only on this camera device are at least this numeric
10826value.<wbr/></p>
10827<p>All of the custom test patterns will be static
10828(that is the raw image must not vary from frame to frame).<wbr/></p></span>
10829 </li>
10830 </ul>
10831
10832 </td> <!-- entry_type -->
10833
10834 <td class="entry_description">
10835 <p>When enabled,<wbr/> the sensor sends a test pattern instead of
10836doing a real exposure from the camera.<wbr/></p>
10837 </td>
10838
10839 <td class="entry_units">
10840 </td>
10841
10842 <td class="entry_range">
10843 <p>Optional.<wbr/> Defaults to OFF.<wbr/> Value must be one of
10844<a href="#static_android.sensor.availableTestPatternModes">android.<wbr/>sensor.<wbr/>available<wbr/>Test<wbr/>Pattern<wbr/>Modes</a></p>
10845 </td>
10846
10847 <td class="entry_tags">
10848 </td>
10849
10850 </tr>
10851 <tr class="entries_header">
10852 <th class="th_details" colspan="5">Details</th>
10853 </tr>
10854 <tr class="entry_cont">
10855 <td class="entry_details" colspan="5">
10856 <p>When a test pattern is enabled,<wbr/> all manual sensor controls specified
10857by android.<wbr/>sensor.<wbr/>* should be ignored.<wbr/> All other controls should
10858work as normal.<wbr/></p>
10859<p>For example,<wbr/> if manual flash is enabled,<wbr/> flash firing should still
10860occur (and that the test pattern remain unmodified,<wbr/> since the flash
10861would not actually affect it).<wbr/></p>
10862 </td>
10863 </tr>
10864
10865 <tr class="entries_header">
10866 <th class="th_details" colspan="5">HAL Implementation Details</th>
10867 </tr>
10868 <tr class="entry_cont">
10869 <td class="entry_details" colspan="5">
10870 <p>All test patterns are specified in the Bayer domain.<wbr/></p>
10871<p>The HAL may choose to substitute test patterns from the sensor
10872with test patterns from on-device memory.<wbr/> In that case,<wbr/> it should be
10873indistinguishable to the ISP whether the data came from the
10874sensor interconnect bus (such as CSI2) or memory.<wbr/></p>
10875 </td>
10876 </tr>
10877
10878 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10879 <!-- end of entry -->
10880
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10881
10882
10883 <!-- end of kind -->
10884 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10885 <tr><td colspan="6" class="kind">static</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10886
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10887 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10888 <tr>
10889 <th class="th_name">Property Name</th>
10890 <th class="th_type">Type</th>
10891 <th class="th_description">Description</th>
10892 <th class="th_units">Units</th>
10893 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10894 <th class="th_tags">Tags</th>
10895 </tr>
10896 </thead>
10897
10898 <tbody>
10899
10900
10901
10902
10903
10904
10905
10906
10907
10908
10909
10910
10911 <tr class="entry" id="static_android.sensor.info.activeArraySize">
Zhijun Hebdc94c42014-01-21 18:28:30 -0800[diff] [blame]10912 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10913 android.<wbr/>sensor.<wbr/>info.<wbr/>active<wbr/>Array<wbr/>Size
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10914 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10915 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10916 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10917 <span class="entry_type_container">x</span>
10918
10919 <span class="entry_type_array">
10920 4
10921 </span>
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]10922 <span class="entry_type_visibility"> [public as rectangle]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10923 <div class="entry_type_notes">Four ints defining the active pixel rectangle</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10924
10925
10926 </td> <!-- entry_type -->
10927
10928 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10929 <p>Area of raw data which corresponds to only
Zhijun Hebdc94c42014-01-21 18:28:30 -0800[diff] [blame]10930active pixels.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10931 </td>
10932
10933 <td class="entry_units">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10934 </td>
10935
10936 <td class="entry_range">
Zhijun Hebdc94c42014-01-21 18:28:30 -0800[diff] [blame]10937 <p>This array contains <code>(xmin,<wbr/> ymin,<wbr/> width,<wbr/> height)</code>.<wbr/> The <code>(xmin,<wbr/> ymin)</code> must be
10938&gt;= <code>(0,<wbr/>0)</code>.<wbr/> The <code>(width,<wbr/> height)</code> must be &lt;=
10939<code><a href="#static_android.sensor.info.pixelArraySize">android.<wbr/>sensor.<wbr/>info.<wbr/>pixel<wbr/>Array<wbr/>Size</a></code>.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10940 </td>
10941
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10942 <td class="entry_tags">
10943 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]10944 <li><a href="#tag_DNG">DNG</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10945 </ul>
10946 </td>
10947
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10948 </tr>
Zhijun Hebdc94c42014-01-21 18:28:30 -0800[diff] [blame]10949 <tr class="entries_header">
10950 <th class="th_details" colspan="5">Details</th>
10951 </tr>
10952 <tr class="entry_cont">
10953 <td class="entry_details" colspan="5">
10954 <p>It is smaller or equal to
10955sensor full pixel array,<wbr/> which could include the black calibration pixels.<wbr/></p>
10956 </td>
10957 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10958
10959
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10960 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10961 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10962
10963
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]10964 <tr class="entry" id="static_android.sensor.info.sensitivityRange">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10965 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10966 android.<wbr/>sensor.<wbr/>info.<wbr/>sensitivity<wbr/>Range
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10967 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10968 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10969 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10970 <span class="entry_type_container">x</span>
10971
10972 <span class="entry_type_array">
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]10973 2
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10974 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10975 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10976 <div class="entry_type_notes">Range of supported sensitivities</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10977
10978
10979 </td> <!-- entry_type -->
10980
10981 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10982 <p>Range of valid sensitivities</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10983 </td>
10984
10985 <td class="entry_units">
10986 </td>
10987
10988 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]10989 <p>Min &lt;= 100,<wbr/> Max &gt;= 1600</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10990 </td>
10991
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10992 <td class="entry_tags">
10993 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]10994 <li><a href="#tag_BC">BC</a></li>
10995 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10996 </ul>
10997 </td>
10998
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10999 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11000
11001
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11002 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11003 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11004
11005
11006 <tr class="entry" id="static_android.sensor.info.colorFilterArrangement">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11007 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11008 android.<wbr/>sensor.<wbr/>info.<wbr/>color<wbr/>Filter<wbr/>Arrangement
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11009 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11010 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]11011 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11012
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]11013 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11014
11015 <ul class="entry_type_enum">
11016 <li>
11017 <span class="entry_type_enum_name">RGGB</span>
11018 </li>
11019 <li>
11020 <span class="entry_type_enum_name">GRBG</span>
11021 </li>
11022 <li>
11023 <span class="entry_type_enum_name">GBRG</span>
11024 </li>
11025 <li>
11026 <span class="entry_type_enum_name">BGGR</span>
11027 </li>
11028 <li>
11029 <span class="entry_type_enum_name">RGB</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]11030 <span class="entry_type_enum_notes"><p>Sensor is not Bayer; output has 3 16-bit
11031values for each pixel,<wbr/> instead of just 1 16-bit value
11032per pixel.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11033 </li>
11034 </ul>
11035
11036 </td> <!-- entry_type -->
11037
11038 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11039 <p>Arrangement of color filters on sensor;
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]11040represents the colors in the top-left 2x2 section of
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11041the sensor,<wbr/> in reading order</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11042 </td>
11043
11044 <td class="entry_units">
11045 </td>
11046
11047 <td class="entry_range">
11048 </td>
11049
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11050 <td class="entry_tags">
11051 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]11052 <li><a href="#tag_DNG">DNG</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11053 </ul>
11054 </td>
11055
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11056 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11057
11058
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11059 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11060 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11061
11062
11063 <tr class="entry" id="static_android.sensor.info.exposureTimeRange">
Igor Murashkin061c6002014-01-27 16:00:26 -0800[diff] [blame]11064 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11065 android.<wbr/>sensor.<wbr/>info.<wbr/>exposure<wbr/>Time<wbr/>Range
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11066 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11067 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]11068 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11069 <span class="entry_type_container">x</span>
11070
11071 <span class="entry_type_array">
11072 2
11073 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]11074 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11075 <div class="entry_type_notes">nanoseconds</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11076
11077
11078 </td> <!-- entry_type -->
11079
11080 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11081 <p>Range of valid exposure
Igor Murashkin061c6002014-01-27 16:00:26 -0800[diff] [blame]11082times used by <a href="#controls_android.sensor.exposureTime">android.<wbr/>sensor.<wbr/>exposure<wbr/>Time</a>.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11083 </td>
11084
11085 <td class="entry_units">
11086 </td>
11087
11088 <td class="entry_range">
Igor Murashkin061c6002014-01-27 16:00:26 -0800[diff] [blame]11089 <p>Min &lt;= 100e3 (100 us),<wbr/> Max &gt;= 1e9 (1
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]11090sec)</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11091 </td>
11092
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11093 <td class="entry_tags">
11094 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]11095 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11096 </ul>
11097 </td>
11098
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11099 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11100
Igor Murashkin061c6002014-01-27 16:00:26 -0800[diff] [blame]11101 <tr class="entries_header">
11102 <th class="th_details" colspan="5">HAL Implementation Details</th>
11103 </tr>
11104 <tr class="entry_cont">
11105 <td class="entry_details" colspan="5">
11106 <p>The maximum of the range must be at least
111071 second.<wbr/> It should be at least 30 seconds.<wbr/></p>
11108 </td>
11109 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11110
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11111 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11112 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11113
11114
11115 <tr class="entry" id="static_android.sensor.info.maxFrameDuration">
Igor Murashkin061c6002014-01-27 16:00:26 -0800[diff] [blame]11116 <td class="entry_name" rowspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11117 android.<wbr/>sensor.<wbr/>info.<wbr/>max<wbr/>Frame<wbr/>Duration
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11118 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11119 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]11120 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11121
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]11122 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11123
11124
11125 </td> <!-- entry_type -->
11126
11127 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11128 <p>Maximum possible frame duration (minimum frame
Igor Murashkin061c6002014-01-27 16:00:26 -0800[diff] [blame]11129rate).<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11130 </td>
11131
11132 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11133 nanoseconds
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11134 </td>
11135
11136 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame]11137 <p>&gt;= 30e9</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11138 </td>
11139
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11140 <td class="entry_tags">
11141 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]11142 <li><a href="#tag_BC">BC</a></li>
11143 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11144 </ul>
11145 </td>
11146
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11147 </tr>
11148 <tr class="entries_header">
11149 <th class="th_details" colspan="5">Details</th>
11150 </tr>
11151 <tr class="entry_cont">
11152 <td class="entry_details" colspan="5">
Igor Murashkin061c6002014-01-27 16:00:26 -0800[diff] [blame]11153 <p>The largest possible android.<wbr/>sensor.<wbr/>frame<wbr/>Duration
11154that will be accepted by the camera device.<wbr/> Attempting to use
11155frame durations beyond the maximum will result in the frame duration
11156being clipped to the maximum.<wbr/> See that control
11157for a full definition of frame durations.<wbr/></p>
11158<p>Refer to
11159<a href="#static_android.scaler.availableProcessedMinDurations">android.<wbr/>scaler.<wbr/>available<wbr/>Processed<wbr/>Min<wbr/>Durations</a>,<wbr/>
11160<a href="#static_android.scaler.availableJpegMinDurations">android.<wbr/>scaler.<wbr/>available<wbr/>Jpeg<wbr/>Min<wbr/>Durations</a>,<wbr/> and
11161<a href="#static_android.scaler.availableRawMinDurations">android.<wbr/>scaler.<wbr/>available<wbr/>Raw<wbr/>Min<wbr/>Durations</a> for the minimum
11162frame duration values.<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11163 </td>
11164 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11165
Igor Murashkin061c6002014-01-27 16:00:26 -0800[diff] [blame]11166 <tr class="entries_header">
11167 <th class="th_details" colspan="5">HAL Implementation Details</th>
11168 </tr>
11169 <tr class="entry_cont">
11170 <td class="entry_details" colspan="5">
11171 <p>This value must be at least 1 second.<wbr/> It should be at least 30
11172seconds (30e9 ns).<wbr/></p>
11173<p>android.<wbr/>sensor.<wbr/>max<wbr/>Frame<wbr/>Duration must be greater or equal to the
11174android.<wbr/>sensor.<wbr/>exposure<wbr/>Time<wbr/>Range max value (since exposure time
11175overrides frame duration).<wbr/></p>
11176 </td>
11177 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11178
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11179 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11180 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11181
11182
11183 <tr class="entry" id="static_android.sensor.info.physicalSize">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11184 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11185 android.<wbr/>sensor.<wbr/>info.<wbr/>physical<wbr/>Size
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11186 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11187 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]11188 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11189 <span class="entry_type_container">x</span>
11190
11191 <span class="entry_type_array">
11192 2
11193 </span>
Timothy Knightec817d52013-08-16 16:15:29 -0700[diff] [blame]11194 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11195 <div class="entry_type_notes">width x height in millimeters</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11196
11197
11198 </td> <!-- entry_type -->
11199
11200 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11201 <p>The physical dimensions of the full pixel
11202array</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11203 </td>
11204
11205 <td class="entry_units">
11206 </td>
11207
11208 <td class="entry_range">
11209 </td>
11210
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11211 <td class="entry_tags">
11212 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]11213 <li><a href="#tag_V1">V1</a></li>
11214 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11215 </ul>
11216 </td>
11217
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11218 </tr>
11219 <tr class="entries_header">
11220 <th class="th_details" colspan="5">Details</th>
11221 </tr>
11222 <tr class="entry_cont">
11223 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11224 <p>Needed for FOV calculation for old API</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11225 </td>
11226 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11227
11228
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11229 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11230 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11231
11232
11233 <tr class="entry" id="static_android.sensor.info.pixelArraySize">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11234 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11235 android.<wbr/>sensor.<wbr/>info.<wbr/>pixel<wbr/>Array<wbr/>Size
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11236 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11237 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]11238 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11239 <span class="entry_type_container">x</span>
11240
11241 <span class="entry_type_array">
11242 2
11243 </span>
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]11244 <span class="entry_type_visibility"> [system as size]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11245
11246
11247 </td> <!-- entry_type -->
11248
11249 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11250 <p>Dimensions of full pixel array,<wbr/> possibly
Zhijun Hebdc94c42014-01-21 18:28:30 -0800[diff] [blame]11251including black calibration pixels.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11252 </td>
11253
11254 <td class="entry_units">
11255 </td>
11256
11257 <td class="entry_range">
11258 </td>
11259
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11260 <td class="entry_tags">
11261 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]11262 <li><a href="#tag_DNG">DNG</a></li>
11263 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11264 </ul>
11265 </td>
11266
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11267 </tr>
11268 <tr class="entries_header">
11269 <th class="th_details" colspan="5">Details</th>
11270 </tr>
11271 <tr class="entry_cont">
11272 <td class="entry_details" colspan="5">
Zhijun Hebdc94c42014-01-21 18:28:30 -0800[diff] [blame]11273 <p>The maximum output resolution for raw format in
11274<a href="#static_android.scaler.availableRawSizes">android.<wbr/>scaler.<wbr/>available<wbr/>Raw<wbr/>Sizes</a> will be equal to this size.<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11275 </td>
11276 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11277
11278
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11279 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11280 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11281
11282
11283 <tr class="entry" id="static_android.sensor.info.whiteLevel">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11284 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11285 android.<wbr/>sensor.<wbr/>info.<wbr/>white<wbr/>Level
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11286 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11287 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]11288 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11289
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]11290 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11291
11292
11293 </td> <!-- entry_type -->
11294
11295 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11296 <p>Maximum raw value output by
11297sensor</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11298 </td>
11299
11300 <td class="entry_units">
11301 </td>
11302
11303 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame]11304 <p>&gt; 1024 (10-bit output)</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11305 </td>
11306
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11307 <td class="entry_tags">
11308 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]11309 <li><a href="#tag_DNG">DNG</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11310 </ul>
11311 </td>
11312
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11313 </tr>
11314 <tr class="entries_header">
11315 <th class="th_details" colspan="5">Details</th>
11316 </tr>
11317 <tr class="entry_cont">
11318 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11319 <p>Defines sensor bit depth (10-14 bits is
11320expected)</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11321 </td>
11322 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11323
11324
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11325 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11326 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11327
11328
11329
11330
11331
11332 <tr class="entry" id="static_android.sensor.baseGainFactor">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11333 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11334 android.<wbr/>sensor.<wbr/>base<wbr/>Gain<wbr/>Factor
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11335 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11336 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]11337 <span class="entry_type_name">rational</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11338
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]11339 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11340
11341
11342 </td> <!-- entry_type -->
11343
11344 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11345 <p>Gain factor from electrons to raw units when
11346ISO=100</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11347 </td>
11348
11349 <td class="entry_units">
11350 </td>
11351
11352 <td class="entry_range">
11353 </td>
11354
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11355 <td class="entry_tags">
11356 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]11357 <li><a href="#tag_V1">V1</a></li>
Alex Rayef40ad62013-10-01 17:52:33 -0700[diff] [blame]11358 <li><a href="#tag_FULL">FULL</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11359 </ul>
11360 </td>
11361
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11362 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11363
11364
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11365 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11366 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11367
11368
11369 <tr class="entry" id="static_android.sensor.blackLevelPattern">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11370 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11371 android.<wbr/>sensor.<wbr/>black<wbr/>Level<wbr/>Pattern
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11372 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11373 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]11374 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11375 <span class="entry_type_container">x</span>
11376
11377 <span class="entry_type_array">
11378 4
11379 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]11380 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11381 <div class="entry_type_notes">2x2 raw count block</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11382
11383
11384 </td> <!-- entry_type -->
11385
11386 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11387 <p>A fixed black level offset for each of the
11388Bayer mosaic channels</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11389 </td>
11390
11391 <td class="entry_units">
11392 </td>
11393
11394 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame]11395 <p>&gt;= 0 each</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11396 </td>
11397
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11398 <td class="entry_tags">
11399 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]11400 <li><a href="#tag_DNG">DNG</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11401 </ul>
11402 </td>
11403
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11404 </tr>
11405 <tr class="entries_header">
11406 <th class="th_details" colspan="5">Details</th>
11407 </tr>
11408 <tr class="entry_cont">
11409 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11410 <p>As per DNG BlackLevelRepeatDim /<wbr/> BlackLevel
11411tags</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11412 </td>
11413 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11414
11415
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11416 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11417 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11418
11419
11420 <tr class="entry" id="static_android.sensor.calibrationTransform1">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11421 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11422 android.<wbr/>sensor.<wbr/>calibration<wbr/>Transform1
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11423 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11424 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]11425 <span class="entry_type_name">rational</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11426 <span class="entry_type_container">x</span>
11427
11428 <span class="entry_type_array">
11429 9
11430 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]11431 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11432 <div class="entry_type_notes">3x3 matrix in row-major-order</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11433
11434
11435 </td> <!-- entry_type -->
11436
11437 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11438 <p>Per-device calibration on top of color space
11439transform 1</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11440 </td>
11441
11442 <td class="entry_units">
11443 </td>
11444
11445 <td class="entry_range">
11446 </td>
11447
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11448 <td class="entry_tags">
11449 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]11450 <li><a href="#tag_DNG">DNG</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11451 </ul>
11452 </td>
11453
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11454 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11455
11456
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11457 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11458 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11459
11460
11461 <tr class="entry" id="static_android.sensor.calibrationTransform2">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11462 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11463 android.<wbr/>sensor.<wbr/>calibration<wbr/>Transform2
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11464 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11465 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]11466 <span class="entry_type_name">rational</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11467 <span class="entry_type_container">x</span>
11468
11469 <span class="entry_type_array">
11470 9
11471 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]11472 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11473 <div class="entry_type_notes">3x3 matrix in row-major-order</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11474
11475
11476 </td> <!-- entry_type -->
11477
11478 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11479 <p>Per-device calibration on top of color space
11480transform 2</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11481 </td>
11482
11483 <td class="entry_units">
11484 </td>
11485
11486 <td class="entry_range">
11487 </td>
11488
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11489 <td class="entry_tags">
11490 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]11491 <li><a href="#tag_DNG">DNG</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11492 </ul>
11493 </td>
11494
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11495 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11496
11497
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11498 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11499 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11500
11501
11502 <tr class="entry" id="static_android.sensor.colorTransform1">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11503 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11504 android.<wbr/>sensor.<wbr/>color<wbr/>Transform1
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11505 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11506 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]11507 <span class="entry_type_name">rational</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11508 <span class="entry_type_container">x</span>
11509
11510 <span class="entry_type_array">
11511 9
11512 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]11513 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11514 <div class="entry_type_notes">3x3 matrix in row-major-order</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11515
11516
11517 </td> <!-- entry_type -->
11518
11519 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11520 <p>Linear mapping from XYZ (D50) color space to
11521reference linear sensor color,<wbr/> for first reference
11522illuminant</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11523 </td>
11524
11525 <td class="entry_units">
11526 </td>
11527
11528 <td class="entry_range">
11529 </td>
11530
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11531 <td class="entry_tags">
11532 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]11533 <li><a href="#tag_DNG">DNG</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11534 </ul>
11535 </td>
11536
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11537 </tr>
11538 <tr class="entries_header">
11539 <th class="th_details" colspan="5">Details</th>
11540 </tr>
11541 <tr class="entry_cont">
11542 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11543 <p>Use as follows XYZ = inv(transform) * clip( (raw -
11544black level(raw) ) /<wbr/> ( white level - max black level) ).<wbr/>
11545At least in the simple case</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11546 </td>
11547 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11548
11549
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11550 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11551 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11552
11553
11554 <tr class="entry" id="static_android.sensor.colorTransform2">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11555 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11556 android.<wbr/>sensor.<wbr/>color<wbr/>Transform2
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11557 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11558 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]11559 <span class="entry_type_name">rational</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11560 <span class="entry_type_container">x</span>
11561
11562 <span class="entry_type_array">
11563 9
11564 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]11565 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11566 <div class="entry_type_notes">3x3 matrix in row-major-order</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11567
11568
11569 </td> <!-- entry_type -->
11570
11571 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11572 <p>Linear mapping from XYZ (D50) color space to
11573reference linear sensor color,<wbr/> for second reference
11574illuminant</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11575 </td>
11576
11577 <td class="entry_units">
11578 </td>
11579
11580 <td class="entry_range">
11581 </td>
11582
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11583 <td class="entry_tags">
11584 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]11585 <li><a href="#tag_DNG">DNG</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11586 </ul>
11587 </td>
11588
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11589 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11590
11591
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11592 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11593 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11594
11595
11596 <tr class="entry" id="static_android.sensor.forwardMatrix1">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11597 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11598 android.<wbr/>sensor.<wbr/>forward<wbr/>Matrix1
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11599 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11600 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]11601 <span class="entry_type_name">rational</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11602 <span class="entry_type_container">x</span>
11603
11604 <span class="entry_type_array">
11605 9
11606 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]11607 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11608 <div class="entry_type_notes">3x3 matrix in row-major-order</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11609
11610
11611 </td> <!-- entry_type -->
11612
11613 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11614 <p>Used by DNG for better WB
11615adaptation</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11616 </td>
11617
11618 <td class="entry_units">
11619 </td>
11620
11621 <td class="entry_range">
11622 </td>
11623
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11624 <td class="entry_tags">
11625 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]11626 <li><a href="#tag_DNG">DNG</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11627 </ul>
11628 </td>
11629
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11630 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11631
11632
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11633 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11634 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11635
11636
11637 <tr class="entry" id="static_android.sensor.forwardMatrix2">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11638 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11639 android.<wbr/>sensor.<wbr/>forward<wbr/>Matrix2
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11640 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11641 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]11642 <span class="entry_type_name">rational</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11643 <span class="entry_type_container">x</span>
11644
11645 <span class="entry_type_array">
11646 9
11647 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]11648 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11649 <div class="entry_type_notes">3x3 matrix in row-major-order</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11650
11651
11652 </td> <!-- entry_type -->
11653
11654 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11655 <p>Used by DNG for better WB
11656adaptation</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11657 </td>
11658
11659 <td class="entry_units">
11660 </td>
11661
11662 <td class="entry_range">
11663 </td>
11664
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11665 <td class="entry_tags">
11666 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]11667 <li><a href="#tag_DNG">DNG</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11668 </ul>
11669 </td>
11670
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11671 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11672
11673
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11674 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11675 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11676
11677
11678 <tr class="entry" id="static_android.sensor.maxAnalogSensitivity">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11679 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11680 android.<wbr/>sensor.<wbr/>max<wbr/>Analog<wbr/>Sensitivity
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11681 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11682 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]11683 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11684
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]11685 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11686
11687
11688 </td> <!-- entry_type -->
11689
11690 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11691 <p>Maximum sensitivity that is implemented
Zhijun Hebdc94c42014-01-21 18:28:30 -0800[diff] [blame]11692purely through analog gain.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11693 </td>
11694
11695 <td class="entry_units">
11696 </td>
11697
11698 <td class="entry_range">
11699 </td>
11700
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11701 <td class="entry_tags">
11702 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]11703 <li><a href="#tag_V1">V1</a></li>
Alex Rayef40ad62013-10-01 17:52:33 -0700[diff] [blame]11704 <li><a href="#tag_FULL">FULL</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11705 </ul>
11706 </td>
11707
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11708 </tr>
11709 <tr class="entries_header">
11710 <th class="th_details" colspan="5">Details</th>
11711 </tr>
11712 <tr class="entry_cont">
11713 <td class="entry_details" colspan="5">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]11714 <p>For <a href="#controls_android.sensor.sensitivity">android.<wbr/>sensor.<wbr/>sensitivity</a> values less than or
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11715equal to this,<wbr/> all applied gain must be analog.<wbr/> For
Zhijun Hebdc94c42014-01-21 18:28:30 -0800[diff] [blame]11716values above this,<wbr/> the gain applied can be a mix of analog and
11717digital.<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11718 </td>
11719 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11720
11721
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11722 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11723 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11724
11725
11726 <tr class="entry" id="static_android.sensor.noiseModelCoefficients">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11727 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11728 android.<wbr/>sensor.<wbr/>noise<wbr/>Model<wbr/>Coefficients
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11729 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11730 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]11731 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11732 <span class="entry_type_container">x</span>
11733
11734 <span class="entry_type_array">
11735 2
11736 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]11737 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11738 <div class="entry_type_notes">float constants A,<wbr/> B for the noise variance model</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11739
11740
11741 </td> <!-- entry_type -->
11742
11743 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11744 <p>Estimation of sensor noise
11745characteristics</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11746 </td>
11747
11748 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11749 var(raw pixel value) = electrons * (baseGainFactor
11750 * iso/<wbr/>100)^2 + A * (baseGainFactor * iso/<wbr/>100)^2 +
11751 B
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11752 </td>
11753
11754 <td class="entry_range">
11755 </td>
11756
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11757 <td class="entry_tags">
11758 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]11759 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11760 </ul>
11761 </td>
11762
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11763 </tr>
11764 <tr class="entries_header">
11765 <th class="th_details" colspan="5">Details</th>
11766 </tr>
11767 <tr class="entry_cont">
11768 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11769 <p>A represents sensor read noise before analog
11770amplification; B represents noise from A/<wbr/>D conversion and
11771other circuits after amplification.<wbr/> Both noise sources
11772are assumed to be gaussian,<wbr/> independent,<wbr/> and not to vary
11773across the sensor</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11774 </td>
11775 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11776
11777
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11778 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11779 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11780
11781
11782 <tr class="entry" id="static_android.sensor.orientation">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11783 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11784 android.<wbr/>sensor.<wbr/>orientation
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11785 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11786 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]11787 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11788
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]11789 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11790
11791
11792 </td> <!-- entry_type -->
11793
11794 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11795 <p>Clockwise angle through which the output
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]11796image needs to be rotated to be upright on the device
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11797screen in its native orientation.<wbr/> Also defines the
11798direction of rolling shutter readout,<wbr/> which is from top
11799to bottom in the sensor's coordinate system</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11800 </td>
11801
11802 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11803 degrees clockwise rotation,<wbr/> only multiples of
11804 90
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11805 </td>
11806
11807 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]11808 <p>0,<wbr/>90,<wbr/>180,<wbr/>270</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11809 </td>
11810
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11811 <td class="entry_tags">
11812 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]11813 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11814 </ul>
11815 </td>
11816
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11817 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11818
11819
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11820 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11821 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11822
11823
11824 <tr class="entry" id="static_android.sensor.referenceIlluminant1">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11825 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11826 android.<wbr/>sensor.<wbr/>reference<wbr/>Illuminant1
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11827 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11828 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]11829 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11830
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]11831 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11832
11833 <ul class="entry_type_enum">
11834 <li>
11835 <span class="entry_type_enum_name">DAYLIGHT</span>
11836 <span class="entry_type_enum_value">1</span>
11837 </li>
11838 <li>
11839 <span class="entry_type_enum_name">FLUORESCENT</span>
11840 <span class="entry_type_enum_value">2</span>
11841 </li>
11842 <li>
11843 <span class="entry_type_enum_name">TUNGSTEN</span>
11844 <span class="entry_type_enum_value">3</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]11845 <span class="entry_type_enum_notes"><p>Incandescent light</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11846 </li>
11847 <li>
11848 <span class="entry_type_enum_name">FLASH</span>
11849 <span class="entry_type_enum_value">4</span>
11850 </li>
11851 <li>
11852 <span class="entry_type_enum_name">FINE_WEATHER</span>
11853 <span class="entry_type_enum_value">9</span>
11854 </li>
11855 <li>
11856 <span class="entry_type_enum_name">CLOUDY_WEATHER</span>
11857 <span class="entry_type_enum_value">10</span>
11858 </li>
11859 <li>
11860 <span class="entry_type_enum_name">SHADE</span>
11861 <span class="entry_type_enum_value">11</span>
11862 </li>
11863 <li>
11864 <span class="entry_type_enum_name">DAYLIGHT_FLUORESCENT</span>
11865 <span class="entry_type_enum_value">12</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]11866 <span class="entry_type_enum_notes"><p>D 5700 - 7100K</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11867 </li>
11868 <li>
11869 <span class="entry_type_enum_name">DAY_WHITE_FLUORESCENT</span>
11870 <span class="entry_type_enum_value">13</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]11871 <span class="entry_type_enum_notes"><p>N 4600 - 5400K</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11872 </li>
11873 <li>
11874 <span class="entry_type_enum_name">COOL_WHITE_FLUORESCENT</span>
11875 <span class="entry_type_enum_value">14</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]11876 <span class="entry_type_enum_notes"><p>W 3900 - 4500K</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11877 </li>
11878 <li>
11879 <span class="entry_type_enum_name">WHITE_FLUORESCENT</span>
11880 <span class="entry_type_enum_value">15</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]11881 <span class="entry_type_enum_notes"><p>WW 3200 - 3700K</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11882 </li>
11883 <li>
11884 <span class="entry_type_enum_name">STANDARD_A</span>
11885 <span class="entry_type_enum_value">17</span>
11886 </li>
11887 <li>
11888 <span class="entry_type_enum_name">STANDARD_B</span>
11889 <span class="entry_type_enum_value">18</span>
11890 </li>
11891 <li>
11892 <span class="entry_type_enum_name">STANDARD_C</span>
11893 <span class="entry_type_enum_value">19</span>
11894 </li>
11895 <li>
11896 <span class="entry_type_enum_name">D55</span>
11897 <span class="entry_type_enum_value">20</span>
11898 </li>
11899 <li>
11900 <span class="entry_type_enum_name">D65</span>
11901 <span class="entry_type_enum_value">21</span>
11902 </li>
11903 <li>
11904 <span class="entry_type_enum_name">D75</span>
11905 <span class="entry_type_enum_value">22</span>
11906 </li>
11907 <li>
11908 <span class="entry_type_enum_name">D50</span>
11909 <span class="entry_type_enum_value">23</span>
11910 </li>
11911 <li>
11912 <span class="entry_type_enum_name">ISO_STUDIO_TUNGSTEN</span>
11913 <span class="entry_type_enum_value">24</span>
11914 </li>
11915 </ul>
11916
11917 </td> <!-- entry_type -->
11918
11919 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11920 <p>Light source used to define transform
119211</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11922 </td>
11923
11924 <td class="entry_units">
11925 </td>
11926
11927 <td class="entry_range">
11928 </td>
11929
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11930 <td class="entry_tags">
11931 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]11932 <li><a href="#tag_DNG">DNG</a></li>
11933 <li><a href="#tag_EXIF">EXIF</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11934 </ul>
11935 </td>
11936
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11937 </tr>
11938 <tr class="entries_header">
11939 <th class="th_details" colspan="5">Details</th>
11940 </tr>
11941 <tr class="entry_cont">
11942 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11943 <p>[EXIF LightSource tag] Must all these be
11944supported? Need CCT for each!</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11945 </td>
11946 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11947
11948
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11949 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11950 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11951
11952
11953 <tr class="entry" id="static_android.sensor.referenceIlluminant2">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11954 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11955 android.<wbr/>sensor.<wbr/>reference<wbr/>Illuminant2
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11956 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11957 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]11958 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11959
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]11960 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11961
11962
11963 </td> <!-- entry_type -->
11964
11965 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11966 <p>Light source used to define transform
119672</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11968 </td>
11969
11970 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11971 Same as illuminant 1
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11972 </td>
11973
11974 <td class="entry_range">
11975 </td>
11976
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11977 <td class="entry_tags">
11978 </td>
11979
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11980 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11981
11982
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11983 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11984 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11985
Igor Murashkina46e02f2014-01-09 17:43:38 -0800[diff] [blame]11986
11987 <tr class="entry" id="static_android.sensor.availableTestPatternModes">
11988 <td class="entry_name" rowspan="1">
11989 android.<wbr/>sensor.<wbr/>available<wbr/>Test<wbr/>Pattern<wbr/>Modes
11990 </td>
11991 <td class="entry_type">
11992 <span class="entry_type_name">byte</span>
11993
11994 <span class="entry_type_visibility"> [public]</span>
11995
11996
11997 </td> <!-- entry_type -->
11998
11999 <td class="entry_description">
12000 <p>Optional.<wbr/> Defaults to [OFF].<wbr/> Lists the supported test
12001pattern modes for android.<wbr/>test.<wbr/>pattern<wbr/>Mode.<wbr/></p>
12002 </td>
12003
12004 <td class="entry_units">
12005 </td>
12006
12007 <td class="entry_range">
12008 <p>Must include OFF.<wbr/> All custom modes must be &gt;= CUSTOM1</p>
12009 </td>
12010
12011 <td class="entry_tags">
12012 </td>
12013
12014 </tr>
12015
12016
12017 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
12018 <!-- end of entry -->
12019
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12020
12021
12022 <!-- end of kind -->
12023 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12024 <tr><td colspan="6" class="kind">dynamic</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12025
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]12026 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12027 <tr>
12028 <th class="th_name">Property Name</th>
12029 <th class="th_type">Type</th>
12030 <th class="th_description">Description</th>
12031 <th class="th_units">Units</th>
12032 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12033 <th class="th_tags">Tags</th>
12034 </tr>
12035 </thead>
12036
12037 <tbody>
12038
12039
12040
12041
12042
12043
12044
12045
12046
12047
12048 <tr class="entry" id="dynamic_android.sensor.exposureTime">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12049 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12050 android.<wbr/>sensor.<wbr/>exposure<wbr/>Time
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12051 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12052 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]12053 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12054
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]12055 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12056
12057
12058 </td> <!-- entry_type -->
12059
12060 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12061 <p>Duration each pixel is exposed to
12062light.<wbr/></p>
12063<p>If the sensor can't expose this exact duration,<wbr/> it should shorten the
12064duration exposed to the nearest possible value (rather than expose longer).<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12065 </td>
12066
12067 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12068 nanoseconds
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12069 </td>
12070
12071 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]12072 <p><a href="#static_android.sensor.info.exposureTimeRange">android.<wbr/>sensor.<wbr/>info.<wbr/>exposure<wbr/>Time<wbr/>Range</a></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12073 </td>
12074
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12075 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]12076 <ul class="entry_tags">
12077 <li><a href="#tag_V1">V1</a></li>
12078 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12079 </td>
12080
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12081 </tr>
12082 <tr class="entries_header">
12083 <th class="th_details" colspan="5">Details</th>
12084 </tr>
12085 <tr class="entry_cont">
12086 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12087 <p>1/<wbr/>10000 - 30 sec range.<wbr/> No bulb mode</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12088 </td>
12089 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12090
12091
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12092 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
12093 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12094
12095
12096 <tr class="entry" id="dynamic_android.sensor.frameDuration">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12097 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12098 android.<wbr/>sensor.<wbr/>frame<wbr/>Duration
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12099 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12100 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]12101 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12102
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]12103 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12104
12105
12106 </td> <!-- entry_type -->
12107
12108 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12109 <p>Duration from start of frame exposure to
Igor Murashkin10f4e0f2014-01-13 17:22:58 -0800[diff] [blame]12110start of next frame exposure.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12111 </td>
12112
12113 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12114 nanoseconds
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12115 </td>
12116
12117 <td class="entry_range">
Igor Murashkin10f4e0f2014-01-13 17:22:58 -0800[diff] [blame]12118 <p>See <a href="#static_android.sensor.info.maxFrameDuration">android.<wbr/>sensor.<wbr/>info.<wbr/>max<wbr/>Frame<wbr/>Duration</a>,<wbr/>
12119android.<wbr/>scaler.<wbr/>available*Min<wbr/>Durations.<wbr/> The duration
12120is capped to <code>max(duration,<wbr/> exposureTime + overhead)</code>.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12121 </td>
12122
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12123 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]12124 <ul class="entry_tags">
12125 <li><a href="#tag_V1">V1</a></li>
12126 <li><a href="#tag_BC">BC</a></li>
12127 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12128 </td>
12129
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12130 </tr>
12131 <tr class="entries_header">
12132 <th class="th_details" colspan="5">Details</th>
12133 </tr>
12134 <tr class="entry_cont">
12135 <td class="entry_details" colspan="5">
Igor Murashkin10f4e0f2014-01-13 17:22:58 -0800[diff] [blame]12136 <p>The maximum frame rate that can be supported by a camera subsystem is
12137a function of many factors:</p>
12138<ul>
12139<li>Requested resolutions of output image streams</li>
12140<li>Availability of binning /<wbr/> skipping modes on the imager</li>
12141<li>The bandwidth of the imager interface</li>
12142<li>The bandwidth of the various ISP processing blocks</li>
12143</ul>
12144<p>Since these factors can vary greatly between different ISPs and
12145sensors,<wbr/> the camera abstraction tries to represent the bandwidth
12146restrictions with as simple a model as possible.<wbr/></p>
12147<p>The model presented has the following characteristics:</p>
12148<ul>
12149<li>The image sensor is always configured to output the smallest
12150resolution possible given the application's requested output stream
12151sizes.<wbr/> The smallest resolution is defined as being at least as large
12152as the largest requested output stream size; the camera pipeline must
12153never digitally upsample sensor data when the crop region covers the
12154whole sensor.<wbr/> In general,<wbr/> this means that if only small output stream
12155resolutions are configured,<wbr/> the sensor can provide a higher frame
12156rate.<wbr/></li>
12157<li>Since any request may use any or all the currently configured
12158output streams,<wbr/> the sensor and ISP must be configured to support
12159scaling a single capture to all the streams at the same time.<wbr/> This
12160means the camera pipeline must be ready to produce the largest
12161requested output size without any delay.<wbr/> Therefore,<wbr/> the overall
12162frame rate of a given configured stream set is governed only by the
12163largest requested stream resolution.<wbr/></li>
12164<li>Using more than one output stream in a request does not affect the
12165frame duration.<wbr/></li>
12166<li>JPEG streams act like processed YUV streams in requests for which
12167they are not included; in requests in which they are directly
12168referenced,<wbr/> they act as JPEG streams.<wbr/> This is because supporting a
12169JPEG stream requires the underlying YUV data to always be ready for
12170use by a JPEG encoder,<wbr/> but the encoder will only be used (and impact
12171frame duration) on requests that actually reference a JPEG stream.<wbr/></li>
12172<li>The JPEG processor can run concurrently to the rest of the camera
12173pipeline,<wbr/> but cannot process more than 1 capture at a time.<wbr/></li>
12174</ul>
12175<p>The necessary information for the application,<wbr/> given the model above,<wbr/>
12176is provided via the android.<wbr/>scaler.<wbr/>available*Min<wbr/>Durations fields.<wbr/>
12177These are used to determine the maximum frame rate /<wbr/> minimum frame
12178duration that is possible for a given stream configuration.<wbr/></p>
12179<p>Specifically,<wbr/> the application can use the following rules to
12180determine the minimum frame duration it can request from the HAL
12181device:</p>
12182<ol>
12183<li>Given the application's currently configured set of output
12184streams,<wbr/> <code>S</code>,<wbr/> divide them into three sets: streams in a JPEG format
12185<code>SJ</code>,<wbr/> streams in a raw sensor format <code>SR</code>,<wbr/> and the rest ('processed')
12186<code>SP</code>.<wbr/></li>
12187<li>For each subset of streams,<wbr/> find the largest resolution (by pixel
12188count) in the subset.<wbr/> This gives (at most) three resolutions <code>RJ</code>,<wbr/>
12189<code>RR</code>,<wbr/> and <code>RP</code>.<wbr/></li>
12190<li>If <code>RJ</code> is greater than <code>RP</code>,<wbr/> set <code>RP</code> equal to <code>RJ</code>.<wbr/> If there is
12191no exact match for <code>RP == RJ</code> (in particular there isn't an available
12192processed resolution at the same size as <code>RJ</code>),<wbr/> then set <code>RP</code> equal
12193to the smallest processed resolution that is larger than <code>RJ</code>.<wbr/> If
12194there are no processed resolutions larger than <code>RJ</code>,<wbr/> then set <code>RJ</code> to
12195the processed resolution closest to <code>RJ</code>.<wbr/></li>
12196<li>If <code>RP</code> is greater than <code>RR</code>,<wbr/> set <code>RR</code> equal to <code>RP</code>.<wbr/> If there is
12197no exact match for <code>RR == RP</code> (in particular there isn't an available
12198raw resolution at the same size as <code>RP</code>),<wbr/> then set <code>RR</code> equal to
12199or to the smallest raw resolution that is larger than <code>RP</code>.<wbr/> If
12200there are no raw resolutions larger than <code>RP</code>,<wbr/> then set <code>RR</code> to
12201the raw resolution closest to <code>RP</code>.<wbr/></li>
12202<li>Look up the matching minimum frame durations in the property lists
12203<a href="#static_android.scaler.availableJpegMinDurations">android.<wbr/>scaler.<wbr/>available<wbr/>Jpeg<wbr/>Min<wbr/>Durations</a>,<wbr/>
12204<a href="#static_android.scaler.availableRawMinDurations">android.<wbr/>scaler.<wbr/>available<wbr/>Raw<wbr/>Min<wbr/>Durations</a>,<wbr/> and
12205<a href="#static_android.scaler.availableProcessedMinDurations">android.<wbr/>scaler.<wbr/>available<wbr/>Processed<wbr/>Min<wbr/>Durations</a>.<wbr/> This gives three
12206minimum frame durations <code>FJ</code>,<wbr/> <code>FR</code>,<wbr/> and <code>FP</code>.<wbr/></li>
12207<li>If a stream of requests do not use a JPEG stream,<wbr/> then the minimum
12208supported frame duration for each request is <code>max(FR,<wbr/> FP)</code>.<wbr/></li>
12209<li>If a stream of requests all use the JPEG stream,<wbr/> then the minimum
12210supported frame duration for each request is <code>max(FR,<wbr/> FP,<wbr/> FJ)</code>.<wbr/></li>
12211<li>If a mix of JPEG-using and non-JPEG-using requests is submitted by
12212the application,<wbr/> then the HAL will have to delay JPEG-using requests
12213whenever the JPEG encoder is still busy processing an older capture.<wbr/>
12214This will happen whenever a JPEG-using request starts capture less
12215than <code>FJ</code> <em>ns</em> after a previous JPEG-using request.<wbr/> The minimum
12216supported frame duration will vary between the values calculated in
12217#6 and #7.<wbr/></li>
12218</ol>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12219 </td>
12220 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12221
12222
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12223 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
12224 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12225
12226
12227 <tr class="entry" id="dynamic_android.sensor.sensitivity">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12228 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12229 android.<wbr/>sensor.<wbr/>sensitivity
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12230 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12231 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]12232 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12233
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]12234 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12235
12236
12237 </td> <!-- entry_type -->
12238
12239 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12240 <p>Gain applied to image data.<wbr/> Must be
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]12241implemented through analog gain only if set to values
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12242below 'maximum analog sensitivity'.<wbr/></p>
12243<p>If the sensor can't apply this exact gain,<wbr/> it should lessen the
12244gain to the nearest possible value (rather than gain more).<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12245 </td>
12246
12247 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12248 ISO arithmetic units
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12249 </td>
12250
12251 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]12252 <p><a href="#static_android.sensor.info.sensitivityRange">android.<wbr/>sensor.<wbr/>info.<wbr/>sensitivity<wbr/>Range</a></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12253 </td>
12254
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12255 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]12256 <ul class="entry_tags">
12257 <li><a href="#tag_V1">V1</a></li>
12258 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12259 </td>
12260
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12261 </tr>
12262 <tr class="entries_header">
12263 <th class="th_details" colspan="5">Details</th>
12264 </tr>
12265 <tr class="entry_cont">
12266 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12267 <p>ISO 12232:2006 REI method</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12268 </td>
12269 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12270
12271
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12272 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
12273 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12274
12275
12276 <tr class="entry" id="dynamic_android.sensor.timestamp">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12277 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12278 android.<wbr/>sensor.<wbr/>timestamp
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12279 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12280 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]12281 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12282
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]12283 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12284
12285
12286 </td> <!-- entry_type -->
12287
12288 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12289 <p>Time at start of exposure of first
12290row</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12291 </td>
12292
12293 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12294 nanoseconds
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12295 </td>
12296
12297 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame]12298 <p>&gt; 0</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12299 </td>
12300
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12301 <td class="entry_tags">
12302 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]12303 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12304 </ul>
12305 </td>
12306
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12307 </tr>
12308 <tr class="entries_header">
12309 <th class="th_details" colspan="5">Details</th>
12310 </tr>
12311 <tr class="entry_cont">
12312 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12313 <p>Monotonic,<wbr/> should be synced to other timestamps in
12314system</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12315 </td>
12316 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12317
12318
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12319 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
12320 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12321
Igor Murashkin656aa5a2013-08-13 14:23:39 -0700[diff] [blame]12322
12323 <tr class="entry" id="dynamic_android.sensor.temperature">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12324 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12325 android.<wbr/>sensor.<wbr/>temperature
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12326 </td>
Igor Murashkin656aa5a2013-08-13 14:23:39 -0700[diff] [blame]12327 <td class="entry_type">
12328 <span class="entry_type_name">float</span>
12329
12330 <span class="entry_type_visibility"> [public]</span>
12331
12332
12333 </td> <!-- entry_type -->
12334
12335 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12336 <p>The temperature of the sensor,<wbr/> sampled at the time
12337exposure began for this frame.<wbr/></p>
12338<p>The thermal diode being queried should be inside the sensor PCB,<wbr/> or
12339somewhere close to it.<wbr/></p>
Igor Murashkin656aa5a2013-08-13 14:23:39 -0700[diff] [blame]12340 </td>
12341
12342 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12343 celsius
Igor Murashkin656aa5a2013-08-13 14:23:39 -0700[diff] [blame]12344 </td>
12345
12346 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]12347 <p>Optional.<wbr/> This value is missing if no temperature is available.<wbr/></p>
Igor Murashkin656aa5a2013-08-13 14:23:39 -0700[diff] [blame]12348 </td>
12349
Igor Murashkin656aa5a2013-08-13 14:23:39 -0700[diff] [blame]12350 <td class="entry_tags">
Alex Rayef40ad62013-10-01 17:52:33 -0700[diff] [blame]12351 <ul class="entry_tags">
12352 <li><a href="#tag_FULL">FULL</a></li>
12353 </ul>
Igor Murashkin656aa5a2013-08-13 14:23:39 -0700[diff] [blame]12354 </td>
12355
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12356 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12357
12358
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12359 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
12360 <!-- end of entry -->
Igor Murashkin656aa5a2013-08-13 14:23:39 -0700[diff] [blame]12361
Igor Murashkina46e02f2014-01-09 17:43:38 -0800[diff] [blame]12362
12363 <tr class="entry" id="dynamic_android.sensor.testPatternMode">
12364 <td class="entry_name" rowspan="5">
12365 android.<wbr/>sensor.<wbr/>test<wbr/>Pattern<wbr/>Mode
12366 </td>
12367 <td class="entry_type">
12368 <span class="entry_type_name entry_type_name_enum">int32</span>
12369
12370 <span class="entry_type_visibility"> [public]</span>
12371
12372 <ul class="entry_type_enum">
12373 <li>
12374 <span class="entry_type_enum_name">OFF</span>
12375 <span class="entry_type_enum_notes"><p>Default.<wbr/> No test pattern mode is used,<wbr/> and the camera
12376device returns captures from the image sensor.<wbr/></p></span>
12377 </li>
12378 <li>
12379 <span class="entry_type_enum_name">SOLID_COLOR</span>
12380 <span class="entry_type_enum_notes"><p>Each pixel in <code>[R,<wbr/> G_<wbr/>even,<wbr/> G_<wbr/>odd,<wbr/> B]</code> is replaced by its
12381respective color channel provided in
12382<a href="#controls_android.sensor.testPatternData">android.<wbr/>sensor.<wbr/>test<wbr/>Pattern<wbr/>Data</a>.<wbr/></p>
12383<p>For example:</p>
12384<pre><code>android.<wbr/>testPatternData = [0,<wbr/> 0xFFFFFFFF,<wbr/> 0xFFFFFFFF,<wbr/> 0]
12385</code></pre>
12386<p>All green pixels are 100% green.<wbr/> All red/<wbr/>blue pixels are black.<wbr/></p>
12387<pre><code>android.<wbr/>testPatternData = [0xFFFFFFFF,<wbr/> 0,<wbr/> 0xFFFFFFFF,<wbr/> 0]
12388</code></pre>
12389<p>All red pixels are 100% red.<wbr/> Only the odd green pixels
12390are 100% green.<wbr/> All blue pixels are 100% black.<wbr/></p></span>
12391 </li>
12392 <li>
12393 <span class="entry_type_enum_name">COLOR_BARS</span>
12394 <span class="entry_type_enum_notes"><p>All pixel data is replaced with an 8-bar color pattern.<wbr/></p>
12395<p>The vertical bars (left-to-right) are as follows:</p>
12396<ul>
12397<li>100% white</li>
12398<li>yellow</li>
12399<li>cyan</li>
12400<li>green</li>
12401<li>magenta</li>
12402<li>red</li>
12403<li>blue</li>
12404<li>black</li>
12405</ul>
12406<p>In general the image would look like the following:</p>
12407<pre><code>W Y C G M R B K
12408W Y C G M R B K
12409W Y C G M R B K
12410W Y C G M R B K
12411W Y C G M R B K
12412.<wbr/> .<wbr/> .<wbr/> .<wbr/> .<wbr/> .<wbr/> .<wbr/> .<wbr/>
12413.<wbr/> .<wbr/> .<wbr/> .<wbr/> .<wbr/> .<wbr/> .<wbr/> .<wbr/>
12414.<wbr/> .<wbr/> .<wbr/> .<wbr/> .<wbr/> .<wbr/> .<wbr/> .<wbr/>
12415
12416(B = Blue,<wbr/> K = Black)
12417</code></pre>
12418<p>Each bar should take up 1/<wbr/>8 of the sensor pixel array width.<wbr/>
12419When this is not possible,<wbr/> the bar size should be rounded
12420down to the nearest integer and the pattern can repeat
12421on the right side.<wbr/></p>
12422<p>Each bar's height must always take up the full sensor
12423pixel array height.<wbr/></p>
12424<p>Each pixel in this test pattern must be set to either
124250% intensity or 100% intensity.<wbr/></p></span>
12426 </li>
12427 <li>
12428 <span class="entry_type_enum_name">COLOR_BARS_FADE_TO_GRAY</span>
12429 <span class="entry_type_enum_notes"><p>The test pattern is similar to COLOR_<wbr/>BARS,<wbr/> except that
12430each bar should start at its specified color at the top,<wbr/>
12431and fade to gray at the bottom.<wbr/></p>
12432<p>Furthermore each bar is further subdivided into a left and
12433right half.<wbr/> The left half should have a smooth gradient,<wbr/>
12434and the right half should have a quantized gradient.<wbr/></p>
12435<p>In particular,<wbr/> the right half's should consist of blocks of the
12436same color for 1/<wbr/>16th active sensor pixel array width.<wbr/></p>
12437<p>The least significant bits in the quantized gradient should
12438be copied from the most significant bits of the smooth gradient.<wbr/></p>
12439<p>The height of each bar should always be a multiple of 128.<wbr/>
12440When this is not the case,<wbr/> the pattern should repeat at the bottom
12441of the image.<wbr/></p></span>
12442 </li>
12443 <li>
12444 <span class="entry_type_enum_name">PN9</span>
12445 <span class="entry_type_enum_notes"><p>All pixel data is replaced by a pseudo-random sequence
12446generated from a PN9 512-bit sequence (typically implemented
12447in hardware with a linear feedback shift register).<wbr/></p>
12448<p>The generator should be reset at the beginning of each frame,<wbr/>
12449and thus each subsequent raw frame with this test pattern should
12450be exactly the same as the last.<wbr/></p></span>
12451 </li>
12452 <li>
12453 <span class="entry_type_enum_name">CUSTOM1</span>
12454 <span class="entry_type_enum_value">256</span>
12455 <span class="entry_type_enum_notes"><p>The first custom test pattern.<wbr/> All custom patterns that are
12456available only on this camera device are at least this numeric
12457value.<wbr/></p>
12458<p>All of the custom test patterns will be static
12459(that is the raw image must not vary from frame to frame).<wbr/></p></span>
12460 </li>
12461 </ul>
12462
12463 </td> <!-- entry_type -->
12464
12465 <td class="entry_description">
12466 <p>When enabled,<wbr/> the sensor sends a test pattern instead of
12467doing a real exposure from the camera.<wbr/></p>
12468 </td>
12469
12470 <td class="entry_units">
12471 </td>
12472
12473 <td class="entry_range">
12474 <p>Optional.<wbr/> Defaults to OFF.<wbr/> Value must be one of
12475<a href="#static_android.sensor.availableTestPatternModes">android.<wbr/>sensor.<wbr/>available<wbr/>Test<wbr/>Pattern<wbr/>Modes</a></p>
12476 </td>
12477
12478 <td class="entry_tags">
12479 </td>
12480
12481 </tr>
12482 <tr class="entries_header">
12483 <th class="th_details" colspan="5">Details</th>
12484 </tr>
12485 <tr class="entry_cont">
12486 <td class="entry_details" colspan="5">
12487 <p>When a test pattern is enabled,<wbr/> all manual sensor controls specified
12488by android.<wbr/>sensor.<wbr/>* should be ignored.<wbr/> All other controls should
12489work as normal.<wbr/></p>
12490<p>For example,<wbr/> if manual flash is enabled,<wbr/> flash firing should still
12491occur (and that the test pattern remain unmodified,<wbr/> since the flash
12492would not actually affect it).<wbr/></p>
12493 </td>
12494 </tr>
12495
12496 <tr class="entries_header">
12497 <th class="th_details" colspan="5">HAL Implementation Details</th>
12498 </tr>
12499 <tr class="entry_cont">
12500 <td class="entry_details" colspan="5">
12501 <p>All test patterns are specified in the Bayer domain.<wbr/></p>
12502<p>The HAL may choose to substitute test patterns from the sensor
12503with test patterns from on-device memory.<wbr/> In that case,<wbr/> it should be
12504indistinguishable to the ISP whether the data came from the
12505sensor interconnect bus (such as CSI2) or memory.<wbr/></p>
12506 </td>
12507 </tr>
12508
12509 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
12510 <!-- end of entry -->
12511
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12512
12513
12514 <!-- end of kind -->
12515 </tbody>
12516
12517 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12518 <tr><td colspan="6" id="section_shading" class="section">shading</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12519
12520
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12521 <tr><td colspan="6" class="kind">controls</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12522
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]12523 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12524 <tr>
12525 <th class="th_name">Property Name</th>
12526 <th class="th_type">Type</th>
12527 <th class="th_description">Description</th>
12528 <th class="th_units">Units</th>
12529 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12530 <th class="th_tags">Tags</th>
12531 </tr>
12532 </thead>
12533
12534 <tbody>
12535
12536
12537
12538
12539
12540
12541
12542
12543
12544
12545 <tr class="entry" id="controls_android.shading.mode">
Zhijun He2f86a212014-01-15 10:34:02 -0800[diff] [blame]12546 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12547 android.<wbr/>shading.<wbr/>mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12548 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12549 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]12550 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12551
Zhijun He2f86a212014-01-15 10:34:02 -0800[diff] [blame]12552 <span class="entry_type_visibility"> [hidden]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12553
12554 <ul class="entry_type_enum">
12555 <li>
12556 <span class="entry_type_enum_name">OFF</span>
Zhijun He2f86a212014-01-15 10:34:02 -0800[diff] [blame]12557 <span class="entry_type_enum_notes"><p>No lens shading correction is applied</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12558 </li>
12559 <li>
12560 <span class="entry_type_enum_name">FAST</span>
Zhijun He2f86a212014-01-15 10:34:02 -0800[diff] [blame]12561 <span class="entry_type_enum_notes"><p>Must not slow down frame rate relative to sensor raw output</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12562 </li>
12563 <li>
12564 <span class="entry_type_enum_name">HIGH_QUALITY</span>
Zhijun He2f86a212014-01-15 10:34:02 -0800[diff] [blame]12565 <span class="entry_type_enum_notes"><p>Frame rate may be reduced by high quality</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12566 </li>
12567 </ul>
12568
12569 </td> <!-- entry_type -->
12570
12571 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12572 <p>Quality of lens shading correction applied
Zhijun He2f86a212014-01-15 10:34:02 -0800[diff] [blame]12573to the image data.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12574 </td>
12575
12576 <td class="entry_units">
12577 </td>
12578
12579 <td class="entry_range">
12580 </td>
12581
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12582 <td class="entry_tags">
12583 </td>
12584
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12585 </tr>
Zhijun He2f86a212014-01-15 10:34:02 -0800[diff] [blame]12586 <tr class="entries_header">
12587 <th class="th_details" colspan="5">Details</th>
12588 </tr>
12589 <tr class="entry_cont">
12590 <td class="entry_details" colspan="5">
12591 <p>When set to OFF mode,<wbr/> no lens shading correction will be applied by the
12592camera device,<wbr/> and an identity lens shading map data will be provided
12593if <code><a href="#controls_android.statistics.lensShadingMapMode">android.<wbr/>statistics.<wbr/>lens<wbr/>Shading<wbr/>Map<wbr/>Mode</a> == ON</code>.<wbr/> For example,<wbr/> for lens
12594shading map with size specified as <code><a href="#static_android.lens.info.shadingMapSize">android.<wbr/>lens.<wbr/>info.<wbr/>shading<wbr/>Map<wbr/>Size</a> = [ 4,<wbr/> 3 ]</code>,<wbr/>
12595the output <a href="#dynamic_android.statistics.lensShadingMap">android.<wbr/>statistics.<wbr/>lens<wbr/>Shading<wbr/>Map</a> for this case will be an identity map
12596shown below:</p>
12597<pre><code>[ 1.<wbr/>0,<wbr/> 1.<wbr/>0,<wbr/> 1.<wbr/>0,<wbr/> 1.<wbr/>0,<wbr/> 1.<wbr/>0,<wbr/> 1.<wbr/>0,<wbr/> 1.<wbr/>0,<wbr/> 1.<wbr/>0,<wbr/>
12598 1.<wbr/>0,<wbr/> 1.<wbr/>0,<wbr/> 1.<wbr/>0,<wbr/> 1.<wbr/>0,<wbr/> 1.<wbr/>0,<wbr/> 1.<wbr/>0,<wbr/> 1.<wbr/>0,<wbr/> 1.<wbr/>0,<wbr/>
12599 1.<wbr/>0,<wbr/> 1.<wbr/>0,<wbr/> 1.<wbr/>0,<wbr/> 1.<wbr/>0,<wbr/> 1.<wbr/>0,<wbr/> 1.<wbr/>0,<wbr/> 1.<wbr/>0,<wbr/> 1.<wbr/>0,<wbr/>
12600 1.<wbr/>0,<wbr/> 1.<wbr/>0,<wbr/> 1.<wbr/>0,<wbr/> 1.<wbr/>0,<wbr/> 1.<wbr/>0,<wbr/> 1.<wbr/>0,<wbr/> 1.<wbr/>0,<wbr/> 1.<wbr/>0,<wbr/>
12601 1.<wbr/>0,<wbr/> 1.<wbr/>0,<wbr/> 1.<wbr/>0,<wbr/> 1.<wbr/>0,<wbr/> 1.<wbr/>0,<wbr/> 1.<wbr/>0,<wbr/> 1.<wbr/>0,<wbr/> 1.<wbr/>0,<wbr/>
12602 1.<wbr/>0,<wbr/> 1.<wbr/>0,<wbr/> 1.<wbr/>0,<wbr/> 1.<wbr/>0,<wbr/> 1.<wbr/>0,<wbr/> 1.<wbr/>0,<wbr/> 1.<wbr/>0,<wbr/> 1.<wbr/>0 ]
12603</code></pre>
12604<p>When set to other modes,<wbr/> lens shading correction will be applied by the
12605camera device.<wbr/> Applications can request lens shading map data by setting
12606<a href="#controls_android.statistics.lensShadingMapMode">android.<wbr/>statistics.<wbr/>lens<wbr/>Shading<wbr/>Map<wbr/>Mode</a> to ON,<wbr/> and then the camera device will provide
12607lens shading map data in <a href="#dynamic_android.statistics.lensShadingMap">android.<wbr/>statistics.<wbr/>lens<wbr/>Shading<wbr/>Map</a>,<wbr/> with size specified
12608by <a href="#static_android.lens.info.shadingMapSize">android.<wbr/>lens.<wbr/>info.<wbr/>shading<wbr/>Map<wbr/>Size</a>.<wbr/></p>
12609 </td>
12610 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12611
12612
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12613 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
12614 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12615
12616
12617 <tr class="entry" id="controls_android.shading.strength">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12618 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12619 android.<wbr/>shading.<wbr/>strength
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12620 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12621 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]12622 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12623
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]12624 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12625
12626
12627 </td> <!-- entry_type -->
12628
12629 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12630 <p>Control the amount of shading correction
12631applied to the images</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12632 </td>
12633
12634 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12635 unitless: 1-10; 10 is full shading
12636 compensation
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12637 </td>
12638
12639 <td class="entry_range">
12640 </td>
12641
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12642 <td class="entry_tags">
12643 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]12644 <li><a href="#tag_ADV">ADV</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12645 </ul>
12646 </td>
12647
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12648 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12649
12650
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12651 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
12652 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12653
12654
12655
12656 <!-- end of kind -->
12657 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12658 <tr><td colspan="6" class="kind">dynamic</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12659
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]12660 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12661 <tr>
12662 <th class="th_name">Property Name</th>
12663 <th class="th_type">Type</th>
12664 <th class="th_description">Description</th>
12665 <th class="th_units">Units</th>
12666 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12667 <th class="th_tags">Tags</th>
12668 </tr>
12669 </thead>
12670
12671 <tbody>
12672
12673
12674
12675
12676
12677
12678
12679
12680
12681
12682 <tr class="entry" id="dynamic_android.shading.mode">
Zhijun He2f86a212014-01-15 10:34:02 -0800[diff] [blame]12683 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12684 android.<wbr/>shading.<wbr/>mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12685 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12686 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]12687 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12688
Zhijun He2f86a212014-01-15 10:34:02 -0800[diff] [blame]12689 <span class="entry_type_visibility"> [hidden]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12690
12691 <ul class="entry_type_enum">
12692 <li>
12693 <span class="entry_type_enum_name">OFF</span>
Zhijun He2f86a212014-01-15 10:34:02 -0800[diff] [blame]12694 <span class="entry_type_enum_notes"><p>No lens shading correction is applied</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12695 </li>
12696 <li>
12697 <span class="entry_type_enum_name">FAST</span>
Zhijun He2f86a212014-01-15 10:34:02 -0800[diff] [blame]12698 <span class="entry_type_enum_notes"><p>Must not slow down frame rate relative to sensor raw output</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12699 </li>
12700 <li>
12701 <span class="entry_type_enum_name">HIGH_QUALITY</span>
Zhijun He2f86a212014-01-15 10:34:02 -0800[diff] [blame]12702 <span class="entry_type_enum_notes"><p>Frame rate may be reduced by high quality</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12703 </li>
12704 </ul>
12705
12706 </td> <!-- entry_type -->
12707
12708 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12709 <p>Quality of lens shading correction applied
Zhijun He2f86a212014-01-15 10:34:02 -0800[diff] [blame]12710to the image data.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12711 </td>
12712
12713 <td class="entry_units">
12714 </td>
12715
12716 <td class="entry_range">
12717 </td>
12718
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12719 <td class="entry_tags">
12720 </td>
12721
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12722 </tr>
Zhijun He2f86a212014-01-15 10:34:02 -0800[diff] [blame]12723 <tr class="entries_header">
12724 <th class="th_details" colspan="5">Details</th>
12725 </tr>
12726 <tr class="entry_cont">
12727 <td class="entry_details" colspan="5">
12728 <p>When set to OFF mode,<wbr/> no lens shading correction will be applied by the
12729camera device,<wbr/> and an identity lens shading map data will be provided
12730if <code><a href="#controls_android.statistics.lensShadingMapMode">android.<wbr/>statistics.<wbr/>lens<wbr/>Shading<wbr/>Map<wbr/>Mode</a> == ON</code>.<wbr/> For example,<wbr/> for lens
12731shading map with size specified as <code><a href="#static_android.lens.info.shadingMapSize">android.<wbr/>lens.<wbr/>info.<wbr/>shading<wbr/>Map<wbr/>Size</a> = [ 4,<wbr/> 3 ]</code>,<wbr/>
12732the output <a href="#dynamic_android.statistics.lensShadingMap">android.<wbr/>statistics.<wbr/>lens<wbr/>Shading<wbr/>Map</a> for this case will be an identity map
12733shown below:</p>
12734<pre><code>[ 1.<wbr/>0,<wbr/> 1.<wbr/>0,<wbr/> 1.<wbr/>0,<wbr/> 1.<wbr/>0,<wbr/> 1.<wbr/>0,<wbr/> 1.<wbr/>0,<wbr/> 1.<wbr/>0,<wbr/> 1.<wbr/>0,<wbr/>
12735 1.<wbr/>0,<wbr/> 1.<wbr/>0,<wbr/> 1.<wbr/>0,<wbr/> 1.<wbr/>0,<wbr/> 1.<wbr/>0,<wbr/> 1.<wbr/>0,<wbr/> 1.<wbr/>0,<wbr/> 1.<wbr/>0,<wbr/>
12736 1.<wbr/>0,<wbr/> 1.<wbr/>0,<wbr/> 1.<wbr/>0,<wbr/> 1.<wbr/>0,<wbr/> 1.<wbr/>0,<wbr/> 1.<wbr/>0,<wbr/> 1.<wbr/>0,<wbr/> 1.<wbr/>0,<wbr/>
12737 1.<wbr/>0,<wbr/> 1.<wbr/>0,<wbr/> 1.<wbr/>0,<wbr/> 1.<wbr/>0,<wbr/> 1.<wbr/>0,<wbr/> 1.<wbr/>0,<wbr/> 1.<wbr/>0,<wbr/> 1.<wbr/>0,<wbr/>
12738 1.<wbr/>0,<wbr/> 1.<wbr/>0,<wbr/> 1.<wbr/>0,<wbr/> 1.<wbr/>0,<wbr/> 1.<wbr/>0,<wbr/> 1.<wbr/>0,<wbr/> 1.<wbr/>0,<wbr/> 1.<wbr/>0,<wbr/>
12739 1.<wbr/>0,<wbr/> 1.<wbr/>0,<wbr/> 1.<wbr/>0,<wbr/> 1.<wbr/>0,<wbr/> 1.<wbr/>0,<wbr/> 1.<wbr/>0,<wbr/> 1.<wbr/>0,<wbr/> 1.<wbr/>0 ]
12740</code></pre>
12741<p>When set to other modes,<wbr/> lens shading correction will be applied by the
12742camera device.<wbr/> Applications can request lens shading map data by setting
12743<a href="#controls_android.statistics.lensShadingMapMode">android.<wbr/>statistics.<wbr/>lens<wbr/>Shading<wbr/>Map<wbr/>Mode</a> to ON,<wbr/> and then the camera device will provide
12744lens shading map data in <a href="#dynamic_android.statistics.lensShadingMap">android.<wbr/>statistics.<wbr/>lens<wbr/>Shading<wbr/>Map</a>,<wbr/> with size specified
12745by <a href="#static_android.lens.info.shadingMapSize">android.<wbr/>lens.<wbr/>info.<wbr/>shading<wbr/>Map<wbr/>Size</a>.<wbr/></p>
12746 </td>
12747 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12748
12749
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12750 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
12751 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12752
12753
12754
12755 <!-- end of kind -->
12756 </tbody>
12757
12758 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12759 <tr><td colspan="6" id="section_statistics" class="section">statistics</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12760
12761
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12762 <tr><td colspan="6" class="kind">controls</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12763
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]12764 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12765 <tr>
12766 <th class="th_name">Property Name</th>
12767 <th class="th_type">Type</th>
12768 <th class="th_description">Description</th>
12769 <th class="th_units">Units</th>
12770 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12771 <th class="th_tags">Tags</th>
12772 </tr>
12773 </thead>
12774
12775 <tbody>
12776
12777
12778
12779
12780
12781
12782
12783
12784
12785
12786 <tr class="entry" id="controls_android.statistics.faceDetectMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12787 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12788 android.<wbr/>statistics.<wbr/>face<wbr/>Detect<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12789 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12790 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]12791 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12792
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]12793 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12794
12795 <ul class="entry_type_enum">
12796 <li>
12797 <span class="entry_type_enum_name">OFF</span>
12798 </li>
12799 <li>
12800 <span class="entry_type_enum_name">SIMPLE</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]12801 <span class="entry_type_enum_notes"><p>Optional Return rectangle and confidence
12802only</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12803 </li>
12804 <li>
12805 <span class="entry_type_enum_name">FULL</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]12806 <span class="entry_type_enum_notes"><p>Optional Return all face
12807metadata</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12808 </li>
12809 </ul>
12810
12811 </td> <!-- entry_type -->
12812
12813 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12814 <p>State of the face detector
12815unit</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12816 </td>
12817
12818 <td class="entry_units">
12819 </td>
12820
12821 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]12822 <p><a href="#static_android.statistics.info.availableFaceDetectModes">android.<wbr/>statistics.<wbr/>info.<wbr/>available<wbr/>Face<wbr/>Detect<wbr/>Modes</a></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12823 </td>
12824
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12825 <td class="entry_tags">
12826 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]12827 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12828 </ul>
12829 </td>
12830
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12831 </tr>
12832 <tr class="entries_header">
12833 <th class="th_details" colspan="5">Details</th>
12834 </tr>
12835 <tr class="entry_cont">
12836 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12837 <p>Whether face detection is enabled,<wbr/> and whether it
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12838should output just the basic fields or the full set of
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12839fields.<wbr/> Value must be one of the
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]12840<a href="#static_android.statistics.info.availableFaceDetectModes">android.<wbr/>statistics.<wbr/>info.<wbr/>available<wbr/>Face<wbr/>Detect<wbr/>Modes</a>.<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12841 </td>
12842 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12843
12844
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12845 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
12846 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12847
12848
12849 <tr class="entry" id="controls_android.statistics.histogramMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12850 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12851 android.<wbr/>statistics.<wbr/>histogram<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12852 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12853 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]12854 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12855
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]12856 <span class="entry_type_visibility"> [system as boolean]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12857
12858 <ul class="entry_type_enum">
12859 <li>
12860 <span class="entry_type_enum_name">OFF</span>
12861 </li>
12862 <li>
12863 <span class="entry_type_enum_name">ON</span>
12864 </li>
12865 </ul>
12866
12867 </td> <!-- entry_type -->
12868
12869 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12870 <p>Operating mode for histogram
12871generation</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12872 </td>
12873
12874 <td class="entry_units">
12875 </td>
12876
12877 <td class="entry_range">
12878 </td>
12879
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12880 <td class="entry_tags">
12881 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]12882 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12883 </ul>
12884 </td>
12885
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12886 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12887
12888
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12889 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
12890 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12891
12892
12893 <tr class="entry" id="controls_android.statistics.sharpnessMapMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12894 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12895 android.<wbr/>statistics.<wbr/>sharpness<wbr/>Map<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12896 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12897 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]12898 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12899
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]12900 <span class="entry_type_visibility"> [system as boolean]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12901
12902 <ul class="entry_type_enum">
12903 <li>
12904 <span class="entry_type_enum_name">OFF</span>
12905 </li>
12906 <li>
12907 <span class="entry_type_enum_name">ON</span>
12908 </li>
12909 </ul>
12910
12911 </td> <!-- entry_type -->
12912
12913 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12914 <p>Operating mode for sharpness map
12915generation</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12916 </td>
12917
12918 <td class="entry_units">
12919 </td>
12920
12921 <td class="entry_range">
12922 </td>
12923
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12924 <td class="entry_tags">
12925 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]12926 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12927 </ul>
12928 </td>
12929
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12930 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12931
12932
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12933 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
12934 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12935
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]12936
12937 <tr class="entry" id="controls_android.statistics.lensShadingMapMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12938 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12939 android.<wbr/>statistics.<wbr/>lens<wbr/>Shading<wbr/>Map<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12940 </td>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]12941 <td class="entry_type">
12942 <span class="entry_type_name entry_type_name_enum">byte</span>
12943
12944 <span class="entry_type_visibility"> [public]</span>
12945
12946 <ul class="entry_type_enum">
12947 <li>
12948 <span class="entry_type_enum_name">OFF</span>
12949 </li>
12950 <li>
12951 <span class="entry_type_enum_name">ON</span>
12952 </li>
12953 </ul>
12954
12955 </td> <!-- entry_type -->
12956
12957 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12958 <p>Whether the HAL needs to output the lens
12959shading map in output result metadata</p>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]12960 </td>
12961
12962 <td class="entry_units">
12963 </td>
12964
12965 <td class="entry_range">
12966 </td>
12967
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12968 <td class="entry_tags">
12969 </td>
12970
12971 </tr>
12972 <tr class="entries_header">
12973 <th class="th_details" colspan="5">Details</th>
12974 </tr>
12975 <tr class="entry_cont">
12976 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12977 <p>When set to ON,<wbr/>
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]12978<a href="#dynamic_android.statistics.lensShadingMap">android.<wbr/>statistics.<wbr/>lens<wbr/>Shading<wbr/>Map</a> must be provided in
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12979the output result metadata.<wbr/></p>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]12980 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12981 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12982
12983
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12984 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
12985 <!-- end of entry -->
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]12986
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12987
12988
12989 <!-- end of kind -->
12990 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12991 <tr><td colspan="6" class="kind">static</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12992
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]12993 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12994 <tr>
12995 <th class="th_name">Property Name</th>
12996 <th class="th_type">Type</th>
12997 <th class="th_description">Description</th>
12998 <th class="th_units">Units</th>
12999 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13000 <th class="th_tags">Tags</th>
13001 </tr>
13002 </thead>
13003
13004 <tbody>
13005
13006
13007
13008
13009
13010
13011
13012
13013
13014
13015
13016
13017 <tr class="entry" id="static_android.statistics.info.availableFaceDetectModes">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]13018 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13019 android.<wbr/>statistics.<wbr/>info.<wbr/>available<wbr/>Face<wbr/>Detect<wbr/>Modes
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]13020 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13021 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]13022 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13023 <span class="entry_type_container">x</span>
13024
13025 <span class="entry_type_array">
13026 n
13027 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]13028 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13029 <div class="entry_type_notes">List of enums from android.<wbr/>statistics.<wbr/>face<wbr/>Detect<wbr/>Mode</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13030
13031
13032 </td> <!-- entry_type -->
13033
13034 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13035 <p>Which face detection modes are available,<wbr/>
13036if any</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13037 </td>
13038
13039 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13040 List of enum:
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]13041 OFF
13042 SIMPLE
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13043 FULL
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13044 </td>
13045
13046 <td class="entry_range">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13047 </td>
13048
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13049 <td class="entry_tags">
13050 </td>
13051
13052 </tr>
13053 <tr class="entries_header">
13054 <th class="th_details" colspan="5">Details</th>
13055 </tr>
13056 <tr class="entry_cont">
13057 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13058 <p>OFF means face detection is disabled,<wbr/> it must
13059be included in the list.<wbr/></p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]13060<p>SIMPLE means the device supports the
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]13061<a href="#dynamic_android.statistics.faceRectangles">android.<wbr/>statistics.<wbr/>face<wbr/>Rectangles</a> and
13062<a href="#dynamic_android.statistics.faceScores">android.<wbr/>statistics.<wbr/>face<wbr/>Scores</a> outputs.<wbr/></p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]13063<p>FULL means the device additionally supports the
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]13064<a href="#dynamic_android.statistics.faceIds">android.<wbr/>statistics.<wbr/>face<wbr/>Ids</a> and
13065<a href="#dynamic_android.statistics.faceLandmarks">android.<wbr/>statistics.<wbr/>face<wbr/>Landmarks</a> outputs.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13066 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13067 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]13068
13069
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13070 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
13071 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13072
13073
13074 <tr class="entry" id="static_android.statistics.info.histogramBucketCount">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]13075 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13076 android.<wbr/>statistics.<wbr/>info.<wbr/>histogram<wbr/>Bucket<wbr/>Count
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]13077 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13078 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]13079 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13080
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]13081 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13082
13083
13084 </td> <!-- entry_type -->
13085
13086 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13087 <p>Number of histogram buckets
13088supported</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13089 </td>
13090
13091 <td class="entry_units">
13092 </td>
13093
13094 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame]13095 <p>&gt;= 64</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13096 </td>
13097
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13098 <td class="entry_tags">
13099 </td>
13100
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13101 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]13102
13103
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13104 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
13105 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13106
13107
13108 <tr class="entry" id="static_android.statistics.info.maxFaceCount">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]13109 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13110 android.<wbr/>statistics.<wbr/>info.<wbr/>max<wbr/>Face<wbr/>Count
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]13111 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13112 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]13113 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13114
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]13115 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13116
13117
13118 </td> <!-- entry_type -->
13119
13120 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13121 <p>Maximum number of simultaneously detectable
13122faces</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13123 </td>
13124
13125 <td class="entry_units">
13126 </td>
13127
13128 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame]13129 <p>&gt;= 4 if availableFaceDetectionModes lists
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]13130modes besides OFF,<wbr/> otherwise 0</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13131 </td>
13132
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13133 <td class="entry_tags">
13134 </td>
13135
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13136 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]13137
13138
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13139 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
13140 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13141
13142
13143 <tr class="entry" id="static_android.statistics.info.maxHistogramCount">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]13144 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13145 android.<wbr/>statistics.<wbr/>info.<wbr/>max<wbr/>Histogram<wbr/>Count
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]13146 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13147 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]13148 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13149
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]13150 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13151
13152
13153 </td> <!-- entry_type -->
13154
13155 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13156 <p>Maximum value possible for a histogram
13157bucket</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13158 </td>
13159
13160 <td class="entry_units">
13161 </td>
13162
13163 <td class="entry_range">
13164 </td>
13165
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13166 <td class="entry_tags">
13167 </td>
13168
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13169 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]13170
13171
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13172 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
13173 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13174
13175
13176 <tr class="entry" id="static_android.statistics.info.maxSharpnessMapValue">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]13177 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13178 android.<wbr/>statistics.<wbr/>info.<wbr/>max<wbr/>Sharpness<wbr/>Map<wbr/>Value
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]13179 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13180 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]13181 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13182
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]13183 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13184
13185
13186 </td> <!-- entry_type -->
13187
13188 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13189 <p>Maximum value possible for a sharpness map
13190region.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13191 </td>
13192
13193 <td class="entry_units">
13194 </td>
13195
13196 <td class="entry_range">
13197 </td>
13198
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13199 <td class="entry_tags">
13200 </td>
13201
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13202 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]13203
13204
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13205 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
13206 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13207
13208
13209 <tr class="entry" id="static_android.statistics.info.sharpnessMapSize">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]13210 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13211 android.<wbr/>statistics.<wbr/>info.<wbr/>sharpness<wbr/>Map<wbr/>Size
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]13212 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13213 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]13214 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13215 <span class="entry_type_container">x</span>
13216
13217 <span class="entry_type_array">
13218 2
13219 </span>
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]13220 <span class="entry_type_visibility"> [system as size]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13221 <div class="entry_type_notes">width x height</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13222
13223
13224 </td> <!-- entry_type -->
13225
13226 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13227 <p>Dimensions of the sharpness
13228map</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13229 </td>
13230
13231 <td class="entry_units">
13232 </td>
13233
13234 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]13235 <p>Must be at least 32 x 32</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13236 </td>
13237
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13238 <td class="entry_tags">
13239 </td>
13240
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13241 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]13242
13243
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13244 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
13245 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13246
13247
13248
13249
13250
13251
13252 <!-- end of kind -->
13253 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13254 <tr><td colspan="6" class="kind">dynamic</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13255
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]13256 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13257 <tr>
13258 <th class="th_name">Property Name</th>
13259 <th class="th_type">Type</th>
13260 <th class="th_description">Description</th>
13261 <th class="th_units">Units</th>
13262 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13263 <th class="th_tags">Tags</th>
13264 </tr>
13265 </thead>
13266
13267 <tbody>
13268
13269
13270
13271
13272
13273
13274
13275
13276
13277
13278 <tr class="entry" id="dynamic_android.statistics.faceDetectMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]13279 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13280 android.<wbr/>statistics.<wbr/>face<wbr/>Detect<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]13281 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13282 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]13283 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13284
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]13285 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13286
13287 <ul class="entry_type_enum">
13288 <li>
13289 <span class="entry_type_enum_name">OFF</span>
13290 </li>
13291 <li>
13292 <span class="entry_type_enum_name">SIMPLE</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]13293 <span class="entry_type_enum_notes"><p>Optional Return rectangle and confidence
13294only</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13295 </li>
13296 <li>
13297 <span class="entry_type_enum_name">FULL</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]13298 <span class="entry_type_enum_notes"><p>Optional Return all face
13299metadata</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13300 </li>
13301 </ul>
13302
13303 </td> <!-- entry_type -->
13304
13305 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13306 <p>State of the face detector
13307unit</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13308 </td>
13309
13310 <td class="entry_units">
13311 </td>
13312
13313 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]13314 <p><a href="#static_android.statistics.info.availableFaceDetectModes">android.<wbr/>statistics.<wbr/>info.<wbr/>available<wbr/>Face<wbr/>Detect<wbr/>Modes</a></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13315 </td>
13316
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13317 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]13318 <ul class="entry_tags">
13319 <li><a href="#tag_BC">BC</a></li>
13320 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13321 </td>
13322
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13323 </tr>
13324 <tr class="entries_header">
13325 <th class="th_details" colspan="5">Details</th>
13326 </tr>
13327 <tr class="entry_cont">
13328 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13329 <p>Whether face detection is enabled,<wbr/> and whether it
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13330should output just the basic fields or the full set of
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13331fields.<wbr/> Value must be one of the
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]13332<a href="#static_android.statistics.info.availableFaceDetectModes">android.<wbr/>statistics.<wbr/>info.<wbr/>available<wbr/>Face<wbr/>Detect<wbr/>Modes</a>.<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13333 </td>
13334 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]13335
13336
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13337 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
13338 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13339
13340
13341 <tr class="entry" id="dynamic_android.statistics.faceIds">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]13342 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13343 android.<wbr/>statistics.<wbr/>face<wbr/>Ids
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]13344 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13345 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]13346 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13347 <span class="entry_type_container">x</span>
13348
13349 <span class="entry_type_array">
13350 n
13351 </span>
Zhijun He3b4c2062013-10-07 11:23:30 -0700[diff] [blame]13352 <span class="entry_type_visibility"> [hidden]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13353
13354
13355 </td> <!-- entry_type -->
13356
13357 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13358 <p>List of unique IDs for detected
13359faces</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13360 </td>
13361
13362 <td class="entry_units">
13363 </td>
13364
13365 <td class="entry_range">
13366 </td>
13367
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13368 <td class="entry_tags">
13369 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]13370 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13371 </ul>
13372 </td>
13373
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13374 </tr>
13375 <tr class="entries_header">
13376 <th class="th_details" colspan="5">Details</th>
13377 </tr>
13378 <tr class="entry_cont">
13379 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13380 <p>Only available if faceDetectMode == FULL</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13381 </td>
13382 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]13383
13384
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13385 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
13386 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13387
13388
13389 <tr class="entry" id="dynamic_android.statistics.faceLandmarks">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]13390 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13391 android.<wbr/>statistics.<wbr/>face<wbr/>Landmarks
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]13392 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13393 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]13394 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13395 <span class="entry_type_container">x</span>
13396
13397 <span class="entry_type_array">
13398 n x 6
13399 </span>
Zhijun He3b4c2062013-10-07 11:23:30 -0700[diff] [blame]13400 <span class="entry_type_visibility"> [hidden]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13401 <div class="entry_type_notes">(leftEyeX,<wbr/> leftEyeY,<wbr/> rightEyeX,<wbr/> rightEyeY,<wbr/> mouthX,<wbr/> mouthY)</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13402
13403
13404 </td> <!-- entry_type -->
13405
13406 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13407 <p>List of landmarks for detected
13408faces</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13409 </td>
13410
13411 <td class="entry_units">
13412 </td>
13413
13414 <td class="entry_range">
13415 </td>
13416
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13417 <td class="entry_tags">
13418 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]13419 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13420 </ul>
13421 </td>
13422
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13423 </tr>
13424 <tr class="entries_header">
13425 <th class="th_details" colspan="5">Details</th>
13426 </tr>
13427 <tr class="entry_cont">
13428 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13429 <p>Only available if faceDetectMode == FULL</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13430 </td>
13431 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]13432
13433
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13434 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
13435 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13436
13437
13438 <tr class="entry" id="dynamic_android.statistics.faceRectangles">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]13439 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13440 android.<wbr/>statistics.<wbr/>face<wbr/>Rectangles
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]13441 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13442 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]13443 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13444 <span class="entry_type_container">x</span>
13445
13446 <span class="entry_type_array">
13447 n x 4
13448 </span>
Zhijun He3b4c2062013-10-07 11:23:30 -0700[diff] [blame]13449 <span class="entry_type_visibility"> [hidden as rectangle]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13450 <div class="entry_type_notes">(xmin,<wbr/> ymin,<wbr/> xmax,<wbr/> ymax).<wbr/> (0,<wbr/>0) is top-left of active pixel area</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13451
13452
13453 </td> <!-- entry_type -->
13454
13455 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13456 <p>List of the bounding rectangles for detected
13457faces</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13458 </td>
13459
13460 <td class="entry_units">
13461 </td>
13462
13463 <td class="entry_range">
13464 </td>
13465
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13466 <td class="entry_tags">
13467 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]13468 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13469 </ul>
13470 </td>
13471
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13472 </tr>
13473 <tr class="entries_header">
13474 <th class="th_details" colspan="5">Details</th>
13475 </tr>
13476 <tr class="entry_cont">
13477 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13478 <p>Only available if faceDetectMode != OFF</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13479 </td>
13480 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]13481
13482
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13483 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
13484 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13485
13486
13487 <tr class="entry" id="dynamic_android.statistics.faceScores">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]13488 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13489 android.<wbr/>statistics.<wbr/>face<wbr/>Scores
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]13490 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13491 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]13492 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13493 <span class="entry_type_container">x</span>
13494
13495 <span class="entry_type_array">
13496 n
13497 </span>
Zhijun He3b4c2062013-10-07 11:23:30 -0700[diff] [blame]13498 <span class="entry_type_visibility"> [hidden]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13499
13500
13501 </td> <!-- entry_type -->
13502
13503 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13504 <p>List of the face confidence scores for
13505detected faces</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13506 </td>
13507
13508 <td class="entry_units">
13509 </td>
13510
13511 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]13512 <p>1-100</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13513 </td>
13514
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13515 <td class="entry_tags">
13516 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]13517 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13518 </ul>
13519 </td>
13520
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13521 </tr>
13522 <tr class="entries_header">
13523 <th class="th_details" colspan="5">Details</th>
13524 </tr>
13525 <tr class="entry_cont">
13526 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13527 <p>Only available if faceDetectMode != OFF.<wbr/> The value should be
13528meaningful (for example,<wbr/> setting 100 at all times is illegal).<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13529 </td>
13530 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]13531
13532
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13533 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
13534 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13535
13536
13537 <tr class="entry" id="dynamic_android.statistics.histogram">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]13538 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13539 android.<wbr/>statistics.<wbr/>histogram
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]13540 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13541 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]13542 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13543 <span class="entry_type_container">x</span>
13544
13545 <span class="entry_type_array">
13546 n x 3
13547 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]13548 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13549 <div class="entry_type_notes">count of pixels for each color channel that fall into each histogram bucket,<wbr/> scaled to be between 0 and maxHistogramCount</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13550
13551
13552 </td> <!-- entry_type -->
13553
13554 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13555 <p>A 3-channel histogram based on the raw
13556sensor data</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13557 </td>
13558
13559 <td class="entry_units">
13560 </td>
13561
13562 <td class="entry_range">
13563 </td>
13564
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13565 <td class="entry_tags">
13566 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]13567 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13568 </ul>
13569 </td>
13570
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13571 </tr>
13572 <tr class="entries_header">
13573 <th class="th_details" colspan="5">Details</th>
13574 </tr>
13575 <tr class="entry_cont">
13576 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13577 <p>The k'th bucket (0-based) covers the input range
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]13578(with w = <a href="#static_android.sensor.info.whiteLevel">android.<wbr/>sensor.<wbr/>info.<wbr/>white<wbr/>Level</a>) of [ k * w/<wbr/>N,<wbr/>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13579(k + 1) * w /<wbr/> N ).<wbr/> If only a monochrome sharpness map is
13580supported,<wbr/> all channels should have the same data</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13581 </td>
13582 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]13583
13584
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13585 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
13586 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13587
13588
13589 <tr class="entry" id="dynamic_android.statistics.histogramMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]13590 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13591 android.<wbr/>statistics.<wbr/>histogram<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]13592 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13593 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]13594 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13595
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]13596 <span class="entry_type_visibility"> [system as boolean]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13597
13598 <ul class="entry_type_enum">
13599 <li>
13600 <span class="entry_type_enum_name">OFF</span>
13601 </li>
13602 <li>
13603 <span class="entry_type_enum_name">ON</span>
13604 </li>
13605 </ul>
13606
13607 </td> <!-- entry_type -->
13608
13609 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13610 <p>Operating mode for histogram
13611generation</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13612 </td>
13613
13614 <td class="entry_units">
13615 </td>
13616
13617 <td class="entry_range">
13618 </td>
13619
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13620 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]13621 <ul class="entry_tags">
13622 <li><a href="#tag_V1">V1</a></li>
13623 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13624 </td>
13625
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13626 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]13627
13628
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13629 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
13630 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13631
13632
13633 <tr class="entry" id="dynamic_android.statistics.sharpnessMap">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]13634 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13635 android.<wbr/>statistics.<wbr/>sharpness<wbr/>Map
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]13636 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13637 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]13638 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13639 <span class="entry_type_container">x</span>
13640
13641 <span class="entry_type_array">
13642 n x m x 3
13643 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]13644 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13645 <div class="entry_type_notes">estimated sharpness for each region of the input image.<wbr/> Normalized to be between 0 and maxSharpnessMapValue.<wbr/> Higher values mean sharper (better focused)</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13646
13647
13648 </td> <!-- entry_type -->
13649
13650 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13651 <p>A 3-channel sharpness map,<wbr/> based on the raw
13652sensor data</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13653 </td>
13654
13655 <td class="entry_units">
13656 </td>
13657
13658 <td class="entry_range">
13659 </td>
13660
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13661 <td class="entry_tags">
13662 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]13663 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13664 </ul>
13665 </td>
13666
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13667 </tr>
13668 <tr class="entries_header">
13669 <th class="th_details" colspan="5">Details</th>
13670 </tr>
13671 <tr class="entry_cont">
13672 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13673 <p>If only a monochrome sharpness map is supported,<wbr/>
13674all channels should have the same data</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13675 </td>
13676 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]13677
13678
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13679 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
13680 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13681
13682
13683 <tr class="entry" id="dynamic_android.statistics.sharpnessMapMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]13684 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13685 android.<wbr/>statistics.<wbr/>sharpness<wbr/>Map<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]13686 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13687 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]13688 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13689
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]13690 <span class="entry_type_visibility"> [system as boolean]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13691
13692 <ul class="entry_type_enum">
13693 <li>
13694 <span class="entry_type_enum_name">OFF</span>
13695 </li>
13696 <li>
13697 <span class="entry_type_enum_name">ON</span>
13698 </li>
13699 </ul>
13700
13701 </td> <!-- entry_type -->
13702
13703 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13704 <p>Operating mode for sharpness map
13705generation</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13706 </td>
13707
13708 <td class="entry_units">
13709 </td>
13710
13711 <td class="entry_range">
13712 </td>
13713
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13714 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]13715 <ul class="entry_tags">
13716 <li><a href="#tag_V1">V1</a></li>
13717 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13718 </td>
13719
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13720 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]13721
13722
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13723 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
13724 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13725
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]13726
13727 <tr class="entry" id="dynamic_android.statistics.lensShadingMap">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]13728 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13729 android.<wbr/>statistics.<wbr/>lens<wbr/>Shading<wbr/>Map
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]13730 </td>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]13731 <td class="entry_type">
13732 <span class="entry_type_name">float</span>
13733 <span class="entry_type_container">x</span>
13734
13735 <span class="entry_type_array">
13736 4 x n x m
13737 </span>
13738 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13739 <div class="entry_type_notes">2D array of float gain factors per channel to correct lens shading</div>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]13740
13741
13742 </td> <!-- entry_type -->
13743
13744 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13745 <p>The shading map is a low-resolution floating-point map
13746that lists the coefficients used to correct for vignetting,<wbr/> for each
13747Bayer color channel.<wbr/></p>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]13748 </td>
13749
13750 <td class="entry_units">
13751 </td>
13752
13753 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]13754 <p>Each gain factor is &gt;= 1</p>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]13755 </td>
13756
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13757 <td class="entry_tags">
13758 </td>
13759
13760 </tr>
13761 <tr class="entries_header">
13762 <th class="th_details" colspan="5">Details</th>
13763 </tr>
13764 <tr class="entry_cont">
13765 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13766 <p>The least shaded section of the image should have a gain factor
13767of 1; all other sections should have gains above 1.<wbr/></p>
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]13768<p>When <a href="#controls_android.colorCorrection.mode">android.<wbr/>color<wbr/>Correction.<wbr/>mode</a> = TRANSFORM_<wbr/>MATRIX,<wbr/> the map
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13769must take into account the colorCorrection settings.<wbr/></p>
13770<p>The shading map is for the entire active pixel array,<wbr/> and is not
13771affected by the crop region specified in the request.<wbr/> Each shading map
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]13772entry is the value of the shading compensation map over a specific
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13773pixel on the sensor.<wbr/> Specifically,<wbr/> with a (N x M) resolution shading
13774map,<wbr/> and an active pixel array size (W x H),<wbr/> shading map entry
13775(x,<wbr/>y) ϵ (0 ...<wbr/> N-1,<wbr/> 0 ...<wbr/> M-1) is the value of the shading map at
13776pixel ( ((W-1)/<wbr/>(N-1)) * x,<wbr/> ((H-1)/<wbr/>(M-1)) * y) for the four color channels.<wbr/>
13777The map is assumed to be bilinearly interpolated between the sample points.<wbr/></p>
13778<p>The channel order is [R,<wbr/> Geven,<wbr/> Godd,<wbr/> B],<wbr/> where Geven is the green
13779channel for the even rows of a Bayer pattern,<wbr/> and Godd is the odd rows.<wbr/>
13780The shading map is stored in a fully interleaved format,<wbr/> and its size
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]13781is provided in the camera static metadata by <a href="#static_android.lens.info.shadingMapSize">android.<wbr/>lens.<wbr/>info.<wbr/>shading<wbr/>Map<wbr/>Size</a>.<wbr/></p>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13782<p>The shading map should have on the order of 30-40 rows and columns,<wbr/>
13783and must be smaller than 64x64.<wbr/></p>
13784<p>As an example,<wbr/> given a very small map defined as:</p>
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]13785<pre><code><a href="#static_android.lens.info.shadingMapSize">android.<wbr/>lens.<wbr/>info.<wbr/>shading<wbr/>Map<wbr/>Size</a> = [ 4,<wbr/> 3 ]
13786<a href="#dynamic_android.statistics.lensShadingMap">android.<wbr/>statistics.<wbr/>lens<wbr/>Shading<wbr/>Map</a> =
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13787[ 1.<wbr/>3,<wbr/> 1.<wbr/>2,<wbr/> 1.<wbr/>15,<wbr/> 1.<wbr/>2,<wbr/> 1.<wbr/>2,<wbr/> 1.<wbr/>2,<wbr/> 1.<wbr/>15,<wbr/> 1.<wbr/>2,<wbr/>
13788 1.<wbr/>1,<wbr/> 1.<wbr/>2,<wbr/> 1.<wbr/>2,<wbr/> 1.<wbr/>2,<wbr/> 1.<wbr/>3,<wbr/> 1.<wbr/>2,<wbr/> 1.<wbr/>3,<wbr/> 1.<wbr/>3,<wbr/>
13789 1.<wbr/>2,<wbr/> 1.<wbr/>2,<wbr/> 1.<wbr/>25,<wbr/> 1.<wbr/>1,<wbr/> 1.<wbr/>1,<wbr/> 1.<wbr/>1,<wbr/> 1.<wbr/>1,<wbr/> 1.<wbr/>0,<wbr/>
13790 1.<wbr/>0,<wbr/> 1.<wbr/>0,<wbr/> 1.<wbr/>0,<wbr/> 1.<wbr/>0,<wbr/> 1.<wbr/>2,<wbr/> 1.<wbr/>3,<wbr/> 1.<wbr/>25,<wbr/> 1.<wbr/>2,<wbr/>
13791 1.<wbr/>3,<wbr/> 1.<wbr/>2,<wbr/> 1.<wbr/>2,<wbr/> 1.<wbr/>3,<wbr/> 1.<wbr/>2,<wbr/> 1.<wbr/>15,<wbr/> 1.<wbr/>1,<wbr/> 1.<wbr/>2,<wbr/>
13792 1.<wbr/>2,<wbr/> 1.<wbr/>1,<wbr/> 1.<wbr/>0,<wbr/> 1.<wbr/>2,<wbr/> 1.<wbr/>3,<wbr/> 1.<wbr/>15,<wbr/> 1.<wbr/>2,<wbr/> 1.<wbr/>3 ]
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]13793</code></pre>
13794<p>The low-resolution scaling map images for each channel are
13795(displayed using nearest-neighbor interpolation):</p>
13796<p><img alt="Red lens shading map" src="images/camera2/metadata/android.statistics.lensShadingMap/red_shading.png"/>
13797<img alt="Green (even rows) lens shading map" src="images/camera2/metadata/android.statistics.lensShadingMap/green_e_shading.png"/>
13798<img alt="Green (odd rows) lens shading map" src="images/camera2/metadata/android.statistics.lensShadingMap/green_o_shading.png"/>
13799<img alt="Blue lens shading map" src="images/camera2/metadata/android.statistics.lensShadingMap/blue_shading.png"/></p>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13800<p>As a visualization only,<wbr/> inverting the full-color map to recover an
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]13801image of a gray wall (using bicubic interpolation for visual quality) as captured by the sensor gives:</p>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13802<p><img alt="Image of a uniform white wall (inverse shading map)" src="images/camera2/metadata/android.statistics.lensShadingMap/inv_shading.png"/></p>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]13803 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13804 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]13805
13806
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13807 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
13808 <!-- end of entry -->
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]13809
13810
13811 <tr class="entry" id="dynamic_android.statistics.predictedColorGains">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]13812 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13813 android.<wbr/>statistics.<wbr/>predicted<wbr/>Color<wbr/>Gains
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]13814 </td>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]13815 <td class="entry_type">
13816 <span class="entry_type_name">float</span>
13817 <span class="entry_type_container">x</span>
13818
13819 <span class="entry_type_array">
13820 4
13821 </span>
Igor Murashkin0fe2f132014-01-13 16:59:47 -0800[diff] [blame]13822 <span class="entry_type_visibility"> [hidden]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13823 <div class="entry_type_notes">A 1D array of floats for 4 color channel gains</div>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]13824
13825
13826 </td> <!-- entry_type -->
13827
13828 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13829 <p>The best-fit color channel gains calculated
13830by the HAL's statistics units for the current output frame</p>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]13831 </td>
13832
13833 <td class="entry_units">
13834 </td>
13835
13836 <td class="entry_range">
Igor Murashkin0fe2f132014-01-13 16:59:47 -0800[diff] [blame]13837 <p><strong>Deprecated</strong>.<wbr/> Do not use.<wbr/></p>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]13838 </td>
13839
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13840 <td class="entry_tags">
13841 </td>
13842
13843 </tr>
13844 <tr class="entries_header">
13845 <th class="th_details" colspan="5">Details</th>
13846 </tr>
13847 <tr class="entry_cont">
13848 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13849 <p>This may be different than the gains used for this frame,<wbr/>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]13850since statistics processing on data from a new frame
13851typically completes after the transform has already been
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13852applied to that frame.<wbr/></p>
13853<p>The 4 channel gains are defined in Bayer domain,<wbr/>
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]13854see <a href="#controls_android.colorCorrection.gains">android.<wbr/>color<wbr/>Correction.<wbr/>gains</a> for details.<wbr/></p>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13855<p>This value should always be calculated by the AWB block,<wbr/>
13856regardless of the android.<wbr/>control.<wbr/>* current values.<wbr/></p>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]13857 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13858 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]13859
13860
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13861 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
13862 <!-- end of entry -->
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]13863
13864
13865 <tr class="entry" id="dynamic_android.statistics.predictedColorTransform">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]13866 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13867 android.<wbr/>statistics.<wbr/>predicted<wbr/>Color<wbr/>Transform
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]13868 </td>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]13869 <td class="entry_type">
13870 <span class="entry_type_name">rational</span>
13871 <span class="entry_type_container">x</span>
13872
13873 <span class="entry_type_array">
13874 3 x 3
13875 </span>
Igor Murashkin0fe2f132014-01-13 16:59:47 -0800[diff] [blame]13876 <span class="entry_type_visibility"> [hidden]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13877 <div class="entry_type_notes">3x3 rational matrix in row-major order</div>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]13878
13879
13880 </td> <!-- entry_type -->
13881
13882 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13883 <p>The best-fit color transform matrix estimate
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]13884calculated by the HAL's statistics units for the current
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13885output frame</p>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]13886 </td>
13887
13888 <td class="entry_units">
13889 </td>
13890
13891 <td class="entry_range">
Igor Murashkin0fe2f132014-01-13 16:59:47 -0800[diff] [blame]13892 <p><strong>Deprecated</strong>.<wbr/> Do not use.<wbr/></p>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]13893 </td>
13894
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13895 <td class="entry_tags">
13896 </td>
13897
13898 </tr>
13899 <tr class="entries_header">
13900 <th class="th_details" colspan="5">Details</th>
13901 </tr>
13902 <tr class="entry_cont">
13903 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13904 <p>The HAL must provide the estimate from its
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]13905statistics unit on the white balance transforms to use
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13906for the next frame.<wbr/> These are the values the HAL believes
13907are the best fit for the current output frame.<wbr/> This may
13908be different than the transform used for this frame,<wbr/> since
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]13909statistics processing on data from a new frame typically
13910completes after the transform has already been applied to
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13911that frame.<wbr/></p>
13912<p>These estimates must be provided for all frames,<wbr/> even if
13913capture settings and color transforms are set by the application.<wbr/></p>
13914<p>This value should always be calculated by the AWB block,<wbr/>
13915regardless of the android.<wbr/>control.<wbr/>* current values.<wbr/></p>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]13916 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13917 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]13918
13919
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13920 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
13921 <!-- end of entry -->
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]13922
13923
13924 <tr class="entry" id="dynamic_android.statistics.sceneFlicker">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]13925 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13926 android.<wbr/>statistics.<wbr/>scene<wbr/>Flicker
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]13927 </td>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]13928 <td class="entry_type">
13929 <span class="entry_type_name entry_type_name_enum">byte</span>
13930
13931 <span class="entry_type_visibility"> [public]</span>
13932
13933 <ul class="entry_type_enum">
13934 <li>
13935 <span class="entry_type_enum_name">NONE</span>
13936 </li>
13937 <li>
13938 <span class="entry_type_enum_name">50HZ</span>
13939 </li>
13940 <li>
13941 <span class="entry_type_enum_name">60HZ</span>
13942 </li>
13943 </ul>
13944
13945 </td> <!-- entry_type -->
13946
13947 <td class="entry_description">
Zhijun Heb8512c52014-02-03 11:46:58 -0800[diff] [blame]13948 <p>The camera device estimated scene illumination lighting
13949frequency.<wbr/></p>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]13950 </td>
13951
13952 <td class="entry_units">
13953 </td>
13954
13955 <td class="entry_range">
13956 </td>
13957
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]13958 <td class="entry_tags">
13959 </td>
13960
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13961 </tr>
13962 <tr class="entries_header">
13963 <th class="th_details" colspan="5">Details</th>
13964 </tr>
13965 <tr class="entry_cont">
13966 <td class="entry_details" colspan="5">
Zhijun Heb8512c52014-02-03 11:46:58 -0800[diff] [blame]13967 <p>Many light sources,<wbr/> such as most fluorescent lights,<wbr/> flicker at a rate
13968that depends on the local utility power standards.<wbr/> This flicker must be
13969accounted for by auto-exposure routines to avoid artifacts in captured images.<wbr/>
13970The camera device uses this entry to tell the application what the scene
13971illuminant frequency is.<wbr/></p>
13972<p>When manual exposure control is enabled
13973(<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/>
13974the <a href="#controls_android.control.aeAntibandingMode">android.<wbr/>control.<wbr/>ae<wbr/>Antibanding<wbr/>Mode</a> doesn't do the antibanding,<wbr/> and the
13975application can ensure it selects exposure times that do not cause banding
13976issues by looking into this metadata field.<wbr/> See android.<wbr/>control.<wbr/>ae<wbr/>Antibanding<wbr/>Mode
13977for more details.<wbr/></p>
13978<p>Report NONE if there doesn't appear to be flickering illumination.<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13979 </td>
13980 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]13981
13982
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13983 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
13984 <!-- end of entry -->
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]13985
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13986
13987
13988 <!-- end of kind -->
13989 </tbody>
13990
13991 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13992 <tr><td colspan="6" id="section_tonemap" class="section">tonemap</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13993
13994
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13995 <tr><td colspan="6" class="kind">controls</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13996
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]13997 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13998 <tr>
13999 <th class="th_name">Property Name</th>
14000 <th class="th_type">Type</th>
14001 <th class="th_description">Description</th>
14002 <th class="th_units">Units</th>
14003 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]14004 <th class="th_tags">Tags</th>
14005 </tr>
14006 </thead>
14007
14008 <tbody>
14009
14010
14011
14012
14013
14014
14015
14016
14017
14018
14019 <tr class="entry" id="controls_android.tonemap.curveBlue">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]14020 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]14021 android.<wbr/>tonemap.<wbr/>curve<wbr/>Blue
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]14022 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]14023 <td class="entry_type">
Eino-Ville Talvala76548fe2013-01-11 13:57:19 -0800[diff] [blame]14024 <span class="entry_type_name">float</span>
Zhijun He704d1282013-08-19 15:26:33 -0700[diff] [blame]14025 <span class="entry_type_container">x</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]14026
Zhijun He704d1282013-08-19 15:26:33 -0700[diff] [blame]14027 <span class="entry_type_array">
14028 n x 2
14029 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]14030 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]14031 <div class="entry_type_notes">1D array of float pairs (P_<wbr/>IN,<wbr/> P_<wbr/>OUT).<wbr/> The maximum number of pairs is specified by android.<wbr/>tonemap.<wbr/>max<wbr/>Curve<wbr/>Points.<wbr/></div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]14032
14033
14034 </td> <!-- entry_type -->
14035
14036 <td class="entry_description">
Igor Murashkin94e06c42014-01-13 16:51:17 -0800[diff] [blame]14037 <p>Tonemapping /<wbr/> contrast /<wbr/> gamma curve for the blue
14038channel,<wbr/> to use when <a href="#controls_android.tonemap.mode">android.<wbr/>tonemap.<wbr/>mode</a> is
14039CONTRAST_<wbr/>CURVE.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]14040 </td>
14041
14042 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]14043 same as android.<wbr/>tonemap.<wbr/>curve<wbr/>Red
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]14044 </td>
14045
14046 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]14047 <p>same as <a href="#controls_android.tonemap.curveRed">android.<wbr/>tonemap.<wbr/>curve<wbr/>Red</a></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]14048 </td>
14049
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]14050 <td class="entry_tags">
14051 </td>
14052
14053 </tr>
14054 <tr class="entries_header">
14055 <th class="th_details" colspan="5">Details</th>
14056 </tr>
14057 <tr class="entry_cont">
14058 <td class="entry_details" colspan="5">
Igor Murashkin94e06c42014-01-13 16:51:17 -0800[diff] [blame]14059 <p>See <a href="#controls_android.tonemap.curveRed">android.<wbr/>tonemap.<wbr/>curve<wbr/>Red</a> for more details.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]14060 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]14061 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]14062
14063
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]14064 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
14065 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]14066
14067
14068 <tr class="entry" id="controls_android.tonemap.curveGreen">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]14069 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]14070 android.<wbr/>tonemap.<wbr/>curve<wbr/>Green
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]14071 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]14072 <td class="entry_type">
Eino-Ville Talvala76548fe2013-01-11 13:57:19 -0800[diff] [blame]14073 <span class="entry_type_name">float</span>
Zhijun He704d1282013-08-19 15:26:33 -0700[diff] [blame]14074 <span class="entry_type_container">x</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]14075
Zhijun He704d1282013-08-19 15:26:33 -0700[diff] [blame]14076 <span class="entry_type_array">
14077 n x 2
14078 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]14079 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]14080 <div class="entry_type_notes">1D array of float pairs (P_<wbr/>IN,<wbr/> P_<wbr/>OUT).<wbr/> The maximum number of pairs is specified by android.<wbr/>tonemap.<wbr/>max<wbr/>Curve<wbr/>Points.<wbr/></div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]14081
14082
14083 </td> <!-- entry_type -->
14084
14085 <td class="entry_description">
Igor Murashkin94e06c42014-01-13 16:51:17 -0800[diff] [blame]14086 <p>Tonemapping /<wbr/> contrast /<wbr/> gamma curve for the green
14087channel,<wbr/> to use when <a href="#controls_android.tonemap.mode">android.<wbr/>tonemap.<wbr/>mode</a> is
14088CONTRAST_<wbr/>CURVE.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]14089 </td>
14090
14091 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]14092 same as android.<wbr/>tonemap.<wbr/>curve<wbr/>Red
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]14093 </td>
14094
14095 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]14096 <p>same as <a href="#controls_android.tonemap.curveRed">android.<wbr/>tonemap.<wbr/>curve<wbr/>Red</a></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]14097 </td>
14098
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]14099 <td class="entry_tags">
14100 </td>
14101
14102 </tr>
14103 <tr class="entries_header">
14104 <th class="th_details" colspan="5">Details</th>
14105 </tr>
14106 <tr class="entry_cont">
14107 <td class="entry_details" colspan="5">
Igor Murashkin94e06c42014-01-13 16:51:17 -0800[diff] [blame]14108 <p>See <a href="#controls_android.tonemap.curveRed">android.<wbr/>tonemap.<wbr/>curve<wbr/>Red</a> for more details.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]14109 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]14110 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]14111
14112
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]14113 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
14114 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]14115
14116
14117 <tr class="entry" id="controls_android.tonemap.curveRed">
Igor Murashkin94e06c42014-01-13 16:51:17 -0800[diff] [blame]14118 <td class="entry_name" rowspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]14119 android.<wbr/>tonemap.<wbr/>curve<wbr/>Red
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]14120 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]14121 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]14122 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]14123 <span class="entry_type_container">x</span>
14124
14125 <span class="entry_type_array">
14126 n x 2
14127 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]14128 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]14129 <div class="entry_type_notes">1D array of float pairs (P_<wbr/>IN,<wbr/> P_<wbr/>OUT).<wbr/> The maximum number of pairs is specified by android.<wbr/>tonemap.<wbr/>max<wbr/>Curve<wbr/>Points.<wbr/></div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]14130
14131
14132 </td> <!-- entry_type -->
14133
14134 <td class="entry_description">
Igor Murashkin94e06c42014-01-13 16:51:17 -0800[diff] [blame]14135 <p>Tonemapping /<wbr/> contrast /<wbr/> gamma curve for the red
14136channel,<wbr/> to use when <a href="#controls_android.tonemap.mode">android.<wbr/>tonemap.<wbr/>mode</a> is
14137CONTRAST_<wbr/>CURVE.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]14138 </td>
14139
14140 <td class="entry_units">
14141 </td>
14142
14143 <td class="entry_range">
Igor Murashkin94e06c42014-01-13 16:51:17 -0800[diff] [blame]14144 <p>0-1 on both input and output coordinates,<wbr/> normalized
14145as a floating-point value such that 0 == black and 1 == white.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]14146 </td>
14147
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]14148 <td class="entry_tags">
14149 <ul class="entry_tags">
14150 <li><a href="#tag_DNG">DNG</a></li>
14151 </ul>
14152 </td>
14153
14154 </tr>
14155 <tr class="entries_header">
14156 <th class="th_details" colspan="5">Details</th>
14157 </tr>
14158 <tr class="entry_cont">
14159 <td class="entry_details" colspan="5">
Igor Murashkin94e06c42014-01-13 16:51:17 -0800[diff] [blame]14160 <p>Each channel's curve is defined by an array of control points:</p>
14161<pre><code><a href="#controls_android.tonemap.curveRed">android.<wbr/>tonemap.<wbr/>curve<wbr/>Red</a> =
14162 [ P0in,<wbr/> P0out,<wbr/> P1in,<wbr/> P1out,<wbr/> P2in,<wbr/> P2out,<wbr/> P3in,<wbr/> P3out,<wbr/> ...,<wbr/> PNin,<wbr/> PNout ]
141632 &lt;= N &lt;= <a href="#static_android.tonemap.maxCurvePoints">android.<wbr/>tonemap.<wbr/>max<wbr/>Curve<wbr/>Points</a></code></pre>
14164<p>These are sorted in order of increasing <code>Pin</code>; it is always
14165guaranteed that input values 0.<wbr/>0 and 1.<wbr/>0 are included in the list to
14166define a complete mapping.<wbr/> For input values between control points,<wbr/>
14167the camera device must linearly interpolate between the control
14168points.<wbr/></p>
14169<p>Each curve can have an independent number of points,<wbr/> and the number
14170of points can be less than max (that is,<wbr/> the request doesn't have to
14171always provide a curve with number of points equivalent to
14172<a href="#static_android.tonemap.maxCurvePoints">android.<wbr/>tonemap.<wbr/>max<wbr/>Curve<wbr/>Points</a>).<wbr/></p>
14173<p>A few examples,<wbr/> and their corresponding graphical mappings; these
14174only specify the red channel and the precision is limited to 4
14175digits,<wbr/> for conciseness.<wbr/></p>
14176<p>Linear mapping:</p>
14177<pre><code><a href="#controls_android.tonemap.curveRed">android.<wbr/>tonemap.<wbr/>curve<wbr/>Red</a> = [ 0,<wbr/> 0,<wbr/> 1.<wbr/>0,<wbr/> 1.<wbr/>0 ]
14178</code></pre>
14179<p><img alt="Linear mapping curve" src="images/camera2/metadata/android.tonemap.curveRed/linear_tonemap.png"/></p>
14180<p>Invert mapping:</p>
14181<pre><code><a href="#controls_android.tonemap.curveRed">android.<wbr/>tonemap.<wbr/>curve<wbr/>Red</a> = [ 0,<wbr/> 1.<wbr/>0,<wbr/> 1.<wbr/>0,<wbr/> 0 ]
14182</code></pre>
14183<p><img alt="Inverting mapping curve" src="images/camera2/metadata/android.tonemap.curveRed/inverse_tonemap.png"/></p>
14184<p>Gamma 1/<wbr/>2.<wbr/>2 mapping,<wbr/> with 16 control points:</p>
14185<pre><code><a href="#controls_android.tonemap.curveRed">android.<wbr/>tonemap.<wbr/>curve<wbr/>Red</a> = [
14186 0.<wbr/>0000,<wbr/> 0.<wbr/>0000,<wbr/> 0.<wbr/>0667,<wbr/> 0.<wbr/>2920,<wbr/> 0.<wbr/>1333,<wbr/> 0.<wbr/>4002,<wbr/> 0.<wbr/>2000,<wbr/> 0.<wbr/>4812,<wbr/>
14187 0.<wbr/>2667,<wbr/> 0.<wbr/>5484,<wbr/> 0.<wbr/>3333,<wbr/> 0.<wbr/>6069,<wbr/> 0.<wbr/>4000,<wbr/> 0.<wbr/>6594,<wbr/> 0.<wbr/>4667,<wbr/> 0.<wbr/>7072,<wbr/>
14188 0.<wbr/>5333,<wbr/> 0.<wbr/>7515,<wbr/> 0.<wbr/>6000,<wbr/> 0.<wbr/>7928,<wbr/> 0.<wbr/>6667,<wbr/> 0.<wbr/>8317,<wbr/> 0.<wbr/>7333,<wbr/> 0.<wbr/>8685,<wbr/>
14189 0.<wbr/>8000,<wbr/> 0.<wbr/>9035,<wbr/> 0.<wbr/>8667,<wbr/> 0.<wbr/>9370,<wbr/> 0.<wbr/>9333,<wbr/> 0.<wbr/>9691,<wbr/> 1.<wbr/>0000,<wbr/> 1.<wbr/>0000 ]
14190</code></pre>
14191<p><img alt="Gamma = 1/2.2 tonemapping curve" src="images/camera2/metadata/android.tonemap.curveRed/gamma_tonemap.png"/></p>
14192<p>Standard sRGB gamma mapping,<wbr/> per IEC 61966-2-1:1999,<wbr/> with 16 control points:</p>
14193<pre><code><a href="#controls_android.tonemap.curveRed">android.<wbr/>tonemap.<wbr/>curve<wbr/>Red</a> = [
14194 0.<wbr/>0000,<wbr/> 0.<wbr/>0000,<wbr/> 0.<wbr/>0667,<wbr/> 0.<wbr/>2864,<wbr/> 0.<wbr/>1333,<wbr/> 0.<wbr/>4007,<wbr/> 0.<wbr/>2000,<wbr/> 0.<wbr/>4845,<wbr/>
14195 0.<wbr/>2667,<wbr/> 0.<wbr/>5532,<wbr/> 0.<wbr/>3333,<wbr/> 0.<wbr/>6125,<wbr/> 0.<wbr/>4000,<wbr/> 0.<wbr/>6652,<wbr/> 0.<wbr/>4667,<wbr/> 0.<wbr/>7130,<wbr/>
14196 0.<wbr/>5333,<wbr/> 0.<wbr/>7569,<wbr/> 0.<wbr/>6000,<wbr/> 0.<wbr/>7977,<wbr/> 0.<wbr/>6667,<wbr/> 0.<wbr/>8360,<wbr/> 0.<wbr/>7333,<wbr/> 0.<wbr/>8721,<wbr/>
14197 0.<wbr/>8000,<wbr/> 0.<wbr/>9063,<wbr/> 0.<wbr/>8667,<wbr/> 0.<wbr/>9389,<wbr/> 0.<wbr/>9333,<wbr/> 0.<wbr/>9701,<wbr/> 1.<wbr/>0000,<wbr/> 1.<wbr/>0000 ]
14198</code></pre>
14199<p><img alt="sRGB tonemapping curve" src="images/camera2/metadata/android.tonemap.curveRed/srgb_tonemap.png"/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]14200 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]14201 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]14202
Igor Murashkin94e06c42014-01-13 16:51:17 -0800[diff] [blame]14203 <tr class="entries_header">
14204 <th class="th_details" colspan="5">HAL Implementation Details</th>
14205 </tr>
14206 <tr class="entry_cont">
14207 <td class="entry_details" colspan="5">
14208 <p>For good quality of mapping,<wbr/> at least 128 control points are
14209preferred.<wbr/></p>
14210<p>A typical use case of this would be a gamma-1/<wbr/>2.<wbr/>2 curve,<wbr/> with as many
14211control points used as are available.<wbr/></p>
14212 </td>
14213 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]14214
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]14215 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
14216 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]14217
14218
14219 <tr class="entry" id="controls_android.tonemap.mode">
Igor Murashkin94e06c42014-01-13 16:51:17 -0800[diff] [blame]14220 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]14221 android.<wbr/>tonemap.<wbr/>mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]14222 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]14223 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]14224 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]14225
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]14226 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]14227
14228 <ul class="entry_type_enum">
14229 <li>
14230 <span class="entry_type_enum_name">CONTRAST_CURVE</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]14231 <span class="entry_type_enum_notes"><p>Use the tone mapping curve specified in
Igor Murashkin94e06c42014-01-13 16:51:17 -0800[diff] [blame]14232android.<wbr/>tonemap.<wbr/>curve.<wbr/></p>
14233<p>All color enhancement and tonemapping must be disabled,<wbr/> except
14234for applying the tonemapping curve specified by
14235<a href="#controls_android.tonemap.curveRed">android.<wbr/>tonemap.<wbr/>curve<wbr/>Red</a>,<wbr/> <a href="#controls_android.tonemap.curveBlue">android.<wbr/>tonemap.<wbr/>curve<wbr/>Blue</a>,<wbr/> or
14236<a href="#controls_android.tonemap.curveGreen">android.<wbr/>tonemap.<wbr/>curve<wbr/>Green</a>.<wbr/></p>
14237<p>Must not slow down frame rate relative to raw
14238sensor output.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]14239 </li>
14240 <li>
14241 <span class="entry_type_enum_name">FAST</span>
Igor Murashkin94e06c42014-01-13 16:51:17 -0800[diff] [blame]14242 <span class="entry_type_enum_notes"><p>Advanced gamma mapping and color enhancement may be applied.<wbr/></p>
14243<p>Should not slow down frame rate relative to raw sensor output.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]14244 </li>
14245 <li>
14246 <span class="entry_type_enum_name">HIGH_QUALITY</span>
Igor Murashkin94e06c42014-01-13 16:51:17 -0800[diff] [blame]14247 <span class="entry_type_enum_notes"><p>Advanced gamma mapping and color enhancement may be applied.<wbr/></p>
14248<p>May slow down frame rate relative to raw sensor output.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]14249 </li>
14250 </ul>
14251
14252 </td> <!-- entry_type -->
14253
14254 <td class="entry_description">
Igor Murashkin94e06c42014-01-13 16:51:17 -0800[diff] [blame]14255 <p>High-level global contrast/<wbr/>gamma/<wbr/>tonemapping control.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]14256 </td>
14257
14258 <td class="entry_units">
14259 </td>
14260
14261 <td class="entry_range">
14262 </td>
14263
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]14264 <td class="entry_tags">
14265 </td>
14266
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]14267 </tr>
Igor Murashkin94e06c42014-01-13 16:51:17 -0800[diff] [blame]14268 <tr class="entries_header">
14269 <th class="th_details" colspan="5">Details</th>
14270 </tr>
14271 <tr class="entry_cont">
14272 <td class="entry_details" colspan="5">
14273 <p>When switching to an application-defined contrast curve by setting
14274<a href="#controls_android.tonemap.mode">android.<wbr/>tonemap.<wbr/>mode</a> to CONTRAST_<wbr/>CURVE,<wbr/> the curve is defined
14275per-channel with a set of <code>(in,<wbr/> out)</code> points that specify the
14276mapping from input high-bit-depth pixel value to the output
14277low-bit-depth value.<wbr/> Since the actual pixel ranges of both input
14278and output may change depending on the camera pipeline,<wbr/> the values
14279are specified by normalized floating-point numbers.<wbr/></p>
14280<p>More-complex color mapping operations such as 3D color look-up
14281tables,<wbr/> selective chroma enhancement,<wbr/> or other non-linear color
14282transforms will be disabled when <a href="#controls_android.tonemap.mode">android.<wbr/>tonemap.<wbr/>mode</a> is
14283CONTRAST_<wbr/>CURVE.<wbr/></p>
14284<p>When using either FAST or HIGH_<wbr/>QUALITY,<wbr/> the camera device will
14285emit its own tonemap curve in <a href="#controls_android.tonemap.curveRed">android.<wbr/>tonemap.<wbr/>curve<wbr/>Red</a>,<wbr/>
14286<a href="#controls_android.tonemap.curveGreen">android.<wbr/>tonemap.<wbr/>curve<wbr/>Green</a>,<wbr/> and <a href="#controls_android.tonemap.curveBlue">android.<wbr/>tonemap.<wbr/>curve<wbr/>Blue</a>.<wbr/>
14287These values are always available,<wbr/> and as close as possible to the
14288actually used nonlinear/<wbr/>nonglobal transforms.<wbr/></p>
14289<p>If a request is sent with TRANSFORM_<wbr/>MATRIX with the camera device's
14290provided curve in FAST or HIGH_<wbr/>QUALITY,<wbr/> the image's tonemap will be
14291roughly the same.<wbr/></p>
14292 </td>
14293 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]14294
14295
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]14296 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
14297 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]14298
14299
14300
14301 <!-- end of kind -->
14302 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]14303 <tr><td colspan="6" class="kind">static</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]14304
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]14305 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]14306 <tr>
14307 <th class="th_name">Property Name</th>
14308 <th class="th_type">Type</th>
14309 <th class="th_description">Description</th>
14310 <th class="th_units">Units</th>
14311 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]14312 <th class="th_tags">Tags</th>
14313 </tr>
14314 </thead>
14315
14316 <tbody>
14317
14318
14319
14320
14321
14322
14323
14324
14325
14326
14327 <tr class="entry" id="static_android.tonemap.maxCurvePoints">
Igor Murashkin94e06c42014-01-13 16:51:17 -0800[diff] [blame]14328 <td class="entry_name" rowspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]14329 android.<wbr/>tonemap.<wbr/>max<wbr/>Curve<wbr/>Points
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]14330 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]14331 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]14332 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]14333
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]14334 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]14335
14336
14337 </td> <!-- entry_type -->
14338
14339 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]14340 <p>Maximum number of supported points in the
Igor Murashkin94e06c42014-01-13 16:51:17 -0800[diff] [blame]14341tonemap curve that can be used for <a href="#controls_android.tonemap.curveRed">android.<wbr/>tonemap.<wbr/>curve<wbr/>Red</a>,<wbr/> or
14342<a href="#controls_android.tonemap.curveGreen">android.<wbr/>tonemap.<wbr/>curve<wbr/>Green</a>,<wbr/> or <a href="#controls_android.tonemap.curveBlue">android.<wbr/>tonemap.<wbr/>curve<wbr/>Blue</a>.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]14343 </td>
14344
14345 <td class="entry_units">
14346 </td>
14347
14348 <td class="entry_range">
Igor Murashkin94e06c42014-01-13 16:51:17 -0800[diff] [blame]14349 <p>&gt;= 64</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]14350 </td>
14351
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]14352 <td class="entry_tags">
14353 </td>
14354
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]14355 </tr>
Igor Murashkin94e06c42014-01-13 16:51:17 -0800[diff] [blame]14356 <tr class="entries_header">
14357 <th class="th_details" colspan="5">Details</th>
14358 </tr>
14359 <tr class="entry_cont">
14360 <td class="entry_details" colspan="5">
14361 <p>If the actual number of points provided by the application (in
14362android.<wbr/>tonemap.<wbr/>curve*) is less than max,<wbr/> the camera device will
14363resample the curve to its internal representation,<wbr/> using linear
14364interpolation.<wbr/></p>
14365<p>The output curves in the result metadata may have a different number
14366of points than the input curves,<wbr/> and will represent the actual
14367hardware curves used as closely as possible when linearly interpolated.<wbr/></p>
14368 </td>
14369 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]14370
Igor Murashkin94e06c42014-01-13 16:51:17 -0800[diff] [blame]14371 <tr class="entries_header">
14372 <th class="th_details" colspan="5">HAL Implementation Details</th>
14373 </tr>
14374 <tr class="entry_cont">
14375 <td class="entry_details" colspan="5">
14376 <p>This value must be at least 64.<wbr/> This should be at least 128.<wbr/></p>
14377 </td>
14378 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]14379
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]14380 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
14381 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]14382
14383
14384
14385 <!-- end of kind -->
14386 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]14387 <tr><td colspan="6" class="kind">dynamic</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]14388
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]14389 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]14390 <tr>
14391 <th class="th_name">Property Name</th>
14392 <th class="th_type">Type</th>
14393 <th class="th_description">Description</th>
14394 <th class="th_units">Units</th>
14395 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]14396 <th class="th_tags">Tags</th>
14397 </tr>
14398 </thead>
14399
14400 <tbody>
14401
14402
14403
14404
14405
14406
14407
14408
14409
14410
14411 <tr class="entry" id="dynamic_android.tonemap.curveBlue">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]14412 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]14413 android.<wbr/>tonemap.<wbr/>curve<wbr/>Blue
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]14414 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]14415 <td class="entry_type">
Eino-Ville Talvala76548fe2013-01-11 13:57:19 -0800[diff] [blame]14416 <span class="entry_type_name">float</span>
Zhijun He704d1282013-08-19 15:26:33 -0700[diff] [blame]14417 <span class="entry_type_container">x</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]14418
Zhijun He704d1282013-08-19 15:26:33 -0700[diff] [blame]14419 <span class="entry_type_array">
14420 n x 2
14421 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]14422 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]14423 <div class="entry_type_notes">1D array of float pairs (P_<wbr/>IN,<wbr/> P_<wbr/>OUT).<wbr/> The maximum number of pairs is specified by android.<wbr/>tonemap.<wbr/>max<wbr/>Curve<wbr/>Points.<wbr/></div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]14424
14425
14426 </td> <!-- entry_type -->
14427
14428 <td class="entry_description">
Igor Murashkin94e06c42014-01-13 16:51:17 -0800[diff] [blame]14429 <p>Tonemapping /<wbr/> contrast /<wbr/> gamma curve for the blue
14430channel,<wbr/> to use when <a href="#controls_android.tonemap.mode">android.<wbr/>tonemap.<wbr/>mode</a> is
14431CONTRAST_<wbr/>CURVE.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]14432 </td>
14433
14434 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]14435 same as android.<wbr/>tonemap.<wbr/>curve<wbr/>Red
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]14436 </td>
14437
14438 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]14439 <p>same as <a href="#controls_android.tonemap.curveRed">android.<wbr/>tonemap.<wbr/>curve<wbr/>Red</a></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]14440 </td>
14441
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]14442 <td class="entry_tags">
14443 </td>
14444
14445 </tr>
14446 <tr class="entries_header">
14447 <th class="th_details" colspan="5">Details</th>
14448 </tr>
14449 <tr class="entry_cont">
14450 <td class="entry_details" colspan="5">
Igor Murashkin94e06c42014-01-13 16:51:17 -0800[diff] [blame]14451 <p>See <a href="#controls_android.tonemap.curveRed">android.<wbr/>tonemap.<wbr/>curve<wbr/>Red</a> for more details.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]14452 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]14453 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]14454
14455
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]14456 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
14457 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]14458
14459
14460 <tr class="entry" id="dynamic_android.tonemap.curveGreen">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]14461 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]14462 android.<wbr/>tonemap.<wbr/>curve<wbr/>Green
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]14463 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]14464 <td class="entry_type">
Eino-Ville Talvala76548fe2013-01-11 13:57:19 -0800[diff] [blame]14465 <span class="entry_type_name">float</span>
Zhijun He704d1282013-08-19 15:26:33 -0700[diff] [blame]14466 <span class="entry_type_container">x</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]14467
Zhijun He704d1282013-08-19 15:26:33 -0700[diff] [blame]14468 <span class="entry_type_array">
14469 n x 2
14470 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]14471 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]14472 <div class="entry_type_notes">1D array of float pairs (P_<wbr/>IN,<wbr/> P_<wbr/>OUT).<wbr/> The maximum number of pairs is specified by android.<wbr/>tonemap.<wbr/>max<wbr/>Curve<wbr/>Points.<wbr/></div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]14473
14474
14475 </td> <!-- entry_type -->
14476
14477 <td class="entry_description">
Igor Murashkin94e06c42014-01-13 16:51:17 -0800[diff] [blame]14478 <p>Tonemapping /<wbr/> contrast /<wbr/> gamma curve for the green
14479channel,<wbr/> to use when <a href="#controls_android.tonemap.mode">android.<wbr/>tonemap.<wbr/>mode</a> is
14480CONTRAST_<wbr/>CURVE.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]14481 </td>
14482
14483 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]14484 same as android.<wbr/>tonemap.<wbr/>curve<wbr/>Red
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]14485 </td>
14486
14487 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]14488 <p>same as <a href="#controls_android.tonemap.curveRed">android.<wbr/>tonemap.<wbr/>curve<wbr/>Red</a></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]14489 </td>
14490
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]14491 <td class="entry_tags">
14492 </td>
14493
14494 </tr>
14495 <tr class="entries_header">
14496 <th class="th_details" colspan="5">Details</th>
14497 </tr>
14498 <tr class="entry_cont">
14499 <td class="entry_details" colspan="5">
Igor Murashkin94e06c42014-01-13 16:51:17 -0800[diff] [blame]14500 <p>See <a href="#controls_android.tonemap.curveRed">android.<wbr/>tonemap.<wbr/>curve<wbr/>Red</a> for more details.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]14501 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]14502 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]14503
14504
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]14505 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
14506 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]14507
14508
14509 <tr class="entry" id="dynamic_android.tonemap.curveRed">
Igor Murashkin94e06c42014-01-13 16:51:17 -0800[diff] [blame]14510 <td class="entry_name" rowspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]14511 android.<wbr/>tonemap.<wbr/>curve<wbr/>Red
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]14512 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]14513 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]14514 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]14515 <span class="entry_type_container">x</span>
14516
14517 <span class="entry_type_array">
14518 n x 2
14519 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]14520 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]14521 <div class="entry_type_notes">1D array of float pairs (P_<wbr/>IN,<wbr/> P_<wbr/>OUT).<wbr/> The maximum number of pairs is specified by android.<wbr/>tonemap.<wbr/>max<wbr/>Curve<wbr/>Points.<wbr/></div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]14522
14523
14524 </td> <!-- entry_type -->
14525
14526 <td class="entry_description">
Igor Murashkin94e06c42014-01-13 16:51:17 -0800[diff] [blame]14527 <p>Tonemapping /<wbr/> contrast /<wbr/> gamma curve for the red
14528channel,<wbr/> to use when <a href="#controls_android.tonemap.mode">android.<wbr/>tonemap.<wbr/>mode</a> is
14529CONTRAST_<wbr/>CURVE.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]14530 </td>
14531
14532 <td class="entry_units">
14533 </td>
14534
14535 <td class="entry_range">
Igor Murashkin94e06c42014-01-13 16:51:17 -0800[diff] [blame]14536 <p>0-1 on both input and output coordinates,<wbr/> normalized
14537as a floating-point value such that 0 == black and 1 == white.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]14538 </td>
14539
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]14540 <td class="entry_tags">
14541 <ul class="entry_tags">
14542 <li><a href="#tag_DNG">DNG</a></li>
14543 </ul>
14544 </td>
14545
14546 </tr>
14547 <tr class="entries_header">
14548 <th class="th_details" colspan="5">Details</th>
14549 </tr>
14550 <tr class="entry_cont">
14551 <td class="entry_details" colspan="5">
Igor Murashkin94e06c42014-01-13 16:51:17 -0800[diff] [blame]14552 <p>Each channel's curve is defined by an array of control points:</p>
14553<pre><code><a href="#controls_android.tonemap.curveRed">android.<wbr/>tonemap.<wbr/>curve<wbr/>Red</a> =
14554 [ P0in,<wbr/> P0out,<wbr/> P1in,<wbr/> P1out,<wbr/> P2in,<wbr/> P2out,<wbr/> P3in,<wbr/> P3out,<wbr/> ...,<wbr/> PNin,<wbr/> PNout ]
145552 &lt;= N &lt;= <a href="#static_android.tonemap.maxCurvePoints">android.<wbr/>tonemap.<wbr/>max<wbr/>Curve<wbr/>Points</a></code></pre>
14556<p>These are sorted in order of increasing <code>Pin</code>; it is always
14557guaranteed that input values 0.<wbr/>0 and 1.<wbr/>0 are included in the list to
14558define a complete mapping.<wbr/> For input values between control points,<wbr/>
14559the camera device must linearly interpolate between the control
14560points.<wbr/></p>
14561<p>Each curve can have an independent number of points,<wbr/> and the number
14562of points can be less than max (that is,<wbr/> the request doesn't have to
14563always provide a curve with number of points equivalent to
14564<a href="#static_android.tonemap.maxCurvePoints">android.<wbr/>tonemap.<wbr/>max<wbr/>Curve<wbr/>Points</a>).<wbr/></p>
14565<p>A few examples,<wbr/> and their corresponding graphical mappings; these
14566only specify the red channel and the precision is limited to 4
14567digits,<wbr/> for conciseness.<wbr/></p>
14568<p>Linear mapping:</p>
14569<pre><code><a href="#controls_android.tonemap.curveRed">android.<wbr/>tonemap.<wbr/>curve<wbr/>Red</a> = [ 0,<wbr/> 0,<wbr/> 1.<wbr/>0,<wbr/> 1.<wbr/>0 ]
14570</code></pre>
14571<p><img alt="Linear mapping curve" src="images/camera2/metadata/android.tonemap.curveRed/linear_tonemap.png"/></p>
14572<p>Invert mapping:</p>
14573<pre><code><a href="#controls_android.tonemap.curveRed">android.<wbr/>tonemap.<wbr/>curve<wbr/>Red</a> = [ 0,<wbr/> 1.<wbr/>0,<wbr/> 1.<wbr/>0,<wbr/> 0 ]
14574</code></pre>
14575<p><img alt="Inverting mapping curve" src="images/camera2/metadata/android.tonemap.curveRed/inverse_tonemap.png"/></p>
14576<p>Gamma 1/<wbr/>2.<wbr/>2 mapping,<wbr/> with 16 control points:</p>
14577<pre><code><a href="#controls_android.tonemap.curveRed">android.<wbr/>tonemap.<wbr/>curve<wbr/>Red</a> = [
14578 0.<wbr/>0000,<wbr/> 0.<wbr/>0000,<wbr/> 0.<wbr/>0667,<wbr/> 0.<wbr/>2920,<wbr/> 0.<wbr/>1333,<wbr/> 0.<wbr/>4002,<wbr/> 0.<wbr/>2000,<wbr/> 0.<wbr/>4812,<wbr/>
14579 0.<wbr/>2667,<wbr/> 0.<wbr/>5484,<wbr/> 0.<wbr/>3333,<wbr/> 0.<wbr/>6069,<wbr/> 0.<wbr/>4000,<wbr/> 0.<wbr/>6594,<wbr/> 0.<wbr/>4667,<wbr/> 0.<wbr/>7072,<wbr/>
14580 0.<wbr/>5333,<wbr/> 0.<wbr/>7515,<wbr/> 0.<wbr/>6000,<wbr/> 0.<wbr/>7928,<wbr/> 0.<wbr/>6667,<wbr/> 0.<wbr/>8317,<wbr/> 0.<wbr/>7333,<wbr/> 0.<wbr/>8685,<wbr/>
14581 0.<wbr/>8000,<wbr/> 0.<wbr/>9035,<wbr/> 0.<wbr/>8667,<wbr/> 0.<wbr/>9370,<wbr/> 0.<wbr/>9333,<wbr/> 0.<wbr/>9691,<wbr/> 1.<wbr/>0000,<wbr/> 1.<wbr/>0000 ]
14582</code></pre>
14583<p><img alt="Gamma = 1/2.2 tonemapping curve" src="images/camera2/metadata/android.tonemap.curveRed/gamma_tonemap.png"/></p>
14584<p>Standard sRGB gamma mapping,<wbr/> per IEC 61966-2-1:1999,<wbr/> with 16 control points:</p>
14585<pre><code><a href="#controls_android.tonemap.curveRed">android.<wbr/>tonemap.<wbr/>curve<wbr/>Red</a> = [
14586 0.<wbr/>0000,<wbr/> 0.<wbr/>0000,<wbr/> 0.<wbr/>0667,<wbr/> 0.<wbr/>2864,<wbr/> 0.<wbr/>1333,<wbr/> 0.<wbr/>4007,<wbr/> 0.<wbr/>2000,<wbr/> 0.<wbr/>4845,<wbr/>
14587 0.<wbr/>2667,<wbr/> 0.<wbr/>5532,<wbr/> 0.<wbr/>3333,<wbr/> 0.<wbr/>6125,<wbr/> 0.<wbr/>4000,<wbr/> 0.<wbr/>6652,<wbr/> 0.<wbr/>4667,<wbr/> 0.<wbr/>7130,<wbr/>
14588 0.<wbr/>5333,<wbr/> 0.<wbr/>7569,<wbr/> 0.<wbr/>6000,<wbr/> 0.<wbr/>7977,<wbr/> 0.<wbr/>6667,<wbr/> 0.<wbr/>8360,<wbr/> 0.<wbr/>7333,<wbr/> 0.<wbr/>8721,<wbr/>
14589 0.<wbr/>8000,<wbr/> 0.<wbr/>9063,<wbr/> 0.<wbr/>8667,<wbr/> 0.<wbr/>9389,<wbr/> 0.<wbr/>9333,<wbr/> 0.<wbr/>9701,<wbr/> 1.<wbr/>0000,<wbr/> 1.<wbr/>0000 ]
14590</code></pre>
14591<p><img alt="sRGB tonemapping curve" src="images/camera2/metadata/android.tonemap.curveRed/srgb_tonemap.png"/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]14592 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]14593 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]14594
Igor Murashkin94e06c42014-01-13 16:51:17 -0800[diff] [blame]14595 <tr class="entries_header">
14596 <th class="th_details" colspan="5">HAL Implementation Details</th>
14597 </tr>
14598 <tr class="entry_cont">
14599 <td class="entry_details" colspan="5">
14600 <p>For good quality of mapping,<wbr/> at least 128 control points are
14601preferred.<wbr/></p>
14602<p>A typical use case of this would be a gamma-1/<wbr/>2.<wbr/>2 curve,<wbr/> with as many
14603control points used as are available.<wbr/></p>
14604 </td>
14605 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]14606
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]14607 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
14608 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]14609
14610
14611 <tr class="entry" id="dynamic_android.tonemap.mode">
Igor Murashkin94e06c42014-01-13 16:51:17 -0800[diff] [blame]14612 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]14613 android.<wbr/>tonemap.<wbr/>mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]14614 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]14615 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]14616 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]14617
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]14618 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]14619
14620 <ul class="entry_type_enum">
14621 <li>
14622 <span class="entry_type_enum_name">CONTRAST_CURVE</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]14623 <span class="entry_type_enum_notes"><p>Use the tone mapping curve specified in
Igor Murashkin94e06c42014-01-13 16:51:17 -0800[diff] [blame]14624android.<wbr/>tonemap.<wbr/>curve.<wbr/></p>
14625<p>All color enhancement and tonemapping must be disabled,<wbr/> except
14626for applying the tonemapping curve specified by
14627<a href="#controls_android.tonemap.curveRed">android.<wbr/>tonemap.<wbr/>curve<wbr/>Red</a>,<wbr/> <a href="#controls_android.tonemap.curveBlue">android.<wbr/>tonemap.<wbr/>curve<wbr/>Blue</a>,<wbr/> or
14628<a href="#controls_android.tonemap.curveGreen">android.<wbr/>tonemap.<wbr/>curve<wbr/>Green</a>.<wbr/></p>
14629<p>Must not slow down frame rate relative to raw
14630sensor output.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]14631 </li>
14632 <li>
14633 <span class="entry_type_enum_name">FAST</span>
Igor Murashkin94e06c42014-01-13 16:51:17 -0800[diff] [blame]14634 <span class="entry_type_enum_notes"><p>Advanced gamma mapping and color enhancement may be applied.<wbr/></p>
14635<p>Should not slow down frame rate relative to raw sensor output.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]14636 </li>
14637 <li>
14638 <span class="entry_type_enum_name">HIGH_QUALITY</span>
Igor Murashkin94e06c42014-01-13 16:51:17 -0800[diff] [blame]14639 <span class="entry_type_enum_notes"><p>Advanced gamma mapping and color enhancement may be applied.<wbr/></p>
14640<p>May slow down frame rate relative to raw sensor output.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]14641 </li>
14642 </ul>
14643
14644 </td> <!-- entry_type -->
14645
14646 <td class="entry_description">
Igor Murashkin94e06c42014-01-13 16:51:17 -0800[diff] [blame]14647 <p>High-level global contrast/<wbr/>gamma/<wbr/>tonemapping control.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]14648 </td>
14649
14650 <td class="entry_units">
14651 </td>
14652
14653 <td class="entry_range">
14654 </td>
14655
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]14656 <td class="entry_tags">
14657 </td>
14658
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]14659 </tr>
Igor Murashkin595f45b2014-01-17 17:27:15 -0800[diff] [blame]14660 <tr class="entries_header">
14661 <th class="th_details" colspan="5">Details</th>
14662 </tr>
14663 <tr class="entry_cont">
14664 <td class="entry_details" colspan="5">
14665 <p>When switching to an application-defined contrast curve by setting
14666<a href="#controls_android.tonemap.mode">android.<wbr/>tonemap.<wbr/>mode</a> to CONTRAST_<wbr/>CURVE,<wbr/> the curve is defined
14667per-channel with a set of <code>(in,<wbr/> out)</code> points that specify the
14668mapping from input high-bit-depth pixel value to the output
14669low-bit-depth value.<wbr/> Since the actual pixel ranges of both input
14670and output may change depending on the camera pipeline,<wbr/> the values
14671are specified by normalized floating-point numbers.<wbr/></p>
14672<p>More-complex color mapping operations such as 3D color look-up
14673tables,<wbr/> selective chroma enhancement,<wbr/> or other non-linear color
14674transforms will be disabled when <a href="#controls_android.tonemap.mode">android.<wbr/>tonemap.<wbr/>mode</a> is
14675CONTRAST_<wbr/>CURVE.<wbr/></p>
14676<p>When using either FAST or HIGH_<wbr/>QUALITY,<wbr/> the camera device will
14677emit its own tonemap curve in <a href="#controls_android.tonemap.curveRed">android.<wbr/>tonemap.<wbr/>curve<wbr/>Red</a>,<wbr/>
14678<a href="#controls_android.tonemap.curveGreen">android.<wbr/>tonemap.<wbr/>curve<wbr/>Green</a>,<wbr/> and <a href="#controls_android.tonemap.curveBlue">android.<wbr/>tonemap.<wbr/>curve<wbr/>Blue</a>.<wbr/>
14679These values are always available,<wbr/> and as close as possible to the
14680actually used nonlinear/<wbr/>nonglobal transforms.<wbr/></p>
14681<p>If a request is sent with TRANSFORM_<wbr/>MATRIX with the camera device's
14682provided curve in FAST or HIGH_<wbr/>QUALITY,<wbr/> the image's tonemap will be
14683roughly the same.<wbr/></p>
14684 </td>
14685 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]14686
14687
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]14688 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
14689 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]14690
14691
14692
14693 <!-- end of kind -->
14694 </tbody>
14695
14696 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]14697 <tr><td colspan="6" id="section_led" class="section">led</td></tr>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]14698
14699
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]14700 <tr><td colspan="6" class="kind">controls</td></tr>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]14701
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]14702 <thead class="entries_header">
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]14703 <tr>
14704 <th class="th_name">Property Name</th>
14705 <th class="th_type">Type</th>
14706 <th class="th_description">Description</th>
14707 <th class="th_units">Units</th>
14708 <th class="th_range">Range</th>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]14709 <th class="th_tags">Tags</th>
14710 </tr>
14711 </thead>
14712
14713 <tbody>
14714
14715
14716
14717
14718
14719
14720
14721
14722
14723
14724 <tr class="entry" id="controls_android.led.transmit">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]14725 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]14726 android.<wbr/>led.<wbr/>transmit
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]14727 </td>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]14728 <td class="entry_type">
14729 <span class="entry_type_name entry_type_name_enum">byte</span>
14730
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]14731 <span class="entry_type_visibility"> [hidden as boolean]</span>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]14732
14733 <ul class="entry_type_enum">
14734 <li>
14735 <span class="entry_type_enum_name">OFF</span>
14736 </li>
14737 <li>
14738 <span class="entry_type_enum_name">ON</span>
14739 </li>
14740 </ul>
14741
14742 </td> <!-- entry_type -->
14743
14744 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]14745 <p>This LED is nominally used to indicate to the user
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]14746that the camera is powered on and may be streaming images back to the
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]14747Application Processor.<wbr/> In certain rare circumstances,<wbr/> the OS may
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]14748disable this when video is processed locally and not transmitted to
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]14749any untrusted applications.<wbr/></p>
14750<p>In particular,<wbr/> the LED <em>must</em> always be on when the data could be
14751transmitted off the device.<wbr/> The LED <em>should</em> always be on whenever
14752data is stored locally on the device.<wbr/></p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]14753<p>The LED <em>may</em> be off if a trusted application is using the data that
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]14754doesn't violate the above rules.<wbr/></p>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]14755 </td>
14756
14757 <td class="entry_units">
14758 </td>
14759
14760 <td class="entry_range">
14761 </td>
14762
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]14763 <td class="entry_tags">
14764 </td>
14765
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]14766 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]14767
14768
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]14769 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
14770 <!-- end of entry -->
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]14771
14772
14773
14774 <!-- end of kind -->
14775 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]14776 <tr><td colspan="6" class="kind">dynamic</td></tr>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]14777
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]14778 <thead class="entries_header">
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]14779 <tr>
14780 <th class="th_name">Property Name</th>
14781 <th class="th_type">Type</th>
14782 <th class="th_description">Description</th>
14783 <th class="th_units">Units</th>
14784 <th class="th_range">Range</th>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]14785 <th class="th_tags">Tags</th>
14786 </tr>
14787 </thead>
14788
14789 <tbody>
14790
14791
14792
14793
14794
14795
14796
14797
14798
14799
14800 <tr class="entry" id="dynamic_android.led.transmit">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]14801 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]14802 android.<wbr/>led.<wbr/>transmit
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]14803 </td>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]14804 <td class="entry_type">
14805 <span class="entry_type_name entry_type_name_enum">byte</span>
14806
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]14807 <span class="entry_type_visibility"> [hidden as boolean]</span>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]14808
14809 <ul class="entry_type_enum">
14810 <li>
14811 <span class="entry_type_enum_name">OFF</span>
14812 </li>
14813 <li>
14814 <span class="entry_type_enum_name">ON</span>
14815 </li>
14816 </ul>
14817
14818 </td> <!-- entry_type -->
14819
14820 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]14821 <p>This LED is nominally used to indicate to the user
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]14822that the camera is powered on and may be streaming images back to the
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]14823Application Processor.<wbr/> In certain rare circumstances,<wbr/> the OS may
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]14824disable this when video is processed locally and not transmitted to
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]14825any untrusted applications.<wbr/></p>
14826<p>In particular,<wbr/> the LED <em>must</em> always be on when the data could be
14827transmitted off the device.<wbr/> The LED <em>should</em> always be on whenever
14828data is stored locally on the device.<wbr/></p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]14829<p>The LED <em>may</em> be off if a trusted application is using the data that
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]14830doesn't violate the above rules.<wbr/></p>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]14831 </td>
14832
14833 <td class="entry_units">
14834 </td>
14835
14836 <td class="entry_range">
14837 </td>
14838
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]14839 <td class="entry_tags">
14840 </td>
14841
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]14842 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]14843
14844
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]14845 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
14846 <!-- end of entry -->
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]14847
14848
14849
14850 <!-- end of kind -->
14851 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]14852 <tr><td colspan="6" class="kind">static</td></tr>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]14853
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]14854 <thead class="entries_header">
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]14855 <tr>
14856 <th class="th_name">Property Name</th>
14857 <th class="th_type">Type</th>
14858 <th class="th_description">Description</th>
14859 <th class="th_units">Units</th>
14860 <th class="th_range">Range</th>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]14861 <th class="th_tags">Tags</th>
14862 </tr>
14863 </thead>
14864
14865 <tbody>
14866
14867
14868
14869
14870
14871
14872
14873
14874
14875
14876 <tr class="entry" id="static_android.led.availableLeds">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]14877 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]14878 android.<wbr/>led.<wbr/>available<wbr/>Leds
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]14879 </td>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]14880 <td class="entry_type">
14881 <span class="entry_type_name entry_type_name_enum">byte</span>
14882 <span class="entry_type_container">x</span>
14883
14884 <span class="entry_type_array">
14885 n
14886 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]14887 <span class="entry_type_visibility"> [hidden]</span>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]14888
14889 <ul class="entry_type_enum">
14890 <li>
14891 <span class="entry_type_enum_name">TRANSMIT</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]14892 <span class="entry_type_enum_notes"><p><a href="#controls_android.led.transmit">android.<wbr/>led.<wbr/>transmit</a> control is used</p></span>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]14893 </li>
14894 </ul>
14895
14896 </td> <!-- entry_type -->
14897
14898 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]14899 <p>A list of camera LEDs that are available on this system.<wbr/></p>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]14900 </td>
14901
14902 <td class="entry_units">
14903 </td>
14904
14905 <td class="entry_range">
14906 </td>
14907
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]14908 <td class="entry_tags">
14909 </td>
14910
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]14911 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]14912
14913
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]14914 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
14915 <!-- end of entry -->
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]14916
14917
14918
14919 <!-- end of kind -->
14920 </tbody>
14921
14922 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]14923 <tr><td colspan="6" id="section_info" class="section">info</td></tr>
Igor Murashkin38b8cae2013-05-23 16:38:59 -0700[diff] [blame]14924
14925
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]14926 <tr><td colspan="6" class="kind">static</td></tr>
Igor Murashkin38b8cae2013-05-23 16:38:59 -0700[diff] [blame]14927
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]14928 <thead class="entries_header">
Igor Murashkin38b8cae2013-05-23 16:38:59 -0700[diff] [blame]14929 <tr>
14930 <th class="th_name">Property Name</th>
14931 <th class="th_type">Type</th>
14932 <th class="th_description">Description</th>
14933 <th class="th_units">Units</th>
14934 <th class="th_range">Range</th>
Igor Murashkin38b8cae2013-05-23 16:38:59 -0700[diff] [blame]14935 <th class="th_tags">Tags</th>
14936 </tr>
14937 </thead>
14938
14939 <tbody>
14940
14941
14942
14943
14944
14945
14946
14947
14948
14949
14950 <tr class="entry" id="static_android.info.supportedHardwareLevel">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]14951 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]14952 android.<wbr/>info.<wbr/>supported<wbr/>Hardware<wbr/>Level
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]14953 </td>
Igor Murashkin38b8cae2013-05-23 16:38:59 -0700[diff] [blame]14954 <td class="entry_type">
14955 <span class="entry_type_name entry_type_name_enum">byte</span>
14956
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]14957 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin38b8cae2013-05-23 16:38:59 -0700[diff] [blame]14958
14959 <ul class="entry_type_enum">
14960 <li>
14961 <span class="entry_type_enum_name">LIMITED</span>
14962 </li>
14963 <li>
14964 <span class="entry_type_enum_name">FULL</span>
14965 </li>
14966 </ul>
14967
14968 </td> <!-- entry_type -->
14969
14970 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]14971 <p>The camera 3 HAL device can implement one of two possible
14972operational modes; limited and full.<wbr/> Full support is
14973expected from new higher-end devices.<wbr/> Limited mode has
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]14974hardware requirements roughly in line with those for a
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]14975camera HAL device v1 implementation,<wbr/> and is expected from
14976older or inexpensive devices.<wbr/> Full is a strict superset of
14977limited,<wbr/> and they share the same essential operational flow.<wbr/></p>
14978<p>For full details refer to "S3.<wbr/> Operational Modes" in camera3.<wbr/>h</p>
Igor Murashkin38b8cae2013-05-23 16:38:59 -0700[diff] [blame]14979 </td>
14980
14981 <td class="entry_units">
14982 </td>
14983
14984 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]14985 <p>Optional.<wbr/> Default value is LIMITED.<wbr/></p>
Igor Murashkin38b8cae2013-05-23 16:38:59 -0700[diff] [blame]14986 </td>
14987
Igor Murashkin38b8cae2013-05-23 16:38:59 -0700[diff] [blame]14988 <td class="entry_tags">
14989 </td>
14990
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]14991 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]14992
14993
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]14994 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
14995 <!-- end of entry -->
Igor Murashkin38b8cae2013-05-23 16:38:59 -0700[diff] [blame]14996
14997
14998
14999 <!-- end of kind -->
15000 </tbody>
15001
15002 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]15003 <tr><td colspan="6" id="section_blackLevel" class="section">blackLevel</td></tr>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]15004
15005
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]15006 <tr><td colspan="6" class="kind">controls</td></tr>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]15007
15008 <thead class="entries_header">
15009 <tr>
15010 <th class="th_name">Property Name</th>
15011 <th class="th_type">Type</th>
15012 <th class="th_description">Description</th>
15013 <th class="th_units">Units</th>
15014 <th class="th_range">Range</th>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]15015 <th class="th_tags">Tags</th>
15016 </tr>
15017 </thead>
15018
15019 <tbody>
15020
15021
15022
15023
15024
15025
15026
15027
15028
15029
15030 <tr class="entry" id="controls_android.blackLevel.lock">
Eino-Ville Talvala7796cfe2013-12-26 13:16:54 -0800[diff] [blame]15031 <td class="entry_name" rowspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]15032 android.<wbr/>black<wbr/>Level.<wbr/>lock
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]15033 </td>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]15034 <td class="entry_type">
15035 <span class="entry_type_name entry_type_name_enum">byte</span>
15036
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]15037 <span class="entry_type_visibility"> [public as boolean]</span>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]15038
15039 <ul class="entry_type_enum">
15040 <li>
15041 <span class="entry_type_enum_name">OFF</span>
15042 </li>
15043 <li>
15044 <span class="entry_type_enum_name">ON</span>
15045 </li>
15046 </ul>
15047
15048 </td> <!-- entry_type -->
15049
15050 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]15051 <p>Whether black-level compensation is locked
15052to its current values,<wbr/> or is free to vary.<wbr/></p>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]15053 </td>
15054
15055 <td class="entry_units">
15056 </td>
15057
15058 <td class="entry_range">
15059 </td>
15060
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]15061 <td class="entry_tags">
15062 <ul class="entry_tags">
15063 <li><a href="#tag_HAL2">HAL2</a></li>
15064 </ul>
15065 </td>
15066
15067 </tr>
15068 <tr class="entries_header">
15069 <th class="th_details" colspan="5">Details</th>
15070 </tr>
15071 <tr class="entry_cont">
15072 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]15073 <p>When set to ON,<wbr/> the values used for black-level
Eino-Ville Talvala7796cfe2013-12-26 13:16:54 -0800[diff] [blame]15074compensation will not change until the lock is set to
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]15075OFF.<wbr/></p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]15076<p>Since changes to certain capture parameters (such as
15077exposure time) may require resetting of black level
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]15078compensation,<wbr/> the camera device must report whether setting
Eino-Ville Talvala7796cfe2013-12-26 13:16:54 -0800[diff] [blame]15079the black level lock was successful in the output result
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]15080metadata.<wbr/></p>
15081<p>For example,<wbr/> if a sequence of requests is as follows:</p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]15082<ul>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]15083<li>Request 1: Exposure = 10ms,<wbr/> Black level lock = OFF</li>
15084<li>Request 2: Exposure = 10ms,<wbr/> Black level lock = ON</li>
15085<li>Request 3: Exposure = 10ms,<wbr/> Black level lock = ON</li>
15086<li>Request 4: Exposure = 20ms,<wbr/> Black level lock = ON</li>
15087<li>Request 5: Exposure = 20ms,<wbr/> Black level lock = ON</li>
15088<li>Request 6: Exposure = 20ms,<wbr/> Black level lock = ON</li>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]15089</ul>
Eino-Ville Talvala7796cfe2013-12-26 13:16:54 -0800[diff] [blame]15090<p>And the exposure change in Request 4 requires the camera
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]15091device to reset the black level offsets,<wbr/> then the output
Eino-Ville Talvala7796cfe2013-12-26 13:16:54 -0800[diff] [blame]15092result metadata is expected to be:</p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]15093<ul>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]15094<li>Result 1: Exposure = 10ms,<wbr/> Black level lock = OFF</li>
15095<li>Result 2: Exposure = 10ms,<wbr/> Black level lock = ON</li>
15096<li>Result 3: Exposure = 10ms,<wbr/> Black level lock = ON</li>
15097<li>Result 4: Exposure = 20ms,<wbr/> Black level lock = OFF</li>
15098<li>Result 5: Exposure = 20ms,<wbr/> Black level lock = ON</li>
15099<li>Result 6: Exposure = 20ms,<wbr/> Black level lock = ON</li>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]15100</ul>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]15101<p>This indicates to the application that on frame 4,<wbr/> black
15102levels were reset due to exposure value changes,<wbr/> and pixel
15103values may not be consistent across captures.<wbr/></p>
Eino-Ville Talvala7796cfe2013-12-26 13:16:54 -0800[diff] [blame]15104<p>The camera device will maintain the lock to the extent
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]15105possible,<wbr/> only overriding the lock to OFF when changes to
Eino-Ville Talvala7796cfe2013-12-26 13:16:54 -0800[diff] [blame]15106other request parameters require a black level recalculation
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]15107or reset.<wbr/></p>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]15108 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]15109 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]15110
Eino-Ville Talvala7796cfe2013-12-26 13:16:54 -0800[diff] [blame]15111 <tr class="entries_header">
15112 <th class="th_details" colspan="5">HAL Implementation Details</th>
15113 </tr>
15114 <tr class="entry_cont">
15115 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]15116 <p>If for some reason black level locking is no longer possible
15117(for example,<wbr/> the analog gain has changed,<wbr/> which forces
15118black level offsets to be recalculated),<wbr/> then the HAL must
Eino-Ville Talvala7796cfe2013-12-26 13:16:54 -0800[diff] [blame]15119override this request (and it must report 'OFF' when this
15120does happen) until the next capture for which locking is
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]15121possible again.<wbr/></p>
Eino-Ville Talvala7796cfe2013-12-26 13:16:54 -0800[diff] [blame]15122 </td>
15123 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]15124
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]15125 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
15126 <!-- end of entry -->
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]15127
15128
15129
15130 <!-- end of kind -->
15131 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]15132 <tr><td colspan="6" class="kind">dynamic</td></tr>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]15133
15134 <thead class="entries_header">
15135 <tr>
15136 <th class="th_name">Property Name</th>
15137 <th class="th_type">Type</th>
15138 <th class="th_description">Description</th>
15139 <th class="th_units">Units</th>
15140 <th class="th_range">Range</th>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]15141 <th class="th_tags">Tags</th>
15142 </tr>
15143 </thead>
15144
15145 <tbody>
15146
15147
15148
15149
15150
15151
15152
15153
15154
15155
15156 <tr class="entry" id="dynamic_android.blackLevel.lock">
Eino-Ville Talvala7796cfe2013-12-26 13:16:54 -0800[diff] [blame]15157 <td class="entry_name" rowspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]15158 android.<wbr/>black<wbr/>Level.<wbr/>lock
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]15159 </td>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]15160 <td class="entry_type">
15161 <span class="entry_type_name entry_type_name_enum">byte</span>
15162
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]15163 <span class="entry_type_visibility"> [public as boolean]</span>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]15164
15165 <ul class="entry_type_enum">
15166 <li>
15167 <span class="entry_type_enum_name">OFF</span>
15168 </li>
15169 <li>
15170 <span class="entry_type_enum_name">ON</span>
15171 </li>
15172 </ul>
15173
15174 </td> <!-- entry_type -->
15175
15176 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]15177 <p>Whether black-level compensation is locked
15178to its current values,<wbr/> or is free to vary.<wbr/></p>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]15179 </td>
15180
15181 <td class="entry_units">
15182 </td>
15183
15184 <td class="entry_range">
15185 </td>
15186
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]15187 <td class="entry_tags">
15188 <ul class="entry_tags">
15189 <li><a href="#tag_HAL2">HAL2</a></li>
15190 </ul>
15191 </td>
15192
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]15193 </tr>
15194 <tr class="entries_header">
15195 <th class="th_details" colspan="5">Details</th>
15196 </tr>
15197 <tr class="entry_cont">
15198 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]15199 <p>Whether the black level offset was locked for this frame.<wbr/> Should be
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]15200ON if <a href="#controls_android.blackLevel.lock">android.<wbr/>black<wbr/>Level.<wbr/>lock</a> was ON in the capture request,<wbr/> unless
Eino-Ville Talvala7796cfe2013-12-26 13:16:54 -0800[diff] [blame]15201a change in other capture settings forced the camera device to
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]15202perform a black level reset.<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]15203 </td>
15204 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]15205
Eino-Ville Talvala7796cfe2013-12-26 13:16:54 -0800[diff] [blame]15206 <tr class="entries_header">
15207 <th class="th_details" colspan="5">HAL Implementation Details</th>
15208 </tr>
15209 <tr class="entry_cont">
15210 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]15211 <p>If for some reason black level locking is no longer possible
15212(for example,<wbr/> the analog gain has changed,<wbr/> which forces
15213black level offsets to be recalculated),<wbr/> then the HAL must
Eino-Ville Talvala7796cfe2013-12-26 13:16:54 -0800[diff] [blame]15214override this request (and it must report 'OFF' when this
15215does happen) until the next capture for which locking is
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]15216possible again.<wbr/></p>
Eino-Ville Talvala7796cfe2013-12-26 13:16:54 -0800[diff] [blame]15217 </td>
15218 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]15219
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]15220 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
15221 <!-- end of entry -->
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]15222
15223
15224
15225 <!-- end of kind -->
15226 </tbody>
15227
15228 <!-- end of section -->
Igor Murashkin5c1fc682014-01-16 17:51:36 -0800[diff] [blame]15229 <tr><td colspan="6" id="section_sync" class="section">sync</td></tr>
15230
15231
15232 <tr><td colspan="6" class="kind">dynamic</td></tr>
15233
15234 <thead class="entries_header">
15235 <tr>
15236 <th class="th_name">Property Name</th>
15237 <th class="th_type">Type</th>
15238 <th class="th_description">Description</th>
15239 <th class="th_units">Units</th>
15240 <th class="th_range">Range</th>
15241 <th class="th_tags">Tags</th>
15242 </tr>
15243 </thead>
15244
15245 <tbody>
15246
15247
15248
15249
15250
15251
15252
15253
15254
15255
15256 <tr class="entry" id="dynamic_android.sync.frameNumber">
15257 <td class="entry_name" rowspan="5">
15258 android.<wbr/>sync.<wbr/>frame<wbr/>Number
15259 </td>
15260 <td class="entry_type">
15261 <span class="entry_type_name entry_type_name_enum">int64</span>
15262
15263 <span class="entry_type_visibility"> [hidden]</span>
15264
15265 <ul class="entry_type_enum">
15266 <li>
15267 <span class="entry_type_enum_name">CONVERGING</span>
15268 <span class="entry_type_enum_value">-1</span>
15269 <span class="entry_type_enum_notes"><p>The current result is not yet fully synchronized to any request.<wbr/>
15270Synchronization is in progress,<wbr/> and reading metadata from this
15271result may include a mix of data that have taken effect since the
15272last synchronization time.<wbr/></p>
15273<p>In some future result,<wbr/> within <a href="#static_android.sync.maxLatency">android.<wbr/>sync.<wbr/>max<wbr/>Latency</a> frames,<wbr/>
15274this value will update to the actual frame number frame number
15275the result is guaranteed to be synchronized to (as long as the
15276request settings remain constant).<wbr/></p></span>
15277 </li>
15278 <li>
15279 <span class="entry_type_enum_name">UNKNOWN</span>
15280 <span class="entry_type_enum_value">-2</span>
15281 <span class="entry_type_enum_notes"><p>The current result's synchronization status is unknown.<wbr/> The
15282result may have already converged,<wbr/> or it may be in progress.<wbr/>
15283Reading from this result may include some mix of settings from
15284past requests.<wbr/></p>
15285<p>After a settings change,<wbr/> the new settings will eventually all
15286take effect for the output buffers and results.<wbr/> However,<wbr/> this
15287value will not change when that happens.<wbr/> Altering settings
15288rapidly may provide outcomes using mixes of settings from recent
15289requests.<wbr/></p>
15290<p>This value is intended primarily for backwards compatibility with
15291the older camera implementations (for android.<wbr/>hardware.<wbr/>Camera).<wbr/></p></span>
15292 </li>
15293 </ul>
15294
15295 </td> <!-- entry_type -->
15296
15297 <td class="entry_description">
15298 <p>The frame number corresponding to the last request
15299with which the output result (metadata + buffers) has been fully
15300synchronized.<wbr/></p>
15301 </td>
15302
15303 <td class="entry_units">
15304 </td>
15305
15306 <td class="entry_range">
15307 <p>Either a non-negative value corresponding to a
15308<code>frame_<wbr/>number</code>,<wbr/> or one of the two enums (CONVERGING /<wbr/> UNKNOWN).<wbr/></p>
15309 </td>
15310
15311 <td class="entry_tags">
15312 <ul class="entry_tags">
15313 <li><a href="#tag_LIMITED">LIMITED</a></li>
15314 </ul>
15315 </td>
15316
15317 </tr>
15318 <tr class="entries_header">
15319 <th class="th_details" colspan="5">Details</th>
15320 </tr>
15321 <tr class="entry_cont">
15322 <td class="entry_details" colspan="5">
15323 <p>When a request is submitted to the camera device,<wbr/> there is usually a
15324delay of several frames before the controls get applied.<wbr/> A camera
15325device may either choose to account for this delay by implementing a
15326pipeline and carefully submit well-timed atomic control updates,<wbr/> or
15327it may start streaming control changes that span over several frame
15328boundaries.<wbr/></p>
15329<p>In the latter case,<wbr/> whenever a request's settings change relative to
15330the previous submitted request,<wbr/> the full set of changes may take
15331multiple frame durations to fully take effect.<wbr/> Some settings may
15332take effect sooner (in less frame durations) than others.<wbr/></p>
15333<p>While a set of control changes are being propagated,<wbr/> this value
15334will be CONVERGING.<wbr/></p>
15335<p>Once it is fully known that a set of control changes have been
15336finished propagating,<wbr/> and the resulting updated control settings
15337have been read back by the camera device,<wbr/> this value will be set
15338to a non-negative frame number (corresponding to the request to
15339which the results have synchronized to).<wbr/></p>
15340<p>Older camera device implementations may not have a way to detect
15341when all camera controls have been applied,<wbr/> and will always set this
15342value to UNKNOWN.<wbr/></p>
15343<p>FULL capability devices will always have this value set to the
15344frame number of the request corresponding to this result.<wbr/></p>
15345<p><em>Further details</em>:</p>
15346<ul>
15347<li>Whenever a request differs from the last request,<wbr/> any future
15348results not yet returned may have this value set to CONVERGING (this
15349could include any in-progress captures not yet returned by the camera
15350device,<wbr/> for more details see pipeline considerations below).<wbr/></li>
15351<li>Submitting a series of multiple requests that differ from the
15352previous request (e.<wbr/>g.<wbr/> r1,<wbr/> r2,<wbr/> r3 s.<wbr/>t.<wbr/> r1 != r2 != r3)
15353moves the new synchronization frame to the last non-repeating
15354request (using the smallest frame number from the contiguous list of
15355repeating requests).<wbr/></li>
15356<li>Submitting the same request repeatedly will not change this value
15357to CONVERGING,<wbr/> if it was already a non-negative value.<wbr/></li>
15358<li>When this value changes to non-negative,<wbr/> that means that all of the
15359metadata controls from the request have been applied,<wbr/> all of the
15360metadata controls from the camera device have been read to the
15361updated values (into the result),<wbr/> and all of the graphics buffers
15362corresponding to this result are also synchronized to the request.<wbr/></li>
15363</ul>
15364<p><em>Pipeline considerations</em>:</p>
15365<p>Submitting a request with updated controls relative to the previously
15366submitted requests may also invalidate the synchronization state
15367of all the results corresponding to currently in-flight requests.<wbr/></p>
15368<p>In other words,<wbr/> results for this current request and up to
15369<a href="#static_android.request.pipelineMaxDepth">android.<wbr/>request.<wbr/>pipeline<wbr/>Max<wbr/>Depth</a> prior requests may have their
15370<a href="#dynamic_android.sync.frameNumber">android.<wbr/>sync.<wbr/>frame<wbr/>Number</a> change to CONVERGING.<wbr/></p>
15371 </td>
15372 </tr>
15373
15374 <tr class="entries_header">
15375 <th class="th_details" colspan="5">HAL Implementation Details</th>
15376 </tr>
15377 <tr class="entry_cont">
15378 <td class="entry_details" colspan="5">
15379 <p>Using UNKNOWN here is illegal unless android.<wbr/>sync.<wbr/>max<wbr/>Latency
15380is also UNKNOWN.<wbr/></p>
15381<p>FULL capability devices should simply set this value to the
15382<code>frame_<wbr/>number</code> of the request this result corresponds to.<wbr/></p>
15383 </td>
15384 </tr>
15385
15386 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
15387 <!-- end of entry -->
15388
15389
15390
15391 <!-- end of kind -->
15392 </tbody>
15393 <tr><td colspan="6" class="kind">static</td></tr>
15394
15395 <thead class="entries_header">
15396 <tr>
15397 <th class="th_name">Property Name</th>
15398 <th class="th_type">Type</th>
15399 <th class="th_description">Description</th>
15400 <th class="th_units">Units</th>
15401 <th class="th_range">Range</th>
15402 <th class="th_tags">Tags</th>
15403 </tr>
15404 </thead>
15405
15406 <tbody>
15407
15408
15409
15410
15411
15412
15413
15414
15415
15416
15417 <tr class="entry" id="static_android.sync.maxLatency">
15418 <td class="entry_name" rowspan="5">
15419 android.<wbr/>sync.<wbr/>max<wbr/>Latency
15420 </td>
15421 <td class="entry_type">
15422 <span class="entry_type_name entry_type_name_enum">int32</span>
15423
15424 <span class="entry_type_visibility"> [public]</span>
15425
15426 <ul class="entry_type_enum">
15427 <li>
15428 <span class="entry_type_enum_name">PER_FRAME_CONTROL</span>
15429 <span class="entry_type_enum_value">0</span>
15430 <span class="entry_type_enum_notes"><p>Every frame has the requests immediately applied.<wbr/>
15431(and furthermore for all results,<wbr/>
15432<code><a href="#dynamic_android.sync.frameNumber">android.<wbr/>sync.<wbr/>frame<wbr/>Number</a> == <a href="#controls_android.request.frameCount">android.<wbr/>request.<wbr/>frame<wbr/>Count</a></code>)</p>
15433<p>Changing controls over multiple requests one after another will
15434produce results that have those controls applied atomically
15435each frame.<wbr/></p>
15436<p>All FULL capability devices will have this as their maxLatency.<wbr/></p></span>
15437 </li>
15438 <li>
15439 <span class="entry_type_enum_name">UNKNOWN</span>
15440 <span class="entry_type_enum_value">-1</span>
15441 <span class="entry_type_enum_notes"><p>Each new frame has some subset (potentially the entire set)
15442of the past requests applied to the camera settings.<wbr/></p>
15443<p>By submitting a series of identical requests,<wbr/> the camera device
15444will eventually have the camera settings applied,<wbr/> but it is
15445unknown when that exact point will be.<wbr/></p></span>
15446 </li>
15447 </ul>
15448
15449 </td> <!-- entry_type -->
15450
15451 <td class="entry_description">
15452 <p>The maximum number of frames that can occur after a request
15453(different than the previous) has been submitted,<wbr/> and before the
15454result's state becomes synchronized (by setting
15455<a href="#dynamic_android.sync.frameNumber">android.<wbr/>sync.<wbr/>frame<wbr/>Number</a> to a non-negative value).<wbr/></p>
15456 </td>
15457
15458 <td class="entry_units">
15459 number of processed requests
15460 </td>
15461
15462 <td class="entry_range">
15463 <p>&gt;= -1</p>
15464 </td>
15465
15466 <td class="entry_tags">
15467 <ul class="entry_tags">
15468 <li><a href="#tag_LIMITED">LIMITED</a></li>
15469 </ul>
15470 </td>
15471
15472 </tr>
15473 <tr class="entries_header">
15474 <th class="th_details" colspan="5">Details</th>
15475 </tr>
15476 <tr class="entry_cont">
15477 <td class="entry_details" colspan="5">
15478 <p>This defines the maximum distance (in number of metadata results),<wbr/>
15479between <a href="#dynamic_android.sync.frameNumber">android.<wbr/>sync.<wbr/>frame<wbr/>Number</a> and the equivalent
15480<a href="#controls_android.request.frameCount">android.<wbr/>request.<wbr/>frame<wbr/>Count</a>.<wbr/></p>
15481<p>In other words this acts as an upper boundary for how many frames
15482must occur before the camera device knows for a fact that the new
15483submitted camera settings have been applied in outgoing frames.<wbr/></p>
15484<p>For example if the distance was 2,<wbr/></p>
15485<pre><code>initial request = X (repeating)
15486request1 = X
15487request2 = Y
15488request3 = Y
15489request4 = Y
15490
15491where requestN has frameNumber N,<wbr/> and the first of the repeating
15492initial request's has frameNumber F (and F &lt; 1).<wbr/>
15493
15494initial result = X' + { <a href="#dynamic_android.sync.frameNumber">android.<wbr/>sync.<wbr/>frame<wbr/>Number</a> == F }
15495result1 = X' + { <a href="#dynamic_android.sync.frameNumber">android.<wbr/>sync.<wbr/>frame<wbr/>Number</a> == F }
15496result2 = X' + { <a href="#dynamic_android.sync.frameNumber">android.<wbr/>sync.<wbr/>frame<wbr/>Number</a> == CONVERGING }
15497result3 = X' + { <a href="#dynamic_android.sync.frameNumber">android.<wbr/>sync.<wbr/>frame<wbr/>Number</a> == CONVERGING }
15498result4 = X' + { <a href="#dynamic_android.sync.frameNumber">android.<wbr/>sync.<wbr/>frame<wbr/>Number</a> == 2 }
15499
15500where resultN has frameNumber N.<wbr/>
15501</code></pre>
15502<p>Since <code>result4</code> has a <code>frameNumber == 4</code> and
15503<code><a href="#dynamic_android.sync.frameNumber">android.<wbr/>sync.<wbr/>frame<wbr/>Number</a> == 2</code>,<wbr/> the distance is clearly
15504<code>4 - 2 = 2</code>.<wbr/></p>
15505 </td>
15506 </tr>
15507
15508 <tr class="entries_header">
15509 <th class="th_details" colspan="5">HAL Implementation Details</th>
15510 </tr>
15511 <tr class="entry_cont">
15512 <td class="entry_details" colspan="5">
15513 <p>Use <code>frame_<wbr/>count</code> from camera3_<wbr/>request_<wbr/>t instead of
15514<a href="#controls_android.request.frameCount">android.<wbr/>request.<wbr/>frame<wbr/>Count</a>.<wbr/></p>
15515<p>LIMITED devices are strongly encouraged to use a non-negative
15516value.<wbr/> If UNKNOWN is used here then app developers do not have a way
15517to know when sensor settings have been applied.<wbr/></p>
15518 </td>
15519 </tr>
15520
15521 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
15522 <!-- end of entry -->
15523
15524
15525
15526 <!-- end of kind -->
15527 </tbody>
15528
15529 <!-- end of section -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]15530<!-- </namespace> -->
15531 </table>
15532
15533 <div class="tags" id="tag_index">
15534 <h2>Tags</h2>
15535 <ul>
15536 <li id="tag_AWB">AWB -
15537 Needed for auto white balance
15538
15539 <ul class="tags_entries">
15540 <li><a href="#controls_android.control.awbMode">android.control.awbMode</a> (controls)</li>
15541 </ul>
15542 </li> <!-- tag_AWB -->
15543 <li id="tag_BC">BC -
15544 Needed for backwards compatibility with old Java API
15545
15546 <ul class="tags_entries">
Eino-Ville Talvala19ce2c12013-12-30 12:03:45 -0800[diff] [blame]15547 <li><a href="#controls_android.control.aeAntibandingMode">android.control.aeAntibandingMode</a> (controls)</li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]15548 <li><a href="#controls_android.control.aeExposureCompensation">android.control.aeExposureCompensation</a> (controls)</li>
15549 <li><a href="#controls_android.control.aeLock">android.control.aeLock</a> (controls)</li>
15550 <li><a href="#controls_android.control.aeMode">android.control.aeMode</a> (controls)</li>
15551 <li><a href="#controls_android.control.aeRegions">android.control.aeRegions</a> (controls)</li>
15552 <li><a href="#controls_android.control.aeTargetFpsRange">android.control.aeTargetFpsRange</a> (controls)</li>
Eino-Ville Talvala3b4383a2013-03-18 09:42:48 -0700[diff] [blame]15553 <li><a href="#controls_android.control.aePrecaptureTrigger">android.control.aePrecaptureTrigger</a> (controls)</li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]15554 <li><a href="#controls_android.control.afMode">android.control.afMode</a> (controls)</li>
15555 <li><a href="#controls_android.control.afRegions">android.control.afRegions</a> (controls)</li>
Eino-Ville Talvala3b4383a2013-03-18 09:42:48 -0700[diff] [blame]15556 <li><a href="#controls_android.control.afTrigger">android.control.afTrigger</a> (controls)</li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]15557 <li><a href="#controls_android.control.awbLock">android.control.awbLock</a> (controls)</li>
15558 <li><a href="#controls_android.control.awbMode">android.control.awbMode</a> (controls)</li>
15559 <li><a href="#controls_android.control.awbRegions">android.control.awbRegions</a> (controls)</li>
15560 <li><a href="#controls_android.control.captureIntent">android.control.captureIntent</a> (controls)</li>
15561 <li><a href="#controls_android.control.effectMode">android.control.effectMode</a> (controls)</li>
15562 <li><a href="#controls_android.control.mode">android.control.mode</a> (controls)</li>
15563 <li><a href="#controls_android.control.sceneMode">android.control.sceneMode</a> (controls)</li>
15564 <li><a href="#controls_android.control.videoStabilizationMode">android.control.videoStabilizationMode</a> (controls)</li>
Eino-Ville Talvala9fa0d902014-01-08 16:16:53 -0800[diff] [blame]15565 <li><a href="#static_android.control.aeAvailableModes">android.control.aeAvailableModes</a> (static)</li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]15566 <li><a href="#static_android.control.aeCompensationRange">android.control.aeCompensationRange</a> (static)</li>
15567 <li><a href="#static_android.control.aeCompensationStep">android.control.aeCompensationStep</a> (static)</li>
15568 <li><a href="#static_android.control.afAvailableModes">android.control.afAvailableModes</a> (static)</li>
15569 <li><a href="#static_android.control.availableEffects">android.control.availableEffects</a> (static)</li>
15570 <li><a href="#static_android.control.availableSceneModes">android.control.availableSceneModes</a> (static)</li>
15571 <li><a href="#static_android.control.availableVideoStabilizationModes">android.control.availableVideoStabilizationModes</a> (static)</li>
15572 <li><a href="#static_android.control.awbAvailableModes">android.control.awbAvailableModes</a> (static)</li>
15573 <li><a href="#static_android.control.maxRegions">android.control.maxRegions</a> (static)</li>
15574 <li><a href="#static_android.control.sceneModeOverrides">android.control.sceneModeOverrides</a> (static)</li>
15575 <li><a href="#controls_android.flash.mode">android.flash.mode</a> (controls)</li>
15576 <li><a href="#static_android.flash.info.available">android.flash.info.available</a> (static)</li>
15577 <li><a href="#controls_android.jpeg.gpsCoordinates">android.jpeg.gpsCoordinates</a> (controls)</li>
15578 <li><a href="#controls_android.jpeg.gpsProcessingMethod">android.jpeg.gpsProcessingMethod</a> (controls)</li>
15579 <li><a href="#controls_android.jpeg.gpsTimestamp">android.jpeg.gpsTimestamp</a> (controls)</li>
15580 <li><a href="#controls_android.jpeg.orientation">android.jpeg.orientation</a> (controls)</li>
15581 <li><a href="#controls_android.jpeg.quality">android.jpeg.quality</a> (controls)</li>
15582 <li><a href="#controls_android.jpeg.thumbnailQuality">android.jpeg.thumbnailQuality</a> (controls)</li>
15583 <li><a href="#controls_android.jpeg.thumbnailSize">android.jpeg.thumbnailSize</a> (controls)</li>
15584 <li><a href="#static_android.jpeg.availableThumbnailSizes">android.jpeg.availableThumbnailSizes</a> (static)</li>
15585 <li><a href="#controls_android.lens.focusDistance">android.lens.focusDistance</a> (controls)</li>
15586 <li><a href="#static_android.lens.info.availableFocalLengths">android.lens.info.availableFocalLengths</a> (static)</li>
15587 <li><a href="#static_android.lens.info.hyperfocalDistance">android.lens.info.hyperfocalDistance</a> (static)</li>
15588 <li><a href="#dynamic_android.lens.focusRange">android.lens.focusRange</a> (dynamic)</li>
15589 <li><a href="#static_android.request.maxNumOutputStreams">android.request.maxNumOutputStreams</a> (static)</li>
15590 <li><a href="#controls_android.scaler.cropRegion">android.scaler.cropRegion</a> (controls)</li>
15591 <li><a href="#static_android.scaler.availableFormats">android.scaler.availableFormats</a> (static)</li>
15592 <li><a href="#static_android.scaler.availableJpegMinDurations">android.scaler.availableJpegMinDurations</a> (static)</li>
15593 <li><a href="#static_android.scaler.availableJpegSizes">android.scaler.availableJpegSizes</a> (static)</li>
Igor Murashkinf11a4df2013-05-07 10:00:46 -0700[diff] [blame]15594 <li><a href="#static_android.scaler.availableMaxDigitalZoom">android.scaler.availableMaxDigitalZoom</a> (static)</li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]15595 <li><a href="#static_android.scaler.availableProcessedMinDurations">android.scaler.availableProcessedMinDurations</a> (static)</li>
15596 <li><a href="#static_android.scaler.availableProcessedSizes">android.scaler.availableProcessedSizes</a> (static)</li>
15597 <li><a href="#static_android.scaler.availableRawMinDurations">android.scaler.availableRawMinDurations</a> (static)</li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]15598 <li><a href="#controls_android.sensor.frameDuration">android.sensor.frameDuration</a> (controls)</li>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]15599 <li><a href="#static_android.sensor.info.sensitivityRange">android.sensor.info.sensitivityRange</a> (static)</li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]15600 <li><a href="#static_android.sensor.info.maxFrameDuration">android.sensor.info.maxFrameDuration</a> (static)</li>
15601 <li><a href="#static_android.sensor.info.physicalSize">android.sensor.info.physicalSize</a> (static)</li>
15602 <li><a href="#static_android.sensor.info.pixelArraySize">android.sensor.info.pixelArraySize</a> (static)</li>
15603 <li><a href="#static_android.sensor.orientation">android.sensor.orientation</a> (static)</li>
15604 <li><a href="#dynamic_android.sensor.timestamp">android.sensor.timestamp</a> (dynamic)</li>
15605 <li><a href="#controls_android.statistics.faceDetectMode">android.statistics.faceDetectMode</a> (controls)</li>
15606 <li><a href="#dynamic_android.statistics.faceIds">android.statistics.faceIds</a> (dynamic)</li>
15607 <li><a href="#dynamic_android.statistics.faceLandmarks">android.statistics.faceLandmarks</a> (dynamic)</li>
15608 <li><a href="#dynamic_android.statistics.faceRectangles">android.statistics.faceRectangles</a> (dynamic)</li>
15609 <li><a href="#dynamic_android.statistics.faceScores">android.statistics.faceScores</a> (dynamic)</li>
15610 <li><a href="#dynamic_android.lens.focalLength">android.lens.focalLength</a> (dynamic)</li>
15611 <li><a href="#dynamic_android.lens.focusDistance">android.lens.focusDistance</a> (dynamic)</li>
15612 </ul>
15613 </li> <!-- tag_BC -->
15614 <li id="tag_V1">V1 -
15615 New features for first camera 2 release (API1)
15616
15617 <ul class="tags_entries">
15618 <li><a href="#controls_android.demosaic.mode">android.demosaic.mode</a> (controls)</li>
15619 <li><a href="#controls_android.flash.firingPower">android.flash.firingPower</a> (controls)</li>
15620 <li><a href="#controls_android.flash.firingTime">android.flash.firingTime</a> (controls)</li>
15621 <li><a href="#static_android.flash.info.chargeDuration">android.flash.info.chargeDuration</a> (static)</li>
15622 <li><a href="#controls_android.hotPixel.mode">android.hotPixel.mode</a> (controls)</li>
15623 <li><a href="#controls_android.lens.aperture">android.lens.aperture</a> (controls)</li>
15624 <li><a href="#controls_android.lens.filterDensity">android.lens.filterDensity</a> (controls)</li>
15625 <li><a href="#controls_android.lens.focalLength">android.lens.focalLength</a> (controls)</li>
15626 <li><a href="#controls_android.lens.focusDistance">android.lens.focusDistance</a> (controls)</li>
15627 <li><a href="#controls_android.lens.opticalStabilizationMode">android.lens.opticalStabilizationMode</a> (controls)</li>
15628 <li><a href="#static_android.lens.info.availableApertures">android.lens.info.availableApertures</a> (static)</li>
15629 <li><a href="#static_android.lens.info.availableFilterDensities">android.lens.info.availableFilterDensities</a> (static)</li>
15630 <li><a href="#static_android.lens.info.availableFocalLengths">android.lens.info.availableFocalLengths</a> (static)</li>
15631 <li><a href="#static_android.lens.info.availableOpticalStabilization">android.lens.info.availableOpticalStabilization</a> (static)</li>
15632 <li><a href="#static_android.lens.info.geometricCorrectionMapSize">android.lens.info.geometricCorrectionMapSize</a> (static)</li>
15633 <li><a href="#static_android.lens.info.minimumFocusDistance">android.lens.info.minimumFocusDistance</a> (static)</li>
15634 <li><a href="#static_android.lens.info.shadingMapSize">android.lens.info.shadingMapSize</a> (static)</li>
15635 <li><a href="#static_android.lens.position">android.lens.position</a> (static)</li>
15636 <li><a href="#dynamic_android.lens.state">android.lens.state</a> (dynamic)</li>
15637 <li><a href="#controls_android.noiseReduction.mode">android.noiseReduction.mode</a> (controls)</li>
15638 <li><a href="#controls_android.request.id">android.request.id</a> (controls)</li>
15639 <li><a href="#controls_android.sensor.exposureTime">android.sensor.exposureTime</a> (controls)</li>
15640 <li><a href="#controls_android.sensor.frameDuration">android.sensor.frameDuration</a> (controls)</li>
15641 <li><a href="#controls_android.sensor.sensitivity">android.sensor.sensitivity</a> (controls)</li>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]15642 <li><a href="#static_android.sensor.info.sensitivityRange">android.sensor.info.sensitivityRange</a> (static)</li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]15643 <li><a href="#static_android.sensor.info.exposureTimeRange">android.sensor.info.exposureTimeRange</a> (static)</li>
15644 <li><a href="#static_android.sensor.info.maxFrameDuration">android.sensor.info.maxFrameDuration</a> (static)</li>
15645 <li><a href="#static_android.sensor.info.physicalSize">android.sensor.info.physicalSize</a> (static)</li>
15646 <li><a href="#static_android.sensor.baseGainFactor">android.sensor.baseGainFactor</a> (static)</li>
15647 <li><a href="#static_android.sensor.maxAnalogSensitivity">android.sensor.maxAnalogSensitivity</a> (static)</li>
15648 <li><a href="#static_android.sensor.noiseModelCoefficients">android.sensor.noiseModelCoefficients</a> (static)</li>
15649 <li><a href="#controls_android.statistics.histogramMode">android.statistics.histogramMode</a> (controls)</li>
15650 <li><a href="#controls_android.statistics.sharpnessMapMode">android.statistics.sharpnessMapMode</a> (controls)</li>
15651 <li><a href="#dynamic_android.statistics.histogram">android.statistics.histogram</a> (dynamic)</li>
15652 <li><a href="#dynamic_android.statistics.sharpnessMap">android.statistics.sharpnessMap</a> (dynamic)</li>
15653 <li><a href="#dynamic_android.hotPixel.mode">android.hotPixel.mode</a> (dynamic)</li>
15654 <li><a href="#dynamic_android.lens.aperture">android.lens.aperture</a> (dynamic)</li>
15655 <li><a href="#dynamic_android.lens.filterDensity">android.lens.filterDensity</a> (dynamic)</li>
15656 <li><a href="#dynamic_android.lens.opticalStabilizationMode">android.lens.opticalStabilizationMode</a> (dynamic)</li>
15657 </ul>
15658 </li> <!-- tag_V1 -->
15659 <li id="tag_ADV">ADV - None
15660 <ul class="tags_entries">
15661 <li><a href="#static_android.flash.colorTemperature">android.flash.colorTemperature</a> (static)</li>
15662 <li><a href="#static_android.flash.maxEnergy">android.flash.maxEnergy</a> (static)</li>
15663 <li><a href="#controls_android.geometric.strength">android.geometric.strength</a> (controls)</li>
15664 <li><a href="#static_android.hotPixel.info.map">android.hotPixel.info.map</a> (static)</li>
15665 <li><a href="#static_android.lens.opticalAxisAngle">android.lens.opticalAxisAngle</a> (static)</li>
15666 <li><a href="#controls_android.shading.strength">android.shading.strength</a> (controls)</li>
15667 </ul>
15668 </li> <!-- tag_ADV -->
15669 <li id="tag_DNG">DNG -
15670 Needed for DNG file support
15671
15672 <ul class="tags_entries">
15673 <li><a href="#static_android.lens.info.geometricCorrectionMap">android.lens.info.geometricCorrectionMap</a> (static)</li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]15674 <li><a href="#static_android.sensor.info.activeArraySize">android.sensor.info.activeArraySize</a> (static)</li>
15675 <li><a href="#static_android.sensor.info.colorFilterArrangement">android.sensor.info.colorFilterArrangement</a> (static)</li>
15676 <li><a href="#static_android.sensor.info.pixelArraySize">android.sensor.info.pixelArraySize</a> (static)</li>
15677 <li><a href="#static_android.sensor.info.whiteLevel">android.sensor.info.whiteLevel</a> (static)</li>
15678 <li><a href="#static_android.sensor.blackLevelPattern">android.sensor.blackLevelPattern</a> (static)</li>
15679 <li><a href="#static_android.sensor.calibrationTransform1">android.sensor.calibrationTransform1</a> (static)</li>
15680 <li><a href="#static_android.sensor.calibrationTransform2">android.sensor.calibrationTransform2</a> (static)</li>
15681 <li><a href="#static_android.sensor.colorTransform1">android.sensor.colorTransform1</a> (static)</li>
15682 <li><a href="#static_android.sensor.colorTransform2">android.sensor.colorTransform2</a> (static)</li>
15683 <li><a href="#static_android.sensor.forwardMatrix1">android.sensor.forwardMatrix1</a> (static)</li>
15684 <li><a href="#static_android.sensor.forwardMatrix2">android.sensor.forwardMatrix2</a> (static)</li>
15685 <li><a href="#static_android.sensor.referenceIlluminant1">android.sensor.referenceIlluminant1</a> (static)</li>
15686 <li><a href="#controls_android.tonemap.curveRed">android.tonemap.curveRed</a> (controls)</li>
15687 </ul>
15688 </li> <!-- tag_DNG -->
15689 <li id="tag_EXIF">EXIF - None
15690 <ul class="tags_entries">
15691 <li><a href="#static_android.sensor.referenceIlluminant1">android.sensor.referenceIlluminant1</a> (static)</li>
15692 </ul>
15693 </li> <!-- tag_EXIF -->
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]15694 <li id="tag_HAL2">HAL2 -
Alex Rayef40ad62013-10-01 17:52:33 -0700[diff] [blame]15695 Entry is only used by camera device HAL 2.x
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]15696
15697 <ul class="tags_entries">
15698 <li><a href="#controls_android.request.inputStreams">android.request.inputStreams</a> (controls)</li>
15699 <li><a href="#controls_android.request.outputStreams">android.request.outputStreams</a> (controls)</li>
15700 <li><a href="#controls_android.request.type">android.request.type</a> (controls)</li>
Zhijun He12744b22014-01-22 15:58:57 -0800[diff] [blame^]15701 <li><a href="#static_android.request.maxNumReprocessStreams">android.request.maxNumReprocessStreams</a> (static)</li>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]15702 <li><a href="#controls_android.blackLevel.lock">android.blackLevel.lock</a> (controls)</li>
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]15703 </ul>
15704 </li> <!-- tag_HAL2 -->
Alex Rayef40ad62013-10-01 17:52:33 -0700[diff] [blame]15705 <li id="tag_FULL">FULL -
15706 Entry is required for full hardware level devices, and optional for other hardware levels
15707
15708 <ul class="tags_entries">
15709 <li><a href="#static_android.sensor.baseGainFactor">android.sensor.baseGainFactor</a> (static)</li>
15710 <li><a href="#static_android.sensor.maxAnalogSensitivity">android.sensor.maxAnalogSensitivity</a> (static)</li>
15711 <li><a href="#dynamic_android.sensor.temperature">android.sensor.temperature</a> (dynamic)</li>
15712 </ul>
15713 </li> <!-- tag_FULL -->
Igor Murashkin5c1fc682014-01-16 17:51:36 -0800[diff] [blame]15714 <li id="tag_LIMITED">LIMITED -
15715 Entry assists with LIMITED device implementation. LIMITED devices
15716 must implement all entries with this tag. Optional for FULL devices.
15717
15718 <ul class="tags_entries">
15719 <li><a href="#dynamic_android.sync.frameNumber">android.sync.frameNumber</a> (dynamic)</li>
15720 <li><a href="#static_android.sync.maxLatency">android.sync.maxLatency</a> (static)</li>
15721 </ul>
15722 </li> <!-- tag_LIMITED -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]15723 </ul>
15724 </div>
15725
15726 [ <a href="#">top</a> ]
15727
15728</body>
15729</html>