Gitiles
Code Review Sign In
gerrit-public.fairphone.software / platform / system / media / cf77fe91af48c48efae570335f6d466714e6caf1 / . / camera / docs / docs.html
blob: 3d652bf55dde40ccb979d4e66dfb2a6965182c07 [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>
426 </ul>
427 </li>
428 <li>
429 <span class="toc_kind_header">dynamic</span>
430 <ul class="toc_section">
431 <li><a href="#dynamic_android.request.frameCount">android.request.frameCount</a></li>
432 <li><a href="#dynamic_android.request.id">android.request.id</a></li>
433 <li><a href="#dynamic_android.request.metadataMode">android.request.metadataMode</a></li>
434 <li><a href="#dynamic_android.request.outputStreams">android.request.outputStreams</a></li>
435 </ul>
436 </li>
437 </ul> <!-- toc_section -->
438 </li>
439 <li>
440 <span class="toc_section_header"><a href="#section_scaler">scaler</a></span>
441 <ul class="toc_section">
442 <li>
443 <span class="toc_kind_header">controls</span>
444 <ul class="toc_section">
445 <li><a href="#controls_android.scaler.cropRegion">android.scaler.cropRegion</a></li>
446 </ul>
447 </li>
448 <li>
449 <span class="toc_kind_header">static</span>
450 <ul class="toc_section">
451 <li><a href="#static_android.scaler.availableFormats">android.scaler.availableFormats</a></li>
452 <li><a href="#static_android.scaler.availableJpegMinDurations">android.scaler.availableJpegMinDurations</a></li>
453 <li><a href="#static_android.scaler.availableJpegSizes">android.scaler.availableJpegSizes</a></li>
454 <li><a href="#static_android.scaler.availableMaxDigitalZoom">android.scaler.availableMaxDigitalZoom</a></li>
455 <li><a href="#static_android.scaler.availableProcessedMinDurations">android.scaler.availableProcessedMinDurations</a></li>
456 <li><a href="#static_android.scaler.availableProcessedSizes">android.scaler.availableProcessedSizes</a></li>
457 <li><a href="#static_android.scaler.availableRawMinDurations">android.scaler.availableRawMinDurations</a></li>
458 <li><a href="#static_android.scaler.availableRawSizes">android.scaler.availableRawSizes</a></li>
459 </ul>
460 </li>
461 <li>
462 <span class="toc_kind_header">dynamic</span>
463 <ul class="toc_section">
464 <li><a href="#dynamic_android.scaler.cropRegion">android.scaler.cropRegion</a></li>
465 </ul>
466 </li>
467 </ul> <!-- toc_section -->
468 </li>
469 <li>
470 <span class="toc_section_header"><a href="#section_sensor">sensor</a></span>
471 <ul class="toc_section">
472 <li>
473 <span class="toc_kind_header">controls</span>
474 <ul class="toc_section">
475 <li><a href="#controls_android.sensor.exposureTime">android.sensor.exposureTime</a></li>
476 <li><a href="#controls_android.sensor.frameDuration">android.sensor.frameDuration</a></li>
477 <li><a href="#controls_android.sensor.sensitivity">android.sensor.sensitivity</a></li>
478 </ul>
479 </li>
480 <li>
481 <span class="toc_kind_header">static</span>
482 <ul class="toc_section">
483
484 <li><a href="#static_android.sensor.info.activeArraySize">android.sensor.info.activeArraySize</a></li>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]485 <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]486 <li><a href="#static_android.sensor.info.colorFilterArrangement">android.sensor.info.colorFilterArrangement</a></li>
487 <li><a href="#static_android.sensor.info.exposureTimeRange">android.sensor.info.exposureTimeRange</a></li>
488 <li><a href="#static_android.sensor.info.maxFrameDuration">android.sensor.info.maxFrameDuration</a></li>
489 <li><a href="#static_android.sensor.info.physicalSize">android.sensor.info.physicalSize</a></li>
490 <li><a href="#static_android.sensor.info.pixelArraySize">android.sensor.info.pixelArraySize</a></li>
491 <li><a href="#static_android.sensor.info.whiteLevel">android.sensor.info.whiteLevel</a></li>
492
493 <li><a href="#static_android.sensor.baseGainFactor">android.sensor.baseGainFactor</a></li>
494 <li><a href="#static_android.sensor.blackLevelPattern">android.sensor.blackLevelPattern</a></li>
495 <li><a href="#static_android.sensor.calibrationTransform1">android.sensor.calibrationTransform1</a></li>
496 <li><a href="#static_android.sensor.calibrationTransform2">android.sensor.calibrationTransform2</a></li>
497 <li><a href="#static_android.sensor.colorTransform1">android.sensor.colorTransform1</a></li>
498 <li><a href="#static_android.sensor.colorTransform2">android.sensor.colorTransform2</a></li>
499 <li><a href="#static_android.sensor.forwardMatrix1">android.sensor.forwardMatrix1</a></li>
500 <li><a href="#static_android.sensor.forwardMatrix2">android.sensor.forwardMatrix2</a></li>
501 <li><a href="#static_android.sensor.maxAnalogSensitivity">android.sensor.maxAnalogSensitivity</a></li>
502 <li><a href="#static_android.sensor.noiseModelCoefficients">android.sensor.noiseModelCoefficients</a></li>
503 <li><a href="#static_android.sensor.orientation">android.sensor.orientation</a></li>
504 <li><a href="#static_android.sensor.referenceIlluminant1">android.sensor.referenceIlluminant1</a></li>
505 <li><a href="#static_android.sensor.referenceIlluminant2">android.sensor.referenceIlluminant2</a></li>
506 </ul>
507 </li>
508 <li>
509 <span class="toc_kind_header">dynamic</span>
510 <ul class="toc_section">
511 <li><a href="#dynamic_android.sensor.exposureTime">android.sensor.exposureTime</a></li>
512 <li><a href="#dynamic_android.sensor.frameDuration">android.sensor.frameDuration</a></li>
513 <li><a href="#dynamic_android.sensor.sensitivity">android.sensor.sensitivity</a></li>
514 <li><a href="#dynamic_android.sensor.timestamp">android.sensor.timestamp</a></li>
Igor Murashkin656aa5a2013-08-13 14:23:39 -0700[diff] [blame]515 <li><a href="#dynamic_android.sensor.temperature">android.sensor.temperature</a></li>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]516 </ul>
517 </li>
518 </ul> <!-- toc_section -->
519 </li>
520 <li>
521 <span class="toc_section_header"><a href="#section_shading">shading</a></span>
522 <ul class="toc_section">
523 <li>
524 <span class="toc_kind_header">controls</span>
525 <ul class="toc_section">
526 <li><a href="#controls_android.shading.mode">android.shading.mode</a></li>
527 <li><a href="#controls_android.shading.strength">android.shading.strength</a></li>
528 </ul>
529 </li>
530 <li>
531 <span class="toc_kind_header">dynamic</span>
532 <ul class="toc_section">
533 <li><a href="#dynamic_android.shading.mode">android.shading.mode</a></li>
534 </ul>
535 </li>
536 </ul> <!-- toc_section -->
537 </li>
538 <li>
539 <span class="toc_section_header"><a href="#section_statistics">statistics</a></span>
540 <ul class="toc_section">
541 <li>
542 <span class="toc_kind_header">controls</span>
543 <ul class="toc_section">
544 <li><a href="#controls_android.statistics.faceDetectMode">android.statistics.faceDetectMode</a></li>
545 <li><a href="#controls_android.statistics.histogramMode">android.statistics.histogramMode</a></li>
546 <li><a href="#controls_android.statistics.sharpnessMapMode">android.statistics.sharpnessMapMode</a></li>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]547 <li><a href="#controls_android.statistics.lensShadingMapMode">android.statistics.lensShadingMapMode</a></li>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]548 </ul>
549 </li>
550 <li>
551 <span class="toc_kind_header">static</span>
552 <ul class="toc_section">
553
554 <li><a href="#static_android.statistics.info.availableFaceDetectModes">android.statistics.info.availableFaceDetectModes</a></li>
555 <li><a href="#static_android.statistics.info.histogramBucketCount">android.statistics.info.histogramBucketCount</a></li>
556 <li><a href="#static_android.statistics.info.maxFaceCount">android.statistics.info.maxFaceCount</a></li>
557 <li><a href="#static_android.statistics.info.maxHistogramCount">android.statistics.info.maxHistogramCount</a></li>
558 <li><a href="#static_android.statistics.info.maxSharpnessMapValue">android.statistics.info.maxSharpnessMapValue</a></li>
559 <li><a href="#static_android.statistics.info.sharpnessMapSize">android.statistics.info.sharpnessMapSize</a></li>
560
561 </ul>
562 </li>
563 <li>
564 <span class="toc_kind_header">dynamic</span>
565 <ul class="toc_section">
566 <li><a href="#dynamic_android.statistics.faceDetectMode">android.statistics.faceDetectMode</a></li>
567 <li><a href="#dynamic_android.statistics.faceIds">android.statistics.faceIds</a></li>
568 <li><a href="#dynamic_android.statistics.faceLandmarks">android.statistics.faceLandmarks</a></li>
569 <li><a href="#dynamic_android.statistics.faceRectangles">android.statistics.faceRectangles</a></li>
570 <li><a href="#dynamic_android.statistics.faceScores">android.statistics.faceScores</a></li>
571 <li><a href="#dynamic_android.statistics.histogram">android.statistics.histogram</a></li>
572 <li><a href="#dynamic_android.statistics.histogramMode">android.statistics.histogramMode</a></li>
573 <li><a href="#dynamic_android.statistics.sharpnessMap">android.statistics.sharpnessMap</a></li>
574 <li><a href="#dynamic_android.statistics.sharpnessMapMode">android.statistics.sharpnessMapMode</a></li>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]575 <li><a href="#dynamic_android.statistics.lensShadingMap">android.statistics.lensShadingMap</a></li>
576 <li><a href="#dynamic_android.statistics.predictedColorGains">android.statistics.predictedColorGains</a></li>
577 <li><a href="#dynamic_android.statistics.predictedColorTransform">android.statistics.predictedColorTransform</a></li>
578 <li><a href="#dynamic_android.statistics.sceneFlicker">android.statistics.sceneFlicker</a></li>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]579 </ul>
580 </li>
581 </ul> <!-- toc_section -->
582 </li>
583 <li>
584 <span class="toc_section_header"><a href="#section_tonemap">tonemap</a></span>
585 <ul class="toc_section">
586 <li>
587 <span class="toc_kind_header">controls</span>
588 <ul class="toc_section">
589 <li><a href="#controls_android.tonemap.curveBlue">android.tonemap.curveBlue</a></li>
590 <li><a href="#controls_android.tonemap.curveGreen">android.tonemap.curveGreen</a></li>
591 <li><a href="#controls_android.tonemap.curveRed">android.tonemap.curveRed</a></li>
592 <li><a href="#controls_android.tonemap.mode">android.tonemap.mode</a></li>
593 </ul>
594 </li>
595 <li>
596 <span class="toc_kind_header">static</span>
597 <ul class="toc_section">
598 <li><a href="#static_android.tonemap.maxCurvePoints">android.tonemap.maxCurvePoints</a></li>
599 </ul>
600 </li>
601 <li>
602 <span class="toc_kind_header">dynamic</span>
603 <ul class="toc_section">
604 <li><a href="#dynamic_android.tonemap.curveBlue">android.tonemap.curveBlue</a></li>
605 <li><a href="#dynamic_android.tonemap.curveGreen">android.tonemap.curveGreen</a></li>
606 <li><a href="#dynamic_android.tonemap.curveRed">android.tonemap.curveRed</a></li>
607 <li><a href="#dynamic_android.tonemap.mode">android.tonemap.mode</a></li>
608 </ul>
609 </li>
610 </ul> <!-- toc_section -->
611 </li>
612 <li>
613 <span class="toc_section_header"><a href="#section_led">led</a></span>
614 <ul class="toc_section">
615 <li>
616 <span class="toc_kind_header">controls</span>
617 <ul class="toc_section">
618 <li><a href="#controls_android.led.transmit">android.led.transmit</a></li>
619 </ul>
620 </li>
621 <li>
622 <span class="toc_kind_header">dynamic</span>
623 <ul class="toc_section">
624 <li><a href="#dynamic_android.led.transmit">android.led.transmit</a></li>
625 </ul>
626 </li>
627 <li>
628 <span class="toc_kind_header">static</span>
629 <ul class="toc_section">
630 <li><a href="#static_android.led.availableLeds">android.led.availableLeds</a></li>
631 </ul>
632 </li>
633 </ul> <!-- toc_section -->
634 </li>
635 <li>
636 <span class="toc_section_header"><a href="#section_info">info</a></span>
637 <ul class="toc_section">
638 <li>
639 <span class="toc_kind_header">static</span>
640 <ul class="toc_section">
641 <li><a href="#static_android.info.supportedHardwareLevel">android.info.supportedHardwareLevel</a></li>
642 </ul>
643 </li>
644 </ul> <!-- toc_section -->
645 </li>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]646 <li>
647 <span class="toc_section_header"><a href="#section_blackLevel">blackLevel</a></span>
648 <ul class="toc_section">
649 <li>
650 <span class="toc_kind_header">controls</span>
651 <ul class="toc_section">
652 <li><a href="#controls_android.blackLevel.lock">android.blackLevel.lock</a></li>
653 </ul>
654 </li>
655 <li>
656 <span class="toc_kind_header">dynamic</span>
657 <ul class="toc_section">
658 <li><a href="#dynamic_android.blackLevel.lock">android.blackLevel.lock</a></li>
659 </ul>
660 </li>
661 </ul> <!-- toc_section -->
662 </li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]663 </ul>
664
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]665
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]666 <h1>Properties</h1>
667 <table class="properties">
668
669 <thead class="thead_dummy">
670 <tr>
671 <th class="th_name">Property Name</th>
672 <th class="th_type">Type</th>
673 <th class="th_description">Description</th>
674 <th class="th_units">Units</th>
675 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]676 <th class="th_tags">Tags</th>
677 </tr>
678 </thead> <!-- so that the first occurrence of thead is not
679 above the first occurrence of tr -->
680<!-- <namespace name="android"> -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]681 <tr><td colspan="6" id="section_colorCorrection" class="section">colorCorrection</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]682
683
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]684 <tr><td colspan="6" class="kind">controls</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]685
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]686 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]687 <tr>
688 <th class="th_name">Property Name</th>
689 <th class="th_type">Type</th>
690 <th class="th_description">Description</th>
691 <th class="th_units">Units</th>
692 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]693 <th class="th_tags">Tags</th>
694 </tr>
695 </thead>
696
697 <tbody>
698
699
700
701
702
703
704
705
706
707
708 <tr class="entry" id="controls_android.colorCorrection.mode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]709 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]710 android.<wbr/>color<wbr/>Correction.<wbr/>mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]711 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]712 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]713 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]714
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]715 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]716
717 <ul class="entry_type_enum">
718 <li>
719 <span class="entry_type_enum_name">TRANSFORM_MATRIX</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]720 <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]721and <a href="#controls_android.colorCorrection.gains">android.<wbr/>color<wbr/>Correction.<wbr/>gains</a> to do color conversion.<wbr/></p>
722<p>All advanced white balance adjustments (not specified
723by our white balance pipeline) must be disabled.<wbr/></p>
724<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
725TRANSFORM_<wbr/>MATRIX is ignored.<wbr/> The camera device will override
726this value to either FAST or HIGH_<wbr/>QUALITY.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]727 </li>
728 <li>
729 <span class="entry_type_enum_name">FAST</span>
Igor Murashkin43817ad2014-01-10 15:58:35 -0800[diff] [blame]730 <span class="entry_type_enum_notes"><p>Must not slow down capture rate relative to sensor raw
731output.<wbr/></p>
732<p>Advanced white balance adjustments above and beyond
733the specified white balance pipeline may be applied.<wbr/></p>
734<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
735the camera device uses the last frame's AWB values
736(or defaults if AWB has never been run).<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]737 </li>
738 <li>
739 <span class="entry_type_enum_name">HIGH_QUALITY</span>
Igor Murashkin43817ad2014-01-10 15:58:35 -0800[diff] [blame]740 <span class="entry_type_enum_notes"><p>Capture rate (relative to sensor raw output)
741may be reduced by high quality.<wbr/></p>
742<p>Advanced white balance adjustments above and beyond
743the specified white balance pipeline may be applied.<wbr/></p>
744<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
745the camera device uses the last frame's AWB values
746(or defaults if AWB has never been run).<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]747 </li>
748 </ul>
749
750 </td> <!-- entry_type -->
751
752 <td class="entry_description">
Igor Murashkin43817ad2014-01-10 15:58:35 -0800[diff] [blame]753 <p>The mode control selects how the image data is converted from the
754sensor's native color into linear sRGB color.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]755 </td>
756
757 <td class="entry_units">
758 </td>
759
760 <td class="entry_range">
761 </td>
762
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]763 <td class="entry_tags">
764 </td>
765
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]766 </tr>
767 <tr class="entries_header">
768 <th class="th_details" colspan="5">Details</th>
769 </tr>
770 <tr class="entry_cont">
771 <td class="entry_details" colspan="5">
Igor Murashkin43817ad2014-01-10 15:58:35 -0800[diff] [blame]772 <p>When auto-white balance is enabled with <a href="#controls_android.control.awbMode">android.<wbr/>control.<wbr/>awb<wbr/>Mode</a>,<wbr/> this
773control is overridden by the AWB routine.<wbr/> When AWB is disabled,<wbr/> the
774application controls how the color mapping is performed.<wbr/></p>
775<p>We define the expected processing pipeline below.<wbr/> For consistency
776across devices,<wbr/> this is always the case with TRANSFORM_<wbr/>MATRIX.<wbr/></p>
777<p>When either FULL or HIGH_<wbr/>QUALITY is used,<wbr/> the camera device may
778do additional processing but <a href="#controls_android.colorCorrection.gains">android.<wbr/>color<wbr/>Correction.<wbr/>gains</a> and
779<a href="#controls_android.colorCorrection.transform">android.<wbr/>color<wbr/>Correction.<wbr/>transform</a> will still be provided by the
780camera device (in the results) and be roughly correct.<wbr/></p>
781<p>Switching to TRANSFORM_<wbr/>MATRIX and using the data provided from
782FAST or HIGH_<wbr/>QUALITY will yield a picture with the same white point
783as what was produced by the camera device in the earlier frame.<wbr/></p>
784<p>The expected processing pipeline is as follows:</p>
785<p><img alt="White balance processing pipeline" src="images/camera2/metadata/android.colorCorrection.mode/processing_pipeline.png"/></p>
786<p>The white balance is encoded by two values,<wbr/> a 4-channel white-balance
787gain vector (applied in the Bayer domain),<wbr/> and a 3x3 color transform
788matrix (applied after demosaic).<wbr/></p>
789<p>The 4-channel white-balance gains are defined as:</p>
790<pre><code><a href="#controls_android.colorCorrection.gains">android.<wbr/>color<wbr/>Correction.<wbr/>gains</a> = [ R G_<wbr/>even G_<wbr/>odd B ]
791</code></pre>
792<p>where <code>G_<wbr/>even</code> is the gain for green pixels on even rows of the
793output,<wbr/> and <code>G_<wbr/>odd</code> is the gain for green pixels on the odd rows.<wbr/>
794These may be identical for a given camera device implementation; if
795the camera device does not support a separate gain for even/<wbr/>odd green
796channels,<wbr/> it will use the <code>G_<wbr/>even</code> value,<wbr/> and write <code>G_<wbr/>odd</code> equal to
797<code>G_<wbr/>even</code> in the output result metadata.<wbr/></p>
798<p>The matrices for color transforms are defined as a 9-entry vector:</p>
799<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 ]
800</code></pre>
801<p>which define a transform from input sensor colors,<wbr/> <code>P_<wbr/>in = [ r g b ]</code>,<wbr/>
802to output linear sRGB,<wbr/> <code>P_<wbr/>out = [ r' g' b' ]</code>,<wbr/></p>
803<p>with colors as follows:</p>
804<pre><code>r' = I0r + I1g + I2b
805g' = I3r + I4g + I5b
806b' = I6r + I7g + I8b
807</code></pre>
808<p>Both the input and output value ranges must match.<wbr/> Overflow/<wbr/>underflow
809values are clipped to fit within the range.<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]810 </td>
811 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]812
813
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]814 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
815 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]816
817
818 <tr class="entry" id="controls_android.colorCorrection.transform">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]819 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]820 android.<wbr/>color<wbr/>Correction.<wbr/>transform
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]821 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]822 <td class="entry_type">
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]823 <span class="entry_type_name">rational</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]824 <span class="entry_type_container">x</span>
825
826 <span class="entry_type_array">
827 3 x 3
828 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]829 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]830 <div class="entry_type_notes">3x3 rational matrix in row-major order</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]831
832
833 </td> <!-- entry_type -->
834
835 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]836 <p>A color transform matrix to use to transform
837from sensor RGB color space to output linear sRGB color space</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]838 </td>
839
840 <td class="entry_units">
841 </td>
842
843 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]844 <p>Output values are expected to be in the range
845(0,<wbr/>1)</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]846 </td>
847
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]848 <td class="entry_tags">
849 </td>
850
851 </tr>
852 <tr class="entries_header">
853 <th class="th_details" colspan="5">Details</th>
854 </tr>
855 <tr class="entry_cont">
856 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]857 <p>This matrix is either set by HAL when the request
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]858<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]859directly by the application in the request when the
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]860<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]861<p>In the latter case,<wbr/> the HAL may round the matrix to account
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]862for precision issues; the final rounded matrix should be
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]863reported back in this matrix result metadata.<wbr/></p>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]864 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]865 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]866
867
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]868 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
869 <!-- end of entry -->
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]870
871
872 <tr class="entry" id="controls_android.colorCorrection.gains">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]873 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]874 android.<wbr/>color<wbr/>Correction.<wbr/>gains
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]875 </td>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]876 <td class="entry_type">
877 <span class="entry_type_name">float</span>
878 <span class="entry_type_container">x</span>
879
880 <span class="entry_type_array">
881 4
882 </span>
883 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]884 <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]885
886
887 </td> <!-- entry_type -->
888
889 <td class="entry_description">
Igor Murashkin43817ad2014-01-10 15:58:35 -0800[diff] [blame]890 <p>Gains applying to Bayer raw color channels for
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]891white-balance</p>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]892 </td>
893
894 <td class="entry_units">
895 </td>
896
897 <td class="entry_range">
898 </td>
899
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]900 <td class="entry_tags">
901 </td>
902
903 </tr>
904 <tr class="entries_header">
905 <th class="th_details" colspan="5">Details</th>
906 </tr>
907 <tr class="entry_cont">
908 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]909 <p>The 4-channel white-balance gains are defined in
Igor Murashkin43817ad2014-01-10 15:58:35 -0800[diff] [blame]910the order of <code>[R G_<wbr/>even G_<wbr/>odd B]</code>,<wbr/> where <code>G_<wbr/>even</code> is the gain
911for green pixels on even rows of the output,<wbr/> and <code>G_<wbr/>odd</code>
912is the gain for green pixels on the odd rows.<wbr/> if a HAL
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]913does not support a separate gain for even/<wbr/>odd green channels,<wbr/>
Igor Murashkin43817ad2014-01-10 15:58:35 -0800[diff] [blame]914it should use the <code>G_<wbr/>even</code> value,<wbr/> and write <code>G_<wbr/>odd</code> equal to
915<code>G_<wbr/>even</code> in the output result metadata.<wbr/></p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]916<p>This array is either set by HAL when the request
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]917<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]918directly by the application in the request when the
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]919<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]920<p>The output should be the gains actually applied by the HAL to
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]921the current frame.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]922 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]923 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]924
925
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]926 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
927 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]928
929
930
931 <!-- end of kind -->
932 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]933 <tr><td colspan="6" class="kind">dynamic</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]934
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]935 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]936 <tr>
937 <th class="th_name">Property Name</th>
938 <th class="th_type">Type</th>
939 <th class="th_description">Description</th>
940 <th class="th_units">Units</th>
941 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]942 <th class="th_tags">Tags</th>
943 </tr>
944 </thead>
945
946 <tbody>
947
948
949
950
951
952
953
954
955
956
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]957 <tr class="entry" id="dynamic_android.colorCorrection.transform">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]958 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]959 android.<wbr/>color<wbr/>Correction.<wbr/>transform
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]960 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]961 <td class="entry_type">
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]962 <span class="entry_type_name">rational</span>
963 <span class="entry_type_container">x</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]964
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]965 <span class="entry_type_array">
966 3 x 3
967 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]968 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]969 <div class="entry_type_notes">3x3 rational matrix in row-major order</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]970
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]971
972 </td> <!-- entry_type -->
973
974 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]975 <p>A color transform matrix to use to transform
976from sensor RGB color space to output linear sRGB color space</p>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]977 </td>
978
979 <td class="entry_units">
980 </td>
981
982 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]983 <p>Output values are expected to be in the range
984(0,<wbr/>1)</p>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]985 </td>
986
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]987 <td class="entry_tags">
988 </td>
989
990 </tr>
991 <tr class="entries_header">
992 <th class="th_details" colspan="5">Details</th>
993 </tr>
994 <tr class="entry_cont">
995 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]996 <p>This matrix is either set by HAL when the request
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]997<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]998directly by the application in the request when the
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]999<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]1000<p>In the latter case,<wbr/> the HAL may round the matrix to account
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]1001for precision issues; the final rounded matrix should be
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1002reported back in this matrix result metadata.<wbr/></p>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]1003 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1004 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1005
1006
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1007 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
1008 <!-- end of entry -->
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]1009
1010
1011 <tr class="entry" id="dynamic_android.colorCorrection.gains">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1012 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1013 android.<wbr/>color<wbr/>Correction.<wbr/>gains
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1014 </td>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]1015 <td class="entry_type">
1016 <span class="entry_type_name">float</span>
1017 <span class="entry_type_container">x</span>
1018
1019 <span class="entry_type_array">
1020 4
1021 </span>
1022 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1023 <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]1024
1025
1026 </td> <!-- entry_type -->
1027
1028 <td class="entry_description">
Igor Murashkin43817ad2014-01-10 15:58:35 -0800[diff] [blame]1029 <p>Gains applying to Bayer raw color channels for
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1030white-balance</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1031 </td>
1032
1033 <td class="entry_units">
1034 </td>
1035
1036 <td class="entry_range">
1037 </td>
1038
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1039 <td class="entry_tags">
1040 </td>
1041
1042 </tr>
1043 <tr class="entries_header">
1044 <th class="th_details" colspan="5">Details</th>
1045 </tr>
1046 <tr class="entry_cont">
1047 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1048 <p>The 4-channel white-balance gains are defined in
Igor Murashkin43817ad2014-01-10 15:58:35 -0800[diff] [blame]1049the order of <code>[R G_<wbr/>even G_<wbr/>odd B]</code>,<wbr/> where <code>G_<wbr/>even</code> is the gain
1050for green pixels on even rows of the output,<wbr/> and <code>G_<wbr/>odd</code>
1051is the gain for green pixels on the odd rows.<wbr/> if a HAL
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1052does not support a separate gain for even/<wbr/>odd green channels,<wbr/>
Igor Murashkin43817ad2014-01-10 15:58:35 -0800[diff] [blame]1053it should use the <code>G_<wbr/>even</code> value,<wbr/> and write <code>G_<wbr/>odd</code> equal to
1054<code>G_<wbr/>even</code> in the output result metadata.<wbr/></p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]1055<p>This array is either set by HAL when the request
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]1056<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]1057directly by the application in the request when the
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]1058<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]1059<p>The output should be the gains actually applied by the HAL to
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1060the current frame.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1061 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1062 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1063
1064
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1065 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
1066 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1067
1068
1069
1070 <!-- end of kind -->
1071 </tbody>
1072
1073 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1074 <tr><td colspan="6" id="section_control" class="section">control</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1075
1076
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1077 <tr><td colspan="6" class="kind">controls</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1078
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]1079 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1080 <tr>
1081 <th class="th_name">Property Name</th>
1082 <th class="th_type">Type</th>
1083 <th class="th_description">Description</th>
1084 <th class="th_units">Units</th>
1085 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1086 <th class="th_tags">Tags</th>
1087 </tr>
1088 </thead>
1089
1090 <tbody>
1091
1092
1093
1094
1095
1096
1097
1098
1099
1100
1101 <tr class="entry" id="controls_android.control.aeAntibandingMode">
Eino-Ville Talvala19ce2c12013-12-30 12:03:45 -0800[diff] [blame]1102 <td class="entry_name" rowspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1103 android.<wbr/>control.<wbr/>ae<wbr/>Antibanding<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1104 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1105 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]1106 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1107
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]1108 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1109
1110 <ul class="entry_type_enum">
1111 <li>
1112 <span class="entry_type_enum_name">OFF</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]1113 <span class="entry_type_enum_notes"><p>The camera device will not adjust exposure duration to
1114avoid banding problems.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1115 </li>
1116 <li>
1117 <span class="entry_type_enum_name">50HZ</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]1118 <span class="entry_type_enum_notes"><p>The camera device will adjust exposure duration to
1119avoid banding problems with 50Hz illumination sources.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1120 </li>
1121 <li>
1122 <span class="entry_type_enum_name">60HZ</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]1123 <span class="entry_type_enum_notes"><p>The camera device will adjust exposure duration to
1124avoid banding problems with 60Hz illumination
1125sources.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1126 </li>
1127 <li>
1128 <span class="entry_type_enum_name">AUTO</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]1129 <span class="entry_type_enum_notes"><p>The camera device will automatically adapt its
1130antibanding routine to the current illumination
1131conditions.<wbr/> This is the default.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1132 </li>
1133 </ul>
1134
1135 </td> <!-- entry_type -->
1136
1137 <td class="entry_description">
Eino-Ville Talvala19ce2c12013-12-30 12:03:45 -0800[diff] [blame]1138 <p>The desired setting for the camera device's auto-exposure
1139algorithm's antibanding compensation.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1140 </td>
1141
1142 <td class="entry_units">
1143 </td>
1144
1145 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]1146 <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]1147 </td>
1148
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1149 <td class="entry_tags">
Eino-Ville Talvala19ce2c12013-12-30 12:03:45 -0800[diff] [blame]1150 <ul class="entry_tags">
1151 <li><a href="#tag_BC">BC</a></li>
1152 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1153 </td>
1154
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1155 </tr>
Eino-Ville Talvala19ce2c12013-12-30 12:03:45 -0800[diff] [blame]1156 <tr class="entries_header">
1157 <th class="th_details" colspan="5">Details</th>
1158 </tr>
1159 <tr class="entry_cont">
1160 <td class="entry_details" colspan="5">
1161 <p>Some kinds of lighting fixtures,<wbr/> such as some fluorescent
1162lights,<wbr/> flicker at the rate of the power supply frequency
1163(60Hz or 50Hz,<wbr/> depending on country).<wbr/> While this is
1164typically not noticeable to a person,<wbr/> it can be visible to
1165a camera device.<wbr/> If a camera sets its exposure time to the
1166wrong value,<wbr/> the flicker may become visible in the
1167viewfinder as flicker or in a final captured image,<wbr/> as a
1168set of variable-brightness bands across the image.<wbr/></p>
1169<p>Therefore,<wbr/> the auto-exposure routines of camera devices
1170include antibanding routines that ensure that the chosen
1171exposure value will not cause such banding.<wbr/> The choice of
1172exposure time depends on the rate of flicker,<wbr/> which the
1173camera device can detect automatically,<wbr/> or the expected
1174rate can be selected by the application using this
1175control.<wbr/></p>
1176<p>A given camera device may not support all of the possible
1177options for the antibanding mode.<wbr/> The
1178<a href="#static_android.control.aeAvailableAntibandingModes">android.<wbr/>control.<wbr/>ae<wbr/>Available<wbr/>Antibanding<wbr/>Modes</a> key contains
1179the available modes for a given camera device.<wbr/></p>
1180<p>The default mode is AUTO,<wbr/> which must be supported by all
1181camera devices.<wbr/></p>
1182<p>If manual exposure control is enabled (by setting
1183<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/>
1184then this setting has no effect,<wbr/> and the application must
1185ensure it selects exposure times that do not cause banding
1186issues.<wbr/> The <a href="#dynamic_android.statistics.sceneFlicker">android.<wbr/>statistics.<wbr/>scene<wbr/>Flicker</a> key can assist
1187the application in this.<wbr/></p>
1188 </td>
1189 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1190
Eino-Ville Talvala19ce2c12013-12-30 12:03:45 -0800[diff] [blame]1191 <tr class="entries_header">
1192 <th class="th_details" colspan="5">HAL Implementation Details</th>
1193 </tr>
1194 <tr class="entry_cont">
1195 <td class="entry_details" colspan="5">
1196 <p>For all capture request templates,<wbr/> this field must be set
1197to AUTO.<wbr/> AUTO is the only mode that must supported;
1198OFF,<wbr/> 50HZ,<wbr/> 60HZ are all optional.<wbr/></p>
1199<p>If manual exposure control is enabled (by setting
1200<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/>
1201then the exposure values provided by the application must not be
1202adjusted for antibanding.<wbr/></p>
1203 </td>
1204 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1205
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1206 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
1207 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1208
1209
1210 <tr class="entry" id="controls_android.control.aeExposureCompensation">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1211 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1212 android.<wbr/>control.<wbr/>ae<wbr/>Exposure<wbr/>Compensation
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1213 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1214 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]1215 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1216
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]1217 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1218
1219
1220 </td> <!-- entry_type -->
1221
1222 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1223 <p>Adjustment to AE target image
1224brightness</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1225 </td>
1226
1227 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1228 count of positive/<wbr/>negative EV steps
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1229 </td>
1230
1231 <td class="entry_range">
1232 </td>
1233
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1234 <td class="entry_tags">
1235 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]1236 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1237 </ul>
1238 </td>
1239
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1240 </tr>
1241 <tr class="entries_header">
1242 <th class="th_details" colspan="5">Details</th>
1243 </tr>
1244 <tr class="entry_cont">
1245 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1246 <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]1247exposure compensation of +2 EV; -3 will mean an exposure
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1248compensation of -1</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1249 </td>
1250 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1251
1252
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1253 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
1254 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1255
1256
1257 <tr class="entry" id="controls_android.control.aeLock">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1258 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1259 android.<wbr/>control.<wbr/>ae<wbr/>Lock
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1260 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1261 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]1262 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1263
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]1264 <span class="entry_type_visibility"> [public as boolean]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1265
1266 <ul class="entry_type_enum">
1267 <li>
Eino-Ville Talvala76548fe2013-01-11 13:57:19 -0800[diff] [blame]1268 <span class="entry_type_enum_name">OFF</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]1269 <span class="entry_type_enum_notes"><p>Autoexposure lock is disabled; the AE algorithm
1270is free to update its parameters.<wbr/></p></span>
Eino-Ville Talvala76548fe2013-01-11 13:57:19 -0800[diff] [blame]1271 </li>
1272 <li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1273 <span class="entry_type_enum_name">ON</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]1274 <span class="entry_type_enum_notes"><p>Autoexposure lock is enabled; the AE algorithm
1275must not update the exposure and sensitivity parameters
1276while the lock is active</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1277 </li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1278 </ul>
1279
1280 </td> <!-- entry_type -->
1281
1282 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1283 <p>Whether AE is currently locked to its latest
1284calculated values</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1285 </td>
1286
1287 <td class="entry_units">
1288 </td>
1289
1290 <td class="entry_range">
1291 </td>
1292
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1293 <td class="entry_tags">
1294 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]1295 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1296 </ul>
1297 </td>
1298
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1299 </tr>
1300 <tr class="entries_header">
1301 <th class="th_details" colspan="5">Details</th>
1302 </tr>
1303 <tr class="entry_cont">
1304 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1305 <p>Note that even when AE is locked,<wbr/> the flash may be
1306fired if the AE mode is ON_<wbr/>AUTO_<wbr/>FLASH /<wbr/> ON_<wbr/>ALWAYS_<wbr/>FLASH /<wbr/>
1307ON_<wbr/>AUTO_<wbr/>FLASH_<wbr/>REDEYE.<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1308 </td>
1309 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1310
1311
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1312 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
1313 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1314
1315
1316 <tr class="entry" id="controls_android.control.aeMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1317 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1318 android.<wbr/>control.<wbr/>ae<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1319 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1320 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]1321 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1322
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]1323 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1324
1325 <ul class="entry_type_enum">
1326 <li>
1327 <span class="entry_type_enum_name">OFF</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]1328 <span class="entry_type_enum_notes"><p>The camera device's autoexposure routine is disabled;
1329the application-selected <a href="#controls_android.sensor.exposureTime">android.<wbr/>sensor.<wbr/>exposure<wbr/>Time</a>,<wbr/>
1330<a href="#controls_android.sensor.sensitivity">android.<wbr/>sensor.<wbr/>sensitivity</a> and
1331<a href="#controls_android.sensor.frameDuration">android.<wbr/>sensor.<wbr/>frame<wbr/>Duration</a> are used by the camera
1332device,<wbr/> along with android.<wbr/>flash.<wbr/>* fields,<wbr/> if there's
1333a flash unit for this camera device.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1334 </li>
1335 <li>
1336 <span class="entry_type_enum_name">ON</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]1337 <span class="entry_type_enum_notes"><p>The camera device's autoexposure routine is active,<wbr/>
1338with no flash control.<wbr/> The application's values for
1339<a href="#controls_android.sensor.exposureTime">android.<wbr/>sensor.<wbr/>exposure<wbr/>Time</a>,<wbr/>
1340<a href="#controls_android.sensor.sensitivity">android.<wbr/>sensor.<wbr/>sensitivity</a>,<wbr/> and
1341<a href="#controls_android.sensor.frameDuration">android.<wbr/>sensor.<wbr/>frame<wbr/>Duration</a> are ignored.<wbr/> The
1342application has control over the various
1343android.<wbr/>flash.<wbr/>* fields.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1344 </li>
1345 <li>
1346 <span class="entry_type_enum_name">ON_AUTO_FLASH</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]1347 <span class="entry_type_enum_notes"><p>Like ON,<wbr/> except that the camera device also controls
1348the camera's flash unit,<wbr/> firing it in low-light
1349conditions.<wbr/> The flash may be fired during a
1350precapture sequence (triggered by
1351<a href="#controls_android.control.aePrecaptureTrigger">android.<wbr/>control.<wbr/>ae<wbr/>Precapture<wbr/>Trigger</a>) and may be fired
1352for captures for which the
1353<a href="#controls_android.control.captureIntent">android.<wbr/>control.<wbr/>capture<wbr/>Intent</a> field is set to
1354STILL_<wbr/>CAPTURE</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1355 </li>
1356 <li>
1357 <span class="entry_type_enum_name">ON_ALWAYS_FLASH</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]1358 <span class="entry_type_enum_notes"><p>Like ON,<wbr/> except that the camera device also controls
1359the camera's flash unit,<wbr/> always firing it for still
1360captures.<wbr/> The flash may be fired during a precapture
1361sequence (triggered by
1362<a href="#controls_android.control.aePrecaptureTrigger">android.<wbr/>control.<wbr/>ae<wbr/>Precapture<wbr/>Trigger</a>) and will always
1363be fired for captures for which the
1364<a href="#controls_android.control.captureIntent">android.<wbr/>control.<wbr/>capture<wbr/>Intent</a> field is set to
1365STILL_<wbr/>CAPTURE</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1366 </li>
1367 <li>
1368 <span class="entry_type_enum_name">ON_AUTO_FLASH_REDEYE</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]1369 <span class="entry_type_enum_notes"><p>Like ON_<wbr/>AUTO_<wbr/>FLASH,<wbr/> but with automatic red eye
1370reduction.<wbr/> If deemed necessary by the camera device,<wbr/>
1371a red eye reduction flash will fire during the
1372precapture sequence.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1373 </li>
1374 </ul>
1375
1376 </td> <!-- entry_type -->
1377
1378 <td class="entry_description">
Eino-Ville Talvala9fa0d902014-01-08 16:16:53 -0800[diff] [blame]1379 <p>The desired mode for the camera device's
1380auto-exposure routine.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1381 </td>
1382
1383 <td class="entry_units">
1384 </td>
1385
1386 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]1387 <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]1388 </td>
1389
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1390 <td class="entry_tags">
1391 <ul class="entry_tags">
1392 <li><a href="#tag_BC">BC</a></li>
1393 </ul>
1394 </td>
1395
1396 </tr>
1397 <tr class="entries_header">
1398 <th class="th_details" colspan="5">Details</th>
1399 </tr>
1400 <tr class="entry_cont">
1401 <td class="entry_details" colspan="5">
Eino-Ville Talvala9fa0d902014-01-08 16:16:53 -0800[diff] [blame]1402 <p>This control is only effective if <a href="#controls_android.control.mode">android.<wbr/>control.<wbr/>mode</a> is
1403AUTO.<wbr/></p>
1404<p>When set to any of the ON modes,<wbr/> the camera device's
1405auto-exposure routine is enabled,<wbr/> overriding the
1406application's selected exposure time,<wbr/> sensor sensitivity,<wbr/>
1407and frame duration (<a href="#controls_android.sensor.exposureTime">android.<wbr/>sensor.<wbr/>exposure<wbr/>Time</a>,<wbr/>
1408<a href="#controls_android.sensor.sensitivity">android.<wbr/>sensor.<wbr/>sensitivity</a>,<wbr/> and
1409<a href="#controls_android.sensor.frameDuration">android.<wbr/>sensor.<wbr/>frame<wbr/>Duration</a>).<wbr/> If one of the FLASH modes
1410is selected,<wbr/> the camera device's flash unit controls are
1411also overridden.<wbr/></p>
1412<p>The FLASH modes are only available if the camera device
1413has a flash unit (<a href="#static_android.flash.info.available">android.<wbr/>flash.<wbr/>info.<wbr/>available</a> is <code>true</code>).<wbr/></p>
1414<p>If flash TORCH mode is desired,<wbr/> this field must be set to
1415ON or OFF,<wbr/> and <a href="#controls_android.flash.mode">android.<wbr/>flash.<wbr/>mode</a> set to TORCH.<wbr/></p>
1416<p>When set to any of the ON modes,<wbr/> the values chosen by the
1417camera device auto-exposure routine for the overridden
1418fields for a given capture will be available in its
1419CaptureResult.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1420 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1421 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1422
1423
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1424 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
1425 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1426
1427
1428 <tr class="entry" id="controls_android.control.aeRegions">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1429 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1430 android.<wbr/>control.<wbr/>ae<wbr/>Regions
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1431 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1432 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]1433 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1434 <span class="entry_type_container">x</span>
1435
1436 <span class="entry_type_array">
1437 5 x area_count
1438 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]1439 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1440
1441
1442 </td> <!-- entry_type -->
1443
1444 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1445 <p>List of areas to use for
1446metering</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1447 </td>
1448
1449 <td class="entry_units">
1450 </td>
1451
1452 <td class="entry_range">
1453 </td>
1454
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1455 <td class="entry_tags">
1456 <ul class="entry_tags">
1457 <li><a href="#tag_BC">BC</a></li>
1458 </ul>
1459 </td>
1460
1461 </tr>
1462 <tr class="entries_header">
1463 <th class="th_details" colspan="5">Details</th>
1464 </tr>
1465 <tr class="entry_cont">
1466 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1467 <p>Each area is a rectangle plus weight: xmin,<wbr/> ymin,<wbr/>
1468xmax,<wbr/> ymax,<wbr/> weight.<wbr/> The rectangle is defined inclusive of the
1469specified coordinates.<wbr/></p>
1470<p>The coordinate system is based on the active pixel array,<wbr/>
1471with (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]1472(<a href="#static_android.sensor.info.activeArraySize">android.<wbr/>sensor.<wbr/>info.<wbr/>active<wbr/>Array<wbr/>Size</a>.<wbr/>width - 1,<wbr/>
1473<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]1474bottom-right pixel in the active pixel array.<wbr/> The weight
1475should be nonnegative.<wbr/></p>
1476<p>If all regions have 0 weight,<wbr/> then no specific metering area
1477needs to be used by the HAL.<wbr/> If the metering region is
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]1478outside 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]1479should ignore the sections outside the region and output the
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1480used sections in the frame metadata</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1481 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1482 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1483
1484
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1485 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
1486 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1487
1488
1489 <tr class="entry" id="controls_android.control.aeTargetFpsRange">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1490 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1491 android.<wbr/>control.<wbr/>ae<wbr/>Target<wbr/>Fps<wbr/>Range
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1492 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1493 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]1494 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1495 <span class="entry_type_container">x</span>
1496
1497 <span class="entry_type_array">
1498 2
1499 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]1500 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1501
1502
1503 </td> <!-- entry_type -->
1504
1505 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1506 <p>Range over which fps can be adjusted to
1507maintain exposure</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1508 </td>
1509
1510 <td class="entry_units">
1511 </td>
1512
1513 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]1514 <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]1515 </td>
1516
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1517 <td class="entry_tags">
1518 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]1519 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1520 </ul>
1521 </td>
1522
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1523 </tr>
1524 <tr class="entries_header">
1525 <th class="th_details" colspan="5">Details</th>
1526 </tr>
1527 <tr class="entry_cont">
1528 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1529 <p>Only constrains AE algorithm,<wbr/> not manual control
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]1530of <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]1531 </td>
1532 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1533
1534
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1535 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
1536 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1537
1538
Eino-Ville Talvala3b4383a2013-03-18 09:42:48 -0700[diff] [blame]1539 <tr class="entry" id="controls_android.control.aePrecaptureTrigger">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1540 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1541 android.<wbr/>control.<wbr/>ae<wbr/>Precapture<wbr/>Trigger
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1542 </td>
Eino-Ville Talvala3b4383a2013-03-18 09:42:48 -0700[diff] [blame]1543 <td class="entry_type">
1544 <span class="entry_type_name entry_type_name_enum">byte</span>
1545
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]1546 <span class="entry_type_visibility"> [public]</span>
Eino-Ville Talvala3b4383a2013-03-18 09:42:48 -0700[diff] [blame]1547
1548 <ul class="entry_type_enum">
1549 <li>
1550 <span class="entry_type_enum_name">IDLE</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]1551 <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]1552 </li>
1553 <li>
1554 <span class="entry_type_enum_name">START</span>
Zhijun He92e698d2014-01-13 16:24:31 -0800[diff] [blame]1555 <span class="entry_type_enum_notes"><p>The precapture metering sequence will be started
1556by the camera device.<wbr/> The exact effect of the precapture
1557trigger depends on the current AE mode and state.<wbr/></p></span>
Eino-Ville Talvala3b4383a2013-03-18 09:42:48 -0700[diff] [blame]1558 </li>
1559 </ul>
1560
1561 </td> <!-- entry_type -->
1562
1563 <td class="entry_description">
Zhijun He92e698d2014-01-13 16:24:31 -0800[diff] [blame]1564 <p>Whether the camera device will trigger a precapture
1565metering sequence when it processes this request.<wbr/></p>
Eino-Ville Talvala3b4383a2013-03-18 09:42:48 -0700[diff] [blame]1566 </td>
1567
1568 <td class="entry_units">
1569 </td>
1570
1571 <td class="entry_range">
1572 </td>
1573
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1574 <td class="entry_tags">
1575 <ul class="entry_tags">
1576 <li><a href="#tag_BC">BC</a></li>
1577 </ul>
1578 </td>
1579
1580 </tr>
1581 <tr class="entries_header">
1582 <th class="th_details" colspan="5">Details</th>
1583 </tr>
1584 <tr class="entry_cont">
1585 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1586 <p>This entry is normally set to IDLE,<wbr/> or is not
1587included at all in the request settings.<wbr/> When included and
Zhijun He92e698d2014-01-13 16:24:31 -0800[diff] [blame]1588set to START,<wbr/> the camera device will trigger the autoexposure
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1589precapture metering sequence.<wbr/></p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]1590<p>The effect of AE precapture trigger depends on the current
Zhijun He92e698d2014-01-13 16:24:31 -0800[diff] [blame]1591AE mode and state; see <a href="#dynamic_android.control.aeState">android.<wbr/>control.<wbr/>ae<wbr/>State</a> for AE precapture
1592state transition details.<wbr/></p>
Eino-Ville Talvala3b4383a2013-03-18 09:42:48 -0700[diff] [blame]1593 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1594 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1595
1596
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1597 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
1598 <!-- end of entry -->
Eino-Ville Talvala3b4383a2013-03-18 09:42:48 -0700[diff] [blame]1599
1600
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1601 <tr class="entry" id="controls_android.control.afMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1602 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1603 android.<wbr/>control.<wbr/>af<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1604 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1605 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]1606 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1607
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]1608 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1609
1610 <ul class="entry_type_enum">
1611 <li>
1612 <span class="entry_type_enum_name">OFF</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]1613 <span class="entry_type_enum_notes"><p>The auto-focus routine does not control the lens;
1614<a href="#controls_android.lens.focusDistance">android.<wbr/>lens.<wbr/>focus<wbr/>Distance</a> is controlled by the
1615application</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1616 </li>
1617 <li>
1618 <span class="entry_type_enum_name">AUTO</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]1619 <span class="entry_type_enum_notes"><p>If lens is not fixed focus.<wbr/></p>
1620<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
1621is fixed-focus.<wbr/> In this mode,<wbr/> the lens does not move unless
1622the autofocus trigger action is called.<wbr/> When that trigger
1623is activated,<wbr/> AF must transition to ACTIVE_<wbr/>SCAN,<wbr/> then to
1624the outcome of the scan (FOCUSED or NOT_<wbr/>FOCUSED).<wbr/></p>
1625<p>Triggering AF_<wbr/>CANCEL resets the lens position to default,<wbr/>
1626and sets the AF state to INACTIVE.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1627 </li>
1628 <li>
1629 <span class="entry_type_enum_name">MACRO</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]1630 <span class="entry_type_enum_notes"><p>In this mode,<wbr/> the lens does not move unless the
1631autofocus trigger action is called.<wbr/></p>
1632<p>When that trigger is activated,<wbr/> AF must transition to
1633ACTIVE_<wbr/>SCAN,<wbr/> then to the outcome of the scan (FOCUSED or
1634NOT_<wbr/>FOCUSED).<wbr/> Triggering cancel AF resets the lens
1635position to default,<wbr/> and sets the AF state to
1636INACTIVE.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1637 </li>
1638 <li>
1639 <span class="entry_type_enum_name">CONTINUOUS_VIDEO</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]1640 <span class="entry_type_enum_notes"><p>In this mode,<wbr/> the AF algorithm modifies the lens
1641position continually to attempt to provide a
1642constantly-in-focus image stream.<wbr/></p>
1643<p>The focusing behavior should be suitable for good quality
1644video recording; typically this means slower focus
1645movement and no overshoots.<wbr/> When the AF trigger is not
1646involved,<wbr/> the AF algorithm should start in INACTIVE state,<wbr/>
1647and then transition into PASSIVE_<wbr/>SCAN and PASSIVE_<wbr/>FOCUSED
1648states as appropriate.<wbr/> When the AF trigger is activated,<wbr/>
1649the algorithm should immediately transition into
1650AF_<wbr/>FOCUSED or AF_<wbr/>NOT_<wbr/>FOCUSED as appropriate,<wbr/> and lock the
1651lens position until a cancel AF trigger is received.<wbr/></p>
1652<p>Once cancel is received,<wbr/> the algorithm should transition
1653back to INACTIVE and resume passive scan.<wbr/> Note that this
1654behavior is not identical to CONTINUOUS_<wbr/>PICTURE,<wbr/> since an
1655ongoing PASSIVE_<wbr/>SCAN must immediately be
1656canceled.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1657 </li>
1658 <li>
1659 <span class="entry_type_enum_name">CONTINUOUS_PICTURE</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]1660 <span class="entry_type_enum_notes"><p>In this mode,<wbr/> the AF algorithm modifies the lens
1661position continually to attempt to provide a
1662constantly-in-focus image stream.<wbr/></p>
1663<p>The focusing behavior should be suitable for still image
1664capture; typically this means focusing as fast as
1665possible.<wbr/> When the AF trigger is not involved,<wbr/> the AF
1666algorithm should start in INACTIVE state,<wbr/> and then
1667transition into PASSIVE_<wbr/>SCAN and PASSIVE_<wbr/>FOCUSED states as
1668appropriate as it attempts to maintain focus.<wbr/> When the AF
1669trigger is activated,<wbr/> the algorithm should finish its
1670PASSIVE_<wbr/>SCAN if active,<wbr/> and then transition into
1671AF_<wbr/>FOCUSED or AF_<wbr/>NOT_<wbr/>FOCUSED as appropriate,<wbr/> and lock the
1672lens position until a cancel AF trigger is received.<wbr/></p>
1673<p>When the AF cancel trigger is activated,<wbr/> the algorithm
1674should transition back to INACTIVE and then act as if it
1675has just been started.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1676 </li>
1677 <li>
1678 <span class="entry_type_enum_name">EDOF</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]1679 <span class="entry_type_enum_notes"><p>Extended depth of field (digital focus).<wbr/> AF
1680trigger is ignored,<wbr/> AF state should always be
1681INACTIVE.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1682 </li>
1683 </ul>
1684
1685 </td> <!-- entry_type -->
1686
1687 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1688 <p>Whether AF is currently enabled,<wbr/> and what
1689mode it is set to</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1690 </td>
1691
1692 <td class="entry_units">
1693 </td>
1694
1695 <td class="entry_range">
Zhijun He7787f7f2014-01-14 16:30:31 -0800[diff] [blame]1696 <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]1697 </td>
1698
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1699 <td class="entry_tags">
1700 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]1701 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1702 </ul>
1703 </td>
1704
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1705 </tr>
1706 <tr class="entries_header">
1707 <th class="th_details" colspan="5">Details</th>
1708 </tr>
1709 <tr class="entry_cont">
1710 <td class="entry_details" colspan="5">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]1711 <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]1712<p>If the lens is controlled by the camera device auto-focus algorithm,<wbr/>
1713the camera device will report the current AF status in android.<wbr/>control.<wbr/>af<wbr/>State
1714in result metadata.<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1715 </td>
1716 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1717
1718
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1719 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
1720 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1721
1722
1723 <tr class="entry" id="controls_android.control.afRegions">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1724 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1725 android.<wbr/>control.<wbr/>af<wbr/>Regions
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1726 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1727 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]1728 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1729 <span class="entry_type_container">x</span>
1730
1731 <span class="entry_type_array">
1732 5 x area_count
1733 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]1734 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1735
1736
1737 </td> <!-- entry_type -->
1738
1739 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1740 <p>List of areas to use for focus
1741estimation</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1742 </td>
1743
1744 <td class="entry_units">
1745 </td>
1746
1747 <td class="entry_range">
1748 </td>
1749
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1750 <td class="entry_tags">
1751 <ul class="entry_tags">
1752 <li><a href="#tag_BC">BC</a></li>
1753 </ul>
1754 </td>
1755
1756 </tr>
1757 <tr class="entries_header">
1758 <th class="th_details" colspan="5">Details</th>
1759 </tr>
1760 <tr class="entry_cont">
1761 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1762 <p>Each area is a rectangle plus weight: xmin,<wbr/> ymin,<wbr/>
1763xmax,<wbr/> ymax,<wbr/> weight.<wbr/> The rectangle is defined inclusive of the
1764specified coordinates.<wbr/></p>
1765<p>The coordinate system is based on the active pixel array,<wbr/>
1766with (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]1767(<a href="#static_android.sensor.info.activeArraySize">android.<wbr/>sensor.<wbr/>info.<wbr/>active<wbr/>Array<wbr/>Size</a>.<wbr/>width - 1,<wbr/>
1768<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]1769bottom-right pixel in the active pixel array.<wbr/> The weight
1770should be nonnegative.<wbr/></p>
1771<p>If all regions have 0 weight,<wbr/> then no specific focus area
1772needs to be used by the HAL.<wbr/> If the focusing region is
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]1773outside 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]1774should ignore the sections outside the region and output the
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1775used sections in the frame metadata</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1776 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1777 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1778
1779
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1780 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
1781 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1782
1783
Eino-Ville Talvala3b4383a2013-03-18 09:42:48 -0700[diff] [blame]1784 <tr class="entry" id="controls_android.control.afTrigger">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1785 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1786 android.<wbr/>control.<wbr/>af<wbr/>Trigger
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1787 </td>
Eino-Ville Talvala3b4383a2013-03-18 09:42:48 -0700[diff] [blame]1788 <td class="entry_type">
1789 <span class="entry_type_name entry_type_name_enum">byte</span>
1790
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]1791 <span class="entry_type_visibility"> [public]</span>
Eino-Ville Talvala3b4383a2013-03-18 09:42:48 -0700[diff] [blame]1792
1793 <ul class="entry_type_enum">
1794 <li>
1795 <span class="entry_type_enum_name">IDLE</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]1796 <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]1797 </li>
1798 <li>
1799 <span class="entry_type_enum_name">START</span>
Zhijun He92e698d2014-01-13 16:24:31 -0800[diff] [blame]1800 <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]1801 </li>
1802 <li>
1803 <span class="entry_type_enum_name">CANCEL</span>
Zhijun He92e698d2014-01-13 16:24:31 -0800[diff] [blame]1804 <span class="entry_type_enum_notes"><p>Autofocus will return to its initial
1805state,<wbr/> and cancel any currently active trigger.<wbr/></p></span>
Eino-Ville Talvala3b4383a2013-03-18 09:42:48 -0700[diff] [blame]1806 </li>
1807 </ul>
1808
1809 </td> <!-- entry_type -->
1810
1811 <td class="entry_description">
Zhijun He92e698d2014-01-13 16:24:31 -0800[diff] [blame]1812 <p>Whether the camera device will trigger autofocus for this request.<wbr/></p>
Eino-Ville Talvala3b4383a2013-03-18 09:42:48 -0700[diff] [blame]1813 </td>
1814
1815 <td class="entry_units">
1816 </td>
1817
1818 <td class="entry_range">
1819 </td>
1820
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1821 <td class="entry_tags">
1822 <ul class="entry_tags">
1823 <li><a href="#tag_BC">BC</a></li>
1824 </ul>
1825 </td>
1826
1827 </tr>
1828 <tr class="entries_header">
1829 <th class="th_details" colspan="5">Details</th>
1830 </tr>
1831 <tr class="entry_cont">
1832 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1833 <p>This entry is normally set to IDLE,<wbr/> or is not
1834included at all in the request settings.<wbr/></p>
Zhijun He92e698d2014-01-13 16:24:31 -0800[diff] [blame]1835<p>When included and set to START,<wbr/> the camera device will trigger the
1836autofocus algorithm.<wbr/> If autofocus is disabled,<wbr/> this trigger has no effect.<wbr/></p>
1837<p>When set to CANCEL,<wbr/> the camera device will cancel any active trigger,<wbr/>
1838and return to its initial AF state.<wbr/></p>
1839<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]1840 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1841 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1842
1843
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1844 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
1845 <!-- end of entry -->
Eino-Ville Talvala3b4383a2013-03-18 09:42:48 -0700[diff] [blame]1846
1847
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1848 <tr class="entry" id="controls_android.control.awbLock">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1849 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1850 android.<wbr/>control.<wbr/>awb<wbr/>Lock
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1851 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1852 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]1853 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1854
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]1855 <span class="entry_type_visibility"> [public as boolean]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1856
1857 <ul class="entry_type_enum">
1858 <li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1859 <span class="entry_type_enum_name">OFF</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]1860 <span class="entry_type_enum_notes"><p>Auto-whitebalance lock is disabled; the AWB
1861algorithm is free to update its parameters if in AUTO
1862mode.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1863 </li>
Eino-Ville Talvala76548fe2013-01-11 13:57:19 -0800[diff] [blame]1864 <li>
1865 <span class="entry_type_enum_name">ON</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]1866 <span class="entry_type_enum_notes"><p>Auto-whitebalance lock is enabled; the AWB
1867algorithm must not update the exposure and sensitivity
1868parameters while the lock is active</p></span>
Eino-Ville Talvala76548fe2013-01-11 13:57:19 -0800[diff] [blame]1869 </li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1870 </ul>
1871
1872 </td> <!-- entry_type -->
1873
1874 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1875 <p>Whether AWB is currently locked to its
1876latest calculated values</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1877 </td>
1878
1879 <td class="entry_units">
1880 </td>
1881
1882 <td class="entry_range">
1883 </td>
1884
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1885 <td class="entry_tags">
1886 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]1887 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1888 </ul>
1889 </td>
1890
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1891 </tr>
1892 <tr class="entries_header">
1893 <th class="th_details" colspan="5">Details</th>
1894 </tr>
1895 <tr class="entry_cont">
1896 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1897 <p>Note that AWB lock is only meaningful for AUTO
1898mode; in other modes,<wbr/> AWB is already fixed to a specific
1899setting</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1900 </td>
1901 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1902
1903
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1904 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
1905 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1906
1907
1908 <tr class="entry" id="controls_android.control.awbMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1909 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1910 android.<wbr/>control.<wbr/>awb<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1911 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1912 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]1913 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1914
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]1915 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1916
1917 <ul class="entry_type_enum">
1918 <li>
1919 <span class="entry_type_enum_name">OFF</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]1920 <span class="entry_type_enum_notes"><p>The camera device's auto white balance routine is disabled;
1921the application-selected color transform matrix
1922(<a href="#controls_android.colorCorrection.transform">android.<wbr/>color<wbr/>Correction.<wbr/>transform</a>) and gains
1923(<a href="#controls_android.colorCorrection.gains">android.<wbr/>color<wbr/>Correction.<wbr/>gains</a>) are used by the camera
1924device for manual white balance control.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1925 </li>
1926 <li>
1927 <span class="entry_type_enum_name">AUTO</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]1928 <span class="entry_type_enum_notes"><p>The camera device's auto white balance routine is active;
1929the application's values for android.<wbr/>color<wbr/>Correction.<wbr/>transform
1930and <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]1931 </li>
1932 <li>
1933 <span class="entry_type_enum_name">INCANDESCENT</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]1934 <span class="entry_type_enum_notes"><p>The camera device's auto white balance routine is disabled;
1935the camera device uses incandescent light as the assumed scene
1936illumination for white balance.<wbr/> While the exact white balance
1937transforms are up to the camera device,<wbr/> they will approximately
1938match the CIE standard illuminant A.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1939 </li>
1940 <li>
1941 <span class="entry_type_enum_name">FLUORESCENT</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]1942 <span class="entry_type_enum_notes"><p>The camera device's auto white balance routine is disabled;
1943the camera device uses fluorescent light as the assumed scene
1944illumination for white balance.<wbr/> While the exact white balance
1945transforms are up to the camera device,<wbr/> they will approximately
1946match the CIE standard illuminant F2.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1947 </li>
1948 <li>
1949 <span class="entry_type_enum_name">WARM_FLUORESCENT</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]1950 <span class="entry_type_enum_notes"><p>The camera device's auto white balance routine is disabled;
1951the camera device uses warm fluorescent light as the assumed scene
1952illumination for white balance.<wbr/> While the exact white balance
1953transforms are up to the camera device,<wbr/> they will approximately
1954match the CIE standard illuminant F4.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1955 </li>
1956 <li>
1957 <span class="entry_type_enum_name">DAYLIGHT</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]1958 <span class="entry_type_enum_notes"><p>The camera device's auto white balance routine is disabled;
1959the camera device uses daylight light as the assumed scene
1960illumination for white balance.<wbr/> While the exact white balance
1961transforms are up to the camera device,<wbr/> they will approximately
1962match the CIE standard illuminant D65.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1963 </li>
1964 <li>
1965 <span class="entry_type_enum_name">CLOUDY_DAYLIGHT</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]1966 <span class="entry_type_enum_notes"><p>The camera device's auto white balance routine is disabled;
1967the camera device uses cloudy daylight light as the assumed scene
1968illumination for white balance.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1969 </li>
1970 <li>
1971 <span class="entry_type_enum_name">TWILIGHT</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]1972 <span class="entry_type_enum_notes"><p>The camera device's auto white balance routine is disabled;
1973the camera device uses twilight light as the assumed scene
1974illumination for white balance.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1975 </li>
1976 <li>
1977 <span class="entry_type_enum_name">SHADE</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]1978 <span class="entry_type_enum_notes"><p>The camera device's auto white balance routine is disabled;
1979the camera device uses shade light as the assumed scene
1980illumination for white balance.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1981 </li>
1982 </ul>
1983
1984 </td> <!-- entry_type -->
1985
1986 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1987 <p>Whether AWB is currently setting the color
1988transform fields,<wbr/> and what its illumination target
1989is</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1990 </td>
1991
1992 <td class="entry_units">
1993 </td>
1994
1995 <td class="entry_range">
Zhijun He7787f7f2014-01-14 16:30:31 -0800[diff] [blame]1996 <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]1997 </td>
1998
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1999 <td class="entry_tags">
2000 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]2001 <li><a href="#tag_BC">BC</a></li>
2002 <li><a href="#tag_AWB">AWB</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2003 </ul>
2004 </td>
2005
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2006 </tr>
2007 <tr class="entries_header">
2008 <th class="th_details" colspan="5">Details</th>
2009 </tr>
2010 <tr class="entry_cont">
2011 <td class="entry_details" colspan="5">
Zhijun He7787f7f2014-01-14 16:30:31 -0800[diff] [blame]2012 <p>This control is only effective if <a href="#controls_android.control.mode">android.<wbr/>control.<wbr/>mode</a> is AUTO.<wbr/></p>
2013<p>When set to the ON mode,<wbr/> the camera device's auto white balance
2014routine is enabled,<wbr/> overriding the application's selected
2015<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
2016<a href="#controls_android.colorCorrection.mode">android.<wbr/>color<wbr/>Correction.<wbr/>mode</a>.<wbr/></p>
2017<p>When set to the OFF mode,<wbr/> the camera device's auto white balance
2018routine is disabled.<wbr/> The applicantion manually controls the white
2019balance by <a href="#controls_android.colorCorrection.transform">android.<wbr/>color<wbr/>Correction.<wbr/>transform</a>,<wbr/> android.<wbr/>color<wbr/>Correction.<wbr/>gains
2020and <a href="#controls_android.colorCorrection.mode">android.<wbr/>color<wbr/>Correction.<wbr/>mode</a>.<wbr/></p>
2021<p>When set to any other modes,<wbr/> the camera device's auto white balance
2022routine is disabled.<wbr/> The camera device uses each particular illumination
2023target for white balance adjustment.<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2024 </td>
2025 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2026
2027
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2028 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
2029 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2030
2031
2032 <tr class="entry" id="controls_android.control.awbRegions">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2033 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2034 android.<wbr/>control.<wbr/>awb<wbr/>Regions
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2035 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2036 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]2037 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2038 <span class="entry_type_container">x</span>
2039
2040 <span class="entry_type_array">
2041 5 x area_count
2042 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2043 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2044
2045
2046 </td> <!-- entry_type -->
2047
2048 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2049 <p>List of areas to use for illuminant
2050estimation</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2051 </td>
2052
2053 <td class="entry_units">
2054 </td>
2055
2056 <td class="entry_range">
2057 </td>
2058
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2059 <td class="entry_tags">
2060 <ul class="entry_tags">
2061 <li><a href="#tag_BC">BC</a></li>
2062 </ul>
2063 </td>
2064
2065 </tr>
2066 <tr class="entries_header">
2067 <th class="th_details" colspan="5">Details</th>
2068 </tr>
2069 <tr class="entry_cont">
2070 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2071 <p>Only used in AUTO mode.<wbr/></p>
2072<p>Each area is a rectangle plus weight: xmin,<wbr/> ymin,<wbr/>
2073xmax,<wbr/> ymax,<wbr/> weight.<wbr/> The rectangle is defined inclusive of the
2074specified coordinates.<wbr/></p>
2075<p>The coordinate system is based on the active pixel array,<wbr/>
2076with (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]2077(<a href="#static_android.sensor.info.activeArraySize">android.<wbr/>sensor.<wbr/>info.<wbr/>active<wbr/>Array<wbr/>Size</a>.<wbr/>width - 1,<wbr/>
2078<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]2079bottom-right pixel in the active pixel array.<wbr/> The weight
2080should be nonnegative.<wbr/></p>
2081<p>If all regions have 0 weight,<wbr/> then no specific metering area
2082needs to be used by the HAL.<wbr/> If the metering region is
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]2083outside 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]2084should ignore the sections outside the region and output the
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2085used sections in the frame metadata</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2086 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2087 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2088
2089
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2090 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
2091 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2092
2093
2094 <tr class="entry" id="controls_android.control.captureIntent">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2095 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2096 android.<wbr/>control.<wbr/>capture<wbr/>Intent
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2097 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2098 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]2099 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2100
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2101 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2102
2103 <ul class="entry_type_enum">
2104 <li>
2105 <span class="entry_type_enum_name">CUSTOM</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]2106 <span class="entry_type_enum_notes"><p>This request doesn't fall into the other
2107categories.<wbr/> Default to preview-like
2108behavior.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2109 </li>
2110 <li>
2111 <span class="entry_type_enum_name">PREVIEW</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]2112 <span class="entry_type_enum_notes"><p>This request is for a preview-like usecase.<wbr/> The
2113precapture trigger may be used to start off a metering
2114w/<wbr/>flash sequence</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2115 </li>
2116 <li>
2117 <span class="entry_type_enum_name">STILL_CAPTURE</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]2118 <span class="entry_type_enum_notes"><p>This request is for a still capture-type
2119usecase.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2120 </li>
2121 <li>
2122 <span class="entry_type_enum_name">VIDEO_RECORD</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]2123 <span class="entry_type_enum_notes"><p>This request is for a video recording
2124usecase.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2125 </li>
2126 <li>
2127 <span class="entry_type_enum_name">VIDEO_SNAPSHOT</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]2128 <span class="entry_type_enum_notes"><p>This request is for a video snapshot (still
2129image while recording video) usecase</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2130 </li>
2131 <li>
2132 <span class="entry_type_enum_name">ZERO_SHUTTER_LAG</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]2133 <span class="entry_type_enum_notes"><p>This request is for a ZSL usecase; the
2134application will stream full-resolution images and
2135reprocess one or several later for a final
2136capture</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2137 </li>
2138 </ul>
2139
2140 </td> <!-- entry_type -->
2141
2142 <td class="entry_description">
Zhijun Heea27bc32014-01-15 13:47:59 -0800[diff] [blame]2143 <p>Information to the camera device 3A (auto-exposure,<wbr/>
2144auto-focus,<wbr/> auto-white balance) routines about the purpose
2145of this capture,<wbr/> to help the camera device to decide optimal 3A
2146strategy.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2147 </td>
2148
2149 <td class="entry_units">
2150 </td>
2151
2152 <td class="entry_range">
Zhijun Heea27bc32014-01-15 13:47:59 -0800[diff] [blame]2153 <p>All must be supported</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2154 </td>
2155
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2156 <td class="entry_tags">
2157 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]2158 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2159 </ul>
2160 </td>
2161
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2162 </tr>
2163 <tr class="entries_header">
2164 <th class="th_details" colspan="5">Details</th>
2165 </tr>
2166 <tr class="entry_cont">
2167 <td class="entry_details" colspan="5">
Zhijun Heea27bc32014-01-15 13:47:59 -0800[diff] [blame]2168 <p>This control is only effective if <code><a href="#controls_android.control.mode">android.<wbr/>control.<wbr/>mode</a> != OFF</code>
2169and any 3A routine is active.<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2170 </td>
2171 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2172
2173
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2174 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
2175 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2176
2177
2178 <tr class="entry" id="controls_android.control.effectMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2179 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2180 android.<wbr/>control.<wbr/>effect<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2181 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2182 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]2183 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2184
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2185 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2186
2187 <ul class="entry_type_enum">
2188 <li>
2189 <span class="entry_type_enum_name">OFF</span>
2190 </li>
2191 <li>
2192 <span class="entry_type_enum_name">MONO</span>
2193 <span class="entry_type_enum_optional">optional</span>
2194 </li>
2195 <li>
2196 <span class="entry_type_enum_name">NEGATIVE</span>
2197 <span class="entry_type_enum_optional">optional</span>
2198 </li>
2199 <li>
2200 <span class="entry_type_enum_name">SOLARIZE</span>
2201 <span class="entry_type_enum_optional">optional</span>
2202 </li>
2203 <li>
2204 <span class="entry_type_enum_name">SEPIA</span>
2205 <span class="entry_type_enum_optional">optional</span>
2206 </li>
2207 <li>
2208 <span class="entry_type_enum_name">POSTERIZE</span>
2209 <span class="entry_type_enum_optional">optional</span>
2210 </li>
2211 <li>
2212 <span class="entry_type_enum_name">WHITEBOARD</span>
2213 <span class="entry_type_enum_optional">optional</span>
2214 </li>
2215 <li>
2216 <span class="entry_type_enum_name">BLACKBOARD</span>
2217 <span class="entry_type_enum_optional">optional</span>
2218 </li>
2219 <li>
2220 <span class="entry_type_enum_name">AQUA</span>
2221 <span class="entry_type_enum_optional">optional</span>
2222 </li>
2223 </ul>
2224
2225 </td> <!-- entry_type -->
2226
2227 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2228 <p>Whether any special color effect is in use.<wbr/>
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]2229Only used if <a href="#controls_android.control.mode">android.<wbr/>control.<wbr/>mode</a> != OFF</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2230 </td>
2231
2232 <td class="entry_units">
2233 </td>
2234
2235 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]2236 <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]2237 </td>
2238
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2239 <td class="entry_tags">
2240 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]2241 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2242 </ul>
2243 </td>
2244
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2245 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2246
2247
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2248 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
2249 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2250
2251
2252 <tr class="entry" id="controls_android.control.mode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2253 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2254 android.<wbr/>control.<wbr/>mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2255 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2256 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]2257 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2258
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2259 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2260
2261 <ul class="entry_type_enum">
2262 <li>
2263 <span class="entry_type_enum_name">OFF</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]2264 <span class="entry_type_enum_notes"><p>Full application control of pipeline.<wbr/> All 3A
2265routines are disabled,<wbr/> no other settings in
2266android.<wbr/>control.<wbr/>* have any effect</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2267 </li>
2268 <li>
2269 <span class="entry_type_enum_name">AUTO</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]2270 <span class="entry_type_enum_notes"><p>Use settings for each individual 3A routine.<wbr/>
2271Manual control of capture parameters is disabled.<wbr/> All
2272controls in android.<wbr/>control.<wbr/>* besides sceneMode take
2273effect</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2274 </li>
2275 <li>
2276 <span class="entry_type_enum_name">USE_SCENE_MODE</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]2277 <span class="entry_type_enum_notes"><p>Use specific scene mode.<wbr/> Enabling this disables
2278control.<wbr/>aeMode,<wbr/> control.<wbr/>awbMode and control.<wbr/>afMode
2279controls; the HAL must ignore those settings while
2280USE_<wbr/>SCENE_<wbr/>MODE is active (except for FACE_<wbr/>PRIORITY
2281scene mode).<wbr/> Other control entries are still active.<wbr/>
2282This setting can only be used if availableSceneModes !=
2283UNSUPPORTED</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2284 </li>
2285 </ul>
2286
2287 </td> <!-- entry_type -->
2288
2289 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2290 <p>Overall mode of 3A control
2291routines</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2292 </td>
2293
2294 <td class="entry_units">
2295 </td>
2296
2297 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]2298 <p>all must be supported</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2299 </td>
2300
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2301 <td class="entry_tags">
2302 <ul class="entry_tags">
2303 <li><a href="#tag_BC">BC</a></li>
2304 </ul>
2305 </td>
2306
2307 </tr>
2308 <tr class="entries_header">
2309 <th class="th_details" colspan="5">Details</th>
2310 </tr>
2311 <tr class="entry_cont">
2312 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2313 <p>High-level 3A control.<wbr/> When set to OFF,<wbr/> all 3A control
Zhijun Hef90eeaf2014-01-16 12:13:35 -0800[diff] [blame]2314by the camera device is disabled.<wbr/> The application must set the fields for
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2315capture parameters itself.<wbr/></p>
2316<p>When set to AUTO,<wbr/> the individual algorithm controls in
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]2317android.<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]2318<p>When set to USE_<wbr/>SCENE_<wbr/>MODE,<wbr/> the individual controls in
Zhijun Hef90eeaf2014-01-16 12:13:35 -0800[diff] [blame]2319android.<wbr/>control.<wbr/>* are mostly disabled,<wbr/> and the camera device implements
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2320one of the scene mode settings (such as ACTION,<wbr/> SUNSET,<wbr/> or PARTY)
Zhijun Hef90eeaf2014-01-16 12:13:35 -0800[diff] [blame]2321as it wishes.<wbr/> The camera device scene mode 3A settings are provided by
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]2322<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]2323 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2324 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2325
2326
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2327 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
2328 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2329
2330
2331 <tr class="entry" id="controls_android.control.sceneMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2332 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2333 android.<wbr/>control.<wbr/>scene<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2334 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2335 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]2336 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2337
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2338 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2339
2340 <ul class="entry_type_enum">
2341 <li>
2342 <span class="entry_type_enum_name">UNSUPPORTED</span>
2343 <span class="entry_type_enum_value">0</span>
2344 </li>
2345 <li>
2346 <span class="entry_type_enum_name">FACE_PRIORITY</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]2347 <span class="entry_type_enum_notes"><p>if face detection support exists Use face
2348detection data to drive 3A routines.<wbr/> If face detection
2349statistics are disabled,<wbr/> should still operate correctly
2350(but not return face detection statistics to the
2351framework).<wbr/></p>
2352<p>Unlike the other scene modes,<wbr/> aeMode,<wbr/> awbMode,<wbr/> and afMode
2353remain active when FACE_<wbr/>PRIORITY is set.<wbr/> This is due to
2354compatibility concerns with the old camera
2355API</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2356 </li>
2357 <li>
2358 <span class="entry_type_enum_name">ACTION</span>
2359 <span class="entry_type_enum_optional">optional</span>
2360 </li>
2361 <li>
2362 <span class="entry_type_enum_name">PORTRAIT</span>
2363 <span class="entry_type_enum_optional">optional</span>
2364 </li>
2365 <li>
2366 <span class="entry_type_enum_name">LANDSCAPE</span>
2367 <span class="entry_type_enum_optional">optional</span>
2368 </li>
2369 <li>
2370 <span class="entry_type_enum_name">NIGHT</span>
2371 <span class="entry_type_enum_optional">optional</span>
2372 </li>
2373 <li>
2374 <span class="entry_type_enum_name">NIGHT_PORTRAIT</span>
2375 <span class="entry_type_enum_optional">optional</span>
2376 </li>
2377 <li>
2378 <span class="entry_type_enum_name">THEATRE</span>
2379 <span class="entry_type_enum_optional">optional</span>
2380 </li>
2381 <li>
2382 <span class="entry_type_enum_name">BEACH</span>
2383 <span class="entry_type_enum_optional">optional</span>
2384 </li>
2385 <li>
2386 <span class="entry_type_enum_name">SNOW</span>
2387 <span class="entry_type_enum_optional">optional</span>
2388 </li>
2389 <li>
2390 <span class="entry_type_enum_name">SUNSET</span>
2391 <span class="entry_type_enum_optional">optional</span>
2392 </li>
2393 <li>
2394 <span class="entry_type_enum_name">STEADYPHOTO</span>
2395 <span class="entry_type_enum_optional">optional</span>
2396 </li>
2397 <li>
2398 <span class="entry_type_enum_name">FIREWORKS</span>
2399 <span class="entry_type_enum_optional">optional</span>
2400 </li>
2401 <li>
2402 <span class="entry_type_enum_name">SPORTS</span>
2403 <span class="entry_type_enum_optional">optional</span>
2404 </li>
2405 <li>
2406 <span class="entry_type_enum_name">PARTY</span>
2407 <span class="entry_type_enum_optional">optional</span>
2408 </li>
2409 <li>
2410 <span class="entry_type_enum_name">CANDLELIGHT</span>
2411 <span class="entry_type_enum_optional">optional</span>
2412 </li>
2413 <li>
2414 <span class="entry_type_enum_name">BARCODE</span>
2415 <span class="entry_type_enum_optional">optional</span>
2416 </li>
2417 </ul>
2418
2419 </td> <!-- entry_type -->
2420
2421 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2422 <p>Which scene mode is active when
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]2423<a href="#controls_android.control.mode">android.<wbr/>control.<wbr/>mode</a> = SCENE_<wbr/>MODE</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2424 </td>
2425
2426 <td class="entry_units">
2427 </td>
2428
2429 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]2430 <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]2431 </td>
2432
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2433 <td class="entry_tags">
2434 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]2435 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2436 </ul>
2437 </td>
2438
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2439 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2440
2441
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2442 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
2443 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2444
2445
2446 <tr class="entry" id="controls_android.control.videoStabilizationMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2447 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2448 android.<wbr/>control.<wbr/>video<wbr/>Stabilization<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2449 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2450 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]2451 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2452
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]2453 <span class="entry_type_visibility"> [public as boolean]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2454
2455 <ul class="entry_type_enum">
2456 <li>
2457 <span class="entry_type_enum_name">OFF</span>
2458 </li>
2459 <li>
2460 <span class="entry_type_enum_name">ON</span>
2461 </li>
2462 </ul>
2463
2464 </td> <!-- entry_type -->
2465
2466 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2467 <p>Whether video stabilization is
2468active</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2469 </td>
2470
2471 <td class="entry_units">
2472 </td>
2473
2474 <td class="entry_range">
2475 </td>
2476
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2477 <td class="entry_tags">
2478 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]2479 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2480 </ul>
2481 </td>
2482
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2483 </tr>
2484 <tr class="entries_header">
2485 <th class="th_details" colspan="5">Details</th>
2486 </tr>
2487 <tr class="entry_cont">
2488 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2489 <p>If enabled,<wbr/> video stabilization can modify the
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]2490<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]2491stabilized</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2492 </td>
2493 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2494
2495
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2496 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
2497 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2498
2499
2500
2501 <!-- end of kind -->
2502 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2503 <tr><td colspan="6" class="kind">static</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2504
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2505 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2506 <tr>
2507 <th class="th_name">Property Name</th>
2508 <th class="th_type">Type</th>
2509 <th class="th_description">Description</th>
2510 <th class="th_units">Units</th>
2511 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2512 <th class="th_tags">Tags</th>
2513 </tr>
2514 </thead>
2515
2516 <tbody>
2517
2518
2519
2520
2521
2522
2523
2524
2525
2526
2527 <tr class="entry" id="static_android.control.aeAvailableAntibandingModes">
Eino-Ville Talvala19ce2c12013-12-30 12:03:45 -0800[diff] [blame]2528 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2529 android.<wbr/>control.<wbr/>ae<wbr/>Available<wbr/>Antibanding<wbr/>Modes
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2530 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2531 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]2532 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2533 <span class="entry_type_container">x</span>
2534
2535 <span class="entry_type_array">
2536 n
2537 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2538 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2539 <div class="entry_type_notes">list of enums</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2540
2541
2542 </td> <!-- entry_type -->
2543
2544 <td class="entry_description">
Eino-Ville Talvala19ce2c12013-12-30 12:03:45 -0800[diff] [blame]2545 <p>The set of auto-exposure antibanding modes that are
2546supported by this camera device.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2547 </td>
2548
2549 <td class="entry_units">
2550 </td>
2551
2552 <td class="entry_range">
2553 </td>
2554
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2555 <td class="entry_tags">
2556 </td>
2557
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2558 </tr>
Eino-Ville Talvala19ce2c12013-12-30 12:03:45 -0800[diff] [blame]2559 <tr class="entries_header">
2560 <th class="th_details" colspan="5">Details</th>
2561 </tr>
2562 <tr class="entry_cont">
2563 <td class="entry_details" colspan="5">
2564 <p>Not all of the auto-exposure anti-banding modes may be
2565supported by a given camera device.<wbr/> This field lists the
2566valid anti-banding modes that the application may request
2567for this camera device; they must include AUTO.<wbr/></p>
2568 </td>
2569 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2570
2571
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2572 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
2573 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2574
2575
2576 <tr class="entry" id="static_android.control.aeAvailableModes">
Eino-Ville Talvala9fa0d902014-01-08 16:16:53 -0800[diff] [blame]2577 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2578 android.<wbr/>control.<wbr/>ae<wbr/>Available<wbr/>Modes
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2579 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2580 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]2581 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2582 <span class="entry_type_container">x</span>
2583
2584 <span class="entry_type_array">
2585 n
2586 </span>
Eino-Ville Talvala9fa0d902014-01-08 16:16:53 -0800[diff] [blame]2587 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2588 <div class="entry_type_notes">list of enums</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2589
2590
2591 </td> <!-- entry_type -->
2592
2593 <td class="entry_description">
Eino-Ville Talvala9fa0d902014-01-08 16:16:53 -0800[diff] [blame]2594 <p>The set of auto-exposure modes that are supported by this
2595camera device.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2596 </td>
2597
2598 <td class="entry_units">
2599 </td>
2600
2601 <td class="entry_range">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2602 </td>
2603
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2604 <td class="entry_tags">
Eino-Ville Talvala9fa0d902014-01-08 16:16:53 -0800[diff] [blame]2605 <ul class="entry_tags">
2606 <li><a href="#tag_BC">BC</a></li>
2607 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2608 </td>
2609
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2610 </tr>
Eino-Ville Talvala9fa0d902014-01-08 16:16:53 -0800[diff] [blame]2611 <tr class="entries_header">
2612 <th class="th_details" colspan="5">Details</th>
2613 </tr>
2614 <tr class="entry_cont">
2615 <td class="entry_details" colspan="5">
2616 <p>Not all the auto-exposure modes may be supported by a
2617given camera device,<wbr/> especially if no flash unit is
2618available.<wbr/> This entry lists the valid modes for
2619<a href="#controls_android.control.aeMode">android.<wbr/>control.<wbr/>ae<wbr/>Mode</a> for this camera device.<wbr/></p>
2620<p>All camera devices support ON,<wbr/> and all camera devices with
2621flash units support ON_<wbr/>AUTO_<wbr/>FLASH and
2622ON_<wbr/>ALWAYS_<wbr/>FLASH.<wbr/></p>
2623<p>Full-capability camera devices always support OFF mode,<wbr/>
2624which enables application control of camera exposure time,<wbr/>
2625sensitivity,<wbr/> and frame duration.<wbr/></p>
2626 </td>
2627 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2628
2629
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2630 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
2631 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2632
2633
2634 <tr class="entry" id="static_android.control.aeAvailableTargetFpsRanges">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2635 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2636 android.<wbr/>control.<wbr/>ae<wbr/>Available<wbr/>Target<wbr/>Fps<wbr/>Ranges
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2637 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2638 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]2639 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2640 <span class="entry_type_container">x</span>
2641
2642 <span class="entry_type_array">
2643 2 x n
2644 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2645 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2646 <div class="entry_type_notes">list of pairs of frame rates</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2647
2648
2649 </td> <!-- entry_type -->
2650
2651 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2652 <p>List of frame rate ranges supported by the
2653AE algorithm/<wbr/>hardware</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2654 </td>
2655
2656 <td class="entry_units">
2657 </td>
2658
2659 <td class="entry_range">
2660 </td>
2661
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2662 <td class="entry_tags">
2663 </td>
2664
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2665 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2666
2667
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2668 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
2669 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2670
2671
2672 <tr class="entry" id="static_android.control.aeCompensationRange">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2673 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2674 android.<wbr/>control.<wbr/>ae<wbr/>Compensation<wbr/>Range
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2675 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2676 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]2677 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2678 <span class="entry_type_container">x</span>
2679
2680 <span class="entry_type_array">
2681 2
2682 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2683 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2684
2685
2686 </td> <!-- entry_type -->
2687
2688 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2689 <p>Maximum and minimum exposure compensation
2690setting,<wbr/> in counts of
2691android.<wbr/>control.<wbr/>ae<wbr/>Compensation<wbr/>Step<wbr/>Size</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2692 </td>
2693
2694 <td class="entry_units">
2695 </td>
2696
2697 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]2698 <p>At least (-2,<wbr/>2)/<wbr/>(exp compensation step
2699size)</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2700 </td>
2701
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2702 <td class="entry_tags">
2703 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]2704 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2705 </ul>
2706 </td>
2707
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2708 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2709
2710
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2711 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
2712 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2713
2714
2715 <tr class="entry" id="static_android.control.aeCompensationStep">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2716 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2717 android.<wbr/>control.<wbr/>ae<wbr/>Compensation<wbr/>Step
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2718 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2719 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]2720 <span class="entry_type_name">rational</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2721
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2722 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2723
2724
2725 </td> <!-- entry_type -->
2726
2727 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2728 <p>Smallest step by which exposure compensation
2729can be changed</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2730 </td>
2731
2732 <td class="entry_units">
2733 </td>
2734
2735 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]2736 <p>&lt;= 1/<wbr/>2</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2737 </td>
2738
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2739 <td class="entry_tags">
2740 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]2741 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2742 </ul>
2743 </td>
2744
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2745 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2746
2747
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2748 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
2749 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2750
2751
2752 <tr class="entry" id="static_android.control.afAvailableModes">
Zhijun Hef163fa92014-01-14 09:59:04 -0800[diff] [blame]2753 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2754 android.<wbr/>control.<wbr/>af<wbr/>Available<wbr/>Modes
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2755 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2756 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]2757 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2758 <span class="entry_type_container">x</span>
2759
2760 <span class="entry_type_array">
2761 n
2762 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2763 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2764 <div class="entry_type_notes">List of enums</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2765
2766
2767 </td> <!-- entry_type -->
2768
2769 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2770 <p>List of AF modes that can be
Zhijun Hef163fa92014-01-14 09:59:04 -0800[diff] [blame]2771selected 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]2772 </td>
2773
2774 <td class="entry_units">
2775 </td>
2776
2777 <td class="entry_range">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2778 </td>
2779
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2780 <td class="entry_tags">
2781 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]2782 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2783 </ul>
2784 </td>
2785
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2786 </tr>
Zhijun Hef163fa92014-01-14 09:59:04 -0800[diff] [blame]2787 <tr class="entries_header">
2788 <th class="th_details" colspan="5">Details</th>
2789 </tr>
2790 <tr class="entry_cont">
2791 <td class="entry_details" colspan="5">
2792 <p>Not all the auto-focus modes may be supported by a
2793given camera device.<wbr/> This entry lists the valid modes for
2794<a href="#controls_android.control.afMode">android.<wbr/>control.<wbr/>af<wbr/>Mode</a> for this camera device.<wbr/></p>
2795<p>All camera devices will support OFF mode,<wbr/> and all camera devices with
2796adjustable 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>)
2797will support AUTO mode.<wbr/></p>
2798 </td>
2799 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2800
2801
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2802 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
2803 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2804
2805
2806 <tr class="entry" id="static_android.control.availableEffects">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2807 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2808 android.<wbr/>control.<wbr/>available<wbr/>Effects
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2809 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2810 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]2811 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2812 <span class="entry_type_container">x</span>
2813
2814 <span class="entry_type_array">
2815 n
2816 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2817 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2818 <div class="entry_type_notes">list of enums</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2819
2820
2821 </td> <!-- entry_type -->
2822
2823 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2824 <p>what subset of the full color effect enum
2825list is supported</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2826 </td>
2827
2828 <td class="entry_units">
2829 </td>
2830
2831 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]2832 <p>OFF must be listed</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2833 </td>
2834
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2835 <td class="entry_tags">
2836 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]2837 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2838 </ul>
2839 </td>
2840
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2841 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2842
2843
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2844 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
2845 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2846
2847
2848 <tr class="entry" id="static_android.control.availableSceneModes">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2849 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2850 android.<wbr/>control.<wbr/>available<wbr/>Scene<wbr/>Modes
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2851 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2852 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]2853 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2854 <span class="entry_type_container">x</span>
2855
2856 <span class="entry_type_array">
2857 n
2858 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2859 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2860 <div class="entry_type_notes">list of enums from android.<wbr/>control.<wbr/>scene<wbr/>Mode,<wbr/> plus UNSUPPORTED to indicate no scene modes are supported</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2861
2862
2863 </td> <!-- entry_type -->
2864
2865 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2866 <p>what subset of the scene mode enum list is
2867supported.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2868 </td>
2869
2870 <td class="entry_units">
2871 </td>
2872
2873 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]2874 <p>SCENE_<wbr/>MODE_<wbr/>FACE_<wbr/>PRIORITY must be supported if face
2875detection is supported</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2876 </td>
2877
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2878 <td class="entry_tags">
2879 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]2880 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2881 </ul>
2882 </td>
2883
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2884 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2885
2886
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2887 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
2888 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2889
2890
2891 <tr class="entry" id="static_android.control.availableVideoStabilizationModes">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2892 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2893 android.<wbr/>control.<wbr/>available<wbr/>Video<wbr/>Stabilization<wbr/>Modes
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2894 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2895 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]2896 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2897 <span class="entry_type_container">x</span>
2898
2899 <span class="entry_type_array">
2900 n
2901 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2902 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2903 <div class="entry_type_notes">List of enums.<wbr/></div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2904
2905
2906 </td> <!-- entry_type -->
2907
2908 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2909 <p>List of video stabilization modes that can
2910be supported</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2911 </td>
2912
2913 <td class="entry_units">
2914 </td>
2915
2916 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]2917 <p>OFF must be included</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2918 </td>
2919
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2920 <td class="entry_tags">
2921 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]2922 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2923 </ul>
2924 </td>
2925
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2926 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2927
2928
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2929 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
2930 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2931
2932
2933 <tr class="entry" id="static_android.control.awbAvailableModes">
Zhijun He7787f7f2014-01-14 16:30:31 -0800[diff] [blame]2934 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2935 android.<wbr/>control.<wbr/>awb<wbr/>Available<wbr/>Modes
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2936 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2937 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]2938 <span class="entry_type_name">byte</span>
Alex Raya4251d92013-04-30 16:43:44 -0700[diff] [blame]2939 <span class="entry_type_container">x</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2940
Alex Raya4251d92013-04-30 16:43:44 -0700[diff] [blame]2941 <span class="entry_type_array">
2942 n
2943 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2944 <span class="entry_type_visibility"> [public]</span>
Zhijun He7787f7f2014-01-14 16:30:31 -0800[diff] [blame]2945 <div class="entry_type_notes">List of enums</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2946
2947
2948 </td> <!-- entry_type -->
2949
2950 <td class="entry_description">
Zhijun He7787f7f2014-01-14 16:30:31 -0800[diff] [blame]2951 <p>The set of auto-white-balance modes (<a href="#controls_android.control.awbMode">android.<wbr/>control.<wbr/>awb<wbr/>Mode</a>)
2952that are supported by this camera device.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2953 </td>
2954
2955 <td class="entry_units">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2956 </td>
2957
2958 <td class="entry_range">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2959 </td>
2960
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2961 <td class="entry_tags">
2962 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]2963 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2964 </ul>
2965 </td>
2966
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2967 </tr>
Zhijun He7787f7f2014-01-14 16:30:31 -0800[diff] [blame]2968 <tr class="entries_header">
2969 <th class="th_details" colspan="5">Details</th>
2970 </tr>
2971 <tr class="entry_cont">
2972 <td class="entry_details" colspan="5">
2973 <p>Not all the auto-white-balance modes may be supported by a
2974given camera device.<wbr/> This entry lists the valid modes for
2975<a href="#controls_android.control.awbMode">android.<wbr/>control.<wbr/>awb<wbr/>Mode</a> for this camera device.<wbr/></p>
2976<p>All camera devices will support ON mode.<wbr/></p>
2977<p>Full-capability camera devices will always support OFF mode,<wbr/>
2978which enables application control of white balance,<wbr/> by using
2979<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>
2980 </td>
2981 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2982
2983
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2984 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
2985 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2986
2987
2988 <tr class="entry" id="static_android.control.maxRegions">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2989 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2990 android.<wbr/>control.<wbr/>max<wbr/>Regions
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2991 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2992 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]2993 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2994
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2995 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2996
2997
2998 </td> <!-- entry_type -->
2999
3000 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3001 <p>For AE,<wbr/> AWB,<wbr/> and AF,<wbr/> how many individual
3002regions can be listed for metering?</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3003 </td>
3004
3005 <td class="entry_units">
3006 </td>
3007
3008 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame]3009 <p>&gt;= 1</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3010 </td>
3011
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3012 <td class="entry_tags">
3013 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]3014 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3015 </ul>
3016 </td>
3017
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3018 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3019
3020
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3021 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
3022 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3023
3024
3025 <tr class="entry" id="static_android.control.sceneModeOverrides">
Ruben Brunkcf77fe92014-01-14 19:31:21 -0800[diff] [blame^]3026 <td class="entry_name" rowspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3027 android.<wbr/>control.<wbr/>scene<wbr/>Mode<wbr/>Overrides
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3028 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3029 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]3030 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3031 <span class="entry_type_container">x</span>
3032
3033 <span class="entry_type_array">
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3034 3 x length(availableSceneModes)
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3035 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3036 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3037
3038
3039 </td> <!-- entry_type -->
3040
3041 <td class="entry_description">
Ruben Brunkcf77fe92014-01-14 19:31:21 -0800[diff] [blame^]3042 <p>Ordered list of auto-exposure,<wbr/> auto-white balance,<wbr/> and auto-focus
3043settings to use with each available scene mode.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3044 </td>
3045
3046 <td class="entry_units">
3047 </td>
3048
3049 <td class="entry_range">
Ruben Brunkcf77fe92014-01-14 19:31:21 -0800[diff] [blame^]3050 <p>For each available scene mode,<wbr/> the list must contain three
3051entries containing the <a href="#controls_android.control.aeMode">android.<wbr/>control.<wbr/>ae<wbr/>Mode</a>,<wbr/>
3052<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
3053by the camera device.<wbr/> The entry order is <code>(aeMode,<wbr/> awbMode,<wbr/> afMode)</code>
3054where aeMode has the lowest index position.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3055 </td>
3056
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3057 <td class="entry_tags">
3058 <ul class="entry_tags">
3059 <li><a href="#tag_BC">BC</a></li>
3060 </ul>
3061 </td>
3062
3063 </tr>
3064 <tr class="entries_header">
3065 <th class="th_details" colspan="5">Details</th>
3066 </tr>
3067 <tr class="entry_cont">
3068 <td class="entry_details" colspan="5">
Ruben Brunkcf77fe92014-01-14 19:31:21 -0800[diff] [blame^]3069 <p>When a scene mode is enabled,<wbr/> the camera device is expected
3070to 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/>
3071and <a href="#controls_android.control.afMode">android.<wbr/>control.<wbr/>af<wbr/>Mode</a> with its preferred settings for
3072that scene mode.<wbr/></p>
3073<p>The order of this list matches that of availableSceneModes,<wbr/>
3074with 3 entries for each mode.<wbr/> The overrides listed
3075for FACE_<wbr/>PRIORITY are ignored,<wbr/> since for that
3076mode the application-set <a href="#controls_android.control.aeMode">android.<wbr/>control.<wbr/>ae<wbr/>Mode</a>,<wbr/>
3077<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
3078used instead,<wbr/> matching the behavior when android.<wbr/>control.<wbr/>mode
3079is set to AUTO.<wbr/> It is recommended that the FACE_<wbr/>PRIORITY
3080overrides should be set to 0.<wbr/></p>
3081<p>For example,<wbr/> if availableSceneModes contains
3082<code>(FACE_<wbr/>PRIORITY,<wbr/> ACTION,<wbr/> NIGHT)</code>,<wbr/> then the camera framework
3083expects sceneModeOverrides to have 9 entries formatted like:
3084<code>(0,<wbr/> 0,<wbr/> 0,<wbr/> ON_<wbr/>AUTO_<wbr/>FLASH,<wbr/> AUTO,<wbr/> CONTINUOUS_<wbr/>PICTURE,<wbr/>
3085ON_<wbr/>AUTO_<wbr/>FLASH,<wbr/> INCANDESCENT,<wbr/> AUTO)</code>.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3086 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3087 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3088
Ruben Brunkcf77fe92014-01-14 19:31:21 -0800[diff] [blame^]3089 <tr class="entries_header">
3090 <th class="th_details" colspan="5">HAL Implementation Details</th>
3091 </tr>
3092 <tr class="entry_cont">
3093 <td class="entry_details" colspan="5">
3094 <p>To maintain backward compatibility,<wbr/> this list will be made available
3095in the static metadata of the camera service.<wbr/> The camera service will
3096use these values to set <a href="#controls_android.control.aeMode">android.<wbr/>control.<wbr/>ae<wbr/>Mode</a>,<wbr/>
3097<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
3098mode other than FACE_<wbr/>PRIORITY.<wbr/></p>
3099 </td>
3100 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3101
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3102 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
3103 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3104
3105
3106
3107 <!-- end of kind -->
3108 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3109 <tr><td colspan="6" class="kind">dynamic</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3110
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3111 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3112 <tr>
3113 <th class="th_name">Property Name</th>
3114 <th class="th_type">Type</th>
3115 <th class="th_description">Description</th>
3116 <th class="th_units">Units</th>
3117 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3118 <th class="th_tags">Tags</th>
3119 </tr>
3120 </thead>
3121
3122 <tbody>
3123
3124
3125
3126
3127
3128
3129
3130
3131
3132
3133 <tr class="entry" id="dynamic_android.control.aePrecaptureId">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3134 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3135 android.<wbr/>control.<wbr/>ae<wbr/>Precapture<wbr/>Id
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3136 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3137 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]3138 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3139
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3140 <span class="entry_type_visibility"> [hidden]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3141
3142
3143 </td> <!-- entry_type -->
3144
3145 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3146 <p>The ID sent with the latest
3147CAMERA2_<wbr/>TRIGGER_<wbr/>PRECAPTURE_<wbr/>METERING call</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3148 </td>
3149
3150 <td class="entry_units">
3151 </td>
3152
3153 <td class="entry_range">
3154 </td>
3155
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3156 <td class="entry_tags">
3157 </td>
3158
3159 </tr>
3160 <tr class="entries_header">
3161 <th class="th_details" colspan="5">Details</th>
3162 </tr>
3163 <tr class="entry_cont">
3164 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3165 <p>Must be 0 if no
3166CAMERA2_<wbr/>TRIGGER_<wbr/>PRECAPTURE_<wbr/>METERING trigger received yet
3167by HAL.<wbr/> Always updated even if AE algorithm ignores the
3168trigger</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3169 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3170 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3171
3172
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3173 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
3174 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3175
3176
Eino-Ville Talvala9fa0d902014-01-08 16:16:53 -0800[diff] [blame]3177 <tr class="entry" id="dynamic_android.control.aeMode">
3178 <td class="entry_name" rowspan="3">
3179 android.<wbr/>control.<wbr/>ae<wbr/>Mode
3180 </td>
3181 <td class="entry_type">
3182 <span class="entry_type_name entry_type_name_enum">byte</span>
3183
3184 <span class="entry_type_visibility"> [public]</span>
3185
3186 <ul class="entry_type_enum">
3187 <li>
3188 <span class="entry_type_enum_name">OFF</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]3189 <span class="entry_type_enum_notes"><p>The camera device's autoexposure routine is disabled;
3190the application-selected <a href="#controls_android.sensor.exposureTime">android.<wbr/>sensor.<wbr/>exposure<wbr/>Time</a>,<wbr/>
3191<a href="#controls_android.sensor.sensitivity">android.<wbr/>sensor.<wbr/>sensitivity</a> and
3192<a href="#controls_android.sensor.frameDuration">android.<wbr/>sensor.<wbr/>frame<wbr/>Duration</a> are used by the camera
3193device,<wbr/> along with android.<wbr/>flash.<wbr/>* fields,<wbr/> if there's
3194a flash unit for this camera device.<wbr/></p></span>
Eino-Ville Talvala9fa0d902014-01-08 16:16:53 -0800[diff] [blame]3195 </li>
3196 <li>
3197 <span class="entry_type_enum_name">ON</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]3198 <span class="entry_type_enum_notes"><p>The camera device's autoexposure routine is active,<wbr/>
3199with no flash control.<wbr/> The application's values for
3200<a href="#controls_android.sensor.exposureTime">android.<wbr/>sensor.<wbr/>exposure<wbr/>Time</a>,<wbr/>
3201<a href="#controls_android.sensor.sensitivity">android.<wbr/>sensor.<wbr/>sensitivity</a>,<wbr/> and
3202<a href="#controls_android.sensor.frameDuration">android.<wbr/>sensor.<wbr/>frame<wbr/>Duration</a> are ignored.<wbr/> The
3203application has control over the various
3204android.<wbr/>flash.<wbr/>* fields.<wbr/></p></span>
Eino-Ville Talvala9fa0d902014-01-08 16:16:53 -0800[diff] [blame]3205 </li>
3206 <li>
3207 <span class="entry_type_enum_name">ON_AUTO_FLASH</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]3208 <span class="entry_type_enum_notes"><p>Like ON,<wbr/> except that the camera device also controls
3209the camera's flash unit,<wbr/> firing it in low-light
3210conditions.<wbr/> The flash may be fired during a
3211precapture sequence (triggered by
3212<a href="#controls_android.control.aePrecaptureTrigger">android.<wbr/>control.<wbr/>ae<wbr/>Precapture<wbr/>Trigger</a>) and may be fired
3213for captures for which the
3214<a href="#controls_android.control.captureIntent">android.<wbr/>control.<wbr/>capture<wbr/>Intent</a> field is set to
3215STILL_<wbr/>CAPTURE</p></span>
Eino-Ville Talvala9fa0d902014-01-08 16:16:53 -0800[diff] [blame]3216 </li>
3217 <li>
3218 <span class="entry_type_enum_name">ON_ALWAYS_FLASH</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]3219 <span class="entry_type_enum_notes"><p>Like ON,<wbr/> except that the camera device also controls
3220the camera's flash unit,<wbr/> always firing it for still
3221captures.<wbr/> The flash may be fired during a precapture
3222sequence (triggered by
3223<a href="#controls_android.control.aePrecaptureTrigger">android.<wbr/>control.<wbr/>ae<wbr/>Precapture<wbr/>Trigger</a>) and will always
3224be fired for captures for which the
3225<a href="#controls_android.control.captureIntent">android.<wbr/>control.<wbr/>capture<wbr/>Intent</a> field is set to
3226STILL_<wbr/>CAPTURE</p></span>
Eino-Ville Talvala9fa0d902014-01-08 16:16:53 -0800[diff] [blame]3227 </li>
3228 <li>
3229 <span class="entry_type_enum_name">ON_AUTO_FLASH_REDEYE</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]3230 <span class="entry_type_enum_notes"><p>Like ON_<wbr/>AUTO_<wbr/>FLASH,<wbr/> but with automatic red eye
3231reduction.<wbr/> If deemed necessary by the camera device,<wbr/>
3232a red eye reduction flash will fire during the
3233precapture sequence.<wbr/></p></span>
Eino-Ville Talvala9fa0d902014-01-08 16:16:53 -0800[diff] [blame]3234 </li>
3235 </ul>
3236
3237 </td> <!-- entry_type -->
3238
3239 <td class="entry_description">
3240 <p>The desired mode for the camera device's
3241auto-exposure routine.<wbr/></p>
3242 </td>
3243
3244 <td class="entry_units">
3245 </td>
3246
3247 <td class="entry_range">
3248 <p><a href="#static_android.control.aeAvailableModes">android.<wbr/>control.<wbr/>ae<wbr/>Available<wbr/>Modes</a></p>
3249 </td>
3250
3251 <td class="entry_tags">
3252 <ul class="entry_tags">
3253 <li><a href="#tag_BC">BC</a></li>
3254 </ul>
3255 </td>
3256
3257 </tr>
3258 <tr class="entries_header">
3259 <th class="th_details" colspan="5">Details</th>
3260 </tr>
3261 <tr class="entry_cont">
3262 <td class="entry_details" colspan="5">
3263 <p>This control is only effective if <a href="#controls_android.control.mode">android.<wbr/>control.<wbr/>mode</a> is
3264AUTO.<wbr/></p>
3265<p>When set to any of the ON modes,<wbr/> the camera device's
3266auto-exposure routine is enabled,<wbr/> overriding the
3267application's selected exposure time,<wbr/> sensor sensitivity,<wbr/>
3268and frame duration (<a href="#controls_android.sensor.exposureTime">android.<wbr/>sensor.<wbr/>exposure<wbr/>Time</a>,<wbr/>
3269<a href="#controls_android.sensor.sensitivity">android.<wbr/>sensor.<wbr/>sensitivity</a>,<wbr/> and
3270<a href="#controls_android.sensor.frameDuration">android.<wbr/>sensor.<wbr/>frame<wbr/>Duration</a>).<wbr/> If one of the FLASH modes
3271is selected,<wbr/> the camera device's flash unit controls are
3272also overridden.<wbr/></p>
3273<p>The FLASH modes are only available if the camera device
3274has a flash unit (<a href="#static_android.flash.info.available">android.<wbr/>flash.<wbr/>info.<wbr/>available</a> is <code>true</code>).<wbr/></p>
3275<p>If flash TORCH mode is desired,<wbr/> this field must be set to
3276ON or OFF,<wbr/> and <a href="#controls_android.flash.mode">android.<wbr/>flash.<wbr/>mode</a> set to TORCH.<wbr/></p>
3277<p>When set to any of the ON modes,<wbr/> the values chosen by the
3278camera device auto-exposure routine for the overridden
3279fields for a given capture will be available in its
3280CaptureResult.<wbr/></p>
3281 </td>
3282 </tr>
3283
3284
3285 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
3286 <!-- end of entry -->
3287
3288
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3289 <tr class="entry" id="dynamic_android.control.aeRegions">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3290 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3291 android.<wbr/>control.<wbr/>ae<wbr/>Regions
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3292 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3293 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]3294 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3295 <span class="entry_type_container">x</span>
3296
3297 <span class="entry_type_array">
3298 5 x area_count
3299 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3300 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3301
3302
3303 </td> <!-- entry_type -->
3304
3305 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3306 <p>List of areas to use for
3307metering</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3308 </td>
3309
3310 <td class="entry_units">
3311 </td>
3312
3313 <td class="entry_range">
3314 </td>
3315
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3316 <td class="entry_tags">
3317 <ul class="entry_tags">
3318 <li><a href="#tag_BC">BC</a></li>
3319 </ul>
3320 </td>
3321
3322 </tr>
3323 <tr class="entries_header">
3324 <th class="th_details" colspan="5">Details</th>
3325 </tr>
3326 <tr class="entry_cont">
3327 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3328 <p>Each area is a rectangle plus weight: xmin,<wbr/> ymin,<wbr/>
3329xmax,<wbr/> ymax,<wbr/> weight.<wbr/> The rectangle is defined inclusive of the
3330specified coordinates.<wbr/></p>
3331<p>The coordinate system is based on the active pixel array,<wbr/>
3332with (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]3333(<a href="#static_android.sensor.info.activeArraySize">android.<wbr/>sensor.<wbr/>info.<wbr/>active<wbr/>Array<wbr/>Size</a>.<wbr/>width - 1,<wbr/>
3334<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]3335bottom-right pixel in the active pixel array.<wbr/> The weight
3336should be nonnegative.<wbr/></p>
3337<p>If all regions have 0 weight,<wbr/> then no specific metering area
3338needs to be used by the HAL.<wbr/> If the metering region is
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]3339outside 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]3340should ignore the sections outside the region and output the
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3341used sections in the frame metadata</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3342 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3343 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3344
3345
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3346 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
3347 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3348
3349
3350 <tr class="entry" id="dynamic_android.control.aeState">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3351 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3352 android.<wbr/>control.<wbr/>ae<wbr/>State
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3353 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3354 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]3355 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3356
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3357 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3358
3359 <ul class="entry_type_enum">
3360 <li>
3361 <span class="entry_type_enum_name">INACTIVE</span>
Zhijun He92e698d2014-01-13 16:24:31 -0800[diff] [blame]3362 <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]3363this state.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3364 </li>
3365 <li>
3366 <span class="entry_type_enum_name">SEARCHING</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]3367 <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]3368for the current scene.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3369 </li>
3370 <li>
3371 <span class="entry_type_enum_name">CONVERGED</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]3372 <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]3373current scene.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3374 </li>
3375 <li>
3376 <span class="entry_type_enum_name">LOCKED</span>
Zhijun He92e698d2014-01-13 16:24:31 -0800[diff] [blame]3377 <span class="entry_type_enum_notes"><p>AE has been locked.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3378 </li>
3379 <li>
3380 <span class="entry_type_enum_name">FLASH_REQUIRED</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]3381 <span class="entry_type_enum_notes"><p>AE has a good set of control values,<wbr/> but flash
3382needs to be fired for good quality still
Zhijun He92e698d2014-01-13 16:24:31 -0800[diff] [blame]3383capture.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3384 </li>
3385 <li>
3386 <span class="entry_type_enum_name">PRECAPTURE</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]3387 <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]3388(through the <a href="#controls_android.control.aePrecaptureTrigger">android.<wbr/>control.<wbr/>ae<wbr/>Precapture<wbr/>Trigger</a> START),<wbr/>
3389and is currently executing it.<wbr/> Once PRECAPTURE
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]3390completes,<wbr/> AE will transition to CONVERGED or
Zhijun He92e698d2014-01-13 16:24:31 -0800[diff] [blame]3391FLASH_<wbr/>REQUIRED as appropriate.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3392 </li>
3393 </ul>
3394
3395 </td> <!-- entry_type -->
3396
3397 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3398 <p>Current state of AE algorithm</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3399 </td>
3400
3401 <td class="entry_units">
3402 </td>
3403
3404 <td class="entry_range">
3405 </td>
3406
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3407 <td class="entry_tags">
3408 </td>
3409
3410 </tr>
3411 <tr class="entries_header">
3412 <th class="th_details" colspan="5">Details</th>
3413 </tr>
3414 <tr class="entry_cont">
3415 <td class="entry_details" colspan="5">
Zhijun He92e698d2014-01-13 16:24:31 -0800[diff] [blame]3416 <p>Switching between or enabling AE modes (<a href="#controls_android.control.aeMode">android.<wbr/>control.<wbr/>ae<wbr/>Mode</a>) always
3417resets the AE state to INACTIVE.<wbr/> Similarly,<wbr/> switching between <a href="#controls_android.control.mode">android.<wbr/>control.<wbr/>mode</a>,<wbr/>
3418or <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
3419the algorithm states to INACTIVE.<wbr/></p>
3420<p>The camera device can do several state transitions between two results,<wbr/> if it is
3421allowed by the state transition table.<wbr/> For example: INACTIVE may never actually be
3422seen in a result.<wbr/></p>
3423<p>The state in the result is the state for this image (in sync with this image): if
3424AE state becomes CONVERGED,<wbr/> then the image data associated with this result should
3425be good to use.<wbr/></p>
3426<p>Below are state transition tables for different AE modes.<wbr/></p>
3427<table>
3428<thead>
3429<tr>
3430<th align="center">State</th>
3431<th align="center">Transition Cause</th>
3432<th align="center">New State</th>
3433<th align="center">Notes</th>
3434</tr>
3435</thead>
3436<tbody>
3437<tr>
3438<td align="center">INACTIVE</td>
3439<td align="center"></td>
3440<td align="center">INACTIVE</td>
3441<td align="center">Camera device auto exposure algorithm is disabled</td>
3442</tr>
3443</tbody>
3444</table>
3445<p>When <a href="#controls_android.control.aeMode">android.<wbr/>control.<wbr/>ae<wbr/>Mode</a> is AE_<wbr/>MODE_<wbr/>ON_<wbr/>*:</p>
3446<table>
3447<thead>
3448<tr>
3449<th align="center">State</th>
3450<th align="center">Transition Cause</th>
3451<th align="center">New State</th>
3452<th align="center">Notes</th>
3453</tr>
3454</thead>
3455<tbody>
3456<tr>
3457<td align="center">INACTIVE</td>
3458<td align="center">Camera device initiates AE scan</td>
3459<td align="center">SEARCHING</td>
3460<td align="center">Values changing</td>
3461</tr>
3462<tr>
3463<td align="center">INACTIVE</td>
3464<td align="center"><a href="#controls_android.control.aeLock">android.<wbr/>control.<wbr/>ae<wbr/>Lock</a> is ON</td>
3465<td align="center">LOCKED</td>
3466<td align="center">Values locked</td>
3467</tr>
3468<tr>
3469<td align="center">SEARCHING</td>
3470<td align="center">Camera device finishes AE scan</td>
3471<td align="center">CONVERGED</td>
3472<td align="center">Good values,<wbr/> not changing</td>
3473</tr>
3474<tr>
3475<td align="center">SEARCHING</td>
3476<td align="center">Camera device finishes AE scan</td>
3477<td align="center">FLASH_<wbr/>REQUIRED</td>
3478<td align="center">Converged but too dark w/<wbr/>o flash</td>
3479</tr>
3480<tr>
3481<td align="center">SEARCHING</td>
3482<td align="center"><a href="#controls_android.control.aeLock">android.<wbr/>control.<wbr/>ae<wbr/>Lock</a> is ON</td>
3483<td align="center">LOCKED</td>
3484<td align="center">Values locked</td>
3485</tr>
3486<tr>
3487<td align="center">CONVERGED</td>
3488<td align="center">Camera device initiates AE scan</td>
3489<td align="center">SEARCHING</td>
3490<td align="center">Values changing</td>
3491</tr>
3492<tr>
3493<td align="center">CONVERGED</td>
3494<td align="center"><a href="#controls_android.control.aeLock">android.<wbr/>control.<wbr/>ae<wbr/>Lock</a> is ON</td>
3495<td align="center">LOCKED</td>
3496<td align="center">Values locked</td>
3497</tr>
3498<tr>
3499<td align="center">FLASH_<wbr/>REQUIRED</td>
3500<td align="center">Camera device initiates AE scan</td>
3501<td align="center">SEARCHING</td>
3502<td align="center">Values changing</td>
3503</tr>
3504<tr>
3505<td align="center">FLASH_<wbr/>REQUIRED</td>
3506<td align="center"><a href="#controls_android.control.aeLock">android.<wbr/>control.<wbr/>ae<wbr/>Lock</a> is ON</td>
3507<td align="center">LOCKED</td>
3508<td align="center">Values locked</td>
3509</tr>
3510<tr>
3511<td align="center">LOCKED</td>
3512<td align="center"><a href="#controls_android.control.aeLock">android.<wbr/>control.<wbr/>ae<wbr/>Lock</a> is OFF</td>
3513<td align="center">SEARCHING</td>
3514<td align="center">Values not good after unlock</td>
3515</tr>
3516<tr>
3517<td align="center">LOCKED</td>
3518<td align="center"><a href="#controls_android.control.aeLock">android.<wbr/>control.<wbr/>ae<wbr/>Lock</a> is OFF</td>
3519<td align="center">CONVERGED</td>
3520<td align="center">Values good after unlock</td>
3521</tr>
3522<tr>
3523<td align="center">LOCKED</td>
3524<td align="center"><a href="#controls_android.control.aeLock">android.<wbr/>control.<wbr/>ae<wbr/>Lock</a> is OFF</td>
3525<td align="center">FLASH_<wbr/>REQUIRED</td>
3526<td align="center">Exposure good,<wbr/> but too dark</td>
3527</tr>
3528<tr>
3529<td align="center">PRECAPTURE</td>
3530<td align="center">Sequence done.<wbr/> <a href="#controls_android.control.aeLock">android.<wbr/>control.<wbr/>ae<wbr/>Lock</a> is OFF</td>
3531<td align="center">CONVERGED</td>
3532<td align="center">Ready for high-quality capture</td>
3533</tr>
3534<tr>
3535<td align="center">PRECAPTURE</td>
3536<td align="center">Sequence done.<wbr/> <a href="#controls_android.control.aeLock">android.<wbr/>control.<wbr/>ae<wbr/>Lock</a> is ON</td>
3537<td align="center">LOCKED</td>
3538<td align="center">Ready for high-quality capture</td>
3539</tr>
3540<tr>
3541<td align="center">Any state</td>
3542<td align="center"><a href="#controls_android.control.aePrecaptureTrigger">android.<wbr/>control.<wbr/>ae<wbr/>Precapture<wbr/>Trigger</a> is START</td>
3543<td align="center">PRECAPTURE</td>
3544<td align="center">Start AE precapture metering sequence</td>
3545</tr>
3546</tbody>
3547</table>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3548 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3549 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3550
3551
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3552 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
3553 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3554
3555
3556 <tr class="entry" id="dynamic_android.control.afMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3557 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3558 android.<wbr/>control.<wbr/>af<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3559 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3560 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]3561 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3562
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3563 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3564
3565 <ul class="entry_type_enum">
3566 <li>
3567 <span class="entry_type_enum_name">OFF</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]3568 <span class="entry_type_enum_notes"><p>The auto-focus routine does not control the lens;
3569<a href="#controls_android.lens.focusDistance">android.<wbr/>lens.<wbr/>focus<wbr/>Distance</a> is controlled by the
3570application</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3571 </li>
3572 <li>
3573 <span class="entry_type_enum_name">AUTO</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]3574 <span class="entry_type_enum_notes"><p>If lens is not fixed focus.<wbr/></p>
3575<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
3576is fixed-focus.<wbr/> In this mode,<wbr/> the lens does not move unless
3577the autofocus trigger action is called.<wbr/> When that trigger
3578is activated,<wbr/> AF must transition to ACTIVE_<wbr/>SCAN,<wbr/> then to
3579the outcome of the scan (FOCUSED or NOT_<wbr/>FOCUSED).<wbr/></p>
3580<p>Triggering AF_<wbr/>CANCEL resets the lens position to default,<wbr/>
3581and sets the AF state to INACTIVE.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3582 </li>
3583 <li>
3584 <span class="entry_type_enum_name">MACRO</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]3585 <span class="entry_type_enum_notes"><p>In this mode,<wbr/> the lens does not move unless the
3586autofocus trigger action is called.<wbr/></p>
3587<p>When that trigger is activated,<wbr/> AF must transition to
3588ACTIVE_<wbr/>SCAN,<wbr/> then to the outcome of the scan (FOCUSED or
3589NOT_<wbr/>FOCUSED).<wbr/> Triggering cancel AF resets the lens
3590position to default,<wbr/> and sets the AF state to
3591INACTIVE.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3592 </li>
3593 <li>
3594 <span class="entry_type_enum_name">CONTINUOUS_VIDEO</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]3595 <span class="entry_type_enum_notes"><p>In this mode,<wbr/> the AF algorithm modifies the lens
3596position continually to attempt to provide a
3597constantly-in-focus image stream.<wbr/></p>
3598<p>The focusing behavior should be suitable for good quality
3599video recording; typically this means slower focus
3600movement and no overshoots.<wbr/> When the AF trigger is not
3601involved,<wbr/> the AF algorithm should start in INACTIVE state,<wbr/>
3602and then transition into PASSIVE_<wbr/>SCAN and PASSIVE_<wbr/>FOCUSED
3603states as appropriate.<wbr/> When the AF trigger is activated,<wbr/>
3604the algorithm should immediately transition into
3605AF_<wbr/>FOCUSED or AF_<wbr/>NOT_<wbr/>FOCUSED as appropriate,<wbr/> and lock the
3606lens position until a cancel AF trigger is received.<wbr/></p>
3607<p>Once cancel is received,<wbr/> the algorithm should transition
3608back to INACTIVE and resume passive scan.<wbr/> Note that this
3609behavior is not identical to CONTINUOUS_<wbr/>PICTURE,<wbr/> since an
3610ongoing PASSIVE_<wbr/>SCAN must immediately be
3611canceled.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3612 </li>
3613 <li>
3614 <span class="entry_type_enum_name">CONTINUOUS_PICTURE</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]3615 <span class="entry_type_enum_notes"><p>In this mode,<wbr/> the AF algorithm modifies the lens
3616position continually to attempt to provide a
3617constantly-in-focus image stream.<wbr/></p>
3618<p>The focusing behavior should be suitable for still image
3619capture; typically this means focusing as fast as
3620possible.<wbr/> When the AF trigger is not involved,<wbr/> the AF
3621algorithm should start in INACTIVE state,<wbr/> and then
3622transition into PASSIVE_<wbr/>SCAN and PASSIVE_<wbr/>FOCUSED states as
3623appropriate as it attempts to maintain focus.<wbr/> When the AF
3624trigger is activated,<wbr/> the algorithm should finish its
3625PASSIVE_<wbr/>SCAN if active,<wbr/> and then transition into
3626AF_<wbr/>FOCUSED or AF_<wbr/>NOT_<wbr/>FOCUSED as appropriate,<wbr/> and lock the
3627lens position until a cancel AF trigger is received.<wbr/></p>
3628<p>When the AF cancel trigger is activated,<wbr/> the algorithm
3629should transition back to INACTIVE and then act as if it
3630has just been started.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3631 </li>
3632 <li>
3633 <span class="entry_type_enum_name">EDOF</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]3634 <span class="entry_type_enum_notes"><p>Extended depth of field (digital focus).<wbr/> AF
3635trigger is ignored,<wbr/> AF state should always be
3636INACTIVE.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3637 </li>
3638 </ul>
3639
3640 </td> <!-- entry_type -->
3641
3642 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3643 <p>Whether AF is currently enabled,<wbr/> and what
3644mode it is set to</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3645 </td>
3646
3647 <td class="entry_units">
3648 </td>
3649
3650 <td class="entry_range">
Zhijun He7787f7f2014-01-14 16:30:31 -0800[diff] [blame]3651 <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]3652 </td>
3653
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3654 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]3655 <ul class="entry_tags">
3656 <li><a href="#tag_BC">BC</a></li>
3657 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3658 </td>
3659
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3660 </tr>
3661 <tr class="entries_header">
3662 <th class="th_details" colspan="5">Details</th>
3663 </tr>
3664 <tr class="entry_cont">
3665 <td class="entry_details" colspan="5">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]3666 <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]3667<p>If the lens is controlled by the camera device auto-focus algorithm,<wbr/>
3668the camera device will report the current AF status in android.<wbr/>control.<wbr/>af<wbr/>State
3669in result metadata.<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3670 </td>
3671 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3672
3673
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3674 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
3675 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3676
3677
3678 <tr class="entry" id="dynamic_android.control.afRegions">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3679 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3680 android.<wbr/>control.<wbr/>af<wbr/>Regions
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3681 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3682 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]3683 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3684 <span class="entry_type_container">x</span>
3685
3686 <span class="entry_type_array">
3687 5 x area_count
3688 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3689 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3690
3691
3692 </td> <!-- entry_type -->
3693
3694 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3695 <p>List of areas to use for focus
3696estimation</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3697 </td>
3698
3699 <td class="entry_units">
3700 </td>
3701
3702 <td class="entry_range">
3703 </td>
3704
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3705 <td class="entry_tags">
3706 <ul class="entry_tags">
3707 <li><a href="#tag_BC">BC</a></li>
3708 </ul>
3709 </td>
3710
3711 </tr>
3712 <tr class="entries_header">
3713 <th class="th_details" colspan="5">Details</th>
3714 </tr>
3715 <tr class="entry_cont">
3716 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3717 <p>Each area is a rectangle plus weight: xmin,<wbr/> ymin,<wbr/>
3718xmax,<wbr/> ymax,<wbr/> weight.<wbr/> The rectangle is defined inclusive of the
3719specified coordinates.<wbr/></p>
3720<p>The coordinate system is based on the active pixel array,<wbr/>
3721with (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]3722(<a href="#static_android.sensor.info.activeArraySize">android.<wbr/>sensor.<wbr/>info.<wbr/>active<wbr/>Array<wbr/>Size</a>.<wbr/>width - 1,<wbr/>
3723<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]3724bottom-right pixel in the active pixel array.<wbr/> The weight
3725should be nonnegative.<wbr/></p>
3726<p>If all regions have 0 weight,<wbr/> then no specific focus area
3727needs to be used by the HAL.<wbr/> If the focusing region is
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]3728outside 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]3729should ignore the sections outside the region and output the
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3730used sections in the frame metadata</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3731 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3732 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3733
3734
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3735 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
3736 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3737
3738
3739 <tr class="entry" id="dynamic_android.control.afState">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3740 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3741 android.<wbr/>control.<wbr/>af<wbr/>State
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3742 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3743 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]3744 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3745
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3746 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3747
3748 <ul class="entry_type_enum">
3749 <li>
3750 <span class="entry_type_enum_name">INACTIVE</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]3751 <span class="entry_type_enum_notes"><p>AF off or has not yet tried to scan/<wbr/>been asked
3752to scan.<wbr/> When a camera device is opened,<wbr/> it starts in
3753this state.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3754 </li>
3755 <li>
3756 <span class="entry_type_enum_name">PASSIVE_SCAN</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]3757 <span class="entry_type_enum_notes"><p>if CONTINUOUS_<wbr/>* modes are supported.<wbr/> AF is
3758currently doing an AF scan initiated by a continuous
3759autofocus mode</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3760 </li>
3761 <li>
3762 <span class="entry_type_enum_name">PASSIVE_FOCUSED</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]3763 <span class="entry_type_enum_notes"><p>if CONTINUOUS_<wbr/>* modes are supported.<wbr/> AF currently
3764believes it is in focus,<wbr/> but may restart scanning at
3765any time.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3766 </li>
3767 <li>
3768 <span class="entry_type_enum_name">ACTIVE_SCAN</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]3769 <span class="entry_type_enum_notes"><p>if AUTO or MACRO modes are supported.<wbr/> AF is doing
3770an AF scan because it was triggered by AF
3771trigger</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3772 </li>
3773 <li>
3774 <span class="entry_type_enum_name">FOCUSED_LOCKED</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]3775 <span class="entry_type_enum_notes"><p>if any AF mode besides OFF is supported.<wbr/> AF
3776believes it is focused correctly and is
3777locked</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3778 </li>
3779 <li>
3780 <span class="entry_type_enum_name">NOT_FOCUSED_LOCKED</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]3781 <span class="entry_type_enum_notes"><p>if any AF mode besides OFF is supported.<wbr/> AF has
3782failed to focus successfully and is
3783locked</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3784 </li>
Eino-Ville Talvala492ba7c2013-09-20 17:24:00 -0700[diff] [blame]3785 <li>
3786 <span class="entry_type_enum_name">PASSIVE_UNFOCUSED</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]3787 <span class="entry_type_enum_notes"><p>if CONTINUOUS_<wbr/>* modes are supported.<wbr/> AF finished a
3788passive scan without finding focus,<wbr/> and may restart
3789scanning at any time.<wbr/></p></span>
Eino-Ville Talvala492ba7c2013-09-20 17:24:00 -0700[diff] [blame]3790 </li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3791 </ul>
3792
3793 </td> <!-- entry_type -->
3794
3795 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3796 <p>Current state of AF algorithm</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">
3803 </td>
3804
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3805 <td class="entry_tags">
3806 </td>
3807
3808 </tr>
3809 <tr class="entries_header">
3810 <th class="th_details" colspan="5">Details</th>
3811 </tr>
3812 <tr class="entry_cont">
3813 <td class="entry_details" colspan="5">
Zhijun He92e698d2014-01-13 16:24:31 -0800[diff] [blame]3814 <p>Switching between or enabling AF modes (<a href="#controls_android.control.afMode">android.<wbr/>control.<wbr/>af<wbr/>Mode</a>) always
3815resets the AF state to INACTIVE.<wbr/> Similarly,<wbr/> switching between <a href="#controls_android.control.mode">android.<wbr/>control.<wbr/>mode</a>,<wbr/>
3816or <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
3817the algorithm states to INACTIVE.<wbr/></p>
3818<p>The camera device can do several state transitions between two results,<wbr/> if it is
3819allowed by the state transition table.<wbr/> For example: INACTIVE may never actually be
3820seen in a result.<wbr/></p>
3821<p>The state in the result is the state for this image (in sync with this image): if
3822AF state becomes FOCUSED,<wbr/> then the image data associated with this result should
3823be sharp.<wbr/></p>
3824<p>Below are state transition tables for different AF modes.<wbr/></p>
3825<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>
3826<table>
3827<thead>
3828<tr>
3829<th align="center">State</th>
3830<th align="center">Transition Cause</th>
3831<th align="center">New State</th>
3832<th align="center">Notes</th>
3833</tr>
3834</thead>
3835<tbody>
3836<tr>
3837<td align="center">INACTIVE</td>
3838<td align="center"></td>
3839<td align="center">INACTIVE</td>
3840<td align="center">Never changes</td>
3841</tr>
3842</tbody>
3843</table>
3844<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>
3845<table>
3846<thead>
3847<tr>
3848<th align="center">State</th>
3849<th align="center">Transition Cause</th>
3850<th align="center">New State</th>
3851<th align="center">Notes</th>
3852</tr>
3853</thead>
3854<tbody>
3855<tr>
3856<td align="center">INACTIVE</td>
3857<td align="center">AF_<wbr/>TRIGGER</td>
3858<td align="center">ACTIVE_<wbr/>SCAN</td>
3859<td align="center">Start AF sweep,<wbr/> Lens now moving</td>
3860</tr>
3861<tr>
3862<td align="center">ACTIVE_<wbr/>SCAN</td>
3863<td align="center">AF sweep done</td>
3864<td align="center">FOCUSED_<wbr/>LOCKED</td>
3865<td align="center">Focused,<wbr/> Lens now locked</td>
3866</tr>
3867<tr>
3868<td align="center">ACTIVE_<wbr/>SCAN</td>
3869<td align="center">AF sweep done</td>
3870<td align="center">NOT_<wbr/>FOCUSED_<wbr/>LOCKED</td>
3871<td align="center">Not focused,<wbr/> Lens now locked</td>
3872</tr>
3873<tr>
3874<td align="center">ACTIVE_<wbr/>SCAN</td>
3875<td align="center">AF_<wbr/>CANCEL</td>
3876<td align="center">INACTIVE</td>
3877<td align="center">Cancel/<wbr/>reset AF,<wbr/> Lens now locked</td>
3878</tr>
3879<tr>
3880<td align="center">FOCUSED_<wbr/>LOCKED</td>
3881<td align="center">AF_<wbr/>CANCEL</td>
3882<td align="center">INACTIVE</td>
3883<td align="center">Cancel/<wbr/>reset AF</td>
3884</tr>
3885<tr>
3886<td align="center">FOCUSED_<wbr/>LOCKED</td>
3887<td align="center">AF_<wbr/>TRIGGER</td>
3888<td align="center">ACTIVE_<wbr/>SCAN</td>
3889<td align="center">Start new sweep,<wbr/> Lens now moving</td>
3890</tr>
3891<tr>
3892<td align="center">NOT_<wbr/>FOCUSED_<wbr/>LOCKED</td>
3893<td align="center">AF_<wbr/>CANCEL</td>
3894<td align="center">INACTIVE</td>
3895<td align="center">Cancel/<wbr/>reset AF</td>
3896</tr>
3897<tr>
3898<td align="center">NOT_<wbr/>FOCUSED_<wbr/>LOCKED</td>
3899<td align="center">AF_<wbr/>TRIGGER</td>
3900<td align="center">ACTIVE_<wbr/>SCAN</td>
3901<td align="center">Start new sweep,<wbr/> Lens now moving</td>
3902</tr>
3903<tr>
3904<td align="center">Any state</td>
3905<td align="center">Mode change</td>
3906<td align="center">INACTIVE</td>
3907<td align="center"></td>
3908</tr>
3909</tbody>
3910</table>
3911<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>
3912<table>
3913<thead>
3914<tr>
3915<th align="center">State</th>
3916<th align="center">Transition Cause</th>
3917<th align="center">New State</th>
3918<th align="center">Notes</th>
3919</tr>
3920</thead>
3921<tbody>
3922<tr>
3923<td align="center">INACTIVE</td>
3924<td align="center">Camera device initiates new scan</td>
3925<td align="center">PASSIVE_<wbr/>SCAN</td>
3926<td align="center">Start AF scan,<wbr/> Lens now moving</td>
3927</tr>
3928<tr>
3929<td align="center">INACTIVE</td>
3930<td align="center">AF_<wbr/>TRIGGER</td>
3931<td align="center">NOT_<wbr/>FOCUSED_<wbr/>LOCKED</td>
3932<td align="center">AF state query,<wbr/> Lens now locked</td>
3933</tr>
3934<tr>
3935<td align="center">PASSIVE_<wbr/>SCAN</td>
3936<td align="center">Camera device completes current scan</td>
3937<td align="center">PASSIVE_<wbr/>FOCUSED</td>
3938<td align="center">End AF scan,<wbr/> Lens now locked</td>
3939</tr>
3940<tr>
3941<td align="center">PASSIVE_<wbr/>SCAN</td>
3942<td align="center">Camera device fails current scan</td>
3943<td align="center">PASSIVE_<wbr/>UNFOCUSED</td>
3944<td align="center">End AF scan,<wbr/> Lens now locked</td>
3945</tr>
3946<tr>
3947<td align="center">PASSIVE_<wbr/>SCAN</td>
3948<td align="center">AF_<wbr/>TRIGGER</td>
3949<td align="center">FOCUSED_<wbr/>LOCKED</td>
3950<td align="center">Immediate trans.<wbr/> If focus is good,<wbr/> Lens now locked</td>
3951</tr>
3952<tr>
3953<td align="center">PASSIVE_<wbr/>SCAN</td>
3954<td align="center">AF_<wbr/>TRIGGER</td>
3955<td align="center">NOT_<wbr/>FOCUSED_<wbr/>LOCKED</td>
3956<td align="center">Immediate trans.<wbr/> if focus is bad,<wbr/> Lens now locked</td>
3957</tr>
3958<tr>
3959<td align="center">PASSIVE_<wbr/>SCAN</td>
3960<td align="center">AF_<wbr/>CANCEL</td>
3961<td align="center">INACTIVE</td>
3962<td align="center">Reset lens position,<wbr/> Lens now locked</td>
3963</tr>
3964<tr>
3965<td align="center">PASSIVE_<wbr/>FOCUSED</td>
3966<td align="center">Camera device initiates new scan</td>
3967<td align="center">PASSIVE_<wbr/>SCAN</td>
3968<td align="center">Start AF scan,<wbr/> Lens now moving</td>
3969</tr>
3970<tr>
3971<td align="center">PASSIVE_<wbr/>UNFOCUSED</td>
3972<td align="center">Camera device initiates new scan</td>
3973<td align="center">PASSIVE_<wbr/>SCAN</td>
3974<td align="center">Start AF scan,<wbr/> Lens now moving</td>
3975</tr>
3976<tr>
3977<td align="center">PASSIVE_<wbr/>FOCUSED</td>
3978<td align="center">AF_<wbr/>TRIGGER</td>
3979<td align="center">FOCUSED_<wbr/>LOCKED</td>
3980<td align="center">Immediate trans.<wbr/> Lens now locked</td>
3981</tr>
3982<tr>
3983<td align="center">PASSIVE_<wbr/>UNFOCUSED</td>
3984<td align="center">AF_<wbr/>TRIGGER</td>
3985<td align="center">NOT_<wbr/>FOCUSED_<wbr/>LOCKED</td>
3986<td align="center">Immediate trans.<wbr/> Lens now locked</td>
3987</tr>
3988<tr>
3989<td align="center">FOCUSED_<wbr/>LOCKED</td>
3990<td align="center">AF_<wbr/>TRIGGER</td>
3991<td align="center">FOCUSED_<wbr/>LOCKED</td>
3992<td align="center">No effect</td>
3993</tr>
3994<tr>
3995<td align="center">FOCUSED_<wbr/>LOCKED</td>
3996<td align="center">AF_<wbr/>CANCEL</td>
3997<td align="center">INACTIVE</td>
3998<td align="center">Restart AF scan</td>
3999</tr>
4000<tr>
4001<td align="center">NOT_<wbr/>FOCUSED_<wbr/>LOCKED</td>
4002<td align="center">AF_<wbr/>TRIGGER</td>
4003<td align="center">NOT_<wbr/>FOCUSED_<wbr/>LOCKED</td>
4004<td align="center">No effect</td>
4005</tr>
4006<tr>
4007<td align="center">NOT_<wbr/>FOCUSED_<wbr/>LOCKED</td>
4008<td align="center">AF_<wbr/>CANCEL</td>
4009<td align="center">INACTIVE</td>
4010<td align="center">Restart AF scan</td>
4011</tr>
4012</tbody>
4013</table>
4014<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>
4015<table>
4016<thead>
4017<tr>
4018<th align="center">State</th>
4019<th align="center">Transition Cause</th>
4020<th align="center">New State</th>
4021<th align="center">Notes</th>
4022</tr>
4023</thead>
4024<tbody>
4025<tr>
4026<td align="center">INACTIVE</td>
4027<td align="center">Camera device initiates new scan</td>
4028<td align="center">PASSIVE_<wbr/>SCAN</td>
4029<td align="center">Start AF scan,<wbr/> Lens now moving</td>
4030</tr>
4031<tr>
4032<td align="center">INACTIVE</td>
4033<td align="center">AF_<wbr/>TRIGGER</td>
4034<td align="center">NOT_<wbr/>FOCUSED_<wbr/>LOCKED</td>
4035<td align="center">AF state query,<wbr/> Lens now locked</td>
4036</tr>
4037<tr>
4038<td align="center">PASSIVE_<wbr/>SCAN</td>
4039<td align="center">Camera device completes current scan</td>
4040<td align="center">PASSIVE_<wbr/>FOCUSED</td>
4041<td align="center">End AF scan,<wbr/> Lens now locked</td>
4042</tr>
4043<tr>
4044<td align="center">PASSIVE_<wbr/>SCAN</td>
4045<td align="center">Camera device fails current scan</td>
4046<td align="center">PASSIVE_<wbr/>UNFOCUSED</td>
4047<td align="center">End AF scan,<wbr/> Lens now locked</td>
4048</tr>
4049<tr>
4050<td align="center">PASSIVE_<wbr/>SCAN</td>
4051<td align="center">AF_<wbr/>TRIGGER</td>
4052<td align="center">FOCUSED_<wbr/>LOCKED</td>
4053<td align="center">Eventual trans.<wbr/> once focus good,<wbr/> Lens now locked</td>
4054</tr>
4055<tr>
4056<td align="center">PASSIVE_<wbr/>SCAN</td>
4057<td align="center">AF_<wbr/>TRIGGER</td>
4058<td align="center">NOT_<wbr/>FOCUSED_<wbr/>LOCKED</td>
4059<td align="center">Eventual trans.<wbr/> if cannot focus,<wbr/> Lens now locked</td>
4060</tr>
4061<tr>
4062<td align="center">PASSIVE_<wbr/>SCAN</td>
4063<td align="center">AF_<wbr/>CANCEL</td>
4064<td align="center">INACTIVE</td>
4065<td align="center">Reset lens position,<wbr/> Lens now locked</td>
4066</tr>
4067<tr>
4068<td align="center">PASSIVE_<wbr/>FOCUSED</td>
4069<td align="center">Camera device initiates new scan</td>
4070<td align="center">PASSIVE_<wbr/>SCAN</td>
4071<td align="center">Start AF scan,<wbr/> Lens now moving</td>
4072</tr>
4073<tr>
4074<td align="center">PASSIVE_<wbr/>UNFOCUSED</td>
4075<td align="center">Camera device initiates new scan</td>
4076<td align="center">PASSIVE_<wbr/>SCAN</td>
4077<td align="center">Start AF scan,<wbr/> Lens now moving</td>
4078</tr>
4079<tr>
4080<td align="center">PASSIVE_<wbr/>FOCUSED</td>
4081<td align="center">AF_<wbr/>TRIGGER</td>
4082<td align="center">FOCUSED_<wbr/>LOCKED</td>
4083<td align="center">Immediate trans.<wbr/> Lens now locked</td>
4084</tr>
4085<tr>
4086<td align="center">PASSIVE_<wbr/>UNFOCUSED</td>
4087<td align="center">AF_<wbr/>TRIGGER</td>
4088<td align="center">NOT_<wbr/>FOCUSED_<wbr/>LOCKED</td>
4089<td align="center">Immediate trans.<wbr/> Lens now locked</td>
4090</tr>
4091<tr>
4092<td align="center">FOCUSED_<wbr/>LOCKED</td>
4093<td align="center">AF_<wbr/>TRIGGER</td>
4094<td align="center">FOCUSED_<wbr/>LOCKED</td>
4095<td align="center">No effect</td>
4096</tr>
4097<tr>
4098<td align="center">FOCUSED_<wbr/>LOCKED</td>
4099<td align="center">AF_<wbr/>CANCEL</td>
4100<td align="center">INACTIVE</td>
4101<td align="center">Restart AF scan</td>
4102</tr>
4103<tr>
4104<td align="center">NOT_<wbr/>FOCUSED_<wbr/>LOCKED</td>
4105<td align="center">AF_<wbr/>TRIGGER</td>
4106<td align="center">NOT_<wbr/>FOCUSED_<wbr/>LOCKED</td>
4107<td align="center">No effect</td>
4108</tr>
4109<tr>
4110<td align="center">NOT_<wbr/>FOCUSED_<wbr/>LOCKED</td>
4111<td align="center">AF_<wbr/>CANCEL</td>
4112<td align="center">INACTIVE</td>
4113<td align="center">Restart AF scan</td>
4114</tr>
4115</tbody>
4116</table>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4117 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4118 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4119
4120
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4121 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
4122 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4123
4124
4125 <tr class="entry" id="dynamic_android.control.afTriggerId">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4126 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4127 android.<wbr/>control.<wbr/>af<wbr/>Trigger<wbr/>Id
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4128 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4129 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4130 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4131
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4132 <span class="entry_type_visibility"> [hidden]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4133
4134
4135 </td> <!-- entry_type -->
4136
4137 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4138 <p>The ID sent with the latest
4139CAMERA2_<wbr/>TRIGGER_<wbr/>AUTOFOCUS call</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4140 </td>
4141
4142 <td class="entry_units">
4143 </td>
4144
4145 <td class="entry_range">
4146 </td>
4147
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4148 <td class="entry_tags">
4149 </td>
4150
4151 </tr>
4152 <tr class="entries_header">
4153 <th class="th_details" colspan="5">Details</th>
4154 </tr>
4155 <tr class="entry_cont">
4156 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4157 <p>Must be 0 if no CAMERA2_<wbr/>TRIGGER_<wbr/>AUTOFOCUS trigger
4158received yet by HAL.<wbr/> Always updated even if AF algorithm
4159ignores the trigger</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4160 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4161 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4162
4163
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4164 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
4165 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4166
4167
4168 <tr class="entry" id="dynamic_android.control.awbMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4169 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4170 android.<wbr/>control.<wbr/>awb<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4171 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4172 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4173 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4174
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4175 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4176
4177 <ul class="entry_type_enum">
4178 <li>
4179 <span class="entry_type_enum_name">OFF</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]4180 <span class="entry_type_enum_notes"><p>The camera device's auto white balance routine is disabled;
4181the application-selected color transform matrix
4182(<a href="#controls_android.colorCorrection.transform">android.<wbr/>color<wbr/>Correction.<wbr/>transform</a>) and gains
4183(<a href="#controls_android.colorCorrection.gains">android.<wbr/>color<wbr/>Correction.<wbr/>gains</a>) are used by the camera
4184device for manual white balance control.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4185 </li>
4186 <li>
4187 <span class="entry_type_enum_name">AUTO</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]4188 <span class="entry_type_enum_notes"><p>The camera device's auto white balance routine is active;
4189the application's values for android.<wbr/>color<wbr/>Correction.<wbr/>transform
4190and <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]4191 </li>
4192 <li>
4193 <span class="entry_type_enum_name">INCANDESCENT</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]4194 <span class="entry_type_enum_notes"><p>The camera device's auto white balance routine is disabled;
4195the camera device uses incandescent light as the assumed scene
4196illumination for white balance.<wbr/> While the exact white balance
4197transforms are up to the camera device,<wbr/> they will approximately
4198match the CIE standard illuminant A.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4199 </li>
4200 <li>
4201 <span class="entry_type_enum_name">FLUORESCENT</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]4202 <span class="entry_type_enum_notes"><p>The camera device's auto white balance routine is disabled;
4203the camera device uses fluorescent light as the assumed scene
4204illumination for white balance.<wbr/> While the exact white balance
4205transforms are up to the camera device,<wbr/> they will approximately
4206match the CIE standard illuminant F2.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4207 </li>
4208 <li>
4209 <span class="entry_type_enum_name">WARM_FLUORESCENT</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]4210 <span class="entry_type_enum_notes"><p>The camera device's auto white balance routine is disabled;
4211the camera device uses warm fluorescent light as the assumed scene
4212illumination for white balance.<wbr/> While the exact white balance
4213transforms are up to the camera device,<wbr/> they will approximately
4214match the CIE standard illuminant F4.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4215 </li>
4216 <li>
4217 <span class="entry_type_enum_name">DAYLIGHT</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]4218 <span class="entry_type_enum_notes"><p>The camera device's auto white balance routine is disabled;
4219the camera device uses daylight light as the assumed scene
4220illumination for white balance.<wbr/> While the exact white balance
4221transforms are up to the camera device,<wbr/> they will approximately
4222match the CIE standard illuminant D65.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4223 </li>
4224 <li>
4225 <span class="entry_type_enum_name">CLOUDY_DAYLIGHT</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]4226 <span class="entry_type_enum_notes"><p>The camera device's auto white balance routine is disabled;
4227the camera device uses cloudy daylight light as the assumed scene
4228illumination for white balance.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4229 </li>
4230 <li>
4231 <span class="entry_type_enum_name">TWILIGHT</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]4232 <span class="entry_type_enum_notes"><p>The camera device's auto white balance routine is disabled;
4233the camera device uses twilight light as the assumed scene
4234illumination for white balance.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4235 </li>
4236 <li>
4237 <span class="entry_type_enum_name">SHADE</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]4238 <span class="entry_type_enum_notes"><p>The camera device's auto white balance routine is disabled;
4239the camera device uses shade light as the assumed scene
4240illumination for white balance.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4241 </li>
4242 </ul>
4243
4244 </td> <!-- entry_type -->
4245
4246 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4247 <p>Whether AWB is currently setting the color
4248transform fields,<wbr/> and what its illumination target
4249is</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4250 </td>
4251
4252 <td class="entry_units">
4253 </td>
4254
4255 <td class="entry_range">
Zhijun He7787f7f2014-01-14 16:30:31 -0800[diff] [blame]4256 <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]4257 </td>
4258
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4259 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]4260 <ul class="entry_tags">
4261 <li><a href="#tag_BC">BC</a></li>
4262 <li><a href="#tag_AWB">AWB</a></li>
4263 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4264 </td>
4265
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4266 </tr>
4267 <tr class="entries_header">
4268 <th class="th_details" colspan="5">Details</th>
4269 </tr>
4270 <tr class="entry_cont">
4271 <td class="entry_details" colspan="5">
Zhijun He7787f7f2014-01-14 16:30:31 -0800[diff] [blame]4272 <p>This control is only effective if <a href="#controls_android.control.mode">android.<wbr/>control.<wbr/>mode</a> is AUTO.<wbr/></p>
4273<p>When set to the ON mode,<wbr/> the camera device's auto white balance
4274routine is enabled,<wbr/> overriding the application's selected
4275<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
4276<a href="#controls_android.colorCorrection.mode">android.<wbr/>color<wbr/>Correction.<wbr/>mode</a>.<wbr/></p>
4277<p>When set to the OFF mode,<wbr/> the camera device's auto white balance
4278routine is disabled.<wbr/> The applicantion manually controls the white
4279balance by <a href="#controls_android.colorCorrection.transform">android.<wbr/>color<wbr/>Correction.<wbr/>transform</a>,<wbr/> android.<wbr/>color<wbr/>Correction.<wbr/>gains
4280and <a href="#controls_android.colorCorrection.mode">android.<wbr/>color<wbr/>Correction.<wbr/>mode</a>.<wbr/></p>
4281<p>When set to any other modes,<wbr/> the camera device's auto white balance
4282routine is disabled.<wbr/> The camera device uses each particular illumination
4283target for white balance adjustment.<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4284 </td>
4285 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4286
4287
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4288 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
4289 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4290
4291
4292 <tr class="entry" id="dynamic_android.control.awbRegions">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4293 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4294 android.<wbr/>control.<wbr/>awb<wbr/>Regions
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4295 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4296 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4297 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4298 <span class="entry_type_container">x</span>
4299
4300 <span class="entry_type_array">
4301 5 x area_count
4302 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4303 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4304
4305
4306 </td> <!-- entry_type -->
4307
4308 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4309 <p>List of areas to use for illuminant
4310estimation</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4311 </td>
4312
4313 <td class="entry_units">
4314 </td>
4315
4316 <td class="entry_range">
4317 </td>
4318
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4319 <td class="entry_tags">
4320 <ul class="entry_tags">
4321 <li><a href="#tag_BC">BC</a></li>
4322 </ul>
4323 </td>
4324
4325 </tr>
4326 <tr class="entries_header">
4327 <th class="th_details" colspan="5">Details</th>
4328 </tr>
4329 <tr class="entry_cont">
4330 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4331 <p>Only used in AUTO mode.<wbr/></p>
4332<p>Each area is a rectangle plus weight: xmin,<wbr/> ymin,<wbr/>
4333xmax,<wbr/> ymax,<wbr/> weight.<wbr/> The rectangle is defined inclusive of the
4334specified coordinates.<wbr/></p>
4335<p>The coordinate system is based on the active pixel array,<wbr/>
4336with (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]4337(<a href="#static_android.sensor.info.activeArraySize">android.<wbr/>sensor.<wbr/>info.<wbr/>active<wbr/>Array<wbr/>Size</a>.<wbr/>width - 1,<wbr/>
4338<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]4339bottom-right pixel in the active pixel array.<wbr/> The weight
4340should be nonnegative.<wbr/></p>
4341<p>If all regions have 0 weight,<wbr/> then no specific metering area
4342needs to be used by the HAL.<wbr/> If the metering region is
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]4343outside 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]4344should ignore the sections outside the region and output the
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4345used sections in the frame metadata</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4346 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4347 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4348
4349
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4350 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
4351 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4352
4353
4354 <tr class="entry" id="dynamic_android.control.awbState">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4355 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4356 android.<wbr/>control.<wbr/>awb<wbr/>State
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4357 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4358 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4359 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4360
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4361 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4362
4363 <ul class="entry_type_enum">
4364 <li>
4365 <span class="entry_type_enum_name">INACTIVE</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]4366 <span class="entry_type_enum_notes"><p>AWB is not in auto mode.<wbr/> When a camera device is opened,<wbr/> it
4367starts in this state.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4368 </li>
4369 <li>
4370 <span class="entry_type_enum_name">SEARCHING</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]4371 <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]4372values for the current scene.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4373 </li>
4374 <li>
4375 <span class="entry_type_enum_name">CONVERGED</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]4376 <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]4377current scene.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4378 </li>
4379 <li>
4380 <span class="entry_type_enum_name">LOCKED</span>
Zhijun He92e698d2014-01-13 16:24:31 -0800[diff] [blame]4381 <span class="entry_type_enum_notes"><p>AWB has been locked.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4382 </li>
4383 </ul>
4384
4385 </td> <!-- entry_type -->
4386
4387 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4388 <p>Current state of AWB algorithm</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4389 </td>
4390
4391 <td class="entry_units">
4392 </td>
4393
4394 <td class="entry_range">
4395 </td>
4396
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4397 <td class="entry_tags">
4398 </td>
4399
4400 </tr>
4401 <tr class="entries_header">
4402 <th class="th_details" colspan="5">Details</th>
4403 </tr>
4404 <tr class="entry_cont">
4405 <td class="entry_details" colspan="5">
Zhijun He92e698d2014-01-13 16:24:31 -0800[diff] [blame]4406 <p>Switching between or enabling AWB modes (<a href="#controls_android.control.awbMode">android.<wbr/>control.<wbr/>awb<wbr/>Mode</a>) always
4407resets the AWB state to INACTIVE.<wbr/> Similarly,<wbr/> switching between <a href="#controls_android.control.mode">android.<wbr/>control.<wbr/>mode</a>,<wbr/>
4408or <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
4409the algorithm states to INACTIVE.<wbr/></p>
4410<p>The camera device can do several state transitions between two results,<wbr/> if it is
4411allowed by the state transition table.<wbr/> So INACTIVE may never actually be seen in
4412a result.<wbr/></p>
4413<p>The state in the result is the state for this image (in sync with this image): if
4414AWB state becomes CONVERGED,<wbr/> then the image data associated with this result should
4415be good to use.<wbr/></p>
4416<p>Below are state transition tables for different AWB modes.<wbr/></p>
4417<p>When <code><a href="#controls_android.control.awbMode">android.<wbr/>control.<wbr/>awb<wbr/>Mode</a> != AWB_<wbr/>MODE_<wbr/>AUTO</code>:</p>
4418<table>
4419<thead>
4420<tr>
4421<th align="center">State</th>
4422<th align="center">Transition Cause</th>
4423<th align="center">New State</th>
4424<th align="center">Notes</th>
4425</tr>
4426</thead>
4427<tbody>
4428<tr>
4429<td align="center">INACTIVE</td>
4430<td align="center"></td>
4431<td align="center">INACTIVE</td>
4432<td align="center">Camera device auto white balance algorithm is disabled</td>
4433</tr>
4434</tbody>
4435</table>
4436<p>When <a href="#controls_android.control.awbMode">android.<wbr/>control.<wbr/>awb<wbr/>Mode</a> is AWB_<wbr/>MODE_<wbr/>AUTO:</p>
4437<table>
4438<thead>
4439<tr>
4440<th align="center">State</th>
4441<th align="center">Transition Cause</th>
4442<th align="center">New State</th>
4443<th align="center">Notes</th>
4444</tr>
4445</thead>
4446<tbody>
4447<tr>
4448<td align="center">INACTIVE</td>
4449<td align="center">Camera device initiates AWB scan</td>
4450<td align="center">SEARCHING</td>
4451<td align="center">Values changing</td>
4452</tr>
4453<tr>
4454<td align="center">INACTIVE</td>
4455<td align="center"><a href="#controls_android.control.awbLock">android.<wbr/>control.<wbr/>awb<wbr/>Lock</a> is ON</td>
4456<td align="center">LOCKED</td>
4457<td align="center">Values locked</td>
4458</tr>
4459<tr>
4460<td align="center">SEARCHING</td>
4461<td align="center">Camera device finishes AWB scan</td>
4462<td align="center">CONVERGED</td>
4463<td align="center">Good values,<wbr/> not changing</td>
4464</tr>
4465<tr>
4466<td align="center">SEARCHING</td>
4467<td align="center"><a href="#controls_android.control.awbLock">android.<wbr/>control.<wbr/>awb<wbr/>Lock</a> is ON</td>
4468<td align="center">LOCKED</td>
4469<td align="center">Values locked</td>
4470</tr>
4471<tr>
4472<td align="center">CONVERGED</td>
4473<td align="center">Camera device initiates AWB scan</td>
4474<td align="center">SEARCHING</td>
4475<td align="center">Values changing</td>
4476</tr>
4477<tr>
4478<td align="center">CONVERGED</td>
4479<td align="center"><a href="#controls_android.control.awbLock">android.<wbr/>control.<wbr/>awb<wbr/>Lock</a> is ON</td>
4480<td align="center">LOCKED</td>
4481<td align="center">Values locked</td>
4482</tr>
4483<tr>
4484<td align="center">LOCKED</td>
4485<td align="center"><a href="#controls_android.control.awbLock">android.<wbr/>control.<wbr/>awb<wbr/>Lock</a> is OFF</td>
4486<td align="center">SEARCHING</td>
4487<td align="center">Values not good after unlock</td>
4488</tr>
4489<tr>
4490<td align="center">LOCKED</td>
4491<td align="center"><a href="#controls_android.control.awbLock">android.<wbr/>control.<wbr/>awb<wbr/>Lock</a> is OFF</td>
4492<td align="center">CONVERGED</td>
4493<td align="center">Values good after unlock</td>
4494</tr>
4495</tbody>
4496</table>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4497 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4498 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4499
4500
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4501 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
4502 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4503
4504
4505 <tr class="entry" id="dynamic_android.control.mode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4506 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4507 android.<wbr/>control.<wbr/>mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4508 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4509 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4510 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4511
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4512 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4513
4514 <ul class="entry_type_enum">
4515 <li>
4516 <span class="entry_type_enum_name">OFF</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]4517 <span class="entry_type_enum_notes"><p>Full application control of pipeline.<wbr/> All 3A
4518routines are disabled,<wbr/> no other settings in
4519android.<wbr/>control.<wbr/>* have any effect</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4520 </li>
4521 <li>
4522 <span class="entry_type_enum_name">AUTO</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]4523 <span class="entry_type_enum_notes"><p>Use settings for each individual 3A routine.<wbr/>
4524Manual control of capture parameters is disabled.<wbr/> All
4525controls in android.<wbr/>control.<wbr/>* besides sceneMode take
4526effect</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4527 </li>
4528 <li>
4529 <span class="entry_type_enum_name">USE_SCENE_MODE</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]4530 <span class="entry_type_enum_notes"><p>Use specific scene mode.<wbr/> Enabling this disables
4531control.<wbr/>aeMode,<wbr/> control.<wbr/>awbMode and control.<wbr/>afMode
4532controls; the HAL must ignore those settings while
4533USE_<wbr/>SCENE_<wbr/>MODE is active (except for FACE_<wbr/>PRIORITY
4534scene mode).<wbr/> Other control entries are still active.<wbr/>
4535This setting can only be used if availableSceneModes !=
4536UNSUPPORTED</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4537 </li>
4538 </ul>
4539
4540 </td> <!-- entry_type -->
4541
4542 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4543 <p>Overall mode of 3A control
4544routines</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4545 </td>
4546
4547 <td class="entry_units">
4548 </td>
4549
4550 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]4551 <p>all must be supported</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4552 </td>
4553
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4554 <td class="entry_tags">
4555 <ul class="entry_tags">
4556 <li><a href="#tag_BC">BC</a></li>
4557 </ul>
4558 </td>
4559
4560 </tr>
4561 <tr class="entries_header">
4562 <th class="th_details" colspan="5">Details</th>
4563 </tr>
4564 <tr class="entry_cont">
4565 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4566 <p>High-level 3A control.<wbr/> When set to OFF,<wbr/> all 3A control
Zhijun Hef90eeaf2014-01-16 12:13:35 -0800[diff] [blame]4567by the camera device is disabled.<wbr/> The application must set the fields for
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4568capture parameters itself.<wbr/></p>
4569<p>When set to AUTO,<wbr/> the individual algorithm controls in
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]4570android.<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]4571<p>When set to USE_<wbr/>SCENE_<wbr/>MODE,<wbr/> the individual controls in
Zhijun Hef90eeaf2014-01-16 12:13:35 -0800[diff] [blame]4572android.<wbr/>control.<wbr/>* are mostly disabled,<wbr/> and the camera device implements
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4573one of the scene mode settings (such as ACTION,<wbr/> SUNSET,<wbr/> or PARTY)
Zhijun Hef90eeaf2014-01-16 12:13:35 -0800[diff] [blame]4574as it wishes.<wbr/> The camera device scene mode 3A settings are provided by
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]4575<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]4576 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4577 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4578
4579
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4580 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
4581 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4582
4583
4584
4585 <!-- end of kind -->
4586 </tbody>
4587
4588 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4589 <tr><td colspan="6" id="section_demosaic" class="section">demosaic</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4590
4591
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4592 <tr><td colspan="6" class="kind">controls</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4593
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4594 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4595 <tr>
4596 <th class="th_name">Property Name</th>
4597 <th class="th_type">Type</th>
4598 <th class="th_description">Description</th>
4599 <th class="th_units">Units</th>
4600 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4601 <th class="th_tags">Tags</th>
4602 </tr>
4603 </thead>
4604
4605 <tbody>
4606
4607
4608
4609
4610
4611
4612
4613
4614
4615
4616 <tr class="entry" id="controls_android.demosaic.mode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4617 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4618 android.<wbr/>demosaic.<wbr/>mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4619 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4620 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4621 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4622
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4623 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4624
4625 <ul class="entry_type_enum">
4626 <li>
4627 <span class="entry_type_enum_name">FAST</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]4628 <span class="entry_type_enum_notes"><p>Minimal or no slowdown of frame rate compared to
4629Bayer RAW output</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4630 </li>
4631 <li>
4632 <span class="entry_type_enum_name">HIGH_QUALITY</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]4633 <span class="entry_type_enum_notes"><p>High-quality may reduce output frame
4634rate</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4635 </li>
4636 </ul>
4637
4638 </td> <!-- entry_type -->
4639
4640 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4641 <p>Controls the quality of the demosaicing
4642processing</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4643 </td>
4644
4645 <td class="entry_units">
4646 </td>
4647
4648 <td class="entry_range">
4649 </td>
4650
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4651 <td class="entry_tags">
4652 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]4653 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4654 </ul>
4655 </td>
4656
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4657 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4658
4659
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4660 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
4661 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4662
4663
4664
4665 <!-- end of kind -->
4666 </tbody>
4667
4668 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4669 <tr><td colspan="6" id="section_edge" class="section">edge</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4670
4671
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4672 <tr><td colspan="6" class="kind">controls</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4673
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4674 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4675 <tr>
4676 <th class="th_name">Property Name</th>
4677 <th class="th_type">Type</th>
4678 <th class="th_description">Description</th>
4679 <th class="th_units">Units</th>
4680 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4681 <th class="th_tags">Tags</th>
4682 </tr>
4683 </thead>
4684
4685 <tbody>
4686
4687
4688
4689
4690
4691
4692
4693
4694
4695
4696 <tr class="entry" id="controls_android.edge.mode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4697 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4698 android.<wbr/>edge.<wbr/>mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4699 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4700 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4701 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4702
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4703 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4704
4705 <ul class="entry_type_enum">
4706 <li>
4707 <span class="entry_type_enum_name">OFF</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]4708 <span class="entry_type_enum_notes"><p>No edge enhancement is applied</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4709 </li>
4710 <li>
4711 <span class="entry_type_enum_name">FAST</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]4712 <span class="entry_type_enum_notes"><p>Must not slow down frame rate relative to sensor
4713output</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4714 </li>
4715 <li>
4716 <span class="entry_type_enum_name">HIGH_QUALITY</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]4717 <span class="entry_type_enum_notes"><p>Frame rate may be reduced by high
4718quality</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4719 </li>
4720 </ul>
4721
4722 </td> <!-- entry_type -->
4723
4724 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4725 <p>Operation mode for edge
4726enhancement</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4727 </td>
4728
4729 <td class="entry_units">
4730 </td>
4731
4732 <td class="entry_range">
4733 </td>
4734
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4735 <td class="entry_tags">
4736 </td>
4737
4738 </tr>
4739 <tr class="entries_header">
4740 <th class="th_details" colspan="5">Details</th>
4741 </tr>
4742 <tr class="entry_cont">
4743 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4744 <p>Edge/<wbr/>sharpness/<wbr/>detail enhancement.<wbr/> OFF means no
4745enhancement will be applied by the HAL.<wbr/></p>
Zhijun Hef90eeaf2014-01-16 12:13:35 -0800[diff] [blame]4746<p>FAST/<wbr/>HIGH_<wbr/>QUALITY both mean camera device determined enhancement
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4747will be applied.<wbr/> HIGH_<wbr/>QUALITY mode indicates that the
Zhijun Hef90eeaf2014-01-16 12:13:35 -0800[diff] [blame]4748camera device will use the highest-quality enhancement algorithms,<wbr/>
4749even if it slows down capture rate.<wbr/> FAST means the camera device will
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4750not slow down capture rate when applying edge enhancement.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4751 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4752 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4753
4754
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4755 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
4756 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4757
4758
4759 <tr class="entry" id="controls_android.edge.strength">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4760 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4761 android.<wbr/>edge.<wbr/>strength
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4762 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4763 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4764 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4765
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4766 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4767
4768
4769 </td> <!-- entry_type -->
4770
4771 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4772 <p>Control the amount of edge enhancement
4773applied to the images</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4774 </td>
4775
4776 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4777 1-10; 10 is maximum sharpening
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4778 </td>
4779
4780 <td class="entry_range">
4781 </td>
4782
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4783 <td class="entry_tags">
4784 </td>
4785
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4786 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4787
4788
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4789 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
4790 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4791
4792
4793
4794 <!-- end of kind -->
4795 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4796 <tr><td colspan="6" class="kind">dynamic</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4797
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4798 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4799 <tr>
4800 <th class="th_name">Property Name</th>
4801 <th class="th_type">Type</th>
4802 <th class="th_description">Description</th>
4803 <th class="th_units">Units</th>
4804 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4805 <th class="th_tags">Tags</th>
4806 </tr>
4807 </thead>
4808
4809 <tbody>
4810
4811
4812
4813
4814
4815
4816
4817
4818
4819
4820 <tr class="entry" id="dynamic_android.edge.mode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4821 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4822 android.<wbr/>edge.<wbr/>mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4823 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4824 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4825 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4826
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4827 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4828
4829 <ul class="entry_type_enum">
4830 <li>
4831 <span class="entry_type_enum_name">OFF</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]4832 <span class="entry_type_enum_notes"><p>No edge enhancement is applied</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4833 </li>
4834 <li>
4835 <span class="entry_type_enum_name">FAST</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]4836 <span class="entry_type_enum_notes"><p>Must not slow down frame rate relative to sensor
4837output</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4838 </li>
4839 <li>
4840 <span class="entry_type_enum_name">HIGH_QUALITY</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]4841 <span class="entry_type_enum_notes"><p>Frame rate may be reduced by high
4842quality</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4843 </li>
4844 </ul>
4845
4846 </td> <!-- entry_type -->
4847
4848 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4849 <p>Operation mode for edge
4850enhancement</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4851 </td>
4852
4853 <td class="entry_units">
4854 </td>
4855
4856 <td class="entry_range">
4857 </td>
4858
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4859 <td class="entry_tags">
4860 </td>
4861
4862 </tr>
4863 <tr class="entries_header">
4864 <th class="th_details" colspan="5">Details</th>
4865 </tr>
4866 <tr class="entry_cont">
4867 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4868 <p>Edge/<wbr/>sharpness/<wbr/>detail enhancement.<wbr/> OFF means no
4869enhancement will be applied by the HAL.<wbr/></p>
Zhijun Hef90eeaf2014-01-16 12:13:35 -0800[diff] [blame]4870<p>FAST/<wbr/>HIGH_<wbr/>QUALITY both mean camera device determined enhancement
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4871will be applied.<wbr/> HIGH_<wbr/>QUALITY mode indicates that the
Zhijun Hef90eeaf2014-01-16 12:13:35 -0800[diff] [blame]4872camera device will use the highest-quality enhancement algorithms,<wbr/>
4873even if it slows down capture rate.<wbr/> FAST means the camera device will
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4874not slow down capture rate when applying edge enhancement.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4875 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4876 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4877
4878
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4879 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
4880 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4881
4882
4883
4884 <!-- end of kind -->
4885 </tbody>
4886
4887 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4888 <tr><td colspan="6" id="section_flash" class="section">flash</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4889
4890
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4891 <tr><td colspan="6" class="kind">controls</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4892
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4893 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4894 <tr>
4895 <th class="th_name">Property Name</th>
4896 <th class="th_type">Type</th>
4897 <th class="th_description">Description</th>
4898 <th class="th_units">Units</th>
4899 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4900 <th class="th_tags">Tags</th>
4901 </tr>
4902 </thead>
4903
4904 <tbody>
4905
4906
4907
4908
4909
4910
4911
4912
4913
4914
4915 <tr class="entry" id="controls_android.flash.firingPower">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4916 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4917 android.<wbr/>flash.<wbr/>firing<wbr/>Power
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4918 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4919 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4920 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4921
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4922 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4923
4924
4925 </td> <!-- entry_type -->
4926
4927 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4928 <p>Power for flash firing/<wbr/>torch</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4929 </td>
4930
4931 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4932 10 is max power; 0 is no flash.<wbr/> Linear
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4933 </td>
4934
4935 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]4936 <p>0 - 10</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4937 </td>
4938
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4939 <td class="entry_tags">
4940 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]4941 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4942 </ul>
4943 </td>
4944
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4945 </tr>
4946 <tr class="entries_header">
4947 <th class="th_details" colspan="5">Details</th>
4948 </tr>
4949 <tr class="entry_cont">
4950 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4951 <p>Power for snapshot may use a different scale than
4952for torch mode.<wbr/> Only one entry for torch mode will be
4953used</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4954 </td>
4955 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4956
4957
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4958 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
4959 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4960
4961
4962 <tr class="entry" id="controls_android.flash.firingTime">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4963 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4964 android.<wbr/>flash.<wbr/>firing<wbr/>Time
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4965 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4966 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4967 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4968
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4969 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4970
4971
4972 </td> <!-- entry_type -->
4973
4974 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4975 <p>Firing time of flash relative to start of
4976exposure</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4977 </td>
4978
4979 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4980 nanoseconds
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4981 </td>
4982
4983 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]4984 <p>0-(exposure time-flash duration)</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4985 </td>
4986
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4987 <td class="entry_tags">
4988 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]4989 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4990 </ul>
4991 </td>
4992
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4993 </tr>
4994 <tr class="entries_header">
4995 <th class="th_details" colspan="5">Details</th>
4996 </tr>
4997 <tr class="entry_cont">
4998 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4999 <p>Clamped to (0,<wbr/> exposure time - flash
5000duration).<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5001 </td>
5002 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5003
5004
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5005 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5006 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5007
5008
5009 <tr class="entry" id="controls_android.flash.mode">
Zhijun Heea27bc32014-01-15 13:47:59 -0800[diff] [blame]5010 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5011 android.<wbr/>flash.<wbr/>mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5012 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5013 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5014 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5015
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5016 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5017
5018 <ul class="entry_type_enum">
5019 <li>
5020 <span class="entry_type_enum_name">OFF</span>
Zhijun Heea27bc32014-01-15 13:47:59 -0800[diff] [blame]5021 <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]5022 </li>
5023 <li>
5024 <span class="entry_type_enum_name">SINGLE</span>
Zhijun Heea27bc32014-01-15 13:47:59 -0800[diff] [blame]5025 <span class="entry_type_enum_notes"><p>If the flash is available and charged,<wbr/> fire flash
5026for this capture based on <a href="#controls_android.flash.firingPower">android.<wbr/>flash.<wbr/>firing<wbr/>Power</a> and
5027<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]5028 </li>
5029 <li>
5030 <span class="entry_type_enum_name">TORCH</span>
Zhijun Heea27bc32014-01-15 13:47:59 -0800[diff] [blame]5031 <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]5032 </li>
5033 </ul>
5034
5035 </td> <!-- entry_type -->
5036
5037 <td class="entry_description">
Zhijun Heea27bc32014-01-15 13:47:59 -0800[diff] [blame]5038 <p>The desired mode for for the camera device's flash control.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5039 </td>
5040
5041 <td class="entry_units">
5042 </td>
5043
5044 <td class="entry_range">
5045 </td>
5046
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5047 <td class="entry_tags">
5048 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5049 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5050 </ul>
5051 </td>
5052
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5053 </tr>
Zhijun Heea27bc32014-01-15 13:47:59 -0800[diff] [blame]5054 <tr class="entries_header">
5055 <th class="th_details" colspan="5">Details</th>
5056 </tr>
5057 <tr class="entry_cont">
5058 <td class="entry_details" colspan="5">
5059 <p>This control is only effective when flash unit is available
5060(<code><a href="#static_android.flash.info.available">android.<wbr/>flash.<wbr/>info.<wbr/>available</a> != 0</code>).<wbr/></p>
5061<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/>
5062Otherwise,<wbr/> the camera device auto-exposure related flash control (ON_<wbr/>AUTO_<wbr/>FLASH,<wbr/>
5063ON_<wbr/>ALWAYS_<wbr/>FLASH,<wbr/> or ON_<wbr/>AUTO_<wbr/>FLASH_<wbr/>REDEYE) will override this control.<wbr/></p>
5064<p>When set to OFF,<wbr/> the camera device will not fire flash for this capture.<wbr/></p>
5065<p>When set to SINGLE,<wbr/> the camera device will fire flash regardless of the camera
5066device's auto-exposure routine's result.<wbr/> When used in still capture case,<wbr/> this
5067control should be used along with AE precapture metering sequence
5068(<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>
5069<p>When set to TORCH,<wbr/> the flash will be on continuously.<wbr/> This mode can be used
5070for use cases such as preview,<wbr/> auto-focus assist,<wbr/> still capture,<wbr/> or video recording.<wbr/></p>
5071 </td>
5072 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5073
5074
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5075 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5076 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5077
5078
5079
5080 <!-- end of kind -->
5081 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5082 <tr><td colspan="6" class="kind">static</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5083
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5084 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5085 <tr>
5086 <th class="th_name">Property Name</th>
5087 <th class="th_type">Type</th>
5088 <th class="th_description">Description</th>
5089 <th class="th_units">Units</th>
5090 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5091 <th class="th_tags">Tags</th>
5092 </tr>
5093 </thead>
5094
5095 <tbody>
5096
5097
5098
5099
5100
5101
5102
5103
5104
5105
5106
5107
5108 <tr class="entry" id="static_android.flash.info.available">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5109 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5110 android.<wbr/>flash.<wbr/>info.<wbr/>available
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5111 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5112 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5113 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5114
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5115 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5116
5117
5118 </td> <!-- entry_type -->
5119
5120 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5121 <p>Whether this camera has a
5122flash</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5123 </td>
5124
5125 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5126 boolean (0 = false,<wbr/> otherwise true)
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5127 </td>
5128
5129 <td class="entry_range">
5130 </td>
5131
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5132 <td class="entry_tags">
5133 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5134 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5135 </ul>
5136 </td>
5137
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5138 </tr>
5139 <tr class="entries_header">
5140 <th class="th_details" colspan="5">Details</th>
5141 </tr>
5142 <tr class="entry_cont">
5143 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5144 <p>If no flash,<wbr/> none of the flash controls do
5145anything.<wbr/> All other metadata should return 0</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5146 </td>
5147 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5148
5149
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5150 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5151 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5152
5153
5154 <tr class="entry" id="static_android.flash.info.chargeDuration">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5155 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5156 android.<wbr/>flash.<wbr/>info.<wbr/>charge<wbr/>Duration
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5157 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5158 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5159 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5160
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5161 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5162
5163
5164 </td> <!-- entry_type -->
5165
5166 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5167 <p>Time taken before flash can fire
5168again</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5169 </td>
5170
5171 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5172 nanoseconds
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5173 </td>
5174
5175 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]5176 <p>0-1e9</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5177 </td>
5178
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5179 <td class="entry_tags">
5180 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5181 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5182 </ul>
5183 </td>
5184
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5185 </tr>
5186 <tr class="entries_header">
5187 <th class="th_details" colspan="5">Details</th>
5188 </tr>
5189 <tr class="entry_cont">
5190 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5191 <p>1 second too long/<wbr/>too short for recharge? Should
5192this be power-dependent?</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5193 </td>
5194 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5195
5196
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5197 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5198 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5199
5200
5201
5202
5203
5204 <tr class="entry" id="static_android.flash.colorTemperature">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5205 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5206 android.<wbr/>flash.<wbr/>color<wbr/>Temperature
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5207 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5208 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5209 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5210
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5211 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5212
5213
5214 </td> <!-- entry_type -->
5215
5216 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5217 <p>The x,<wbr/>y whitepoint of the
5218flash</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5219 </td>
5220
5221 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5222 pair of floats
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5223 </td>
5224
5225 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]5226 <p>0-1 for both</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5227 </td>
5228
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5229 <td class="entry_tags">
5230 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5231 <li><a href="#tag_ADV">ADV</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5232 </ul>
5233 </td>
5234
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5235 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5236
5237
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5238 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5239 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5240
5241
5242 <tr class="entry" id="static_android.flash.maxEnergy">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5243 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5244 android.<wbr/>flash.<wbr/>max<wbr/>Energy
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5245 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5246 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5247 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5248
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5249 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5250
5251
5252 </td> <!-- entry_type -->
5253
5254 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5255 <p>Max energy output of the flash for a full
5256power single flash</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5257 </td>
5258
5259 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5260 lumen-seconds
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5261 </td>
5262
5263 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame]5264 <p>&gt;= 0</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5265 </td>
5266
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5267 <td class="entry_tags">
5268 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5269 <li><a href="#tag_ADV">ADV</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5270 </ul>
5271 </td>
5272
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5273 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5274
5275
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5276 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5277 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5278
5279
5280
5281 <!-- end of kind -->
5282 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5283 <tr><td colspan="6" class="kind">dynamic</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5284
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5285 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5286 <tr>
5287 <th class="th_name">Property Name</th>
5288 <th class="th_type">Type</th>
5289 <th class="th_description">Description</th>
5290 <th class="th_units">Units</th>
5291 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5292 <th class="th_tags">Tags</th>
5293 </tr>
5294 </thead>
5295
5296 <tbody>
5297
5298
5299
5300
5301
5302
5303
5304
5305
5306
5307 <tr class="entry" id="dynamic_android.flash.firingPower">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5308 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5309 android.<wbr/>flash.<wbr/>firing<wbr/>Power
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5310 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5311 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5312 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5313
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5314 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5315
5316
5317 </td> <!-- entry_type -->
5318
5319 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5320 <p>Power for flash firing/<wbr/>torch</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5321 </td>
5322
5323 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5324 10 is max power; 0 is no flash.<wbr/> Linear
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5325 </td>
5326
5327 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]5328 <p>0 - 10</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5329 </td>
5330
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5331 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5332 <ul class="entry_tags">
5333 <li><a href="#tag_V1">V1</a></li>
5334 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5335 </td>
5336
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5337 </tr>
5338 <tr class="entries_header">
5339 <th class="th_details" colspan="5">Details</th>
5340 </tr>
5341 <tr class="entry_cont">
5342 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5343 <p>Power for snapshot may use a different scale than
5344for torch mode.<wbr/> Only one entry for torch mode will be
5345used</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5346 </td>
5347 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5348
5349
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5350 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5351 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5352
5353
5354 <tr class="entry" id="dynamic_android.flash.firingTime">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5355 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5356 android.<wbr/>flash.<wbr/>firing<wbr/>Time
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5357 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5358 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5359 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5360
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5361 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5362
5363
5364 </td> <!-- entry_type -->
5365
5366 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5367 <p>Firing time of flash relative to start of
5368exposure</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5369 </td>
5370
5371 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5372 nanoseconds
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5373 </td>
5374
5375 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]5376 <p>0-(exposure time-flash duration)</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5377 </td>
5378
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5379 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5380 <ul class="entry_tags">
5381 <li><a href="#tag_V1">V1</a></li>
5382 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5383 </td>
5384
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5385 </tr>
5386 <tr class="entries_header">
5387 <th class="th_details" colspan="5">Details</th>
5388 </tr>
5389 <tr class="entry_cont">
5390 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5391 <p>Clamped to (0,<wbr/> exposure time - flash
5392duration).<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5393 </td>
5394 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5395
5396
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5397 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5398 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5399
5400
5401 <tr class="entry" id="dynamic_android.flash.mode">
Zhijun Heea27bc32014-01-15 13:47:59 -0800[diff] [blame]5402 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5403 android.<wbr/>flash.<wbr/>mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5404 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5405 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5406 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5407
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5408 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5409
5410 <ul class="entry_type_enum">
5411 <li>
5412 <span class="entry_type_enum_name">OFF</span>
Zhijun Heea27bc32014-01-15 13:47:59 -0800[diff] [blame]5413 <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]5414 </li>
5415 <li>
5416 <span class="entry_type_enum_name">SINGLE</span>
Zhijun Heea27bc32014-01-15 13:47:59 -0800[diff] [blame]5417 <span class="entry_type_enum_notes"><p>If the flash is available and charged,<wbr/> fire flash
5418for this capture based on <a href="#controls_android.flash.firingPower">android.<wbr/>flash.<wbr/>firing<wbr/>Power</a> and
5419<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]5420 </li>
5421 <li>
5422 <span class="entry_type_enum_name">TORCH</span>
Zhijun Heea27bc32014-01-15 13:47:59 -0800[diff] [blame]5423 <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]5424 </li>
5425 </ul>
5426
5427 </td> <!-- entry_type -->
5428
5429 <td class="entry_description">
Zhijun Heea27bc32014-01-15 13:47:59 -0800[diff] [blame]5430 <p>The desired mode for for the camera device's flash control.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5431 </td>
5432
5433 <td class="entry_units">
5434 </td>
5435
5436 <td class="entry_range">
5437 </td>
5438
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5439 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5440 <ul class="entry_tags">
5441 <li><a href="#tag_BC">BC</a></li>
5442 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5443 </td>
5444
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5445 </tr>
Zhijun Heea27bc32014-01-15 13:47:59 -0800[diff] [blame]5446 <tr class="entries_header">
5447 <th class="th_details" colspan="5">Details</th>
5448 </tr>
5449 <tr class="entry_cont">
5450 <td class="entry_details" colspan="5">
5451 <p>This control is only effective when flash unit is available
5452(<code><a href="#static_android.flash.info.available">android.<wbr/>flash.<wbr/>info.<wbr/>available</a> != 0</code>).<wbr/></p>
5453<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/>
5454Otherwise,<wbr/> the camera device auto-exposure related flash control (ON_<wbr/>AUTO_<wbr/>FLASH,<wbr/>
5455ON_<wbr/>ALWAYS_<wbr/>FLASH,<wbr/> or ON_<wbr/>AUTO_<wbr/>FLASH_<wbr/>REDEYE) will override this control.<wbr/></p>
5456<p>When set to OFF,<wbr/> the camera device will not fire flash for this capture.<wbr/></p>
5457<p>When set to SINGLE,<wbr/> the camera device will fire flash regardless of the camera
5458device's auto-exposure routine's result.<wbr/> When used in still capture case,<wbr/> this
5459control should be used along with AE precapture metering sequence
5460(<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>
5461<p>When set to TORCH,<wbr/> the flash will be on continuously.<wbr/> This mode can be used
5462for use cases such as preview,<wbr/> auto-focus assist,<wbr/> still capture,<wbr/> or video recording.<wbr/></p>
5463 </td>
5464 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5465
5466
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5467 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5468 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5469
5470
5471 <tr class="entry" id="dynamic_android.flash.state">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5472 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5473 android.<wbr/>flash.<wbr/>state
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5474 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5475 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5476 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5477
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5478 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5479
5480 <ul class="entry_type_enum">
5481 <li>
5482 <span class="entry_type_enum_name">UNAVAILABLE</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]5483 <span class="entry_type_enum_notes"><p>No flash on camera</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5484 </li>
5485 <li>
5486 <span class="entry_type_enum_name">CHARGING</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]5487 <span class="entry_type_enum_notes"><p>if android.<wbr/>flash.<wbr/>available is true Flash is
5488charging and cannot be fired</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5489 </li>
5490 <li>
5491 <span class="entry_type_enum_name">READY</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]5492 <span class="entry_type_enum_notes"><p>if android.<wbr/>flash.<wbr/>available is true Flash is
5493ready to fire</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5494 </li>
5495 <li>
5496 <span class="entry_type_enum_name">FIRED</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]5497 <span class="entry_type_enum_notes"><p>if android.<wbr/>flash.<wbr/>available is true Flash fired
5498for this capture</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5499 </li>
5500 </ul>
5501
5502 </td> <!-- entry_type -->
5503
5504 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5505 <p>Current state of the flash
5506unit</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5507 </td>
5508
5509 <td class="entry_units">
5510 </td>
5511
5512 <td class="entry_range">
5513 </td>
5514
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5515 <td class="entry_tags">
5516 </td>
5517
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5518 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5519
5520
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5521 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5522 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5523
5524
5525
5526 <!-- end of kind -->
5527 </tbody>
5528
5529 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5530 <tr><td colspan="6" id="section_geometric" class="section">geometric</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5531
5532
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5533 <tr><td colspan="6" class="kind">controls</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5534
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5535 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5536 <tr>
5537 <th class="th_name">Property Name</th>
5538 <th class="th_type">Type</th>
5539 <th class="th_description">Description</th>
5540 <th class="th_units">Units</th>
5541 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5542 <th class="th_tags">Tags</th>
5543 </tr>
5544 </thead>
5545
5546 <tbody>
5547
5548
5549
5550
5551
5552
5553
5554
5555
5556
5557 <tr class="entry" id="controls_android.geometric.mode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5558 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5559 android.<wbr/>geometric.<wbr/>mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5560 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5561 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5562 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5563
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5564 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5565
5566 <ul class="entry_type_enum">
5567 <li>
5568 <span class="entry_type_enum_name">OFF</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]5569 <span class="entry_type_enum_notes"><p>No geometric correction is
5570applied</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5571 </li>
5572 <li>
5573 <span class="entry_type_enum_name">FAST</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]5574 <span class="entry_type_enum_notes"><p>Must not slow down frame rate relative to raw
5575bayer output</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5576 </li>
5577 <li>
5578 <span class="entry_type_enum_name">HIGH_QUALITY</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]5579 <span class="entry_type_enum_notes"><p>Frame rate may be reduced by high
5580quality</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5581 </li>
5582 </ul>
5583
5584 </td> <!-- entry_type -->
5585
5586 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5587 <p>Operating mode of geometric
5588correction</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5589 </td>
5590
5591 <td class="entry_units">
5592 </td>
5593
5594 <td class="entry_range">
5595 </td>
5596
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5597 <td class="entry_tags">
5598 </td>
5599
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5600 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5601
5602
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5603 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5604 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5605
5606
5607 <tr class="entry" id="controls_android.geometric.strength">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5608 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5609 android.<wbr/>geometric.<wbr/>strength
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5610 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5611 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5612 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5613
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5614 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5615
5616
5617 </td> <!-- entry_type -->
5618
5619 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5620 <p>Control the amount of shading correction
5621applied to the images</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5622 </td>
5623
5624 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5625 unitless: 1-10; 10 is full shading
5626 compensation
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5627 </td>
5628
5629 <td class="entry_range">
5630 </td>
5631
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5632 <td class="entry_tags">
5633 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5634 <li><a href="#tag_ADV">ADV</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5635 </ul>
5636 </td>
5637
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5638 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5639
5640
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5641 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5642 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5643
5644
5645
5646 <!-- end of kind -->
5647 </tbody>
5648
5649 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5650 <tr><td colspan="6" id="section_hotPixel" class="section">hotPixel</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5651
5652
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5653 <tr><td colspan="6" class="kind">controls</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5654
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5655 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5656 <tr>
5657 <th class="th_name">Property Name</th>
5658 <th class="th_type">Type</th>
5659 <th class="th_description">Description</th>
5660 <th class="th_units">Units</th>
5661 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5662 <th class="th_tags">Tags</th>
5663 </tr>
5664 </thead>
5665
5666 <tbody>
5667
5668
5669
5670
5671
5672
5673
5674
5675
5676
5677 <tr class="entry" id="controls_android.hotPixel.mode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5678 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5679 android.<wbr/>hot<wbr/>Pixel.<wbr/>mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5680 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5681 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5682 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5683
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5684 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5685
5686 <ul class="entry_type_enum">
5687 <li>
5688 <span class="entry_type_enum_name">OFF</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]5689 <span class="entry_type_enum_notes"><p>No hot pixel correction can be
5690applied</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5691 </li>
5692 <li>
5693 <span class="entry_type_enum_name">FAST</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]5694 <span class="entry_type_enum_notes"><p>Frame rate must not be reduced compared to raw
5695Bayer output</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5696 </li>
5697 <li>
5698 <span class="entry_type_enum_name">HIGH_QUALITY</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]5699 <span class="entry_type_enum_notes"><p>Frame rate may be reduced by high
5700quality</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5701 </li>
5702 </ul>
5703
5704 </td> <!-- entry_type -->
5705
5706 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5707 <p>Set operational mode for hot pixel
5708correction</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5709 </td>
5710
5711 <td class="entry_units">
5712 </td>
5713
5714 <td class="entry_range">
5715 </td>
5716
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5717 <td class="entry_tags">
5718 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5719 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5720 </ul>
5721 </td>
5722
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5723 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5724
5725
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5726 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5727 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5728
5729
5730
5731 <!-- end of kind -->
5732 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5733 <tr><td colspan="6" class="kind">static</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5734
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5735 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5736 <tr>
5737 <th class="th_name">Property Name</th>
5738 <th class="th_type">Type</th>
5739 <th class="th_description">Description</th>
5740 <th class="th_units">Units</th>
5741 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5742 <th class="th_tags">Tags</th>
5743 </tr>
5744 </thead>
5745
5746 <tbody>
5747
5748
5749
5750
5751
5752
5753
5754
5755
5756
5757
5758
5759 <tr class="entry" id="static_android.hotPixel.info.map">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5760 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5761 android.<wbr/>hot<wbr/>Pixel.<wbr/>info.<wbr/>map
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5762 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5763 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5764 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5765 <span class="entry_type_container">x</span>
5766
5767 <span class="entry_type_array">
5768 2 x n
5769 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5770 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5771 <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]5772
5773
5774 </td> <!-- entry_type -->
5775
5776 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5777 <p>Location of hot/<wbr/>defective pixels on
5778sensor</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5779 </td>
5780
5781 <td class="entry_units">
5782 </td>
5783
5784 <td class="entry_range">
5785 </td>
5786
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5787 <td class="entry_tags">
5788 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5789 <li><a href="#tag_ADV">ADV</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5790 </ul>
5791 </td>
5792
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5793 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5794
5795
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5796 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5797 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5798
5799
5800
5801
5802
5803
5804 <!-- end of kind -->
5805 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5806 <tr><td colspan="6" class="kind">dynamic</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5807
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5808 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5809 <tr>
5810 <th class="th_name">Property Name</th>
5811 <th class="th_type">Type</th>
5812 <th class="th_description">Description</th>
5813 <th class="th_units">Units</th>
5814 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5815 <th class="th_tags">Tags</th>
5816 </tr>
5817 </thead>
5818
5819 <tbody>
5820
5821
5822
5823
5824
5825
5826
5827
5828
5829
5830 <tr class="entry" id="dynamic_android.hotPixel.mode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5831 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5832 android.<wbr/>hot<wbr/>Pixel.<wbr/>mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5833 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5834 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5835 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5836
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5837 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5838
5839 <ul class="entry_type_enum">
5840 <li>
5841 <span class="entry_type_enum_name">OFF</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]5842 <span class="entry_type_enum_notes"><p>No hot pixel correction can be
5843applied</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5844 </li>
5845 <li>
5846 <span class="entry_type_enum_name">FAST</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]5847 <span class="entry_type_enum_notes"><p>Frame rate must not be reduced compared to raw
5848Bayer output</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5849 </li>
5850 <li>
5851 <span class="entry_type_enum_name">HIGH_QUALITY</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]5852 <span class="entry_type_enum_notes"><p>Frame rate may be reduced by high
5853quality</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5854 </li>
5855 </ul>
5856
5857 </td> <!-- entry_type -->
5858
5859 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5860 <p>Set operational mode for hot pixel
5861correction</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5862 </td>
5863
5864 <td class="entry_units">
5865 </td>
5866
5867 <td class="entry_range">
5868 </td>
5869
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5870 <td class="entry_tags">
5871 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5872 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5873 </ul>
5874 </td>
5875
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5876 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5877
5878
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5879 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5880 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5881
5882
5883
5884 <!-- end of kind -->
5885 </tbody>
5886
5887 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5888 <tr><td colspan="6" id="section_jpeg" class="section">jpeg</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5889
5890
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5891 <tr><td colspan="6" class="kind">controls</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5892
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5893 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5894 <tr>
5895 <th class="th_name">Property Name</th>
5896 <th class="th_type">Type</th>
5897 <th class="th_description">Description</th>
5898 <th class="th_units">Units</th>
5899 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5900 <th class="th_tags">Tags</th>
5901 </tr>
5902 </thead>
5903
5904 <tbody>
5905
5906
5907
5908
5909
5910
5911
5912
5913
5914
5915 <tr class="entry" id="controls_android.jpeg.gpsCoordinates">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5916 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5917 android.<wbr/>jpeg.<wbr/>gps<wbr/>Coordinates
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5918 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5919 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5920 <span class="entry_type_name">double</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5921 <span class="entry_type_container">x</span>
5922
5923 <span class="entry_type_array">
5924 3
5925 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5926 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5927 <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]5928
5929
5930 </td> <!-- entry_type -->
5931
5932 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5933 <p>GPS coordinates to include in output JPEG
5934EXIF</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5935 </td>
5936
5937 <td class="entry_units">
5938 </td>
5939
5940 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]5941 <p>(-180 - 180],<wbr/> [-90,<wbr/>90],<wbr/> [-inf,<wbr/> inf]</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5942 </td>
5943
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5944 <td class="entry_tags">
5945 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5946 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5947 </ul>
5948 </td>
5949
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5950 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5951
5952
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5953 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5954 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5955
5956
5957 <tr class="entry" id="controls_android.jpeg.gpsProcessingMethod">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5958 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5959 android.<wbr/>jpeg.<wbr/>gps<wbr/>Processing<wbr/>Method
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5960 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5961 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5962 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5963
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]5964 <span class="entry_type_visibility"> [public as string]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5965
5966
5967 </td> <!-- entry_type -->
5968
5969 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5970 <p>32 characters describing GPS algorithm to
5971include in EXIF</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5972 </td>
5973
5974 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5975 UTF-8 null-terminated string
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5976 </td>
5977
5978 <td class="entry_range">
5979 </td>
5980
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5981 <td class="entry_tags">
5982 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5983 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5984 </ul>
5985 </td>
5986
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5987 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5988
5989
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5990 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5991 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5992
5993
5994 <tr class="entry" id="controls_android.jpeg.gpsTimestamp">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5995 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5996 android.<wbr/>jpeg.<wbr/>gps<wbr/>Timestamp
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5997 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5998 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5999 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6000
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6001 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6002
6003
6004 </td> <!-- entry_type -->
6005
6006 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6007 <p>Time GPS fix was made to include in
6008EXIF</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6009 </td>
6010
6011 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6012 UTC in seconds since January 1,<wbr/> 1970
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6013 </td>
6014
6015 <td class="entry_range">
6016 </td>
6017
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6018 <td class="entry_tags">
6019 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6020 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6021 </ul>
6022 </td>
6023
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6024 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6025
6026
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6027 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6028 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6029
6030
6031 <tr class="entry" id="controls_android.jpeg.orientation">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6032 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6033 android.<wbr/>jpeg.<wbr/>orientation
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6034 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6035 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6036 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6037
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6038 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6039
6040
6041 </td> <!-- entry_type -->
6042
6043 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6044 <p>Orientation of JPEG image to
6045write</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6046 </td>
6047
6048 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6049 Degrees in multiples of 90
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6050 </td>
6051
6052 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]6053 <p>0,<wbr/> 90,<wbr/> 180,<wbr/> 270</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6054 </td>
6055
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6056 <td class="entry_tags">
6057 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6058 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6059 </ul>
6060 </td>
6061
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6062 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6063
6064
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6065 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6066 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6067
6068
6069 <tr class="entry" id="controls_android.jpeg.quality">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6070 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6071 android.<wbr/>jpeg.<wbr/>quality
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6072 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6073 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6074 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6075
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6076 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6077
6078
6079 </td> <!-- entry_type -->
6080
6081 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6082 <p>Compression quality of the final JPEG
6083image</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6084 </td>
6085
6086 <td class="entry_units">
6087 </td>
6088
6089 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]6090 <p>1-100; larger is higher quality</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6091 </td>
6092
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6093 <td class="entry_tags">
6094 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6095 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6096 </ul>
6097 </td>
6098
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6099 </tr>
6100 <tr class="entries_header">
6101 <th class="th_details" colspan="5">Details</th>
6102 </tr>
6103 <tr class="entry_cont">
6104 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6105 <p>85-95 is typical usage range</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6106 </td>
6107 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6108
6109
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6110 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6111 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6112
6113
6114 <tr class="entry" id="controls_android.jpeg.thumbnailQuality">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6115 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6116 android.<wbr/>jpeg.<wbr/>thumbnail<wbr/>Quality
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6117 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6118 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6119 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6120
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6121 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6122
6123
6124 </td> <!-- entry_type -->
6125
6126 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6127 <p>Compression quality of JPEG
6128thumbnail</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6129 </td>
6130
6131 <td class="entry_units">
6132 </td>
6133
6134 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]6135 <p>1-100; larger is higher quality</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6136 </td>
6137
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6138 <td class="entry_tags">
6139 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6140 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6141 </ul>
6142 </td>
6143
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6144 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6145
6146
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6147 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6148 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6149
6150
6151 <tr class="entry" id="controls_android.jpeg.thumbnailSize">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6152 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6153 android.<wbr/>jpeg.<wbr/>thumbnail<wbr/>Size
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6154 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6155 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6156 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6157 <span class="entry_type_container">x</span>
6158
6159 <span class="entry_type_array">
6160 2
6161 </span>
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]6162 <span class="entry_type_visibility"> [public as size]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6163
6164
6165 </td> <!-- entry_type -->
6166
6167 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6168 <p>Resolution of embedded JPEG thumbnail</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6169 </td>
6170
6171 <td class="entry_units">
6172 </td>
6173
6174 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]6175 <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]6176 </td>
6177
6178 <td class="entry_tags">
6179 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6180 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6181 </ul>
6182 </td>
6183
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6184 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6185 <tr class="entries_header">
6186 <th class="th_details" colspan="5">Details</th>
6187 </tr>
6188 <tr class="entry_cont">
6189 <td class="entry_details" colspan="5">
Zhijun Hef90eeaf2014-01-16 12:13:35 -0800[diff] [blame]6190 <p>When set to (0,<wbr/> 0) value,<wbr/> the JPEG EXIF will not contain thumbnail,<wbr/>
6191but the captured JPEG will still be a valid image.<wbr/></p>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6192<p>When a jpeg image capture is issued,<wbr/> the thumbnail size selected should have
6193the same aspect ratio as the jpeg image.<wbr/></p>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6194 </td>
6195 </tr>
6196
6197
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6198 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6199 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6200
6201
6202
6203 <!-- end of kind -->
6204 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6205 <tr><td colspan="6" class="kind">static</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6206
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6207 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6208 <tr>
6209 <th class="th_name">Property Name</th>
6210 <th class="th_type">Type</th>
6211 <th class="th_description">Description</th>
6212 <th class="th_units">Units</th>
6213 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6214 <th class="th_tags">Tags</th>
6215 </tr>
6216 </thead>
6217
6218 <tbody>
6219
6220
6221
6222
6223
6224
6225
6226
6227
6228
6229 <tr class="entry" id="static_android.jpeg.availableThumbnailSizes">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6230 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6231 android.<wbr/>jpeg.<wbr/>available<wbr/>Thumbnail<wbr/>Sizes
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6232 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6233 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6234 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6235 <span class="entry_type_container">x</span>
6236
6237 <span class="entry_type_array">
6238 2 x n
6239 </span>
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]6240 <span class="entry_type_visibility"> [public as size]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6241
6242
6243 </td> <!-- entry_type -->
6244
6245 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6246 <p>Supported resolutions for the JPEG thumbnail</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6247 </td>
6248
6249 <td class="entry_units">
6250 </td>
6251
6252 <td class="entry_range">
Zhijun Hef90eeaf2014-01-16 12:13:35 -0800[diff] [blame]6253 <p>Will include at least one valid resolution,<wbr/> plus
6254(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]6255 </td>
6256
6257 <td class="entry_tags">
6258 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6259 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6260 </ul>
6261 </td>
6262
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6263 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6264 <tr class="entries_header">
6265 <th class="th_details" colspan="5">Details</th>
6266 </tr>
6267 <tr class="entry_cont">
6268 <td class="entry_details" colspan="5">
Zhijun Hef90eeaf2014-01-16 12:13:35 -0800[diff] [blame]6269 <p>Below condiditions will be satisfied for this size list:</p>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6270<ul>
Zhijun Hef90eeaf2014-01-16 12:13:35 -0800[diff] [blame]6271<li>The sizes will be sorted by increasing pixel area (width x height).<wbr/>
6272If several resolutions have the same area,<wbr/> they will be sorted by increasing width.<wbr/></li>
6273<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]6274aspect 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]6275The largest size is defined as the size that has the largest pixel area
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6276in a given size list.<wbr/></li>
Zhijun Hef90eeaf2014-01-16 12:13:35 -0800[diff] [blame]6277<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]6278one corresponding size that has the same aspect ratio in availableThumbnailSizes,<wbr/>
6279and vice versa.<wbr/></li>
Zhijun Hef90eeaf2014-01-16 12:13:35 -0800[diff] [blame]6280<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]6281</ul>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6282 </td>
6283 </tr>
6284
6285
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6286 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6287 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6288
6289
6290 <tr class="entry" id="static_android.jpeg.maxSize">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6291 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6292 android.<wbr/>jpeg.<wbr/>max<wbr/>Size
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6293 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6294 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6295 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6296
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6297 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6298
6299
6300 </td> <!-- entry_type -->
6301
6302 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6303 <p>Maximum size in bytes for the compressed
6304JPEG buffer</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6305 </td>
6306
6307 <td class="entry_units">
6308 </td>
6309
6310 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]6311 <p>Must be large enough to fit any JPEG produced by
6312the camera</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6313 </td>
6314
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6315 <td class="entry_tags">
6316 </td>
6317
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6318 </tr>
6319 <tr class="entries_header">
6320 <th class="th_details" colspan="5">Details</th>
6321 </tr>
6322 <tr class="entry_cont">
6323 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6324 <p>This is used for sizing the gralloc buffers for
6325JPEG</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6326 </td>
6327 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6328
6329
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6330 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6331 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6332
6333
6334
6335 <!-- end of kind -->
6336 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6337 <tr><td colspan="6" class="kind">dynamic</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6338
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6339 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6340 <tr>
6341 <th class="th_name">Property Name</th>
6342 <th class="th_type">Type</th>
6343 <th class="th_description">Description</th>
6344 <th class="th_units">Units</th>
6345 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6346 <th class="th_tags">Tags</th>
6347 </tr>
6348 </thead>
6349
6350 <tbody>
6351
6352
6353
6354
6355
6356
6357
6358
6359
6360
6361 <tr class="entry" id="dynamic_android.jpeg.gpsCoordinates">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6362 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6363 android.<wbr/>jpeg.<wbr/>gps<wbr/>Coordinates
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6364 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6365 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6366 <span class="entry_type_name">double</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6367 <span class="entry_type_container">x</span>
6368
6369 <span class="entry_type_array">
6370 3
6371 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6372 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6373 <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]6374
6375
6376 </td> <!-- entry_type -->
6377
6378 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6379 <p>GPS coordinates to include in output JPEG
6380EXIF</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6381 </td>
6382
6383 <td class="entry_units">
6384 </td>
6385
6386 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]6387 <p>(-180 - 180],<wbr/> [-90,<wbr/>90],<wbr/> [-inf,<wbr/> inf]</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6388 </td>
6389
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6390 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6391 <ul class="entry_tags">
6392 <li><a href="#tag_BC">BC</a></li>
6393 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6394 </td>
6395
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6396 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6397
6398
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6399 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6400 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6401
6402
6403 <tr class="entry" id="dynamic_android.jpeg.gpsProcessingMethod">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6404 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6405 android.<wbr/>jpeg.<wbr/>gps<wbr/>Processing<wbr/>Method
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6406 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6407 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6408 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6409
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]6410 <span class="entry_type_visibility"> [public as string]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6411
6412
6413 </td> <!-- entry_type -->
6414
6415 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6416 <p>32 characters describing GPS algorithm to
6417include in EXIF</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6418 </td>
6419
6420 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6421 UTF-8 null-terminated string
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6422 </td>
6423
6424 <td class="entry_range">
6425 </td>
6426
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6427 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6428 <ul class="entry_tags">
6429 <li><a href="#tag_BC">BC</a></li>
6430 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6431 </td>
6432
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6433 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6434
6435
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6436 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6437 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6438
6439
6440 <tr class="entry" id="dynamic_android.jpeg.gpsTimestamp">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6441 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6442 android.<wbr/>jpeg.<wbr/>gps<wbr/>Timestamp
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6443 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6444 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6445 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6446
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6447 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6448
6449
6450 </td> <!-- entry_type -->
6451
6452 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6453 <p>Time GPS fix was made to include in
6454EXIF</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6455 </td>
6456
6457 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6458 UTC in seconds since January 1,<wbr/> 1970
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6459 </td>
6460
6461 <td class="entry_range">
6462 </td>
6463
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6464 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6465 <ul class="entry_tags">
6466 <li><a href="#tag_BC">BC</a></li>
6467 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6468 </td>
6469
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6470 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6471
6472
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6473 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6474 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6475
6476
6477 <tr class="entry" id="dynamic_android.jpeg.orientation">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6478 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6479 android.<wbr/>jpeg.<wbr/>orientation
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6480 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6481 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6482 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6483
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6484 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6485
6486
6487 </td> <!-- entry_type -->
6488
6489 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6490 <p>Orientation of JPEG image to
6491write</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6492 </td>
6493
6494 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6495 Degrees in multiples of 90
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6496 </td>
6497
6498 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]6499 <p>0,<wbr/> 90,<wbr/> 180,<wbr/> 270</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6500 </td>
6501
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6502 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6503 <ul class="entry_tags">
6504 <li><a href="#tag_BC">BC</a></li>
6505 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6506 </td>
6507
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6508 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6509
6510
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6511 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6512 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6513
6514
6515 <tr class="entry" id="dynamic_android.jpeg.quality">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6516 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6517 android.<wbr/>jpeg.<wbr/>quality
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6518 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6519 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6520 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6521
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6522 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6523
6524
6525 </td> <!-- entry_type -->
6526
6527 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6528 <p>Compression quality of the final JPEG
6529image</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6530 </td>
6531
6532 <td class="entry_units">
6533 </td>
6534
6535 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]6536 <p>1-100; larger is higher quality</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6537 </td>
6538
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6539 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6540 <ul class="entry_tags">
6541 <li><a href="#tag_BC">BC</a></li>
6542 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6543 </td>
6544
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6545 </tr>
6546 <tr class="entries_header">
6547 <th class="th_details" colspan="5">Details</th>
6548 </tr>
6549 <tr class="entry_cont">
6550 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6551 <p>85-95 is typical usage range</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6552 </td>
6553 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6554
6555
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6556 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6557 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6558
6559
6560 <tr class="entry" id="dynamic_android.jpeg.size">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6561 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6562 android.<wbr/>jpeg.<wbr/>size
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6563 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6564 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6565 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6566
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6567 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6568
6569
6570 </td> <!-- entry_type -->
6571
6572 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6573 <p>The size of the compressed JPEG image,<wbr/> in
6574bytes</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6575 </td>
6576
6577 <td class="entry_units">
6578 </td>
6579
6580 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame]6581 <p>&gt;= 0</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6582 </td>
6583
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6584 <td class="entry_tags">
6585 </td>
6586
6587 </tr>
6588 <tr class="entries_header">
6589 <th class="th_details" colspan="5">Details</th>
6590 </tr>
6591 <tr class="entry_cont">
6592 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6593 <p>If no JPEG output is produced for the request,<wbr/>
6594this must be 0.<wbr/></p>
6595<p>Otherwise,<wbr/> this describes the real size of the compressed
6596JPEG image placed in the output stream.<wbr/> More specifically,<wbr/>
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]6597if <a href="#static_android.jpeg.maxSize">android.<wbr/>jpeg.<wbr/>max<wbr/>Size</a> = 1000000,<wbr/> and a specific capture
6598has <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]6599the JPEG stream will be 1000000 bytes,<wbr/> of which the first
6600500000 make up the real data.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6601 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6602 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6603
6604
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6605 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6606 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6607
6608
6609 <tr class="entry" id="dynamic_android.jpeg.thumbnailQuality">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6610 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6611 android.<wbr/>jpeg.<wbr/>thumbnail<wbr/>Quality
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6612 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6613 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6614 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6615
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6616 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6617
6618
6619 </td> <!-- entry_type -->
6620
6621 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6622 <p>Compression quality of JPEG
6623thumbnail</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6624 </td>
6625
6626 <td class="entry_units">
6627 </td>
6628
6629 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]6630 <p>1-100; larger is higher quality</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6631 </td>
6632
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6633 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6634 <ul class="entry_tags">
6635 <li><a href="#tag_BC">BC</a></li>
6636 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6637 </td>
6638
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6639 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6640
6641
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6642 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6643 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6644
6645
6646 <tr class="entry" id="dynamic_android.jpeg.thumbnailSize">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6647 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6648 android.<wbr/>jpeg.<wbr/>thumbnail<wbr/>Size
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6649 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6650 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6651 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6652 <span class="entry_type_container">x</span>
6653
6654 <span class="entry_type_array">
6655 2
6656 </span>
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]6657 <span class="entry_type_visibility"> [public as size]</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>Resolution of embedded JPEG thumbnail</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6664 </td>
6665
6666 <td class="entry_units">
6667 </td>
6668
6669 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]6670 <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]6671 </td>
6672
6673 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6674 <ul class="entry_tags">
6675 <li><a href="#tag_BC">BC</a></li>
6676 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6677 </td>
6678
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6679 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6680 <tr class="entries_header">
6681 <th class="th_details" colspan="5">Details</th>
6682 </tr>
6683 <tr class="entry_cont">
6684 <td class="entry_details" colspan="5">
Zhijun Hef90eeaf2014-01-16 12:13:35 -0800[diff] [blame]6685 <p>When set to (0,<wbr/> 0) value,<wbr/> the JPEG EXIF will not contain thumbnail,<wbr/>
6686but the captured JPEG will still be a valid image.<wbr/></p>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6687<p>When a jpeg image capture is issued,<wbr/> the thumbnail size selected should have
6688the same aspect ratio as the jpeg image.<wbr/></p>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6689 </td>
6690 </tr>
6691
6692
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6693 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6694 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6695
6696
6697
6698 <!-- end of kind -->
6699 </tbody>
6700
6701 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6702 <tr><td colspan="6" id="section_lens" class="section">lens</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6703
6704
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6705 <tr><td colspan="6" class="kind">controls</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6706
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6707 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6708 <tr>
6709 <th class="th_name">Property Name</th>
6710 <th class="th_type">Type</th>
6711 <th class="th_description">Description</th>
6712 <th class="th_units">Units</th>
6713 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6714 <th class="th_tags">Tags</th>
6715 </tr>
6716 </thead>
6717
6718 <tbody>
6719
6720
6721
6722
6723
6724
6725
6726
6727
6728
6729 <tr class="entry" id="controls_android.lens.aperture">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6730 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6731 android.<wbr/>lens.<wbr/>aperture
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6732 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6733 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6734 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6735
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6736 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6737
6738
6739 </td> <!-- entry_type -->
6740
6741 <td class="entry_description">
Zhijun He1b58d382014-01-10 10:22:53 -0800[diff] [blame]6742 <p>The ratio of lens focal length to the effective
6743aperture diameter.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6744 </td>
6745
6746 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6747 f-number (f/<wbr/>NNN)
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6748 </td>
6749
6750 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]6751 <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]6752 </td>
6753
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6754 <td class="entry_tags">
6755 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6756 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6757 </ul>
6758 </td>
6759
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]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">
Zhijun He1b58d382014-01-10 10:22:53 -0800[diff] [blame]6766 <p>This will only be supported on the camera devices that
6767have variable aperture lens.<wbr/> The aperture value can only be
6768one of the values listed in <a href="#static_android.lens.info.availableApertures">android.<wbr/>lens.<wbr/>info.<wbr/>available<wbr/>Apertures</a>.<wbr/></p>
6769<p>When this is supported and <a href="#controls_android.control.aeMode">android.<wbr/>control.<wbr/>ae<wbr/>Mode</a> is OFF,<wbr/>
6770this can be set along with <a href="#controls_android.sensor.exposureTime">android.<wbr/>sensor.<wbr/>exposure<wbr/>Time</a>,<wbr/>
6771<a href="#controls_android.sensor.sensitivity">android.<wbr/>sensor.<wbr/>sensitivity</a>,<wbr/> and android.<wbr/>sensor.<wbr/>frame<wbr/>Duration
6772to achieve manual exposure control.<wbr/></p>
6773<p>The requested aperture value may take several frames to reach the
6774requested value; the camera device will report the current (intermediate)
6775aperture size in capture result metadata while the aperture is changing.<wbr/></p>
6776<p>When this is supported and <a href="#controls_android.control.aeMode">android.<wbr/>control.<wbr/>ae<wbr/>Mode</a> is one of
6777the ON modes,<wbr/> this will be overridden by the camera device
6778auto-exposure algorithm,<wbr/> the overridden values are then provided
6779back to the user in the corresponding result.<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6780 </td>
6781 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6782
6783
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6784 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6785 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6786
6787
6788 <tr class="entry" id="controls_android.lens.filterDensity">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6789 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6790 android.<wbr/>lens.<wbr/>filter<wbr/>Density
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6791 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6792 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6793 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6794
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6795 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6796
6797
6798 </td> <!-- entry_type -->
6799
6800 <td class="entry_description">
Ruben Brunk83eb3032014-01-15 16:12:07 -0800[diff] [blame]6801 <p>State of lens neutral density filter(s).<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6802 </td>
6803
6804 <td class="entry_units">
Ruben Brunk83eb3032014-01-15 16:12:07 -0800[diff] [blame]6805 Steps of Exposure Value (EV).<wbr/>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6806 </td>
6807
6808 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]6809 <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]6810 </td>
6811
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6812 <td class="entry_tags">
6813 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6814 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6815 </ul>
6816 </td>
6817
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6818 </tr>
6819 <tr class="entries_header">
6820 <th class="th_details" colspan="5">Details</th>
6821 </tr>
6822 <tr class="entry_cont">
6823 <td class="entry_details" colspan="5">
Ruben Brunk83eb3032014-01-15 16:12:07 -0800[diff] [blame]6824 <p>This will not be supported on most camera devices.<wbr/> On devices
6825where this is supported,<wbr/> this may only be set to one of the
6826values included in <a href="#static_android.lens.info.availableFilterDensities">android.<wbr/>lens.<wbr/>info.<wbr/>available<wbr/>Filter<wbr/>Densities</a>.<wbr/></p>
6827<p>Lens filters are typically used to lower the amount of light the
6828sensor is exposed to (measured in steps of EV).<wbr/> As used here,<wbr/> an EV
6829step is the standard logarithmic representation,<wbr/> which are
6830non-negative,<wbr/> and inversely proportional to the amount of light
6831hitting the sensor.<wbr/> For example,<wbr/> setting this to 0 would result
6832in no reduction of the incoming light,<wbr/> and setting this to 2 would
6833mean that the filter is set to reduce incoming light by two stops
6834(allowing 1/<wbr/>4 of the prior amount of light to the sensor).<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6835 </td>
6836 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6837
6838
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6839 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6840 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6841
6842
6843 <tr class="entry" id="controls_android.lens.focalLength">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6844 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6845 android.<wbr/>lens.<wbr/>focal<wbr/>Length
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6846 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6847 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6848 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6849
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6850 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6851
6852
6853 </td> <!-- entry_type -->
6854
6855 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6856 <p>Lens optical zoom setting</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6857 </td>
6858
6859 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6860 focal length in mm
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6861 </td>
6862
6863 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame]6864 <p>&gt; 0</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6865 </td>
6866
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6867 <td class="entry_tags">
6868 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6869 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6870 </ul>
6871 </td>
6872
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6873 </tr>
6874 <tr class="entries_header">
6875 <th class="th_details" colspan="5">Details</th>
6876 </tr>
6877 <tr class="entry_cont">
6878 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6879 <p>Will not be supported on most devices.<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6880 </td>
6881 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6882
6883
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6884 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6885 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6886
6887
6888 <tr class="entry" id="controls_android.lens.focusDistance">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6889 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6890 android.<wbr/>lens.<wbr/>focus<wbr/>Distance
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6891 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6892 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6893 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6894
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6895 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6896
6897
6898 </td> <!-- entry_type -->
6899
6900 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6901 <p>Distance to plane of sharpest focus,<wbr/>
6902measured from frontmost surface of the lens</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6903 </td>
6904
6905 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6906 diopters (1/<wbr/>m)
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6907 </td>
6908
6909 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame]6910 <p>&gt;= 0</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6911 </td>
6912
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6913 <td class="entry_tags">
6914 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6915 <li><a href="#tag_BC">BC</a></li>
6916 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6917 </ul>
6918 </td>
6919
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6920 </tr>
6921 <tr class="entries_header">
6922 <th class="th_details" colspan="5">Details</th>
6923 </tr>
6924 <tr class="entry_cont">
6925 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6926 <p>0 = infinity focus.<wbr/> Used value should be clamped
6927to (0,<wbr/>minimum focus distance)</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6928 </td>
6929 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6930
6931
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6932 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6933 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6934
6935
6936 <tr class="entry" id="controls_android.lens.opticalStabilizationMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6937 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6938 android.<wbr/>lens.<wbr/>optical<wbr/>Stabilization<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6939 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6940 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6941 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6942
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6943 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6944
6945 <ul class="entry_type_enum">
6946 <li>
6947 <span class="entry_type_enum_name">OFF</span>
6948 </li>
6949 <li>
6950 <span class="entry_type_enum_name">ON</span>
6951 <span class="entry_type_enum_optional">optional</span>
6952 </li>
6953 </ul>
6954
6955 </td> <!-- entry_type -->
6956
6957 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6958 <p>Whether optical image stabilization is
6959enabled.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6960 </td>
6961
6962 <td class="entry_units">
6963 </td>
6964
6965 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]6966 <p>android.<wbr/>lens.<wbr/>available<wbr/>Optical<wbr/>Stabilization</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6967 </td>
6968
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6969 <td class="entry_tags">
6970 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6971 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6972 </ul>
6973 </td>
6974
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6975 </tr>
6976 <tr class="entries_header">
6977 <th class="th_details" colspan="5">Details</th>
6978 </tr>
6979 <tr class="entry_cont">
6980 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6981 <p>Will not be supported on most devices.<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6982 </td>
6983 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6984
6985
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6986 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6987 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6988
6989
6990
6991 <!-- end of kind -->
6992 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6993 <tr><td colspan="6" class="kind">static</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6994
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6995 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6996 <tr>
6997 <th class="th_name">Property Name</th>
6998 <th class="th_type">Type</th>
6999 <th class="th_description">Description</th>
7000 <th class="th_units">Units</th>
7001 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7002 <th class="th_tags">Tags</th>
7003 </tr>
7004 </thead>
7005
7006 <tbody>
7007
7008
7009
7010
7011
7012
7013
7014
7015
7016
7017
7018
7019 <tr class="entry" id="static_android.lens.info.availableApertures">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7020 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7021 android.<wbr/>lens.<wbr/>info.<wbr/>available<wbr/>Apertures
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7022 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7023 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7024 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7025 <span class="entry_type_container">x</span>
7026
7027 <span class="entry_type_array">
7028 n
7029 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7030 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7031
7032
7033 </td> <!-- entry_type -->
7034
7035 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7036 <p>List of supported aperture
Zhijun He1b58d382014-01-10 10:22:53 -0800[diff] [blame]7037values.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7038 </td>
7039
7040 <td class="entry_units">
7041 </td>
7042
7043 <td class="entry_range">
Zhijun He1b58d382014-01-10 10:22:53 -0800[diff] [blame]7044 <p>one entry required,<wbr/> &amp;&gt; 0</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7045 </td>
7046
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7047 <td class="entry_tags">
7048 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]7049 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7050 </ul>
7051 </td>
7052
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7053 </tr>
7054 <tr class="entries_header">
7055 <th class="th_details" colspan="5">Details</th>
7056 </tr>
7057 <tr class="entry_cont">
7058 <td class="entry_details" colspan="5">
Zhijun He1b58d382014-01-10 10:22:53 -0800[diff] [blame]7059 <p>If the camera device doesn't support variable apertures,<wbr/>
7060listed value will be the fixed aperture.<wbr/></p>
7061<p>If the camera device supports variable apertures,<wbr/> the aperture value
7062in this list will be sorted in ascending order.<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7063 </td>
7064 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7065
7066
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7067 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7068 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7069
7070
7071 <tr class="entry" id="static_android.lens.info.availableFilterDensities">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7072 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7073 android.<wbr/>lens.<wbr/>info.<wbr/>available<wbr/>Filter<wbr/>Densities
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7074 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7075 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7076 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7077 <span class="entry_type_container">x</span>
7078
7079 <span class="entry_type_array">
7080 n
7081 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7082 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7083
7084
7085 </td> <!-- entry_type -->
7086
7087 <td class="entry_description">
Ruben Brunk83eb3032014-01-15 16:12:07 -0800[diff] [blame]7088 <p>List of supported neutral density filter values for
7089<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]7090 </td>
7091
7092 <td class="entry_units">
7093 </td>
7094
7095 <td class="entry_range">
Ruben Brunk83eb3032014-01-15 16:12:07 -0800[diff] [blame]7096 <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]7097 </td>
7098
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7099 <td class="entry_tags">
7100 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]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">
Ruben Brunk83eb3032014-01-15 16:12:07 -0800[diff] [blame]7111 <p>If changing <a href="#controls_android.lens.filterDensity">android.<wbr/>lens.<wbr/>filter<wbr/>Density</a> is not supported,<wbr/>
7112availableFilterDensities must contain only 0.<wbr/> Otherwise,<wbr/> this
7113list contains only the exact filter density values available on
7114this camera device.<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7115 </td>
7116 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7117
7118
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7119 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7120 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7121
7122
7123 <tr class="entry" id="static_android.lens.info.availableFocalLengths">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7124 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7125 android.<wbr/>lens.<wbr/>info.<wbr/>available<wbr/>Focal<wbr/>Lengths
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7126 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7127 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7128 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7129 <span class="entry_type_container">x</span>
7130
7131 <span class="entry_type_array">
7132 n
7133 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7134 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7135 <div class="entry_type_notes">the list of available focal lengths</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7136
7137
7138 </td> <!-- entry_type -->
7139
7140 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7141 <p>If fitted with optical zoom,<wbr/> what focal
7142lengths are available.<wbr/> If not,<wbr/> the static focal
7143length</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7144 </td>
7145
7146 <td class="entry_units">
7147 </td>
7148
7149 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame]7150 <p>&gt; 0</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7151 </td>
7152
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7153 <td class="entry_tags">
7154 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]7155 <li><a href="#tag_BC">BC</a></li>
7156 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7157 </ul>
7158 </td>
7159
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7160 </tr>
7161 <tr class="entries_header">
7162 <th class="th_details" colspan="5">Details</th>
7163 </tr>
7164 <tr class="entry_cont">
7165 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7166 <p>If optical zoom not supported,<wbr/> only one value
7167should be reported</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7168 </td>
7169 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7170
7171
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7172 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7173 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7174
7175
7176 <tr class="entry" id="static_android.lens.info.availableOpticalStabilization">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7177 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7178 android.<wbr/>lens.<wbr/>info.<wbr/>available<wbr/>Optical<wbr/>Stabilization
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7179 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7180 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7181 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7182 <span class="entry_type_container">x</span>
7183
7184 <span class="entry_type_array">
7185 n
7186 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7187 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7188 <div class="entry_type_notes">list of enums</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7189
7190
7191 </td> <!-- entry_type -->
7192
7193 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7194 <p>List of supported optical image
7195stabilization modes</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7196 </td>
7197
7198 <td class="entry_units">
7199 </td>
7200
7201 <td class="entry_range">
7202 </td>
7203
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7204 <td class="entry_tags">
7205 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]7206 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7207 </ul>
7208 </td>
7209
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7210 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7211
7212
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7213 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7214 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7215
7216
7217 <tr class="entry" id="static_android.lens.info.geometricCorrectionMap">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7218 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7219 android.<wbr/>lens.<wbr/>info.<wbr/>geometric<wbr/>Correction<wbr/>Map
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7220 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7221 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7222 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7223 <span class="entry_type_container">x</span>
7224
7225 <span class="entry_type_array">
7226 2 x 3 x n x m
7227 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7228 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7229 <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]7230
7231
7232 </td> <!-- entry_type -->
7233
7234 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7235 <p>A low-resolution map for correction of
7236geometric distortions and chromatic aberrations,<wbr/> per
7237color channel</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7238 </td>
7239
7240 <td class="entry_units">
7241 </td>
7242
7243 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]7244 <p>N,<wbr/> M &gt;= 2</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7245 </td>
7246
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7247 <td class="entry_tags">
7248 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]7249 <li><a href="#tag_DNG">DNG</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7250 </ul>
7251 </td>
7252
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7253 </tr>
7254 <tr class="entries_header">
7255 <th class="th_details" colspan="5">Details</th>
7256 </tr>
7257 <tr class="entry_cont">
7258 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7259 <p>[DNG wants a function instead].<wbr/> What's easiest
7260for implementers? With an array size (M,<wbr/> N),<wbr/> entry (i,<wbr/>
7261j) provides the destination for pixel (i/<wbr/>(M-1) * width,<wbr/>
7262j/<wbr/>(N-1) * height).<wbr/> Data is row-major,<wbr/> with each array
7263entry 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]7264 </td>
7265 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7266
7267
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7268 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7269 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7270
7271
7272 <tr class="entry" id="static_android.lens.info.geometricCorrectionMapSize">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7273 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7274 android.<wbr/>lens.<wbr/>info.<wbr/>geometric<wbr/>Correction<wbr/>Map<wbr/>Size
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7275 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7276 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7277 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7278 <span class="entry_type_container">x</span>
7279
7280 <span class="entry_type_array">
7281 2
7282 </span>
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]7283 <span class="entry_type_visibility"> [system as size]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7284 <div class="entry_type_notes">width and height of geometric correction map</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7285
7286
7287 </td> <!-- entry_type -->
7288
7289 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7290 <p>Dimensions of geometric correction
7291map</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7292 </td>
7293
7294 <td class="entry_units">
7295 </td>
7296
7297 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]7298 <p>Both values &gt;= 2</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7299 </td>
7300
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7301 <td class="entry_tags">
7302 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]7303 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7304 </ul>
7305 </td>
7306
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7307 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7308
7309
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7310 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7311 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7312
7313
7314 <tr class="entry" id="static_android.lens.info.hyperfocalDistance">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7315 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7316 android.<wbr/>lens.<wbr/>info.<wbr/>hyperfocal<wbr/>Distance
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7317 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7318 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7319 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7320
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7321 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7322
7323
7324 </td> <!-- entry_type -->
7325
7326 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7327 <p>Hyperfocal distance for this lens; set to
73280 if fixed focus</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7329 </td>
7330
7331 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7332 diopters
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7333 </td>
7334
7335 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame]7336 <p>&gt;= 0</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7337 </td>
7338
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7339 <td class="entry_tags">
7340 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]7341 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7342 </ul>
7343 </td>
7344
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7345 </tr>
7346 <tr class="entries_header">
7347 <th class="th_details" colspan="5">Details</th>
7348 </tr>
7349 <tr class="entry_cont">
7350 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7351 <p>The hyperfocal distance is used for the old
7352API's 'fixed' setting</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7353 </td>
7354 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7355
7356
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7357 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7358 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7359
7360
7361 <tr class="entry" id="static_android.lens.info.minimumFocusDistance">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7362 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7363 android.<wbr/>lens.<wbr/>info.<wbr/>minimum<wbr/>Focus<wbr/>Distance
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7364 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7365 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7366 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7367
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7368 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7369
7370
7371 </td> <!-- entry_type -->
7372
7373 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7374 <p>Shortest distance from frontmost surface
7375of the lens that can be focused correctly</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7376 </td>
7377
7378 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7379 diopters
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7380 </td>
7381
7382 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame]7383 <p>&gt;= 0</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7384 </td>
7385
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7386 <td class="entry_tags">
7387 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]7388 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7389 </ul>
7390 </td>
7391
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7392 </tr>
7393 <tr class="entries_header">
7394 <th class="th_details" colspan="5">Details</th>
7395 </tr>
7396 <tr class="entry_cont">
7397 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7398 <p>If the lens is fixed-focus,<wbr/> this should be
73990</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7400 </td>
7401 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7402
7403
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7404 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7405 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7406
7407
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7408 <tr class="entry" id="static_android.lens.info.shadingMapSize">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7409 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7410 android.<wbr/>lens.<wbr/>info.<wbr/>shading<wbr/>Map<wbr/>Size
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7411 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7412 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7413 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7414 <span class="entry_type_container">x</span>
7415
7416 <span class="entry_type_array">
7417 2
7418 </span>
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]7419 <span class="entry_type_visibility"> [public as size]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7420 <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]7421
7422
7423 </td> <!-- entry_type -->
7424
7425 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7426 <p>Dimensions of lens shading map.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7427 </td>
7428
7429 <td class="entry_units">
7430 </td>
7431
7432 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]7433 <p>Both values &gt;= 1</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7434 </td>
7435
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7436 <td class="entry_tags">
7437 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]7438 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7439 </ul>
7440 </td>
7441
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7442 </tr>
7443 <tr class="entries_header">
7444 <th class="th_details" colspan="5">Details</th>
7445 </tr>
7446 <tr class="entry_cont">
7447 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7448 <p>The map should be on the order of 30-40 rows and columns,<wbr/> and
7449must be smaller than 64x64.<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7450 </td>
7451 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7452
7453
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7454 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7455 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7456
7457
7458
7459
7460
7461 <tr class="entry" id="static_android.lens.facing">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7462 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7463 android.<wbr/>lens.<wbr/>facing
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7464 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7465 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7466 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7467
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7468 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7469
7470 <ul class="entry_type_enum">
7471 <li>
7472 <span class="entry_type_enum_name">FRONT</span>
7473 </li>
7474 <li>
7475 <span class="entry_type_enum_name">BACK</span>
7476 </li>
7477 </ul>
7478
7479 </td> <!-- entry_type -->
7480
7481 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7482 <p>Direction the camera faces relative to
7483device screen</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7484 </td>
7485
7486 <td class="entry_units">
7487 </td>
7488
7489 <td class="entry_range">
7490 </td>
7491
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7492 <td class="entry_tags">
7493 </td>
7494
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7495 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7496
7497
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7498 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7499 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7500
7501
7502 <tr class="entry" id="static_android.lens.opticalAxisAngle">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7503 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7504 android.<wbr/>lens.<wbr/>optical<wbr/>Axis<wbr/>Angle
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7505 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7506 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7507 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7508 <span class="entry_type_container">x</span>
7509
7510 <span class="entry_type_array">
7511 2
7512 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7513 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7514 <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]7515
7516
7517 </td> <!-- entry_type -->
7518
7519 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7520 <p>Relative angle of camera optical axis to the
7521perpendicular axis from the display</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7522 </td>
7523
7524 <td class="entry_units">
7525 </td>
7526
7527 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]7528 <p>[0-90) for first angle,<wbr/> [0-360) for second</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7529 </td>
7530
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7531 <td class="entry_tags">
7532 <ul class="entry_tags">
7533 <li><a href="#tag_ADV">ADV</a></li>
7534 </ul>
7535 </td>
7536
7537 </tr>
7538 <tr class="entries_header">
7539 <th class="th_details" colspan="5">Details</th>
7540 </tr>
7541 <tr class="entry_cont">
7542 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7543 <p>Examples:</p>
7544<p>(0,<wbr/>0) means that the camera optical axis
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]7545is perpendicular to the display surface;</p>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7546<p>(45,<wbr/>0) means that the camera points 45 degrees up when
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]7547device is held upright;</p>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7548<p>(45,<wbr/>90) means the camera points 45 degrees to the right when
7549the device is held upright.<wbr/></p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]7550<p>Use FACING field to determine perpendicular outgoing
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7551direction</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7552 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7553 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7554
7555
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7556 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7557 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7558
7559
7560 <tr class="entry" id="static_android.lens.position">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7561 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7562 android.<wbr/>lens.<wbr/>position
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7563 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7564 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7565 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7566 <span class="entry_type_container">x</span>
7567
7568 <span class="entry_type_array">
7569 3, location in mm, in the sensor coordinate
7570 system
7571 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7572 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7573
7574
7575 </td> <!-- entry_type -->
7576
7577 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7578 <p>Coordinates of camera optical axis on
7579device</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7580 </td>
7581
7582 <td class="entry_units">
7583 </td>
7584
7585 <td class="entry_range">
7586 </td>
7587
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7588 <td class="entry_tags">
7589 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]7590 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7591 </ul>
7592 </td>
7593
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7594 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7595
7596
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7597 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7598 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7599
7600
7601
7602 <!-- end of kind -->
7603 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7604 <tr><td colspan="6" class="kind">dynamic</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7605
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7606 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7607 <tr>
7608 <th class="th_name">Property Name</th>
7609 <th class="th_type">Type</th>
7610 <th class="th_description">Description</th>
7611 <th class="th_units">Units</th>
7612 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7613 <th class="th_tags">Tags</th>
7614 </tr>
7615 </thead>
7616
7617 <tbody>
7618
7619
7620
7621
7622
7623
7624
7625
7626
7627
7628 <tr class="entry" id="dynamic_android.lens.aperture">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7629 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7630 android.<wbr/>lens.<wbr/>aperture
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7631 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7632 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7633 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7634
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7635 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7636
7637
7638 </td> <!-- entry_type -->
7639
7640 <td class="entry_description">
Zhijun He1b58d382014-01-10 10:22:53 -0800[diff] [blame]7641 <p>The ratio of lens focal length to the effective
7642aperture diameter.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7643 </td>
7644
7645 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7646 f-number (f/<wbr/>NNN)
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7647 </td>
7648
7649 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]7650 <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]7651 </td>
7652
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7653 <td class="entry_tags">
7654 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]7655 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7656 </ul>
7657 </td>
7658
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7659 </tr>
7660 <tr class="entries_header">
7661 <th class="th_details" colspan="5">Details</th>
7662 </tr>
7663 <tr class="entry_cont">
7664 <td class="entry_details" colspan="5">
Zhijun He1b58d382014-01-10 10:22:53 -0800[diff] [blame]7665 <p>This will only be supported on the camera devices that
7666have variable aperture lens.<wbr/> The aperture value can only be
7667one of the values listed in <a href="#static_android.lens.info.availableApertures">android.<wbr/>lens.<wbr/>info.<wbr/>available<wbr/>Apertures</a>.<wbr/></p>
7668<p>When this is supported and <a href="#controls_android.control.aeMode">android.<wbr/>control.<wbr/>ae<wbr/>Mode</a> is OFF,<wbr/>
7669this can be set along with <a href="#controls_android.sensor.exposureTime">android.<wbr/>sensor.<wbr/>exposure<wbr/>Time</a>,<wbr/>
7670<a href="#controls_android.sensor.sensitivity">android.<wbr/>sensor.<wbr/>sensitivity</a>,<wbr/> and android.<wbr/>sensor.<wbr/>frame<wbr/>Duration
7671to achieve manual exposure control.<wbr/></p>
7672<p>The requested aperture value may take several frames to reach the
7673requested value; the camera device will report the current (intermediate)
7674aperture size in capture result metadata while the aperture is changing.<wbr/></p>
7675<p>When this is supported and <a href="#controls_android.control.aeMode">android.<wbr/>control.<wbr/>ae<wbr/>Mode</a> is one of
7676the ON modes,<wbr/> this will be overridden by the camera device
7677auto-exposure algorithm,<wbr/> the overridden values are then provided
7678back to the user in the corresponding result.<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7679 </td>
7680 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7681
7682
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7683 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7684 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7685
7686
7687 <tr class="entry" id="dynamic_android.lens.filterDensity">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7688 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7689 android.<wbr/>lens.<wbr/>filter<wbr/>Density
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7690 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7691 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7692 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7693
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7694 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7695
7696
7697 </td> <!-- entry_type -->
7698
7699 <td class="entry_description">
Ruben Brunk83eb3032014-01-15 16:12:07 -0800[diff] [blame]7700 <p>State of lens neutral density filter(s).<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7701 </td>
7702
7703 <td class="entry_units">
Ruben Brunk83eb3032014-01-15 16:12:07 -0800[diff] [blame]7704 Steps of Exposure Value (EV).<wbr/>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7705 </td>
7706
7707 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]7708 <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]7709 </td>
7710
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7711 <td class="entry_tags">
7712 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]7713 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7714 </ul>
7715 </td>
7716
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7717 </tr>
7718 <tr class="entries_header">
7719 <th class="th_details" colspan="5">Details</th>
7720 </tr>
7721 <tr class="entry_cont">
7722 <td class="entry_details" colspan="5">
Ruben Brunk83eb3032014-01-15 16:12:07 -0800[diff] [blame]7723 <p>This will not be supported on most camera devices.<wbr/> On devices
7724where this is supported,<wbr/> this may only be set to one of the
7725values included in <a href="#static_android.lens.info.availableFilterDensities">android.<wbr/>lens.<wbr/>info.<wbr/>available<wbr/>Filter<wbr/>Densities</a>.<wbr/></p>
7726<p>Lens filters are typically used to lower the amount of light the
7727sensor is exposed to (measured in steps of EV).<wbr/> As used here,<wbr/> an EV
7728step is the standard logarithmic representation,<wbr/> which are
7729non-negative,<wbr/> and inversely proportional to the amount of light
7730hitting the sensor.<wbr/> For example,<wbr/> setting this to 0 would result
7731in no reduction of the incoming light,<wbr/> and setting this to 2 would
7732mean that the filter is set to reduce incoming light by two stops
7733(allowing 1/<wbr/>4 of the prior amount of light to the sensor).<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7734 </td>
7735 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7736
7737
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7738 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7739 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7740
7741
7742 <tr class="entry" id="dynamic_android.lens.focalLength">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7743 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7744 android.<wbr/>lens.<wbr/>focal<wbr/>Length
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7745 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7746 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7747 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7748
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7749 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7750
7751
7752 </td> <!-- entry_type -->
7753
7754 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7755 <p>Lens optical zoom setting</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7756 </td>
7757
7758 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7759 focal length in mm
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7760 </td>
7761
7762 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame]7763 <p>&gt; 0</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7764 </td>
7765
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7766 <td class="entry_tags">
7767 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]7768 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7769 </ul>
7770 </td>
7771
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7772 </tr>
7773 <tr class="entries_header">
7774 <th class="th_details" colspan="5">Details</th>
7775 </tr>
7776 <tr class="entry_cont">
7777 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7778 <p>Will not be supported on most devices.<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7779 </td>
7780 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7781
7782
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7783 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7784 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7785
7786
7787 <tr class="entry" id="dynamic_android.lens.focusDistance">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7788 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7789 android.<wbr/>lens.<wbr/>focus<wbr/>Distance
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7790 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7791 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7792 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7793
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7794 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7795
7796
7797 </td> <!-- entry_type -->
7798
7799 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7800 <p>Distance to plane of sharpest focus,<wbr/>
7801measured from frontmost surface of the lens</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7802 </td>
7803
7804 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7805 diopters (1/<wbr/>m)
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7806 </td>
7807
7808 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame]7809 <p>&gt;= 0</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7810 </td>
7811
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7812 <td class="entry_tags">
7813 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]7814 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7815 </ul>
7816 </td>
7817
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7818 </tr>
7819 <tr class="entries_header">
7820 <th class="th_details" colspan="5">Details</th>
7821 </tr>
7822 <tr class="entry_cont">
7823 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7824 <p>Should be zero for fixed-focus cameras</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7825 </td>
7826 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7827
7828
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7829 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7830 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7831
7832
7833 <tr class="entry" id="dynamic_android.lens.focusRange">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7834 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7835 android.<wbr/>lens.<wbr/>focus<wbr/>Range
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7836 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7837 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7838 <span class="entry_type_name">float</span>
Zhijun He50451ad2013-09-26 10:27:47 -0700[diff] [blame]7839 <span class="entry_type_container">x</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7840
Zhijun He50451ad2013-09-26 10:27:47 -0700[diff] [blame]7841 <span class="entry_type_array">
7842 2
7843 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7844 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7845 <div class="entry_type_notes">Range of scene distances that are in focus</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7846
7847
7848 </td> <!-- entry_type -->
7849
7850 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7851 <p>The range of scene distances that are in
7852sharp focus (depth of field)</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7853 </td>
7854
7855 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7856 pair of focus distances in diopters: (near,<wbr/>
7857 far)
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7858 </td>
7859
7860 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame]7861 <p>&gt;=0</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7862 </td>
7863
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7864 <td class="entry_tags">
7865 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]7866 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7867 </ul>
7868 </td>
7869
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7870 </tr>
7871 <tr class="entries_header">
7872 <th class="th_details" colspan="5">Details</th>
7873 </tr>
7874 <tr class="entry_cont">
7875 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7876 <p>If variable focus not supported,<wbr/> can still report
7877fixed depth of field range</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7878 </td>
7879 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7880
7881
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7882 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7883 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7884
7885
7886 <tr class="entry" id="dynamic_android.lens.opticalStabilizationMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7887 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7888 android.<wbr/>lens.<wbr/>optical<wbr/>Stabilization<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7889 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7890 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7891 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7892
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7893 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7894
7895 <ul class="entry_type_enum">
7896 <li>
7897 <span class="entry_type_enum_name">OFF</span>
7898 </li>
7899 <li>
7900 <span class="entry_type_enum_name">ON</span>
7901 <span class="entry_type_enum_optional">optional</span>
7902 </li>
7903 </ul>
7904
7905 </td> <!-- entry_type -->
7906
7907 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7908 <p>Whether optical image stabilization is
7909enabled.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7910 </td>
7911
7912 <td class="entry_units">
7913 </td>
7914
7915 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]7916 <p>android.<wbr/>lens.<wbr/>available<wbr/>Optical<wbr/>Stabilization</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7917 </td>
7918
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7919 <td class="entry_tags">
7920 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]7921 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7922 </ul>
7923 </td>
7924
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7925 </tr>
7926 <tr class="entries_header">
7927 <th class="th_details" colspan="5">Details</th>
7928 </tr>
7929 <tr class="entry_cont">
7930 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7931 <p>Will not be supported on most devices.<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7932 </td>
7933 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7934
7935
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7936 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7937 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7938
7939
7940 <tr class="entry" id="dynamic_android.lens.state">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7941 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7942 android.<wbr/>lens.<wbr/>state
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7943 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7944 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7945 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7946
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7947 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7948
7949 <ul class="entry_type_enum">
7950 <li>
7951 <span class="entry_type_enum_name">STATIONARY</span>
7952 </li>
Igor Murashkin0e323a12013-09-06 11:50:48 -0700[diff] [blame]7953 <li>
7954 <span class="entry_type_enum_name">MOVING</span>
7955 </li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7956 </ul>
7957
7958 </td> <!-- entry_type -->
7959
7960 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7961 <p>Current lens status</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7962 </td>
7963
7964 <td class="entry_units">
7965 </td>
7966
7967 <td class="entry_range">
7968 </td>
7969
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7970 <td class="entry_tags">
7971 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]7972 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7973 </ul>
7974 </td>
7975
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7976 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7977
7978
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7979 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7980 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7981
7982
7983
7984 <!-- end of kind -->
7985 </tbody>
7986
7987 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7988 <tr><td colspan="6" id="section_noiseReduction" class="section">noiseReduction</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7989
7990
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7991 <tr><td colspan="6" class="kind">controls</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7992
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7993 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7994 <tr>
7995 <th class="th_name">Property Name</th>
7996 <th class="th_type">Type</th>
7997 <th class="th_description">Description</th>
7998 <th class="th_units">Units</th>
7999 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8000 <th class="th_tags">Tags</th>
8001 </tr>
8002 </thead>
8003
8004 <tbody>
8005
8006
8007
8008
8009
8010
8011
8012
8013
8014
8015 <tr class="entry" id="controls_android.noiseReduction.mode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8016 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8017 android.<wbr/>noise<wbr/>Reduction.<wbr/>mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8018 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8019 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8020 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8021
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8022 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8023
8024 <ul class="entry_type_enum">
8025 <li>
8026 <span class="entry_type_enum_name">OFF</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]8027 <span class="entry_type_enum_notes"><p>No noise reduction is applied</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8028 </li>
8029 <li>
8030 <span class="entry_type_enum_name">FAST</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]8031 <span class="entry_type_enum_notes"><p>Must not slow down frame rate relative to sensor
8032output</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8033 </li>
8034 <li>
8035 <span class="entry_type_enum_name">HIGH_QUALITY</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]8036 <span class="entry_type_enum_notes"><p>May slow down frame rate to provide highest
8037quality</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8038 </li>
8039 </ul>
8040
8041 </td> <!-- entry_type -->
8042
8043 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8044 <p>Mode of operation for the noise reduction
8045algorithm</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8046 </td>
8047
8048 <td class="entry_units">
8049 </td>
8050
8051 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]8052 <p>android.<wbr/>noise<wbr/>Reduction.<wbr/>available<wbr/>Modes</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8053 </td>
8054
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8055 <td class="entry_tags">
8056 <ul class="entry_tags">
8057 <li><a href="#tag_V1">V1</a></li>
8058 </ul>
8059 </td>
8060
8061 </tr>
8062 <tr class="entries_header">
8063 <th class="th_details" colspan="5">Details</th>
8064 </tr>
8065 <tr class="entry_cont">
8066 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8067 <p>Noise filtering control.<wbr/> OFF means no noise reduction
8068will be applied by the HAL.<wbr/></p>
Zhijun Hef90eeaf2014-01-16 12:13:35 -0800[diff] [blame]8069<p>FAST/<wbr/>HIGH_<wbr/>QUALITY both mean camera device determined noise filtering
8070will be applied.<wbr/> HIGH_<wbr/>QUALITY mode indicates that the camera device
8071will use the highest-quality noise filtering algorithms,<wbr/>
8072even if it slows down capture rate.<wbr/> FAST means the camera device should not
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8073slow down capture rate when applying noise filtering.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8074 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8075 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8076
8077
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8078 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8079 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8080
8081
8082 <tr class="entry" id="controls_android.noiseReduction.strength">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8083 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8084 android.<wbr/>noise<wbr/>Reduction.<wbr/>strength
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8085 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8086 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8087 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8088
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8089 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8090
8091
8092 </td> <!-- entry_type -->
8093
8094 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8095 <p>Control the amount of noise reduction
8096applied to the images</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8097 </td>
8098
8099 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8100 1-10; 10 is max noise reduction
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8101 </td>
8102
8103 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]8104 <p>1 - 10</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8105 </td>
8106
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8107 <td class="entry_tags">
8108 </td>
8109
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8110 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8111
8112
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8113 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8114 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8115
8116
8117
8118 <!-- end of kind -->
8119 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8120 <tr><td colspan="6" class="kind">dynamic</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8121
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8122 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8123 <tr>
8124 <th class="th_name">Property Name</th>
8125 <th class="th_type">Type</th>
8126 <th class="th_description">Description</th>
8127 <th class="th_units">Units</th>
8128 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8129 <th class="th_tags">Tags</th>
8130 </tr>
8131 </thead>
8132
8133 <tbody>
8134
8135
8136
8137
8138
8139
8140
8141
8142
8143
8144 <tr class="entry" id="dynamic_android.noiseReduction.mode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8145 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8146 android.<wbr/>noise<wbr/>Reduction.<wbr/>mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8147 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8148 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8149 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8150
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8151 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8152
8153 <ul class="entry_type_enum">
8154 <li>
8155 <span class="entry_type_enum_name">OFF</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]8156 <span class="entry_type_enum_notes"><p>No noise reduction is applied</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8157 </li>
8158 <li>
8159 <span class="entry_type_enum_name">FAST</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]8160 <span class="entry_type_enum_notes"><p>Must not slow down frame rate relative to sensor
8161output</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8162 </li>
8163 <li>
8164 <span class="entry_type_enum_name">HIGH_QUALITY</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]8165 <span class="entry_type_enum_notes"><p>May slow down frame rate to provide highest
8166quality</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8167 </li>
8168 </ul>
8169
8170 </td> <!-- entry_type -->
8171
8172 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8173 <p>Mode of operation for the noise reduction
8174algorithm</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8175 </td>
8176
8177 <td class="entry_units">
8178 </td>
8179
8180 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]8181 <p>android.<wbr/>noise<wbr/>Reduction.<wbr/>available<wbr/>Modes</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8182 </td>
8183
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8184 <td class="entry_tags">
8185 <ul class="entry_tags">
8186 <li><a href="#tag_V1">V1</a></li>
8187 </ul>
8188 </td>
8189
8190 </tr>
8191 <tr class="entries_header">
8192 <th class="th_details" colspan="5">Details</th>
8193 </tr>
8194 <tr class="entry_cont">
8195 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8196 <p>Noise filtering control.<wbr/> OFF means no noise reduction
8197will be applied by the HAL.<wbr/></p>
Zhijun Hef90eeaf2014-01-16 12:13:35 -0800[diff] [blame]8198<p>FAST/<wbr/>HIGH_<wbr/>QUALITY both mean camera device determined noise filtering
8199will be applied.<wbr/> HIGH_<wbr/>QUALITY mode indicates that the camera device
8200will use the highest-quality noise filtering algorithms,<wbr/>
8201even if it slows down capture rate.<wbr/> FAST means the camera device should not
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8202slow down capture rate when applying noise filtering.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8203 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8204 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8205
8206
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8207 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8208 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8209
8210
8211
8212 <!-- end of kind -->
8213 </tbody>
8214
8215 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8216 <tr><td colspan="6" id="section_quirks" class="section">quirks</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8217
8218
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8219 <tr><td colspan="6" class="kind">static</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8220
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8221 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8222 <tr>
8223 <th class="th_name">Property Name</th>
8224 <th class="th_type">Type</th>
8225 <th class="th_description">Description</th>
8226 <th class="th_units">Units</th>
8227 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8228 <th class="th_tags">Tags</th>
8229 </tr>
8230 </thead>
8231
8232 <tbody>
8233
8234
8235
8236
8237
8238
8239
8240
8241
8242
8243 <tr class="entry" id="static_android.quirks.meteringCropRegion">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8244 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8245 android.<wbr/>quirks.<wbr/>metering<wbr/>Crop<wbr/>Region
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8246 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8247 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8248 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8249
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8250 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8251
8252
8253 </td> <!-- entry_type -->
8254
8255 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8256 <p>If set to 1,<wbr/> the camera service does not
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]8257scale 'normalized' coordinates with respect to the crop
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8258region.<wbr/> This applies to metering input (a{e,<wbr/>f,<wbr/>wb}Region
8259and output (face rectangles).<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8260 </td>
8261
8262 <td class="entry_units">
8263 </td>
8264
8265 <td class="entry_range">
8266 </td>
8267
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8268 <td class="entry_tags">
8269 </td>
8270
8271 </tr>
8272 <tr class="entries_header">
8273 <th class="th_details" colspan="5">Details</th>
8274 </tr>
8275 <tr class="entry_cont">
8276 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8277 <p>Normalized coordinates refer to those in the
8278(-1000,<wbr/>1000) range mentioned in the
8279android.<wbr/>hardware.<wbr/>Camera API.<wbr/></p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]8280<p>HAL implementations should instead always use and emit
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8281sensor array-relative coordinates for all region data.<wbr/> Does
8282not need to be listed in static metadata.<wbr/> Support will be
8283removed in future versions of camera service.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8284 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8285 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8286
8287
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8288 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8289 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8290
8291
8292 <tr class="entry" id="static_android.quirks.triggerAfWithAuto">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8293 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8294 android.<wbr/>quirks.<wbr/>trigger<wbr/>Af<wbr/>With<wbr/>Auto
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8295 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8296 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8297 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8298
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8299 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8300
8301
8302 </td> <!-- entry_type -->
8303
8304 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8305 <p>If set to 1,<wbr/> then the camera service always
8306switches to FOCUS_<wbr/>MODE_<wbr/>AUTO before issuing a AF
8307trigger.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8308 </td>
8309
8310 <td class="entry_units">
8311 </td>
8312
8313 <td class="entry_range">
8314 </td>
8315
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8316 <td class="entry_tags">
8317 </td>
8318
8319 </tr>
8320 <tr class="entries_header">
8321 <th class="th_details" colspan="5">Details</th>
8322 </tr>
8323 <tr class="entry_cont">
8324 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8325 <p>HAL implementations should implement AF trigger
8326modes for AUTO,<wbr/> MACRO,<wbr/> CONTINUOUS_<wbr/>FOCUS,<wbr/> and
8327CONTINUOUS_<wbr/>PICTURE modes instead of using this flag.<wbr/> Does
8328not need to be listed in static metadata.<wbr/> Support will be
8329removed in future versions of camera service</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8330 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8331 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8332
8333
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8334 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8335 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8336
8337
8338 <tr class="entry" id="static_android.quirks.useZslFormat">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8339 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8340 android.<wbr/>quirks.<wbr/>use<wbr/>Zsl<wbr/>Format
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8341 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8342 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8343 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8344
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8345 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8346
8347
8348 </td> <!-- entry_type -->
8349
8350 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8351 <p>If set to 1,<wbr/> the camera service uses
8352CAMERA2_<wbr/>PIXEL_<wbr/>FORMAT_<wbr/>ZSL instead of
8353HAL_<wbr/>PIXEL_<wbr/>FORMAT_<wbr/>IMPLEMENTATION_<wbr/>DEFINED for the zero
8354shutter lag stream</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8355 </td>
8356
8357 <td class="entry_units">
8358 </td>
8359
8360 <td class="entry_range">
8361 </td>
8362
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8363 <td class="entry_tags">
8364 </td>
8365
8366 </tr>
8367 <tr class="entries_header">
8368 <th class="th_details" colspan="5">Details</th>
8369 </tr>
8370 <tr class="entry_cont">
8371 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8372 <p>HAL implementations should use gralloc usage flags
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]8373to determine that a stream will be used for
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8374zero-shutter-lag,<wbr/> instead of relying on an explicit
8375format setting.<wbr/> Does not need to be listed in static
8376metadata.<wbr/> Support will be removed in future versions of
8377camera service.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8378 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8379 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8380
8381
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8382 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8383 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8384
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]8385
8386 <tr class="entry" id="static_android.quirks.usePartialResult">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8387 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8388 android.<wbr/>quirks.<wbr/>use<wbr/>Partial<wbr/>Result
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8389 </td>
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]8390 <td class="entry_type">
8391 <span class="entry_type_name">byte</span>
8392
Eino-Ville Talvala52a64a52013-11-07 14:43:43 -0800[diff] [blame]8393 <span class="entry_type_visibility"> [hidden]</span>
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]8394
8395
8396 </td> <!-- entry_type -->
8397
8398 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8399 <p>If set to 1,<wbr/> the HAL will always split result
8400metadata for a single capture into multiple buffers,<wbr/>
8401returned using multiple process_<wbr/>capture_<wbr/>result calls.<wbr/></p>
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]8402 </td>
8403
8404 <td class="entry_units">
8405 </td>
8406
8407 <td class="entry_range">
8408 </td>
8409
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8410 <td class="entry_tags">
8411 </td>
8412
8413 </tr>
8414 <tr class="entries_header">
8415 <th class="th_details" colspan="5">Details</th>
8416 </tr>
8417 <tr class="entry_cont">
8418 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8419 <p>Does not need to be listed in static
8420metadata.<wbr/> Support for partial results will be reworked in
8421future versions of camera service.<wbr/> This quirk will stop
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]8422working at that point; DO NOT USE without careful
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8423consideration of future support.<wbr/></p>
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]8424 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8425 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8426
8427
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8428 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8429 <!-- end of entry -->
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]8430
8431
8432
8433 <!-- end of kind -->
8434 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8435 <tr><td colspan="6" class="kind">dynamic</td></tr>
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]8436
8437 <thead class="entries_header">
8438 <tr>
8439 <th class="th_name">Property Name</th>
8440 <th class="th_type">Type</th>
8441 <th class="th_description">Description</th>
8442 <th class="th_units">Units</th>
8443 <th class="th_range">Range</th>
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]8444 <th class="th_tags">Tags</th>
8445 </tr>
8446 </thead>
8447
8448 <tbody>
8449
8450
8451
8452
8453
8454
8455
8456
8457
8458
8459 <tr class="entry" id="dynamic_android.quirks.partialResult">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8460 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8461 android.<wbr/>quirks.<wbr/>partial<wbr/>Result
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8462 </td>
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]8463 <td class="entry_type">
8464 <span class="entry_type_name entry_type_name_enum">byte</span>
8465
Eino-Ville Talvala52a64a52013-11-07 14:43:43 -0800[diff] [blame]8466 <span class="entry_type_visibility"> [hidden as boolean]</span>
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]8467
8468 <ul class="entry_type_enum">
8469 <li>
8470 <span class="entry_type_enum_name">FINAL</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]8471 <span class="entry_type_enum_notes"><p>The last or only metadata result buffer
8472for this capture.<wbr/></p></span>
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]8473 </li>
8474 <li>
8475 <span class="entry_type_enum_name">PARTIAL</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]8476 <span class="entry_type_enum_notes"><p>A partial buffer of result metadata for this
8477capture.<wbr/> More result buffers for this capture will be sent
8478by the HAL,<wbr/> the last of which will be marked
8479FINAL.<wbr/></p></span>
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]8480 </li>
8481 </ul>
8482
8483 </td> <!-- entry_type -->
8484
8485 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8486 <p>Whether a result given to the framework is the
8487final one for the capture,<wbr/> or only a partial that contains a
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]8488subset of the full set of dynamic metadata
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8489values.<wbr/></p>
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]8490 </td>
8491
8492 <td class="entry_units">
8493 </td>
8494
8495 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]8496 <p>Optional.<wbr/> Default value is FINAL.<wbr/></p>
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]8497 </td>
8498
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8499 <td class="entry_tags">
8500 </td>
8501
8502 </tr>
8503 <tr class="entries_header">
8504 <th class="th_details" colspan="5">Details</th>
8505 </tr>
8506 <tr class="entry_cont">
8507 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8508 <p>The entries in the result metadata buffers for a
8509single capture may not overlap,<wbr/> except for this entry.<wbr/> The
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]8510FINAL buffers must retain FIFO ordering relative to the
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8511requests that generate them,<wbr/> so the FINAL buffer for frame 3 must
8512always be sent to the framework after the FINAL buffer for frame 2,<wbr/> and
8513before the FINAL buffer for frame 4.<wbr/> PARTIAL buffers may be returned
8514in any order relative to other frames,<wbr/> but all PARTIAL buffers for a given
8515capture must arrive before the FINAL buffer for that capture.<wbr/> This entry may
8516only 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]8517 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8518 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8519
8520
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8521 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8522 <!-- end of entry -->
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]8523
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8524
8525
8526 <!-- end of kind -->
8527 </tbody>
8528
8529 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8530 <tr><td colspan="6" id="section_request" class="section">request</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8531
8532
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8533 <tr><td colspan="6" class="kind">controls</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8534
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8535 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8536 <tr>
8537 <th class="th_name">Property Name</th>
8538 <th class="th_type">Type</th>
8539 <th class="th_description">Description</th>
8540 <th class="th_units">Units</th>
8541 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8542 <th class="th_tags">Tags</th>
8543 </tr>
8544 </thead>
8545
8546 <tbody>
8547
8548
8549
8550
8551
8552
8553
8554
8555
8556
8557 <tr class="entry" id="controls_android.request.frameCount">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8558 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8559 android.<wbr/>request.<wbr/>frame<wbr/>Count
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8560 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8561 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8562 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8563
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8564 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8565
8566
8567 </td> <!-- entry_type -->
8568
8569 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8570 <p>A frame counter set by the framework.<wbr/> Must
8571be maintained unchanged in output frame.<wbr/> This value monotonically
8572increases with every new result (that is,<wbr/> each new result has a unique
8573frameCount value).<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8574 </td>
8575
8576 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8577 incrementing integer
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8578 </td>
8579
8580 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]8581 <p>Any int</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8582 </td>
8583
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8584 <td class="entry_tags">
8585 </td>
8586
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8587 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8588
8589
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8590 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8591 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8592
8593
8594 <tr class="entry" id="controls_android.request.id">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8595 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8596 android.<wbr/>request.<wbr/>id
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8597 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8598 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8599 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8600
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8601 <span class="entry_type_visibility"> [hidden]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8602
8603
8604 </td> <!-- entry_type -->
8605
8606 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8607 <p>An application-specified ID for the current
8608request.<wbr/> Must be maintained unchanged in output
8609frame</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8610 </td>
8611
8612 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8613 arbitrary integer assigned by application
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8614 </td>
8615
8616 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]8617 <p>Any int</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8618 </td>
8619
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8620 <td class="entry_tags">
8621 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]8622 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8623 </ul>
8624 </td>
8625
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8626 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8627
8628
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8629 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8630 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8631
8632
8633 <tr class="entry" id="controls_android.request.inputStreams">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8634 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8635 android.<wbr/>request.<wbr/>input<wbr/>Streams
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8636 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8637 <td class="entry_type">
Zhijun Hee36cdbe2013-09-06 14:28:37 -0700[diff] [blame]8638 <span class="entry_type_name">int32</span>
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]8639 <span class="entry_type_container">x</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8640
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]8641 <span class="entry_type_array">
8642 n
8643 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8644 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8645
8646
8647 </td> <!-- entry_type -->
8648
8649 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8650 <p>List which camera reprocess stream is used
8651for the source of reprocessing data.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8652 </td>
8653
8654 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8655 List of camera reprocess stream IDs
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8656 </td>
8657
8658 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]8659 <p>Typically,<wbr/> only one entry allowed,<wbr/> must be a valid
8660reprocess stream ID.<wbr/></p>
8661<p>If android.<wbr/>jpeg.<wbr/>needs<wbr/>Thumbnail is set,<wbr/> then multiple
8662reprocess streams may be included in a single request; they
8663must be different scaled versions of the same image.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8664 </td>
8665
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8666 <td class="entry_tags">
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]8667 <ul class="entry_tags">
8668 <li><a href="#tag_HAL2">HAL2</a></li>
8669 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8670 </td>
8671
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8672 </tr>
8673 <tr class="entries_header">
8674 <th class="th_details" colspan="5">Details</th>
8675 </tr>
8676 <tr class="entry_cont">
8677 <td class="entry_details" colspan="5">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]8678 <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]8679REPROCESS.<wbr/> Ignored otherwise</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8680 </td>
8681 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8682
8683
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8684 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8685 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8686
8687
8688 <tr class="entry" id="controls_android.request.metadataMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8689 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8690 android.<wbr/>request.<wbr/>metadata<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8691 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8692 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8693 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8694
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8695 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8696
8697 <ul class="entry_type_enum">
8698 <li>
8699 <span class="entry_type_enum_name">NONE</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]8700 <span class="entry_type_enum_notes"><p>No metadata should be produced on output,<wbr/> except
8701for application-bound buffer data.<wbr/> If no
8702application-bound streams exist,<wbr/> no frame should be
8703placed in the output frame queue.<wbr/> If such streams
8704exist,<wbr/> a frame should be placed on the output queue
8705with null metadata but with the necessary output buffer
8706information.<wbr/> Timestamp information should still be
8707included with any output stream buffers</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8708 </li>
8709 <li>
8710 <span class="entry_type_enum_name">FULL</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]8711 <span class="entry_type_enum_notes"><p>All metadata should be produced.<wbr/> Statistics will
8712only be produced if they are separately
8713enabled</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8714 </li>
8715 </ul>
8716
8717 </td> <!-- entry_type -->
8718
8719 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8720 <p>How much metadata to produce on
8721output</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8722 </td>
8723
8724 <td class="entry_units">
8725 </td>
8726
8727 <td class="entry_range">
8728 </td>
8729
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8730 <td class="entry_tags">
8731 </td>
8732
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8733 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8734
8735
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8736 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8737 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8738
8739
8740 <tr class="entry" id="controls_android.request.outputStreams">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8741 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8742 android.<wbr/>request.<wbr/>output<wbr/>Streams
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8743 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8744 <td class="entry_type">
Zhijun Hee36cdbe2013-09-06 14:28:37 -0700[diff] [blame]8745 <span class="entry_type_name">int32</span>
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]8746 <span class="entry_type_container">x</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8747
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]8748 <span class="entry_type_array">
8749 n
8750 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8751 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8752
8753
8754 </td> <!-- entry_type -->
8755
8756 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8757 <p>Lists which camera output streams image data
8758from this capture must be sent to</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8759 </td>
8760
8761 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8762 List of camera stream IDs
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8763 </td>
8764
8765 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]8766 <p>List must only include streams that have been
8767created</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8768 </td>
8769
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8770 <td class="entry_tags">
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]8771 <ul class="entry_tags">
8772 <li><a href="#tag_HAL2">HAL2</a></li>
8773 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8774 </td>
8775
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8776 </tr>
8777 <tr class="entries_header">
8778 <th class="th_details" colspan="5">Details</th>
8779 </tr>
8780 <tr class="entry_cont">
8781 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8782 <p>If no output streams are listed,<wbr/> then the image
8783data should simply be discarded.<wbr/> The image data must
8784still be captured for metadata and statistics production,<wbr/>
8785and the lens and flash must operate as requested.<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8786 </td>
8787 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8788
8789
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8790 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8791 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8792
8793
8794 <tr class="entry" id="controls_android.request.type">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8795 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8796 android.<wbr/>request.<wbr/>type
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8797 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8798 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8799 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8800
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8801 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8802
8803 <ul class="entry_type_enum">
8804 <li>
8805 <span class="entry_type_enum_name">CAPTURE</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]8806 <span class="entry_type_enum_notes"><p>Capture a new image from the imaging hardware,<wbr/>
8807and process it according to the
8808settings</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8809 </li>
8810 <li>
8811 <span class="entry_type_enum_name">REPROCESS</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]8812 <span class="entry_type_enum_notes"><p>Process previously captured data; the
8813android.<wbr/>request.<wbr/>input<wbr/>Stream parameter determines the
8814source reprocessing stream.<wbr/> TODO: Mark dynamic metadata
8815needed for reprocessing with [RP]</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8816 </li>
8817 </ul>
8818
8819 </td> <!-- entry_type -->
8820
8821 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8822 <p>The type of the request; either CAPTURE or
8823REPROCESS.<wbr/> For HAL3,<wbr/> this tag is redundant.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8824 </td>
8825
8826 <td class="entry_units">
8827 </td>
8828
8829 <td class="entry_range">
8830 </td>
8831
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8832 <td class="entry_tags">
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]8833 <ul class="entry_tags">
8834 <li><a href="#tag_HAL2">HAL2</a></li>
8835 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8836 </td>
8837
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8838 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8839
8840
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8841 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8842 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8843
8844
8845
8846 <!-- end of kind -->
8847 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8848 <tr><td colspan="6" class="kind">static</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8849
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8850 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8851 <tr>
8852 <th class="th_name">Property Name</th>
8853 <th class="th_type">Type</th>
8854 <th class="th_description">Description</th>
8855 <th class="th_units">Units</th>
8856 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8857 <th class="th_tags">Tags</th>
8858 </tr>
8859 </thead>
8860
8861 <tbody>
8862
8863
8864
8865
8866
8867
8868
8869
8870
8871
8872 <tr class="entry" id="static_android.request.maxNumOutputStreams">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8873 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8874 android.<wbr/>request.<wbr/>max<wbr/>Num<wbr/>Output<wbr/>Streams
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8875 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8876 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8877 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8878 <span class="entry_type_container">x</span>
8879
8880 <span class="entry_type_array">
8881 3
8882 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8883 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8884
8885
8886 </td> <!-- entry_type -->
8887
8888 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8889 <p>How many output streams can be allocated at
8890the same time for each type of stream</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8891 </td>
8892
8893 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8894 The number of raw sensor streams; the number of
8895 processed,<wbr/> uncompressed streams; and the number of
8896 JPEG-compressed streams
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8897 </td>
8898
8899 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame]8900 <p>&gt;=1 for Raw and JPEG-compressed stream.<wbr/> &gt;= 3
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]8901for processed,<wbr/> uncompressed streams</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8902 </td>
8903
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8904 <td class="entry_tags">
8905 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]8906 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8907 </ul>
8908 </td>
8909
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8910 </tr>
8911 <tr class="entries_header">
8912 <th class="th_details" colspan="5">Details</th>
8913 </tr>
8914 <tr class="entry_cont">
8915 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8916 <p>Video snapshot with preview callbacks requires 3
8917processed streams (preview,<wbr/> record,<wbr/> app callbacks) and
8918one JPEG stream (snapshot)</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8919 </td>
8920 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8921
8922
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8923 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8924 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8925
8926
8927 <tr class="entry" id="static_android.request.maxNumReprocessStreams">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8928 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8929 android.<wbr/>request.<wbr/>max<wbr/>Num<wbr/>Reprocess<wbr/>Streams
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8930 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8931 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8932 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8933 <span class="entry_type_container">x</span>
8934
8935 <span class="entry_type_array">
8936 1
8937 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8938 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8939
8940
8941 </td> <!-- entry_type -->
8942
8943 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8944 <p>How many reprocessing streams of any type
8945can be allocated at the same time</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8946 </td>
8947
8948 <td class="entry_units">
8949 </td>
8950
8951 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame]8952 <p>&gt;= 1</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8953 </td>
8954
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8955 <td class="entry_tags">
8956 </td>
8957
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8958 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8959
8960
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8961 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8962 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8963
8964
8965
8966 <!-- end of kind -->
8967 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8968 <tr><td colspan="6" class="kind">dynamic</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8969
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8970 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8971 <tr>
8972 <th class="th_name">Property Name</th>
8973 <th class="th_type">Type</th>
8974 <th class="th_description">Description</th>
8975 <th class="th_units">Units</th>
8976 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8977 <th class="th_tags">Tags</th>
8978 </tr>
8979 </thead>
8980
8981 <tbody>
8982
8983
8984
8985
8986
8987
8988
8989
8990
8991
8992 <tr class="entry" id="dynamic_android.request.frameCount">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8993 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8994 android.<wbr/>request.<wbr/>frame<wbr/>Count
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8995 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8996 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8997 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8998
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8999 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9000
9001
9002 </td> <!-- entry_type -->
9003
9004 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9005 <p>A frame counter set by the framework.<wbr/> This value monotonically
9006increases with every new result (that is,<wbr/> each new result has a unique
9007frameCount value).<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9008 </td>
9009
9010 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9011 count of frames
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9012 </td>
9013
9014 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame]9015 <p>&gt; 0</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9016 </td>
9017
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9018 <td class="entry_tags">
9019 </td>
9020
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9021 </tr>
9022 <tr class="entries_header">
9023 <th class="th_details" colspan="5">Details</th>
9024 </tr>
9025 <tr class="entry_cont">
9026 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9027 <p>Reset on release()</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9028 </td>
9029 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9030
9031
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9032 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9033 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9034
9035
9036 <tr class="entry" id="dynamic_android.request.id">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9037 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9038 android.<wbr/>request.<wbr/>id
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9039 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9040 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9041 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9042
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9043 <span class="entry_type_visibility"> [hidden]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9044
9045
9046 </td> <!-- entry_type -->
9047
9048 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9049 <p>An application-specified ID for the current
9050request.<wbr/> Must be maintained unchanged in output
9051frame</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9052 </td>
9053
9054 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9055 arbitrary integer assigned by application
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9056 </td>
9057
9058 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]9059 <p>Any int</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9060 </td>
9061
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9062 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9063 <ul class="entry_tags">
9064 <li><a href="#tag_V1">V1</a></li>
9065 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9066 </td>
9067
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9068 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9069
9070
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9071 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9072 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9073
9074
9075 <tr class="entry" id="dynamic_android.request.metadataMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9076 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9077 android.<wbr/>request.<wbr/>metadata<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9078 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9079 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9080 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9081
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9082 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9083
9084 <ul class="entry_type_enum">
9085 <li>
9086 <span class="entry_type_enum_name">NONE</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]9087 <span class="entry_type_enum_notes"><p>No metadata should be produced on output,<wbr/> except
9088for application-bound buffer data.<wbr/> If no
9089application-bound streams exist,<wbr/> no frame should be
9090placed in the output frame queue.<wbr/> If such streams
9091exist,<wbr/> a frame should be placed on the output queue
9092with null metadata but with the necessary output buffer
9093information.<wbr/> Timestamp information should still be
9094included with any output stream buffers</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9095 </li>
9096 <li>
9097 <span class="entry_type_enum_name">FULL</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]9098 <span class="entry_type_enum_notes"><p>All metadata should be produced.<wbr/> Statistics will
9099only be produced if they are separately
9100enabled</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9101 </li>
9102 </ul>
9103
9104 </td> <!-- entry_type -->
9105
9106 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9107 <p>How much metadata to produce on
9108output</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9109 </td>
9110
9111 <td class="entry_units">
9112 </td>
9113
9114 <td class="entry_range">
9115 </td>
9116
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9117 <td class="entry_tags">
9118 </td>
9119
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9120 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9121
9122
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9123 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9124 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9125
9126
9127 <tr class="entry" id="dynamic_android.request.outputStreams">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9128 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9129 android.<wbr/>request.<wbr/>output<wbr/>Streams
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9130 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9131 <td class="entry_type">
Zhijun Hee36cdbe2013-09-06 14:28:37 -0700[diff] [blame]9132 <span class="entry_type_name">int32</span>
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]9133 <span class="entry_type_container">x</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9134
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]9135 <span class="entry_type_array">
9136 n
9137 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9138 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9139
9140
9141 </td> <!-- entry_type -->
9142
9143 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9144 <p>Lists which camera output streams image data
9145from this capture must be sent to</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9146 </td>
9147
9148 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9149 List of camera stream IDs
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9150 </td>
9151
9152 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]9153 <p>List must only include streams that have been
9154created</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9155 </td>
9156
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9157 <td class="entry_tags">
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]9158 <ul class="entry_tags">
9159 <li><a href="#tag_HAL2">HAL2</a></li>
9160 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9161 </td>
9162
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9163 </tr>
9164 <tr class="entries_header">
9165 <th class="th_details" colspan="5">Details</th>
9166 </tr>
9167 <tr class="entry_cont">
9168 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9169 <p>If no output streams are listed,<wbr/> then the image
9170data should simply be discarded.<wbr/> The image data must
9171still be captured for metadata and statistics production,<wbr/>
9172and the lens and flash must operate as requested.<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9173 </td>
9174 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9175
9176
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9177 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9178 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9179
9180
9181
9182 <!-- end of kind -->
9183 </tbody>
9184
9185 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9186 <tr><td colspan="6" id="section_scaler" class="section">scaler</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9187
9188
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9189 <tr><td colspan="6" class="kind">controls</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9190
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9191 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9192 <tr>
9193 <th class="th_name">Property Name</th>
9194 <th class="th_type">Type</th>
9195 <th class="th_description">Description</th>
9196 <th class="th_units">Units</th>
9197 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9198 <th class="th_tags">Tags</th>
9199 </tr>
9200 </thead>
9201
9202 <tbody>
9203
9204
9205
9206
9207
9208
9209
9210
9211
9212
9213 <tr class="entry" id="controls_android.scaler.cropRegion">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9214 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9215 android.<wbr/>scaler.<wbr/>crop<wbr/>Region
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9216 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9217 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9218 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9219 <span class="entry_type_container">x</span>
9220
9221 <span class="entry_type_array">
Eino-Ville Talvalae04ec6e2013-04-16 15:35:18 -0700[diff] [blame]9222 4
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9223 </span>
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]9224 <span class="entry_type_visibility"> [public as rectangle]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9225
9226
9227 </td> <!-- entry_type -->
9228
9229 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9230 <p>(x,<wbr/> y,<wbr/> width,<wbr/> height).<wbr/></p>
9231<p>A rectangle with the top-level corner of (x,<wbr/>y) and size
9232(width,<wbr/> height).<wbr/> The region of the sensor that is used for
9233output.<wbr/> Each stream must use this rectangle to produce its
9234output,<wbr/> cropping to a smaller region if necessary to
9235maintain the stream's aspect ratio.<wbr/></p>
9236<p>HAL2.<wbr/>x uses only (x,<wbr/> y,<wbr/> width)</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9237 </td>
9238
9239 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9240 (x,<wbr/>y) of top-left corner,<wbr/> width and height of region
9241 in pixels; (0,<wbr/>0) is top-left corner of
9242 android.<wbr/>sensor.<wbr/>active<wbr/>Array<wbr/>Size
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9243 </td>
9244
9245 <td class="entry_range">
9246 </td>
9247
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9248 <td class="entry_tags">
9249 <ul class="entry_tags">
9250 <li><a href="#tag_BC">BC</a></li>
9251 </ul>
9252 </td>
9253
9254 </tr>
9255 <tr class="entries_header">
9256 <th class="th_details" colspan="5">Details</th>
9257 </tr>
9258 <tr class="entry_cont">
9259 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9260 <p>Any additional per-stream cropping must be done to
9261maximize the final pixel area of the stream.<wbr/></p>
9262<p>For example,<wbr/> if the crop region is set to a 4:3 aspect
9263ratio,<wbr/> then 4:3 streams should use the exact crop
9264region.<wbr/> 16:9 streams should further crop vertically
9265(letterbox).<wbr/></p>
9266<p>Conversely,<wbr/> if the crop region is set to a 16:9,<wbr/> then 4:3
9267outputs should crop horizontally (pillarbox),<wbr/> and 16:9
9268streams should match exactly.<wbr/> These additional crops must
9269be centered within the crop region.<wbr/></p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]9270<p>The output streams must maintain square pixels at all
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9271times,<wbr/> no matter what the relative aspect ratios of the
9272crop region and the stream are.<wbr/> Negative values for
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]9273corner are allowed for raw output if full pixel array is
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9274larger than active pixel array.<wbr/> Width and height may be
9275rounded to nearest larger supportable width,<wbr/> especially
9276for raw output,<wbr/> where only a few fixed scales may be
9277possible.<wbr/> The width and height of the crop region cannot
9278be set to be smaller than floor( activeArraySize.<wbr/>width /<wbr/>
9279android.<wbr/>scaler.<wbr/>max<wbr/>Digital<wbr/>Zoom ) and floor(
9280activeArraySize.<wbr/>height /<wbr/> android.<wbr/>scaler.<wbr/>max<wbr/>Digital<wbr/>Zoom),<wbr/>
9281respectively.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9282 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9283 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9284
9285
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9286 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9287 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9288
9289
9290
9291 <!-- end of kind -->
9292 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9293 <tr><td colspan="6" class="kind">static</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9294
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9295 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9296 <tr>
9297 <th class="th_name">Property Name</th>
9298 <th class="th_type">Type</th>
9299 <th class="th_description">Description</th>
9300 <th class="th_units">Units</th>
9301 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9302 <th class="th_tags">Tags</th>
9303 </tr>
9304 </thead>
9305
9306 <tbody>
9307
9308
9309
9310
9311
9312
9313
9314
9315
9316
9317 <tr class="entry" id="static_android.scaler.availableFormats">
Zhijun Heb8317e22014-01-16 09:47:07 -0800[diff] [blame]9318 <td class="entry_name" rowspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9319 android.<wbr/>scaler.<wbr/>available<wbr/>Formats
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9320 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9321 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9322 <span class="entry_type_name entry_type_name_enum">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9323 <span class="entry_type_container">x</span>
9324
9325 <span class="entry_type_array">
9326 n
9327 </span>
Eino-Ville Talvalad4e240a2013-08-08 12:56:37 -0700[diff] [blame]9328 <span class="entry_type_visibility"> [public as imageFormat]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9329
9330 <ul class="entry_type_enum">
9331 <li>
9332 <span class="entry_type_enum_name">RAW_SENSOR</span>
Zhijun Heb8317e22014-01-16 09:47:07 -0800[diff] [blame]9333 <span class="entry_type_enum_optional">optional</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9334 <span class="entry_type_enum_value">0x20</span>
9335 </li>
9336 <li>
9337 <span class="entry_type_enum_name">YV12</span>
Zhijun Heb8317e22014-01-16 09:47:07 -0800[diff] [blame]9338 <span class="entry_type_enum_optional">optional</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9339 <span class="entry_type_enum_value">0x32315659</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]9340 <span class="entry_type_enum_notes"><p>YCrCb 4:2:0 Planar</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9341 </li>
9342 <li>
Zhijun Hec2eebff2013-05-16 17:49:35 -0700[diff] [blame]9343 <span class="entry_type_enum_name">YCrCb_420_SP</span>
Zhijun Heb8317e22014-01-16 09:47:07 -0800[diff] [blame]9344 <span class="entry_type_enum_optional">optional</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9345 <span class="entry_type_enum_value">0x11</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]9346 <span class="entry_type_enum_notes"><p>NV21</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9347 </li>
9348 <li>
Zhijun Hec2eebff2013-05-16 17:49:35 -0700[diff] [blame]9349 <span class="entry_type_enum_name">IMPLEMENTATION_DEFINED</span>
9350 <span class="entry_type_enum_value">0x22</span>
Zhijun Heb8317e22014-01-16 09:47:07 -0800[diff] [blame]9351 <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]9352 </li>
9353 <li>
9354 <span class="entry_type_enum_name">YCbCr_420_888</span>
9355 <span class="entry_type_enum_value">0x23</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]9356 <span class="entry_type_enum_notes"><p>Flexible YUV420 Format</p></span>
Zhijun Hec2eebff2013-05-16 17:49:35 -0700[diff] [blame]9357 </li>
9358 <li>
9359 <span class="entry_type_enum_name">BLOB</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9360 <span class="entry_type_enum_value">0x21</span>
Zhijun Heb8317e22014-01-16 09:47:07 -0800[diff] [blame]9361 <span class="entry_type_enum_notes"><p>JPEG format</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9362 </li>
9363 </ul>
9364
9365 </td> <!-- entry_type -->
9366
9367 <td class="entry_description">
Zhijun Heb8317e22014-01-16 09:47:07 -0800[diff] [blame]9368 <p>The list of image formats that are supported by this
9369camera device.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9370 </td>
9371
9372 <td class="entry_units">
9373 </td>
9374
9375 <td class="entry_range">
9376 </td>
9377
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9378 <td class="entry_tags">
9379 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9380 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9381 </ul>
9382 </td>
9383
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9384 </tr>
Zhijun Heb8317e22014-01-16 09:47:07 -0800[diff] [blame]9385 <tr class="entries_header">
9386 <th class="th_details" colspan="5">Details</th>
9387 </tr>
9388 <tr class="entry_cont">
9389 <td class="entry_details" colspan="5">
9390 <p>All camera devices will support JPEG and YUV_<wbr/>420_<wbr/>888 formats.<wbr/></p>
9391<p>When set to YUV_<wbr/>420_<wbr/>888,<wbr/> application can access the YUV420 data directly.<wbr/></p>
9392 </td>
9393 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9394
Zhijun Heb8317e22014-01-16 09:47:07 -0800[diff] [blame]9395 <tr class="entries_header">
9396 <th class="th_details" colspan="5">HAL Implementation Details</th>
9397 </tr>
9398 <tr class="entry_cont">
9399 <td class="entry_details" colspan="5">
9400 <p>These format values are from HAL_<wbr/>PIXEL_<wbr/>FORMAT_<wbr/>* in
9401system/<wbr/>core/<wbr/>include/<wbr/>system/<wbr/>graphics.<wbr/>h.<wbr/></p>
9402<p>When IMPLEMENTATION_<wbr/>DEFINED is used,<wbr/> the platform
9403gralloc module will select a format based on the usage flags provided
9404by the camera HAL device and the other endpoint of the stream.<wbr/> It is
9405usually used by preview and recording streams,<wbr/> where the application doesn't
9406need access the image data.<wbr/></p>
9407<p>YCb<wbr/>Cr_<wbr/>420_<wbr/>888 format must be supported by the HAL.<wbr/> When an image stream
9408needs CPU/<wbr/>application direct access,<wbr/> this format will be used.<wbr/></p>
9409<p>The BLOB format must be supported by the HAL.<wbr/> This is used for the JPEG stream.<wbr/></p>
9410 </td>
9411 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9412
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9413 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9414 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9415
9416
9417 <tr class="entry" id="static_android.scaler.availableJpegMinDurations">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9418 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9419 android.<wbr/>scaler.<wbr/>available<wbr/>Jpeg<wbr/>Min<wbr/>Durations
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9420 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9421 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9422 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9423 <span class="entry_type_container">x</span>
9424
9425 <span class="entry_type_array">
9426 n
9427 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9428 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9429
9430
9431 </td> <!-- entry_type -->
9432
9433 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9434 <p>The minimum frame duration that is supported
Igor Murashkin10f4e0f2014-01-13 17:22:58 -0800[diff] [blame]9435for 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]9436 </td>
9437
9438 <td class="entry_units">
Igor Murashkin10f4e0f2014-01-13 17:22:58 -0800[diff] [blame]9439 ns
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9440 </td>
9441
9442 <td class="entry_range">
9443 </td>
9444
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9445 <td class="entry_tags">
9446 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9447 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9448 </ul>
9449 </td>
9450
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9451 </tr>
9452 <tr class="entries_header">
9453 <th class="th_details" colspan="5">Details</th>
9454 </tr>
9455 <tr class="entry_cont">
9456 <td class="entry_details" colspan="5">
Igor Murashkin10f4e0f2014-01-13 17:22:58 -0800[diff] [blame]9457 <p>This corresponds to the minimum steady-state frame duration when only
9458that JPEG stream is active and captured in a burst,<wbr/> with all
9459processing (typically in android.<wbr/>*.<wbr/>mode) set to FAST.<wbr/></p>
9460<p>When multiple streams are configured,<wbr/> the minimum
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9461frame duration will be &gt;= max(individual stream min
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9462durations)</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9463 </td>
9464 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9465
9466
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9467 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9468 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9469
9470
9471 <tr class="entry" id="static_android.scaler.availableJpegSizes">
Zhijun Heb8317e22014-01-16 09:47:07 -0800[diff] [blame]9472 <td class="entry_name" rowspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9473 android.<wbr/>scaler.<wbr/>available<wbr/>Jpeg<wbr/>Sizes
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9474 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9475 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9476 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9477 <span class="entry_type_container">x</span>
9478
9479 <span class="entry_type_array">
9480 n x 2
9481 </span>
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]9482 <span class="entry_type_visibility"> [public as size]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9483
9484
9485 </td> <!-- entry_type -->
9486
9487 <td class="entry_description">
Zhijun Heb8317e22014-01-16 09:47:07 -0800[diff] [blame]9488 <p>The JPEG resolutions that are supported by this camera device.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9489 </td>
9490
9491 <td class="entry_units">
9492 </td>
9493
9494 <td class="entry_range">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9495 </td>
9496
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9497 <td class="entry_tags">
9498 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9499 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9500 </ul>
9501 </td>
9502
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9503 </tr>
Zhijun Heb8317e22014-01-16 09:47:07 -0800[diff] [blame]9504 <tr class="entries_header">
9505 <th class="th_details" colspan="5">Details</th>
9506 </tr>
9507 <tr class="entry_cont">
9508 <td class="entry_details" colspan="5">
9509 <p>The resolutions are listed as <code>(width,<wbr/> height)</code> pairs.<wbr/> All camera devices will support
9510sensor 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>
9511 </td>
9512 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9513
Zhijun Heb8317e22014-01-16 09:47:07 -0800[diff] [blame]9514 <tr class="entries_header">
9515 <th class="th_details" colspan="5">HAL Implementation Details</th>
9516 </tr>
9517 <tr class="entry_cont">
9518 <td class="entry_details" colspan="5">
9519 <p>The HAL must include sensor maximum resolution
9520(defined by <a href="#static_android.sensor.info.activeArraySize">android.<wbr/>sensor.<wbr/>info.<wbr/>active<wbr/>Array<wbr/>Size</a>),<wbr/>
9521and should include half/<wbr/>quarter of sensor maximum resolution.<wbr/></p>
9522 </td>
9523 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9524
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9525 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9526 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9527
9528
9529 <tr class="entry" id="static_android.scaler.availableMaxDigitalZoom">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9530 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9531 android.<wbr/>scaler.<wbr/>available<wbr/>Max<wbr/>Digital<wbr/>Zoom
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9532 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9533 <td class="entry_type">
Igor Murashkinf11a4df2013-05-07 10:00:46 -0700[diff] [blame]9534 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9535
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9536 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9537
9538
9539 </td> <!-- entry_type -->
9540
9541 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9542 <p>The maximum ratio between active area width
9543and crop region width,<wbr/> or between active area height and
9544crop region height,<wbr/> if the crop region height is larger
9545than width</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9546 </td>
9547
9548 <td class="entry_units">
9549 </td>
9550
9551 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame]9552 <p>&gt;=1</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9553 </td>
9554
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9555 <td class="entry_tags">
Igor Murashkinf11a4df2013-05-07 10:00:46 -0700[diff] [blame]9556 <ul class="entry_tags">
9557 <li><a href="#tag_BC">BC</a></li>
9558 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9559 </td>
9560
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9561 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9562
9563
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9564 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9565 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9566
9567
9568 <tr class="entry" id="static_android.scaler.availableProcessedMinDurations">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9569 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9570 android.<wbr/>scaler.<wbr/>available<wbr/>Processed<wbr/>Min<wbr/>Durations
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9571 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9572 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9573 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9574 <span class="entry_type_container">x</span>
9575
9576 <span class="entry_type_array">
9577 n
9578 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9579 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9580
9581
9582 </td> <!-- entry_type -->
9583
9584 <td class="entry_description">
Igor Murashkin10f4e0f2014-01-13 17:22:58 -0800[diff] [blame]9585 <p>For each available processed output size (defined in
9586<a href="#static_android.scaler.availableProcessedSizes">android.<wbr/>scaler.<wbr/>available<wbr/>Processed<wbr/>Sizes</a>),<wbr/> this property lists the
9587minimum supportable frame duration for that size.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9588 </td>
9589
9590 <td class="entry_units">
Igor Murashkin10f4e0f2014-01-13 17:22:58 -0800[diff] [blame]9591 ns
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9592 </td>
9593
9594 <td class="entry_range">
9595 </td>
9596
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9597 <td class="entry_tags">
9598 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9599 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9600 </ul>
9601 </td>
9602
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9603 </tr>
9604 <tr class="entries_header">
9605 <th class="th_details" colspan="5">Details</th>
9606 </tr>
9607 <tr class="entry_cont">
9608 <td class="entry_details" colspan="5">
Igor Murashkin10f4e0f2014-01-13 17:22:58 -0800[diff] [blame]9609 <p>This should correspond to the frame duration when only that processed
9610stream is active,<wbr/> with all processing (typically in android.<wbr/>*.<wbr/>mode)
9611set to FAST.<wbr/></p>
9612<p>When multiple streams are configured,<wbr/> the minimum frame duration will
9613be &gt;= max(individual stream min durations).<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9614 </td>
9615 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9616
9617
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9618 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9619 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9620
9621
9622 <tr class="entry" id="static_android.scaler.availableProcessedSizes">
Zhijun Heb8317e22014-01-16 09:47:07 -0800[diff] [blame]9623 <td class="entry_name" rowspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9624 android.<wbr/>scaler.<wbr/>available<wbr/>Processed<wbr/>Sizes
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9625 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9626 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9627 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9628 <span class="entry_type_container">x</span>
9629
9630 <span class="entry_type_array">
9631 n x 2
9632 </span>
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]9633 <span class="entry_type_visibility"> [public as size]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9634
9635
9636 </td> <!-- entry_type -->
9637
9638 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9639 <p>The resolutions available for use with
9640processed output streams,<wbr/> such as YV12,<wbr/> NV12,<wbr/> and
9641platform opaque YUV/<wbr/>RGB streams to the GPU or video
Zhijun Heb8317e22014-01-16 09:47:07 -0800[diff] [blame]9642encoders.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9643 </td>
9644
9645 <td class="entry_units">
9646 </td>
9647
9648 <td class="entry_range">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9649 </td>
9650
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9651 <td class="entry_tags">
9652 <ul class="entry_tags">
9653 <li><a href="#tag_BC">BC</a></li>
9654 </ul>
9655 </td>
9656
9657 </tr>
9658 <tr class="entries_header">
9659 <th class="th_details" colspan="5">Details</th>
9660 </tr>
9661 <tr class="entry_cont">
9662 <td class="entry_details" colspan="5">
Zhijun Heb8317e22014-01-16 09:47:07 -0800[diff] [blame]9663 <p>The resolutions are listed as <code>(width,<wbr/> height)</code> pairs.<wbr/></p>
9664<p>For a given use case,<wbr/> the actual maximum supported resolution
9665may be lower than what is listed here,<wbr/> depending on the destination
9666Surface for the image data.<wbr/> For example,<wbr/> for recording video,<wbr/>
9667the video encoder chosen may have a maximum size limit (e.<wbr/>g.<wbr/> 1080p)
9668smaller than what the camera (e.<wbr/>g.<wbr/> maximum resolution is 3264x2448)
9669can provide.<wbr/></p>
9670<p>Please reference the documentation for the image data destination to
9671check if it limits the maximum size for image data.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9672 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9673 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9674
Zhijun Heb8317e22014-01-16 09:47:07 -0800[diff] [blame]9675 <tr class="entries_header">
9676 <th class="th_details" colspan="5">HAL Implementation Details</th>
9677 </tr>
9678 <tr class="entry_cont">
9679 <td class="entry_details" colspan="5">
9680 <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/>
9681the HAL must include all JPEG sizes listed in android.<wbr/>scaler.<wbr/>available<wbr/>Jpeg<wbr/>Sizes
9682and each below resolution if it is smaller than or equal to the sensor
9683maximum resolution (if they are not listed in JPEG sizes already):</p>
9684<ul>
9685<li>240p (320 x 240)</li>
9686<li>480p (640 x 480)</li>
9687<li>720p (1280 x 720)</li>
9688<li>1080p (1920 x 1080)</li>
9689</ul>
9690<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/>
9691the HAL only has to list up to the maximum video size supported by the devices.<wbr/></p>
9692 </td>
9693 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9694
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9695 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9696 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9697
9698
9699 <tr class="entry" id="static_android.scaler.availableRawMinDurations">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9700 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9701 android.<wbr/>scaler.<wbr/>available<wbr/>Raw<wbr/>Min<wbr/>Durations
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9702 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9703 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9704 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9705 <span class="entry_type_container">x</span>
9706
9707 <span class="entry_type_array">
9708 n
9709 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9710 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9711
9712
9713 </td> <!-- entry_type -->
9714
9715 <td class="entry_description">
Igor Murashkin10f4e0f2014-01-13 17:22:58 -0800[diff] [blame]9716 <p>For each available processed output size (defined in
9717<a href="#static_android.scaler.availableRawSizes">android.<wbr/>scaler.<wbr/>available<wbr/>Raw<wbr/>Sizes</a>),<wbr/> this property lists the minimum
9718supportable frame duration for that size.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9719 </td>
9720
9721 <td class="entry_units">
Igor Murashkin10f4e0f2014-01-13 17:22:58 -0800[diff] [blame]9722 ns
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9723 </td>
9724
9725 <td class="entry_range">
9726 </td>
9727
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9728 <td class="entry_tags">
9729 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9730 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9731 </ul>
9732 </td>
9733
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9734 </tr>
9735 <tr class="entries_header">
9736 <th class="th_details" colspan="5">Details</th>
9737 </tr>
9738 <tr class="entry_cont">
9739 <td class="entry_details" colspan="5">
Igor Murashkin10f4e0f2014-01-13 17:22:58 -0800[diff] [blame]9740 <p>Should correspond to the frame duration when only the raw stream is
9741active.<wbr/></p>
9742<p>When multiple streams are configured,<wbr/> the minimum
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9743frame duration will be &gt;= max(individual stream min
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9744durations)</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9745 </td>
9746 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9747
9748
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9749 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9750 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9751
9752
9753 <tr class="entry" id="static_android.scaler.availableRawSizes">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9754 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9755 android.<wbr/>scaler.<wbr/>available<wbr/>Raw<wbr/>Sizes
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9756 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9757 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9758 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9759 <span class="entry_type_container">x</span>
9760
9761 <span class="entry_type_array">
9762 n x 2
9763 </span>
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]9764 <span class="entry_type_visibility"> [system as size]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9765
9766
9767 </td> <!-- entry_type -->
9768
9769 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9770 <p>The resolutions available for use with raw
9771sensor output streams,<wbr/> listed as width,<wbr/>
9772height</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9773 </td>
9774
9775 <td class="entry_units">
9776 </td>
9777
9778 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]9779 <p>Must include: - sensor maximum resolution</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9780 </td>
9781
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9782 <td class="entry_tags">
9783 </td>
9784
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9785 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9786
9787
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9788 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9789 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9790
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9791
9792
9793 <!-- end of kind -->
9794 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9795 <tr><td colspan="6" class="kind">dynamic</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9796
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9797 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9798 <tr>
9799 <th class="th_name">Property Name</th>
9800 <th class="th_type">Type</th>
9801 <th class="th_description">Description</th>
9802 <th class="th_units">Units</th>
9803 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9804 <th class="th_tags">Tags</th>
9805 </tr>
9806 </thead>
9807
9808 <tbody>
9809
9810
9811
9812
9813
9814
9815
9816
9817
9818
9819 <tr class="entry" id="dynamic_android.scaler.cropRegion">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9820 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9821 android.<wbr/>scaler.<wbr/>crop<wbr/>Region
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9822 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9823 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9824 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9825 <span class="entry_type_container">x</span>
9826
9827 <span class="entry_type_array">
Eino-Ville Talvalae04ec6e2013-04-16 15:35:18 -0700[diff] [blame]9828 4
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9829 </span>
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]9830 <span class="entry_type_visibility"> [public as rectangle]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9831
9832
9833 </td> <!-- entry_type -->
9834
9835 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9836 <p>(x,<wbr/> y,<wbr/> width,<wbr/> height).<wbr/></p>
9837<p>A rectangle with the top-level corner of (x,<wbr/>y) and size
9838(width,<wbr/> height).<wbr/> The region of the sensor that is used for
9839output.<wbr/> Each stream must use this rectangle to produce its
9840output,<wbr/> cropping to a smaller region if necessary to
9841maintain the stream's aspect ratio.<wbr/></p>
9842<p>HAL2.<wbr/>x uses only (x,<wbr/> y,<wbr/> width)</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9843 </td>
9844
9845 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9846 (x,<wbr/>y) of top-left corner,<wbr/> width and height of region
9847 in pixels; (0,<wbr/>0) is top-left corner of
9848 android.<wbr/>sensor.<wbr/>active<wbr/>Array<wbr/>Size
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9849 </td>
9850
9851 <td class="entry_range">
9852 </td>
9853
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9854 <td class="entry_tags">
9855 <ul class="entry_tags">
9856 <li><a href="#tag_BC">BC</a></li>
9857 </ul>
9858 </td>
9859
9860 </tr>
9861 <tr class="entries_header">
9862 <th class="th_details" colspan="5">Details</th>
9863 </tr>
9864 <tr class="entry_cont">
9865 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9866 <p>Any additional per-stream cropping must be done to
9867maximize the final pixel area of the stream.<wbr/></p>
9868<p>For example,<wbr/> if the crop region is set to a 4:3 aspect
9869ratio,<wbr/> then 4:3 streams should use the exact crop
9870region.<wbr/> 16:9 streams should further crop vertically
9871(letterbox).<wbr/></p>
9872<p>Conversely,<wbr/> if the crop region is set to a 16:9,<wbr/> then 4:3
9873outputs should crop horizontally (pillarbox),<wbr/> and 16:9
9874streams should match exactly.<wbr/> These additional crops must
9875be centered within the crop region.<wbr/></p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]9876<p>The output streams must maintain square pixels at all
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9877times,<wbr/> no matter what the relative aspect ratios of the
9878crop region and the stream are.<wbr/> Negative values for
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]9879corner are allowed for raw output if full pixel array is
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9880larger than active pixel array.<wbr/> Width and height may be
9881rounded to nearest larger supportable width,<wbr/> especially
9882for raw output,<wbr/> where only a few fixed scales may be
9883possible.<wbr/> The width and height of the crop region cannot
9884be set to be smaller than floor( activeArraySize.<wbr/>width /<wbr/>
9885android.<wbr/>scaler.<wbr/>max<wbr/>Digital<wbr/>Zoom ) and floor(
9886activeArraySize.<wbr/>height /<wbr/> android.<wbr/>scaler.<wbr/>max<wbr/>Digital<wbr/>Zoom),<wbr/>
9887respectively.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9888 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9889 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9890
9891
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9892 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9893 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9894
9895
9896
9897 <!-- end of kind -->
9898 </tbody>
9899
9900 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9901 <tr><td colspan="6" id="section_sensor" class="section">sensor</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9902
9903
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9904 <tr><td colspan="6" class="kind">controls</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9905
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9906 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9907 <tr>
9908 <th class="th_name">Property Name</th>
9909 <th class="th_type">Type</th>
9910 <th class="th_description">Description</th>
9911 <th class="th_units">Units</th>
9912 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9913 <th class="th_tags">Tags</th>
9914 </tr>
9915 </thead>
9916
9917 <tbody>
9918
9919
9920
9921
9922
9923
9924
9925
9926
9927
9928 <tr class="entry" id="controls_android.sensor.exposureTime">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9929 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9930 android.<wbr/>sensor.<wbr/>exposure<wbr/>Time
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9931 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9932 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9933 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9934
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9935 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9936
9937
9938 </td> <!-- entry_type -->
9939
9940 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9941 <p>Duration each pixel is exposed to
9942light.<wbr/></p>
9943<p>If the sensor can't expose this exact duration,<wbr/> it should shorten the
9944duration exposed to the nearest possible value (rather than expose longer).<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9945 </td>
9946
9947 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9948 nanoseconds
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9949 </td>
9950
9951 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]9952 <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]9953 </td>
9954
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9955 <td class="entry_tags">
9956 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9957 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9958 </ul>
9959 </td>
9960
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9961 </tr>
9962 <tr class="entries_header">
9963 <th class="th_details" colspan="5">Details</th>
9964 </tr>
9965 <tr class="entry_cont">
9966 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9967 <p>1/<wbr/>10000 - 30 sec range.<wbr/> No bulb mode</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9968 </td>
9969 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9970
9971
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9972 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9973 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9974
9975
9976 <tr class="entry" id="controls_android.sensor.frameDuration">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9977 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9978 android.<wbr/>sensor.<wbr/>frame<wbr/>Duration
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9979 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9980 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9981 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9982
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9983 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9984
9985
9986 </td> <!-- entry_type -->
9987
9988 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9989 <p>Duration from start of frame exposure to
Igor Murashkin10f4e0f2014-01-13 17:22:58 -0800[diff] [blame]9990start of next frame exposure.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9991 </td>
9992
9993 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9994 nanoseconds
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9995 </td>
9996
9997 <td class="entry_range">
Igor Murashkin10f4e0f2014-01-13 17:22:58 -0800[diff] [blame]9998 <p>See <a href="#static_android.sensor.info.maxFrameDuration">android.<wbr/>sensor.<wbr/>info.<wbr/>max<wbr/>Frame<wbr/>Duration</a>,<wbr/>
9999android.<wbr/>scaler.<wbr/>available*Min<wbr/>Durations.<wbr/> The duration
10000is capped to <code>max(duration,<wbr/> exposureTime + overhead)</code>.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10001 </td>
10002
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10003 <td class="entry_tags">
10004 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]10005 <li><a href="#tag_V1">V1</a></li>
10006 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10007 </ul>
10008 </td>
10009
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10010 </tr>
10011 <tr class="entries_header">
10012 <th class="th_details" colspan="5">Details</th>
10013 </tr>
10014 <tr class="entry_cont">
10015 <td class="entry_details" colspan="5">
Igor Murashkin10f4e0f2014-01-13 17:22:58 -0800[diff] [blame]10016 <p>The maximum frame rate that can be supported by a camera subsystem is
10017a function of many factors:</p>
10018<ul>
10019<li>Requested resolutions of output image streams</li>
10020<li>Availability of binning /<wbr/> skipping modes on the imager</li>
10021<li>The bandwidth of the imager interface</li>
10022<li>The bandwidth of the various ISP processing blocks</li>
10023</ul>
10024<p>Since these factors can vary greatly between different ISPs and
10025sensors,<wbr/> the camera abstraction tries to represent the bandwidth
10026restrictions with as simple a model as possible.<wbr/></p>
10027<p>The model presented has the following characteristics:</p>
10028<ul>
10029<li>The image sensor is always configured to output the smallest
10030resolution possible given the application's requested output stream
10031sizes.<wbr/> The smallest resolution is defined as being at least as large
10032as the largest requested output stream size; the camera pipeline must
10033never digitally upsample sensor data when the crop region covers the
10034whole sensor.<wbr/> In general,<wbr/> this means that if only small output stream
10035resolutions are configured,<wbr/> the sensor can provide a higher frame
10036rate.<wbr/></li>
10037<li>Since any request may use any or all the currently configured
10038output streams,<wbr/> the sensor and ISP must be configured to support
10039scaling a single capture to all the streams at the same time.<wbr/> This
10040means the camera pipeline must be ready to produce the largest
10041requested output size without any delay.<wbr/> Therefore,<wbr/> the overall
10042frame rate of a given configured stream set is governed only by the
10043largest requested stream resolution.<wbr/></li>
10044<li>Using more than one output stream in a request does not affect the
10045frame duration.<wbr/></li>
10046<li>JPEG streams act like processed YUV streams in requests for which
10047they are not included; in requests in which they are directly
10048referenced,<wbr/> they act as JPEG streams.<wbr/> This is because supporting a
10049JPEG stream requires the underlying YUV data to always be ready for
10050use by a JPEG encoder,<wbr/> but the encoder will only be used (and impact
10051frame duration) on requests that actually reference a JPEG stream.<wbr/></li>
10052<li>The JPEG processor can run concurrently to the rest of the camera
10053pipeline,<wbr/> but cannot process more than 1 capture at a time.<wbr/></li>
10054</ul>
10055<p>The necessary information for the application,<wbr/> given the model above,<wbr/>
10056is provided via the android.<wbr/>scaler.<wbr/>available*Min<wbr/>Durations fields.<wbr/>
10057These are used to determine the maximum frame rate /<wbr/> minimum frame
10058duration that is possible for a given stream configuration.<wbr/></p>
10059<p>Specifically,<wbr/> the application can use the following rules to
10060determine the minimum frame duration it can request from the HAL
10061device:</p>
10062<ol>
10063<li>Given the application's currently configured set of output
10064streams,<wbr/> <code>S</code>,<wbr/> divide them into three sets: streams in a JPEG format
10065<code>SJ</code>,<wbr/> streams in a raw sensor format <code>SR</code>,<wbr/> and the rest ('processed')
10066<code>SP</code>.<wbr/></li>
10067<li>For each subset of streams,<wbr/> find the largest resolution (by pixel
10068count) in the subset.<wbr/> This gives (at most) three resolutions <code>RJ</code>,<wbr/>
10069<code>RR</code>,<wbr/> and <code>RP</code>.<wbr/></li>
10070<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
10071no exact match for <code>RP == RJ</code> (in particular there isn't an available
10072processed resolution at the same size as <code>RJ</code>),<wbr/> then set <code>RP</code> equal
10073to the smallest processed resolution that is larger than <code>RJ</code>.<wbr/> If
10074there are no processed resolutions larger than <code>RJ</code>,<wbr/> then set <code>RJ</code> to
10075the processed resolution closest to <code>RJ</code>.<wbr/></li>
10076<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
10077no exact match for <code>RR == RP</code> (in particular there isn't an available
10078raw resolution at the same size as <code>RP</code>),<wbr/> then set <code>RR</code> equal to
10079or to the smallest raw resolution that is larger than <code>RP</code>.<wbr/> If
10080there are no raw resolutions larger than <code>RP</code>,<wbr/> then set <code>RR</code> to
10081the raw resolution closest to <code>RP</code>.<wbr/></li>
10082<li>Look up the matching minimum frame durations in the property lists
10083<a href="#static_android.scaler.availableJpegMinDurations">android.<wbr/>scaler.<wbr/>available<wbr/>Jpeg<wbr/>Min<wbr/>Durations</a>,<wbr/>
10084<a href="#static_android.scaler.availableRawMinDurations">android.<wbr/>scaler.<wbr/>available<wbr/>Raw<wbr/>Min<wbr/>Durations</a>,<wbr/> and
10085<a href="#static_android.scaler.availableProcessedMinDurations">android.<wbr/>scaler.<wbr/>available<wbr/>Processed<wbr/>Min<wbr/>Durations</a>.<wbr/> This gives three
10086minimum frame durations <code>FJ</code>,<wbr/> <code>FR</code>,<wbr/> and <code>FP</code>.<wbr/></li>
10087<li>If a stream of requests do not use a JPEG stream,<wbr/> then the minimum
10088supported frame duration for each request is <code>max(FR,<wbr/> FP)</code>.<wbr/></li>
10089<li>If a stream of requests all use the JPEG stream,<wbr/> then the minimum
10090supported frame duration for each request is <code>max(FR,<wbr/> FP,<wbr/> FJ)</code>.<wbr/></li>
10091<li>If a mix of JPEG-using and non-JPEG-using requests is submitted by
10092the application,<wbr/> then the HAL will have to delay JPEG-using requests
10093whenever the JPEG encoder is still busy processing an older capture.<wbr/>
10094This will happen whenever a JPEG-using request starts capture less
10095than <code>FJ</code> <em>ns</em> after a previous JPEG-using request.<wbr/> The minimum
10096supported frame duration will vary between the values calculated in
10097#6 and #7.<wbr/></li>
10098</ol>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10099 </td>
10100 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10101
10102
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10103 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10104 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10105
10106
10107 <tr class="entry" id="controls_android.sensor.sensitivity">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10108 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10109 android.<wbr/>sensor.<wbr/>sensitivity
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10110 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10111 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10112 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10113
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10114 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10115
10116
10117 </td> <!-- entry_type -->
10118
10119 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10120 <p>Gain applied to image data.<wbr/> Must be
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]10121implemented through analog gain only if set to values
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10122below 'maximum analog sensitivity'.<wbr/></p>
10123<p>If the sensor can't apply this exact gain,<wbr/> it should lessen the
10124gain to the nearest possible value (rather than gain more).<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10125 </td>
10126
10127 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10128 ISO arithmetic units
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10129 </td>
10130
10131 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]10132 <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]10133 </td>
10134
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10135 <td class="entry_tags">
10136 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]10137 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10138 </ul>
10139 </td>
10140
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10141 </tr>
10142 <tr class="entries_header">
10143 <th class="th_details" colspan="5">Details</th>
10144 </tr>
10145 <tr class="entry_cont">
10146 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10147 <p>ISO 12232:2006 REI method</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10148 </td>
10149 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10150
10151
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10152 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10153 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10154
10155
10156
10157 <!-- end of kind -->
10158 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10159 <tr><td colspan="6" class="kind">static</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10160
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10161 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10162 <tr>
10163 <th class="th_name">Property Name</th>
10164 <th class="th_type">Type</th>
10165 <th class="th_description">Description</th>
10166 <th class="th_units">Units</th>
10167 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10168 <th class="th_tags">Tags</th>
10169 </tr>
10170 </thead>
10171
10172 <tbody>
10173
10174
10175
10176
10177
10178
10179
10180
10181
10182
10183
10184
10185 <tr class="entry" id="static_android.sensor.info.activeArraySize">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10186 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10187 android.<wbr/>sensor.<wbr/>info.<wbr/>active<wbr/>Array<wbr/>Size
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10188 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10189 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10190 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10191 <span class="entry_type_container">x</span>
10192
10193 <span class="entry_type_array">
10194 4
10195 </span>
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]10196 <span class="entry_type_visibility"> [public as rectangle]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10197 <div class="entry_type_notes">Four ints defining the active pixel rectangle</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10198
10199
10200 </td> <!-- entry_type -->
10201
10202 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10203 <p>Area of raw data which corresponds to only
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]10204active pixels; smaller or equal to
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10205pixelArraySize.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10206 </td>
10207
10208 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10209 xmin,<wbr/> ymin,<wbr/> width,<wbr/> height.<wbr/> Top left of full
10210 pixel array is (0,<wbr/>0)
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10211 </td>
10212
10213 <td class="entry_range">
10214 </td>
10215
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10216 <td class="entry_tags">
10217 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]10218 <li><a href="#tag_DNG">DNG</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10219 </ul>
10220 </td>
10221
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10222 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10223
10224
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10225 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10226 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10227
10228
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]10229 <tr class="entry" id="static_android.sensor.info.sensitivityRange">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10230 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10231 android.<wbr/>sensor.<wbr/>info.<wbr/>sensitivity<wbr/>Range
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10232 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10233 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10234 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10235 <span class="entry_type_container">x</span>
10236
10237 <span class="entry_type_array">
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]10238 2
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10239 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10240 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10241 <div class="entry_type_notes">Range of supported sensitivities</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10242
10243
10244 </td> <!-- entry_type -->
10245
10246 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10247 <p>Range of valid sensitivities</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10248 </td>
10249
10250 <td class="entry_units">
10251 </td>
10252
10253 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]10254 <p>Min &lt;= 100,<wbr/> Max &gt;= 1600</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10255 </td>
10256
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10257 <td class="entry_tags">
10258 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]10259 <li><a href="#tag_BC">BC</a></li>
10260 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10261 </ul>
10262 </td>
10263
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10264 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10265
10266
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10267 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10268 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10269
10270
10271 <tr class="entry" id="static_android.sensor.info.colorFilterArrangement">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10272 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10273 android.<wbr/>sensor.<wbr/>info.<wbr/>color<wbr/>Filter<wbr/>Arrangement
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10274 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10275 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10276 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10277
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10278 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10279
10280 <ul class="entry_type_enum">
10281 <li>
10282 <span class="entry_type_enum_name">RGGB</span>
10283 </li>
10284 <li>
10285 <span class="entry_type_enum_name">GRBG</span>
10286 </li>
10287 <li>
10288 <span class="entry_type_enum_name">GBRG</span>
10289 </li>
10290 <li>
10291 <span class="entry_type_enum_name">BGGR</span>
10292 </li>
10293 <li>
10294 <span class="entry_type_enum_name">RGB</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]10295 <span class="entry_type_enum_notes"><p>Sensor is not Bayer; output has 3 16-bit
10296values for each pixel,<wbr/> instead of just 1 16-bit value
10297per pixel.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10298 </li>
10299 </ul>
10300
10301 </td> <!-- entry_type -->
10302
10303 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10304 <p>Arrangement of color filters on sensor;
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]10305represents the colors in the top-left 2x2 section of
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10306the sensor,<wbr/> in reading order</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10307 </td>
10308
10309 <td class="entry_units">
10310 </td>
10311
10312 <td class="entry_range">
10313 </td>
10314
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10315 <td class="entry_tags">
10316 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]10317 <li><a href="#tag_DNG">DNG</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10318 </ul>
10319 </td>
10320
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10321 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10322
10323
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10324 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10325 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10326
10327
10328 <tr class="entry" id="static_android.sensor.info.exposureTimeRange">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10329 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10330 android.<wbr/>sensor.<wbr/>info.<wbr/>exposure<wbr/>Time<wbr/>Range
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10331 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10332 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10333 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10334 <span class="entry_type_container">x</span>
10335
10336 <span class="entry_type_array">
10337 2
10338 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10339 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10340 <div class="entry_type_notes">nanoseconds</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10341
10342
10343 </td> <!-- entry_type -->
10344
10345 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10346 <p>Range of valid exposure
10347times</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10348 </td>
10349
10350 <td class="entry_units">
10351 </td>
10352
10353 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]10354 <p>Min &lt;= 100e3 (100 us),<wbr/> Max &gt;= 30e9 (30
10355sec)</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10356 </td>
10357
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10358 <td class="entry_tags">
10359 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]10360 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10361 </ul>
10362 </td>
10363
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10364 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10365
10366
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10367 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10368 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10369
10370
10371 <tr class="entry" id="static_android.sensor.info.maxFrameDuration">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10372 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10373 android.<wbr/>sensor.<wbr/>info.<wbr/>max<wbr/>Frame<wbr/>Duration
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10374 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10375 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10376 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10377
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10378 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10379
10380
10381 </td> <!-- entry_type -->
10382
10383 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10384 <p>Maximum possible frame duration (minimum frame
10385rate)</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10386 </td>
10387
10388 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10389 nanoseconds
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10390 </td>
10391
10392 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame]10393 <p>&gt;= 30e9</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10394 </td>
10395
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10396 <td class="entry_tags">
10397 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]10398 <li><a href="#tag_BC">BC</a></li>
10399 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10400 </ul>
10401 </td>
10402
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10403 </tr>
10404 <tr class="entries_header">
10405 <th class="th_details" colspan="5">Details</th>
10406 </tr>
10407 <tr class="entry_cont">
10408 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10409 <p>Minimum duration is a function of resolution,<wbr/>
10410processing settings.<wbr/> See
10411android.<wbr/>scaler.<wbr/>available<wbr/>Processed<wbr/>Min<wbr/>Durations
10412android.<wbr/>scaler.<wbr/>available<wbr/>Jpeg<wbr/>Min<wbr/>Durations
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]10413<a href="#static_android.scaler.availableRawMinDurations">android.<wbr/>scaler.<wbr/>available<wbr/>Raw<wbr/>Min<wbr/>Durations</a></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10414 </td>
10415 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10416
10417
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10418 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10419 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10420
10421
10422 <tr class="entry" id="static_android.sensor.info.physicalSize">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10423 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10424 android.<wbr/>sensor.<wbr/>info.<wbr/>physical<wbr/>Size
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10425 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10426 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10427 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10428 <span class="entry_type_container">x</span>
10429
10430 <span class="entry_type_array">
10431 2
10432 </span>
Timothy Knightec817d52013-08-16 16:15:29 -0700[diff] [blame]10433 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10434 <div class="entry_type_notes">width x height in millimeters</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10435
10436
10437 </td> <!-- entry_type -->
10438
10439 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10440 <p>The physical dimensions of the full pixel
10441array</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10442 </td>
10443
10444 <td class="entry_units">
10445 </td>
10446
10447 <td class="entry_range">
10448 </td>
10449
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10450 <td class="entry_tags">
10451 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]10452 <li><a href="#tag_V1">V1</a></li>
10453 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10454 </ul>
10455 </td>
10456
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10457 </tr>
10458 <tr class="entries_header">
10459 <th class="th_details" colspan="5">Details</th>
10460 </tr>
10461 <tr class="entry_cont">
10462 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10463 <p>Needed for FOV calculation for old API</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10464 </td>
10465 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10466
10467
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10468 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10469 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10470
10471
10472 <tr class="entry" id="static_android.sensor.info.pixelArraySize">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10473 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10474 android.<wbr/>sensor.<wbr/>info.<wbr/>pixel<wbr/>Array<wbr/>Size
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10475 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10476 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10477 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10478 <span class="entry_type_container">x</span>
10479
10480 <span class="entry_type_array">
10481 2
10482 </span>
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]10483 <span class="entry_type_visibility"> [system as size]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10484
10485
10486 </td> <!-- entry_type -->
10487
10488 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10489 <p>Dimensions of full pixel array,<wbr/> possibly
10490including black calibration pixels</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10491 </td>
10492
10493 <td class="entry_units">
10494 </td>
10495
10496 <td class="entry_range">
10497 </td>
10498
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10499 <td class="entry_tags">
10500 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]10501 <li><a href="#tag_DNG">DNG</a></li>
10502 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10503 </ul>
10504 </td>
10505
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10506 </tr>
10507 <tr class="entries_header">
10508 <th class="th_details" colspan="5">Details</th>
10509 </tr>
10510 <tr class="entry_cont">
10511 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10512 <p>Maximum output resolution for raw format must
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10513match this in
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10514android.<wbr/>scaler.<wbr/>info.<wbr/>available<wbr/>Sizes<wbr/>Per<wbr/>Format</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10515 </td>
10516 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10517
10518
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10519 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10520 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10521
10522
10523 <tr class="entry" id="static_android.sensor.info.whiteLevel">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10524 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10525 android.<wbr/>sensor.<wbr/>info.<wbr/>white<wbr/>Level
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10526 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10527 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10528 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10529
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10530 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10531
10532
10533 </td> <!-- entry_type -->
10534
10535 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10536 <p>Maximum raw value output by
10537sensor</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10538 </td>
10539
10540 <td class="entry_units">
10541 </td>
10542
10543 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame]10544 <p>&gt; 1024 (10-bit output)</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10545 </td>
10546
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10547 <td class="entry_tags">
10548 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]10549 <li><a href="#tag_DNG">DNG</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10550 </ul>
10551 </td>
10552
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10553 </tr>
10554 <tr class="entries_header">
10555 <th class="th_details" colspan="5">Details</th>
10556 </tr>
10557 <tr class="entry_cont">
10558 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10559 <p>Defines sensor bit depth (10-14 bits is
10560expected)</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10561 </td>
10562 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10563
10564
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10565 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10566 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10567
10568
10569
10570
10571
10572 <tr class="entry" id="static_android.sensor.baseGainFactor">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10573 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10574 android.<wbr/>sensor.<wbr/>base<wbr/>Gain<wbr/>Factor
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10575 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10576 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10577 <span class="entry_type_name">rational</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10578
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10579 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10580
10581
10582 </td> <!-- entry_type -->
10583
10584 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10585 <p>Gain factor from electrons to raw units when
10586ISO=100</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10587 </td>
10588
10589 <td class="entry_units">
10590 </td>
10591
10592 <td class="entry_range">
10593 </td>
10594
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10595 <td class="entry_tags">
10596 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]10597 <li><a href="#tag_V1">V1</a></li>
Alex Rayef40ad62013-10-01 17:52:33 -0700[diff] [blame]10598 <li><a href="#tag_FULL">FULL</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10599 </ul>
10600 </td>
10601
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10602 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10603
10604
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10605 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10606 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10607
10608
10609 <tr class="entry" id="static_android.sensor.blackLevelPattern">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10610 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10611 android.<wbr/>sensor.<wbr/>black<wbr/>Level<wbr/>Pattern
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10612 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10613 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10614 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10615 <span class="entry_type_container">x</span>
10616
10617 <span class="entry_type_array">
10618 4
10619 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10620 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10621 <div class="entry_type_notes">2x2 raw count block</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10622
10623
10624 </td> <!-- entry_type -->
10625
10626 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10627 <p>A fixed black level offset for each of the
10628Bayer mosaic channels</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10629 </td>
10630
10631 <td class="entry_units">
10632 </td>
10633
10634 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame]10635 <p>&gt;= 0 each</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10636 </td>
10637
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10638 <td class="entry_tags">
10639 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]10640 <li><a href="#tag_DNG">DNG</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10641 </ul>
10642 </td>
10643
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10644 </tr>
10645 <tr class="entries_header">
10646 <th class="th_details" colspan="5">Details</th>
10647 </tr>
10648 <tr class="entry_cont">
10649 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10650 <p>As per DNG BlackLevelRepeatDim /<wbr/> BlackLevel
10651tags</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10652 </td>
10653 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10654
10655
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10656 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10657 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10658
10659
10660 <tr class="entry" id="static_android.sensor.calibrationTransform1">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10661 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10662 android.<wbr/>sensor.<wbr/>calibration<wbr/>Transform1
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10663 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10664 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10665 <span class="entry_type_name">rational</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10666 <span class="entry_type_container">x</span>
10667
10668 <span class="entry_type_array">
10669 9
10670 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10671 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10672 <div class="entry_type_notes">3x3 matrix in row-major-order</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10673
10674
10675 </td> <!-- entry_type -->
10676
10677 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10678 <p>Per-device calibration on top of color space
10679transform 1</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10680 </td>
10681
10682 <td class="entry_units">
10683 </td>
10684
10685 <td class="entry_range">
10686 </td>
10687
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10688 <td class="entry_tags">
10689 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]10690 <li><a href="#tag_DNG">DNG</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10691 </ul>
10692 </td>
10693
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10694 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10695
10696
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10697 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10698 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10699
10700
10701 <tr class="entry" id="static_android.sensor.calibrationTransform2">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10702 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10703 android.<wbr/>sensor.<wbr/>calibration<wbr/>Transform2
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10704 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10705 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10706 <span class="entry_type_name">rational</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10707 <span class="entry_type_container">x</span>
10708
10709 <span class="entry_type_array">
10710 9
10711 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10712 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10713 <div class="entry_type_notes">3x3 matrix in row-major-order</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10714
10715
10716 </td> <!-- entry_type -->
10717
10718 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10719 <p>Per-device calibration on top of color space
10720transform 2</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10721 </td>
10722
10723 <td class="entry_units">
10724 </td>
10725
10726 <td class="entry_range">
10727 </td>
10728
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10729 <td class="entry_tags">
10730 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]10731 <li><a href="#tag_DNG">DNG</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10732 </ul>
10733 </td>
10734
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10735 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10736
10737
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10738 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10739 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10740
10741
10742 <tr class="entry" id="static_android.sensor.colorTransform1">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10743 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10744 android.<wbr/>sensor.<wbr/>color<wbr/>Transform1
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10745 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10746 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10747 <span class="entry_type_name">rational</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10748 <span class="entry_type_container">x</span>
10749
10750 <span class="entry_type_array">
10751 9
10752 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10753 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10754 <div class="entry_type_notes">3x3 matrix in row-major-order</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10755
10756
10757 </td> <!-- entry_type -->
10758
10759 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10760 <p>Linear mapping from XYZ (D50) color space to
10761reference linear sensor color,<wbr/> for first reference
10762illuminant</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10763 </td>
10764
10765 <td class="entry_units">
10766 </td>
10767
10768 <td class="entry_range">
10769 </td>
10770
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10771 <td class="entry_tags">
10772 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]10773 <li><a href="#tag_DNG">DNG</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10774 </ul>
10775 </td>
10776
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10777 </tr>
10778 <tr class="entries_header">
10779 <th class="th_details" colspan="5">Details</th>
10780 </tr>
10781 <tr class="entry_cont">
10782 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10783 <p>Use as follows XYZ = inv(transform) * clip( (raw -
10784black level(raw) ) /<wbr/> ( white level - max black level) ).<wbr/>
10785At least in the simple case</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10786 </td>
10787 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10788
10789
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10790 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10791 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10792
10793
10794 <tr class="entry" id="static_android.sensor.colorTransform2">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10795 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10796 android.<wbr/>sensor.<wbr/>color<wbr/>Transform2
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10797 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10798 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10799 <span class="entry_type_name">rational</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10800 <span class="entry_type_container">x</span>
10801
10802 <span class="entry_type_array">
10803 9
10804 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10805 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10806 <div class="entry_type_notes">3x3 matrix in row-major-order</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10807
10808
10809 </td> <!-- entry_type -->
10810
10811 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10812 <p>Linear mapping from XYZ (D50) color space to
10813reference linear sensor color,<wbr/> for second reference
10814illuminant</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10815 </td>
10816
10817 <td class="entry_units">
10818 </td>
10819
10820 <td class="entry_range">
10821 </td>
10822
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10823 <td class="entry_tags">
10824 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]10825 <li><a href="#tag_DNG">DNG</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10826 </ul>
10827 </td>
10828
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10829 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10830
10831
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10832 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10833 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10834
10835
10836 <tr class="entry" id="static_android.sensor.forwardMatrix1">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10837 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10838 android.<wbr/>sensor.<wbr/>forward<wbr/>Matrix1
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10839 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10840 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10841 <span class="entry_type_name">rational</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10842 <span class="entry_type_container">x</span>
10843
10844 <span class="entry_type_array">
10845 9
10846 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10847 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10848 <div class="entry_type_notes">3x3 matrix in row-major-order</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10849
10850
10851 </td> <!-- entry_type -->
10852
10853 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10854 <p>Used by DNG for better WB
10855adaptation</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10856 </td>
10857
10858 <td class="entry_units">
10859 </td>
10860
10861 <td class="entry_range">
10862 </td>
10863
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10864 <td class="entry_tags">
10865 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]10866 <li><a href="#tag_DNG">DNG</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10867 </ul>
10868 </td>
10869
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10870 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10871
10872
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10873 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10874 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10875
10876
10877 <tr class="entry" id="static_android.sensor.forwardMatrix2">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10878 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10879 android.<wbr/>sensor.<wbr/>forward<wbr/>Matrix2
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10880 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10881 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10882 <span class="entry_type_name">rational</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10883 <span class="entry_type_container">x</span>
10884
10885 <span class="entry_type_array">
10886 9
10887 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10888 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10889 <div class="entry_type_notes">3x3 matrix in row-major-order</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10890
10891
10892 </td> <!-- entry_type -->
10893
10894 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10895 <p>Used by DNG for better WB
10896adaptation</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10897 </td>
10898
10899 <td class="entry_units">
10900 </td>
10901
10902 <td class="entry_range">
10903 </td>
10904
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10905 <td class="entry_tags">
10906 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]10907 <li><a href="#tag_DNG">DNG</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10908 </ul>
10909 </td>
10910
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10911 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10912
10913
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10914 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10915 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10916
10917
10918 <tr class="entry" id="static_android.sensor.maxAnalogSensitivity">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10919 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10920 android.<wbr/>sensor.<wbr/>max<wbr/>Analog<wbr/>Sensitivity
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10921 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10922 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10923 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10924
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10925 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10926
10927
10928 </td> <!-- entry_type -->
10929
10930 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10931 <p>Maximum sensitivity that is implemented
10932purely through analog gain</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10933 </td>
10934
10935 <td class="entry_units">
10936 </td>
10937
10938 <td class="entry_range">
10939 </td>
10940
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10941 <td class="entry_tags">
10942 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]10943 <li><a href="#tag_V1">V1</a></li>
Alex Rayef40ad62013-10-01 17:52:33 -0700[diff] [blame]10944 <li><a href="#tag_FULL">FULL</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>
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">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]10954 <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]10955equal to this,<wbr/> all applied gain must be analog.<wbr/> For
10956values above this,<wbr/> it can be a mix of analog and
10957digital</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10958 </td>
10959 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10960
10961
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10962 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10963 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10964
10965
10966 <tr class="entry" id="static_android.sensor.noiseModelCoefficients">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10967 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10968 android.<wbr/>sensor.<wbr/>noise<wbr/>Model<wbr/>Coefficients
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10969 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10970 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10971 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10972 <span class="entry_type_container">x</span>
10973
10974 <span class="entry_type_array">
10975 2
10976 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10977 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10978 <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]10979
10980
10981 </td> <!-- entry_type -->
10982
10983 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10984 <p>Estimation of sensor noise
10985characteristics</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10986 </td>
10987
10988 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10989 var(raw pixel value) = electrons * (baseGainFactor
10990 * iso/<wbr/>100)^2 + A * (baseGainFactor * iso/<wbr/>100)^2 +
10991 B
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10992 </td>
10993
10994 <td class="entry_range">
10995 </td>
10996
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10997 <td class="entry_tags">
10998 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]10999 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11000 </ul>
11001 </td>
11002
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11003 </tr>
11004 <tr class="entries_header">
11005 <th class="th_details" colspan="5">Details</th>
11006 </tr>
11007 <tr class="entry_cont">
11008 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11009 <p>A represents sensor read noise before analog
11010amplification; B represents noise from A/<wbr/>D conversion and
11011other circuits after amplification.<wbr/> Both noise sources
11012are assumed to be gaussian,<wbr/> independent,<wbr/> and not to vary
11013across the sensor</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11014 </td>
11015 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11016
11017
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11018 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11019 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11020
11021
11022 <tr class="entry" id="static_android.sensor.orientation">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11023 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11024 android.<wbr/>sensor.<wbr/>orientation
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11025 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11026 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]11027 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11028
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]11029 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11030
11031
11032 </td> <!-- entry_type -->
11033
11034 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11035 <p>Clockwise angle through which the output
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]11036image needs to be rotated to be upright on the device
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11037screen in its native orientation.<wbr/> Also defines the
11038direction of rolling shutter readout,<wbr/> which is from top
11039to bottom in the sensor's coordinate system</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11040 </td>
11041
11042 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11043 degrees clockwise rotation,<wbr/> only multiples of
11044 90
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11045 </td>
11046
11047 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]11048 <p>0,<wbr/>90,<wbr/>180,<wbr/>270</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11049 </td>
11050
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11051 <td class="entry_tags">
11052 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]11053 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11054 </ul>
11055 </td>
11056
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11057 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11058
11059
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11060 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11061 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11062
11063
11064 <tr class="entry" id="static_android.sensor.referenceIlluminant1">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11065 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11066 android.<wbr/>sensor.<wbr/>reference<wbr/>Illuminant1
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11067 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11068 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]11069 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11070
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]11071 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11072
11073 <ul class="entry_type_enum">
11074 <li>
11075 <span class="entry_type_enum_name">DAYLIGHT</span>
11076 <span class="entry_type_enum_value">1</span>
11077 </li>
11078 <li>
11079 <span class="entry_type_enum_name">FLUORESCENT</span>
11080 <span class="entry_type_enum_value">2</span>
11081 </li>
11082 <li>
11083 <span class="entry_type_enum_name">TUNGSTEN</span>
11084 <span class="entry_type_enum_value">3</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]11085 <span class="entry_type_enum_notes"><p>Incandescent light</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11086 </li>
11087 <li>
11088 <span class="entry_type_enum_name">FLASH</span>
11089 <span class="entry_type_enum_value">4</span>
11090 </li>
11091 <li>
11092 <span class="entry_type_enum_name">FINE_WEATHER</span>
11093 <span class="entry_type_enum_value">9</span>
11094 </li>
11095 <li>
11096 <span class="entry_type_enum_name">CLOUDY_WEATHER</span>
11097 <span class="entry_type_enum_value">10</span>
11098 </li>
11099 <li>
11100 <span class="entry_type_enum_name">SHADE</span>
11101 <span class="entry_type_enum_value">11</span>
11102 </li>
11103 <li>
11104 <span class="entry_type_enum_name">DAYLIGHT_FLUORESCENT</span>
11105 <span class="entry_type_enum_value">12</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]11106 <span class="entry_type_enum_notes"><p>D 5700 - 7100K</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11107 </li>
11108 <li>
11109 <span class="entry_type_enum_name">DAY_WHITE_FLUORESCENT</span>
11110 <span class="entry_type_enum_value">13</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]11111 <span class="entry_type_enum_notes"><p>N 4600 - 5400K</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11112 </li>
11113 <li>
11114 <span class="entry_type_enum_name">COOL_WHITE_FLUORESCENT</span>
11115 <span class="entry_type_enum_value">14</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]11116 <span class="entry_type_enum_notes"><p>W 3900 - 4500K</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11117 </li>
11118 <li>
11119 <span class="entry_type_enum_name">WHITE_FLUORESCENT</span>
11120 <span class="entry_type_enum_value">15</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]11121 <span class="entry_type_enum_notes"><p>WW 3200 - 3700K</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11122 </li>
11123 <li>
11124 <span class="entry_type_enum_name">STANDARD_A</span>
11125 <span class="entry_type_enum_value">17</span>
11126 </li>
11127 <li>
11128 <span class="entry_type_enum_name">STANDARD_B</span>
11129 <span class="entry_type_enum_value">18</span>
11130 </li>
11131 <li>
11132 <span class="entry_type_enum_name">STANDARD_C</span>
11133 <span class="entry_type_enum_value">19</span>
11134 </li>
11135 <li>
11136 <span class="entry_type_enum_name">D55</span>
11137 <span class="entry_type_enum_value">20</span>
11138 </li>
11139 <li>
11140 <span class="entry_type_enum_name">D65</span>
11141 <span class="entry_type_enum_value">21</span>
11142 </li>
11143 <li>
11144 <span class="entry_type_enum_name">D75</span>
11145 <span class="entry_type_enum_value">22</span>
11146 </li>
11147 <li>
11148 <span class="entry_type_enum_name">D50</span>
11149 <span class="entry_type_enum_value">23</span>
11150 </li>
11151 <li>
11152 <span class="entry_type_enum_name">ISO_STUDIO_TUNGSTEN</span>
11153 <span class="entry_type_enum_value">24</span>
11154 </li>
11155 </ul>
11156
11157 </td> <!-- entry_type -->
11158
11159 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11160 <p>Light source used to define transform
111611</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11162 </td>
11163
11164 <td class="entry_units">
11165 </td>
11166
11167 <td class="entry_range">
11168 </td>
11169
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11170 <td class="entry_tags">
11171 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]11172 <li><a href="#tag_DNG">DNG</a></li>
11173 <li><a href="#tag_EXIF">EXIF</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11174 </ul>
11175 </td>
11176
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11177 </tr>
11178 <tr class="entries_header">
11179 <th class="th_details" colspan="5">Details</th>
11180 </tr>
11181 <tr class="entry_cont">
11182 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11183 <p>[EXIF LightSource tag] Must all these be
11184supported? Need CCT for each!</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11185 </td>
11186 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11187
11188
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11189 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11190 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11191
11192
11193 <tr class="entry" id="static_android.sensor.referenceIlluminant2">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11194 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11195 android.<wbr/>sensor.<wbr/>reference<wbr/>Illuminant2
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11196 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11197 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]11198 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11199
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]11200 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11201
11202
11203 </td> <!-- entry_type -->
11204
11205 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11206 <p>Light source used to define transform
112072</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11208 </td>
11209
11210 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11211 Same as illuminant 1
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11212 </td>
11213
11214 <td class="entry_range">
11215 </td>
11216
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11217 <td class="entry_tags">
11218 </td>
11219
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11220 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11221
11222
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11223 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11224 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11225
11226
11227
11228 <!-- end of kind -->
11229 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11230 <tr><td colspan="6" class="kind">dynamic</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11231
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]11232 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11233 <tr>
11234 <th class="th_name">Property Name</th>
11235 <th class="th_type">Type</th>
11236 <th class="th_description">Description</th>
11237 <th class="th_units">Units</th>
11238 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11239 <th class="th_tags">Tags</th>
11240 </tr>
11241 </thead>
11242
11243 <tbody>
11244
11245
11246
11247
11248
11249
11250
11251
11252
11253
11254 <tr class="entry" id="dynamic_android.sensor.exposureTime">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11255 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11256 android.<wbr/>sensor.<wbr/>exposure<wbr/>Time
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11257 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11258 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]11259 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11260
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]11261 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11262
11263
11264 </td> <!-- entry_type -->
11265
11266 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11267 <p>Duration each pixel is exposed to
11268light.<wbr/></p>
11269<p>If the sensor can't expose this exact duration,<wbr/> it should shorten the
11270duration exposed to the nearest possible value (rather than expose longer).<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11271 </td>
11272
11273 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11274 nanoseconds
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11275 </td>
11276
11277 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]11278 <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]11279 </td>
11280
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11281 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]11282 <ul class="entry_tags">
11283 <li><a href="#tag_V1">V1</a></li>
11284 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11285 </td>
11286
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11287 </tr>
11288 <tr class="entries_header">
11289 <th class="th_details" colspan="5">Details</th>
11290 </tr>
11291 <tr class="entry_cont">
11292 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11293 <p>1/<wbr/>10000 - 30 sec range.<wbr/> No bulb mode</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11294 </td>
11295 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11296
11297
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11298 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11299 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11300
11301
11302 <tr class="entry" id="dynamic_android.sensor.frameDuration">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11303 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11304 android.<wbr/>sensor.<wbr/>frame<wbr/>Duration
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11305 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11306 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]11307 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11308
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]11309 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11310
11311
11312 </td> <!-- entry_type -->
11313
11314 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11315 <p>Duration from start of frame exposure to
Igor Murashkin10f4e0f2014-01-13 17:22:58 -0800[diff] [blame]11316start of next frame exposure.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11317 </td>
11318
11319 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11320 nanoseconds
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11321 </td>
11322
11323 <td class="entry_range">
Igor Murashkin10f4e0f2014-01-13 17:22:58 -0800[diff] [blame]11324 <p>See <a href="#static_android.sensor.info.maxFrameDuration">android.<wbr/>sensor.<wbr/>info.<wbr/>max<wbr/>Frame<wbr/>Duration</a>,<wbr/>
11325android.<wbr/>scaler.<wbr/>available*Min<wbr/>Durations.<wbr/> The duration
11326is capped to <code>max(duration,<wbr/> exposureTime + overhead)</code>.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11327 </td>
11328
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11329 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]11330 <ul class="entry_tags">
11331 <li><a href="#tag_V1">V1</a></li>
11332 <li><a href="#tag_BC">BC</a></li>
11333 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11334 </td>
11335
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11336 </tr>
11337 <tr class="entries_header">
11338 <th class="th_details" colspan="5">Details</th>
11339 </tr>
11340 <tr class="entry_cont">
11341 <td class="entry_details" colspan="5">
Igor Murashkin10f4e0f2014-01-13 17:22:58 -0800[diff] [blame]11342 <p>The maximum frame rate that can be supported by a camera subsystem is
11343a function of many factors:</p>
11344<ul>
11345<li>Requested resolutions of output image streams</li>
11346<li>Availability of binning /<wbr/> skipping modes on the imager</li>
11347<li>The bandwidth of the imager interface</li>
11348<li>The bandwidth of the various ISP processing blocks</li>
11349</ul>
11350<p>Since these factors can vary greatly between different ISPs and
11351sensors,<wbr/> the camera abstraction tries to represent the bandwidth
11352restrictions with as simple a model as possible.<wbr/></p>
11353<p>The model presented has the following characteristics:</p>
11354<ul>
11355<li>The image sensor is always configured to output the smallest
11356resolution possible given the application's requested output stream
11357sizes.<wbr/> The smallest resolution is defined as being at least as large
11358as the largest requested output stream size; the camera pipeline must
11359never digitally upsample sensor data when the crop region covers the
11360whole sensor.<wbr/> In general,<wbr/> this means that if only small output stream
11361resolutions are configured,<wbr/> the sensor can provide a higher frame
11362rate.<wbr/></li>
11363<li>Since any request may use any or all the currently configured
11364output streams,<wbr/> the sensor and ISP must be configured to support
11365scaling a single capture to all the streams at the same time.<wbr/> This
11366means the camera pipeline must be ready to produce the largest
11367requested output size without any delay.<wbr/> Therefore,<wbr/> the overall
11368frame rate of a given configured stream set is governed only by the
11369largest requested stream resolution.<wbr/></li>
11370<li>Using more than one output stream in a request does not affect the
11371frame duration.<wbr/></li>
11372<li>JPEG streams act like processed YUV streams in requests for which
11373they are not included; in requests in which they are directly
11374referenced,<wbr/> they act as JPEG streams.<wbr/> This is because supporting a
11375JPEG stream requires the underlying YUV data to always be ready for
11376use by a JPEG encoder,<wbr/> but the encoder will only be used (and impact
11377frame duration) on requests that actually reference a JPEG stream.<wbr/></li>
11378<li>The JPEG processor can run concurrently to the rest of the camera
11379pipeline,<wbr/> but cannot process more than 1 capture at a time.<wbr/></li>
11380</ul>
11381<p>The necessary information for the application,<wbr/> given the model above,<wbr/>
11382is provided via the android.<wbr/>scaler.<wbr/>available*Min<wbr/>Durations fields.<wbr/>
11383These are used to determine the maximum frame rate /<wbr/> minimum frame
11384duration that is possible for a given stream configuration.<wbr/></p>
11385<p>Specifically,<wbr/> the application can use the following rules to
11386determine the minimum frame duration it can request from the HAL
11387device:</p>
11388<ol>
11389<li>Given the application's currently configured set of output
11390streams,<wbr/> <code>S</code>,<wbr/> divide them into three sets: streams in a JPEG format
11391<code>SJ</code>,<wbr/> streams in a raw sensor format <code>SR</code>,<wbr/> and the rest ('processed')
11392<code>SP</code>.<wbr/></li>
11393<li>For each subset of streams,<wbr/> find the largest resolution (by pixel
11394count) in the subset.<wbr/> This gives (at most) three resolutions <code>RJ</code>,<wbr/>
11395<code>RR</code>,<wbr/> and <code>RP</code>.<wbr/></li>
11396<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
11397no exact match for <code>RP == RJ</code> (in particular there isn't an available
11398processed resolution at the same size as <code>RJ</code>),<wbr/> then set <code>RP</code> equal
11399to the smallest processed resolution that is larger than <code>RJ</code>.<wbr/> If
11400there are no processed resolutions larger than <code>RJ</code>,<wbr/> then set <code>RJ</code> to
11401the processed resolution closest to <code>RJ</code>.<wbr/></li>
11402<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
11403no exact match for <code>RR == RP</code> (in particular there isn't an available
11404raw resolution at the same size as <code>RP</code>),<wbr/> then set <code>RR</code> equal to
11405or to the smallest raw resolution that is larger than <code>RP</code>.<wbr/> If
11406there are no raw resolutions larger than <code>RP</code>,<wbr/> then set <code>RR</code> to
11407the raw resolution closest to <code>RP</code>.<wbr/></li>
11408<li>Look up the matching minimum frame durations in the property lists
11409<a href="#static_android.scaler.availableJpegMinDurations">android.<wbr/>scaler.<wbr/>available<wbr/>Jpeg<wbr/>Min<wbr/>Durations</a>,<wbr/>
11410<a href="#static_android.scaler.availableRawMinDurations">android.<wbr/>scaler.<wbr/>available<wbr/>Raw<wbr/>Min<wbr/>Durations</a>,<wbr/> and
11411<a href="#static_android.scaler.availableProcessedMinDurations">android.<wbr/>scaler.<wbr/>available<wbr/>Processed<wbr/>Min<wbr/>Durations</a>.<wbr/> This gives three
11412minimum frame durations <code>FJ</code>,<wbr/> <code>FR</code>,<wbr/> and <code>FP</code>.<wbr/></li>
11413<li>If a stream of requests do not use a JPEG stream,<wbr/> then the minimum
11414supported frame duration for each request is <code>max(FR,<wbr/> FP)</code>.<wbr/></li>
11415<li>If a stream of requests all use the JPEG stream,<wbr/> then the minimum
11416supported frame duration for each request is <code>max(FR,<wbr/> FP,<wbr/> FJ)</code>.<wbr/></li>
11417<li>If a mix of JPEG-using and non-JPEG-using requests is submitted by
11418the application,<wbr/> then the HAL will have to delay JPEG-using requests
11419whenever the JPEG encoder is still busy processing an older capture.<wbr/>
11420This will happen whenever a JPEG-using request starts capture less
11421than <code>FJ</code> <em>ns</em> after a previous JPEG-using request.<wbr/> The minimum
11422supported frame duration will vary between the values calculated in
11423#6 and #7.<wbr/></li>
11424</ol>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11425 </td>
11426 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11427
11428
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11429 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11430 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11431
11432
11433 <tr class="entry" id="dynamic_android.sensor.sensitivity">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11434 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11435 android.<wbr/>sensor.<wbr/>sensitivity
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11436 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11437 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]11438 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11439
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]11440 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11441
11442
11443 </td> <!-- entry_type -->
11444
11445 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11446 <p>Gain applied to image data.<wbr/> Must be
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]11447implemented through analog gain only if set to values
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11448below 'maximum analog sensitivity'.<wbr/></p>
11449<p>If the sensor can't apply this exact gain,<wbr/> it should lessen the
11450gain to the nearest possible value (rather than gain more).<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11451 </td>
11452
11453 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11454 ISO arithmetic units
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11455 </td>
11456
11457 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]11458 <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]11459 </td>
11460
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11461 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]11462 <ul class="entry_tags">
11463 <li><a href="#tag_V1">V1</a></li>
11464 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11465 </td>
11466
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11467 </tr>
11468 <tr class="entries_header">
11469 <th class="th_details" colspan="5">Details</th>
11470 </tr>
11471 <tr class="entry_cont">
11472 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11473 <p>ISO 12232:2006 REI method</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11474 </td>
11475 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11476
11477
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11478 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11479 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11480
11481
11482 <tr class="entry" id="dynamic_android.sensor.timestamp">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11483 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11484 android.<wbr/>sensor.<wbr/>timestamp
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11485 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11486 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]11487 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11488
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]11489 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11490
11491
11492 </td> <!-- entry_type -->
11493
11494 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11495 <p>Time at start of exposure of first
11496row</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11497 </td>
11498
11499 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11500 nanoseconds
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11501 </td>
11502
11503 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame]11504 <p>&gt; 0</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11505 </td>
11506
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11507 <td class="entry_tags">
11508 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]11509 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11510 </ul>
11511 </td>
11512
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11513 </tr>
11514 <tr class="entries_header">
11515 <th class="th_details" colspan="5">Details</th>
11516 </tr>
11517 <tr class="entry_cont">
11518 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11519 <p>Monotonic,<wbr/> should be synced to other timestamps in
11520system</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11521 </td>
11522 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11523
11524
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11525 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11526 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11527
Igor Murashkin656aa5a2013-08-13 14:23:39 -0700[diff] [blame]11528
11529 <tr class="entry" id="dynamic_android.sensor.temperature">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11530 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11531 android.<wbr/>sensor.<wbr/>temperature
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11532 </td>
Igor Murashkin656aa5a2013-08-13 14:23:39 -0700[diff] [blame]11533 <td class="entry_type">
11534 <span class="entry_type_name">float</span>
11535
11536 <span class="entry_type_visibility"> [public]</span>
11537
11538
11539 </td> <!-- entry_type -->
11540
11541 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11542 <p>The temperature of the sensor,<wbr/> sampled at the time
11543exposure began for this frame.<wbr/></p>
11544<p>The thermal diode being queried should be inside the sensor PCB,<wbr/> or
11545somewhere close to it.<wbr/></p>
Igor Murashkin656aa5a2013-08-13 14:23:39 -0700[diff] [blame]11546 </td>
11547
11548 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11549 celsius
Igor Murashkin656aa5a2013-08-13 14:23:39 -0700[diff] [blame]11550 </td>
11551
11552 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]11553 <p>Optional.<wbr/> This value is missing if no temperature is available.<wbr/></p>
Igor Murashkin656aa5a2013-08-13 14:23:39 -0700[diff] [blame]11554 </td>
11555
Igor Murashkin656aa5a2013-08-13 14:23:39 -0700[diff] [blame]11556 <td class="entry_tags">
Alex Rayef40ad62013-10-01 17:52:33 -0700[diff] [blame]11557 <ul class="entry_tags">
11558 <li><a href="#tag_FULL">FULL</a></li>
11559 </ul>
Igor Murashkin656aa5a2013-08-13 14:23:39 -0700[diff] [blame]11560 </td>
11561
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11562 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11563
11564
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11565 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11566 <!-- end of entry -->
Igor Murashkin656aa5a2013-08-13 14:23:39 -0700[diff] [blame]11567
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11568
11569
11570 <!-- end of kind -->
11571 </tbody>
11572
11573 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11574 <tr><td colspan="6" id="section_shading" class="section">shading</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11575
11576
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11577 <tr><td colspan="6" class="kind">controls</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11578
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]11579 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11580 <tr>
11581 <th class="th_name">Property Name</th>
11582 <th class="th_type">Type</th>
11583 <th class="th_description">Description</th>
11584 <th class="th_units">Units</th>
11585 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11586 <th class="th_tags">Tags</th>
11587 </tr>
11588 </thead>
11589
11590 <tbody>
11591
11592
11593
11594
11595
11596
11597
11598
11599
11600
11601 <tr class="entry" id="controls_android.shading.mode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11602 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11603 android.<wbr/>shading.<wbr/>mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11604 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11605 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]11606 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11607
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]11608 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11609
11610 <ul class="entry_type_enum">
11611 <li>
11612 <span class="entry_type_enum_name">OFF</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]11613 <span class="entry_type_enum_notes"><p>No shading correction is applied</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11614 </li>
11615 <li>
11616 <span class="entry_type_enum_name">FAST</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]11617 <span class="entry_type_enum_notes"><p>Must not slow down frame rate relative to raw
11618bayer output</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11619 </li>
11620 <li>
11621 <span class="entry_type_enum_name">HIGH_QUALITY</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]11622 <span class="entry_type_enum_notes"><p>Frame rate may be reduced by high
11623quality</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11624 </li>
11625 </ul>
11626
11627 </td> <!-- entry_type -->
11628
11629 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11630 <p>Quality of lens shading correction applied
11631to the image data</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11632 </td>
11633
11634 <td class="entry_units">
11635 </td>
11636
11637 <td class="entry_range">
11638 </td>
11639
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11640 <td class="entry_tags">
11641 </td>
11642
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11643 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11644
11645
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11646 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11647 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11648
11649
11650 <tr class="entry" id="controls_android.shading.strength">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11651 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11652 android.<wbr/>shading.<wbr/>strength
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11653 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11654 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]11655 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11656
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]11657 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11658
11659
11660 </td> <!-- entry_type -->
11661
11662 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11663 <p>Control the amount of shading correction
11664applied to the images</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11665 </td>
11666
11667 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11668 unitless: 1-10; 10 is full shading
11669 compensation
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11670 </td>
11671
11672 <td class="entry_range">
11673 </td>
11674
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11675 <td class="entry_tags">
11676 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]11677 <li><a href="#tag_ADV">ADV</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11678 </ul>
11679 </td>
11680
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11681 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11682
11683
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11684 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11685 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11686
11687
11688
11689 <!-- end of kind -->
11690 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11691 <tr><td colspan="6" class="kind">dynamic</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11692
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]11693 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11694 <tr>
11695 <th class="th_name">Property Name</th>
11696 <th class="th_type">Type</th>
11697 <th class="th_description">Description</th>
11698 <th class="th_units">Units</th>
11699 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11700 <th class="th_tags">Tags</th>
11701 </tr>
11702 </thead>
11703
11704 <tbody>
11705
11706
11707
11708
11709
11710
11711
11712
11713
11714
11715 <tr class="entry" id="dynamic_android.shading.mode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11716 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11717 android.<wbr/>shading.<wbr/>mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11718 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11719 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]11720 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11721
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]11722 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11723
11724 <ul class="entry_type_enum">
11725 <li>
11726 <span class="entry_type_enum_name">OFF</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]11727 <span class="entry_type_enum_notes"><p>No shading correction is applied</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11728 </li>
11729 <li>
11730 <span class="entry_type_enum_name">FAST</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]11731 <span class="entry_type_enum_notes"><p>Must not slow down frame rate relative to raw
11732bayer output</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11733 </li>
11734 <li>
11735 <span class="entry_type_enum_name">HIGH_QUALITY</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]11736 <span class="entry_type_enum_notes"><p>Frame rate may be reduced by high
11737quality</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11738 </li>
11739 </ul>
11740
11741 </td> <!-- entry_type -->
11742
11743 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11744 <p>Quality of lens shading correction applied
11745to the image data</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11746 </td>
11747
11748 <td class="entry_units">
11749 </td>
11750
11751 <td class="entry_range">
11752 </td>
11753
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11754 <td class="entry_tags">
11755 </td>
11756
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11757 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11758
11759
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11760 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11761 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11762
11763
11764
11765 <!-- end of kind -->
11766 </tbody>
11767
11768 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11769 <tr><td colspan="6" id="section_statistics" class="section">statistics</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11770
11771
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11772 <tr><td colspan="6" class="kind">controls</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11773
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]11774 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11775 <tr>
11776 <th class="th_name">Property Name</th>
11777 <th class="th_type">Type</th>
11778 <th class="th_description">Description</th>
11779 <th class="th_units">Units</th>
11780 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11781 <th class="th_tags">Tags</th>
11782 </tr>
11783 </thead>
11784
11785 <tbody>
11786
11787
11788
11789
11790
11791
11792
11793
11794
11795
11796 <tr class="entry" id="controls_android.statistics.faceDetectMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11797 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11798 android.<wbr/>statistics.<wbr/>face<wbr/>Detect<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11799 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11800 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]11801 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11802
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]11803 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11804
11805 <ul class="entry_type_enum">
11806 <li>
11807 <span class="entry_type_enum_name">OFF</span>
11808 </li>
11809 <li>
11810 <span class="entry_type_enum_name">SIMPLE</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]11811 <span class="entry_type_enum_notes"><p>Optional Return rectangle and confidence
11812only</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11813 </li>
11814 <li>
11815 <span class="entry_type_enum_name">FULL</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]11816 <span class="entry_type_enum_notes"><p>Optional Return all face
11817metadata</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11818 </li>
11819 </ul>
11820
11821 </td> <!-- entry_type -->
11822
11823 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11824 <p>State of the face detector
11825unit</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11826 </td>
11827
11828 <td class="entry_units">
11829 </td>
11830
11831 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]11832 <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]11833 </td>
11834
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11835 <td class="entry_tags">
11836 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]11837 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11838 </ul>
11839 </td>
11840
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11841 </tr>
11842 <tr class="entries_header">
11843 <th class="th_details" colspan="5">Details</th>
11844 </tr>
11845 <tr class="entry_cont">
11846 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11847 <p>Whether face detection is enabled,<wbr/> and whether it
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11848should output just the basic fields or the full set of
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11849fields.<wbr/> Value must be one of the
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]11850<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]11851 </td>
11852 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11853
11854
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11855 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11856 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11857
11858
11859 <tr class="entry" id="controls_android.statistics.histogramMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11860 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11861 android.<wbr/>statistics.<wbr/>histogram<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11862 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11863 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]11864 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11865
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]11866 <span class="entry_type_visibility"> [system as boolean]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11867
11868 <ul class="entry_type_enum">
11869 <li>
11870 <span class="entry_type_enum_name">OFF</span>
11871 </li>
11872 <li>
11873 <span class="entry_type_enum_name">ON</span>
11874 </li>
11875 </ul>
11876
11877 </td> <!-- entry_type -->
11878
11879 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11880 <p>Operating mode for histogram
11881generation</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11882 </td>
11883
11884 <td class="entry_units">
11885 </td>
11886
11887 <td class="entry_range">
11888 </td>
11889
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11890 <td class="entry_tags">
11891 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]11892 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11893 </ul>
11894 </td>
11895
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11896 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11897
11898
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11899 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11900 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11901
11902
11903 <tr class="entry" id="controls_android.statistics.sharpnessMapMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11904 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11905 android.<wbr/>statistics.<wbr/>sharpness<wbr/>Map<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11906 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11907 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]11908 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11909
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]11910 <span class="entry_type_visibility"> [system as boolean]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11911
11912 <ul class="entry_type_enum">
11913 <li>
11914 <span class="entry_type_enum_name">OFF</span>
11915 </li>
11916 <li>
11917 <span class="entry_type_enum_name">ON</span>
11918 </li>
11919 </ul>
11920
11921 </td> <!-- entry_type -->
11922
11923 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11924 <p>Operating mode for sharpness map
11925generation</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11926 </td>
11927
11928 <td class="entry_units">
11929 </td>
11930
11931 <td class="entry_range">
11932 </td>
11933
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11934 <td class="entry_tags">
11935 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]11936 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11937 </ul>
11938 </td>
11939
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11940 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11941
11942
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11943 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11944 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11945
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]11946
11947 <tr class="entry" id="controls_android.statistics.lensShadingMapMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11948 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11949 android.<wbr/>statistics.<wbr/>lens<wbr/>Shading<wbr/>Map<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11950 </td>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]11951 <td class="entry_type">
11952 <span class="entry_type_name entry_type_name_enum">byte</span>
11953
11954 <span class="entry_type_visibility"> [public]</span>
11955
11956 <ul class="entry_type_enum">
11957 <li>
11958 <span class="entry_type_enum_name">OFF</span>
11959 </li>
11960 <li>
11961 <span class="entry_type_enum_name">ON</span>
11962 </li>
11963 </ul>
11964
11965 </td> <!-- entry_type -->
11966
11967 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11968 <p>Whether the HAL needs to output the lens
11969shading map in output result metadata</p>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]11970 </td>
11971
11972 <td class="entry_units">
11973 </td>
11974
11975 <td class="entry_range">
11976 </td>
11977
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11978 <td class="entry_tags">
11979 </td>
11980
11981 </tr>
11982 <tr class="entries_header">
11983 <th class="th_details" colspan="5">Details</th>
11984 </tr>
11985 <tr class="entry_cont">
11986 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11987 <p>When set to ON,<wbr/>
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]11988<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]11989the output result metadata.<wbr/></p>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]11990 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11991 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11992
11993
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11994 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11995 <!-- end of entry -->
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]11996
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11997
11998
11999 <!-- end of kind -->
12000 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12001 <tr><td colspan="6" class="kind">static</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12002
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]12003 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12004 <tr>
12005 <th class="th_name">Property Name</th>
12006 <th class="th_type">Type</th>
12007 <th class="th_description">Description</th>
12008 <th class="th_units">Units</th>
12009 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12010 <th class="th_tags">Tags</th>
12011 </tr>
12012 </thead>
12013
12014 <tbody>
12015
12016
12017
12018
12019
12020
12021
12022
12023
12024
12025
12026
12027 <tr class="entry" id="static_android.statistics.info.availableFaceDetectModes">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12028 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12029 android.<wbr/>statistics.<wbr/>info.<wbr/>available<wbr/>Face<wbr/>Detect<wbr/>Modes
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12030 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12031 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]12032 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12033 <span class="entry_type_container">x</span>
12034
12035 <span class="entry_type_array">
12036 n
12037 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]12038 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12039 <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]12040
12041
12042 </td> <!-- entry_type -->
12043
12044 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12045 <p>Which face detection modes are available,<wbr/>
12046if any</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12047 </td>
12048
12049 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12050 List of enum:
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]12051 OFF
12052 SIMPLE
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12053 FULL
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12054 </td>
12055
12056 <td class="entry_range">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12057 </td>
12058
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12059 <td class="entry_tags">
12060 </td>
12061
12062 </tr>
12063 <tr class="entries_header">
12064 <th class="th_details" colspan="5">Details</th>
12065 </tr>
12066 <tr class="entry_cont">
12067 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12068 <p>OFF means face detection is disabled,<wbr/> it must
12069be included in the list.<wbr/></p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]12070<p>SIMPLE means the device supports the
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]12071<a href="#dynamic_android.statistics.faceRectangles">android.<wbr/>statistics.<wbr/>face<wbr/>Rectangles</a> and
12072<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]12073<p>FULL means the device additionally supports the
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]12074<a href="#dynamic_android.statistics.faceIds">android.<wbr/>statistics.<wbr/>face<wbr/>Ids</a> and
12075<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]12076 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12077 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12078
12079
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12080 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
12081 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12082
12083
12084 <tr class="entry" id="static_android.statistics.info.histogramBucketCount">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12085 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12086 android.<wbr/>statistics.<wbr/>info.<wbr/>histogram<wbr/>Bucket<wbr/>Count
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12087 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12088 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]12089 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12090
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]12091 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12092
12093
12094 </td> <!-- entry_type -->
12095
12096 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12097 <p>Number of histogram buckets
12098supported</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12099 </td>
12100
12101 <td class="entry_units">
12102 </td>
12103
12104 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame]12105 <p>&gt;= 64</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12106 </td>
12107
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12108 <td class="entry_tags">
12109 </td>
12110
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12111 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12112
12113
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12114 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
12115 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12116
12117
12118 <tr class="entry" id="static_android.statistics.info.maxFaceCount">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12119 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12120 android.<wbr/>statistics.<wbr/>info.<wbr/>max<wbr/>Face<wbr/>Count
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12121 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12122 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]12123 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12124
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]12125 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12126
12127
12128 </td> <!-- entry_type -->
12129
12130 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12131 <p>Maximum number of simultaneously detectable
12132faces</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12133 </td>
12134
12135 <td class="entry_units">
12136 </td>
12137
12138 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame]12139 <p>&gt;= 4 if availableFaceDetectionModes lists
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]12140modes besides OFF,<wbr/> otherwise 0</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12141 </td>
12142
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12143 <td class="entry_tags">
12144 </td>
12145
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12146 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12147
12148
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12149 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
12150 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12151
12152
12153 <tr class="entry" id="static_android.statistics.info.maxHistogramCount">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12154 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12155 android.<wbr/>statistics.<wbr/>info.<wbr/>max<wbr/>Histogram<wbr/>Count
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12156 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12157 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]12158 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12159
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]12160 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12161
12162
12163 </td> <!-- entry_type -->
12164
12165 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12166 <p>Maximum value possible for a histogram
12167bucket</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12168 </td>
12169
12170 <td class="entry_units">
12171 </td>
12172
12173 <td class="entry_range">
12174 </td>
12175
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12176 <td class="entry_tags">
12177 </td>
12178
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12179 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12180
12181
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12182 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
12183 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12184
12185
12186 <tr class="entry" id="static_android.statistics.info.maxSharpnessMapValue">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12187 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12188 android.<wbr/>statistics.<wbr/>info.<wbr/>max<wbr/>Sharpness<wbr/>Map<wbr/>Value
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12189 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12190 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]12191 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12192
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]12193 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12194
12195
12196 </td> <!-- entry_type -->
12197
12198 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12199 <p>Maximum value possible for a sharpness map
12200region.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12201 </td>
12202
12203 <td class="entry_units">
12204 </td>
12205
12206 <td class="entry_range">
12207 </td>
12208
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12209 <td class="entry_tags">
12210 </td>
12211
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12212 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12213
12214
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12215 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
12216 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12217
12218
12219 <tr class="entry" id="static_android.statistics.info.sharpnessMapSize">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12220 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12221 android.<wbr/>statistics.<wbr/>info.<wbr/>sharpness<wbr/>Map<wbr/>Size
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12222 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12223 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]12224 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12225 <span class="entry_type_container">x</span>
12226
12227 <span class="entry_type_array">
12228 2
12229 </span>
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]12230 <span class="entry_type_visibility"> [system as size]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12231 <div class="entry_type_notes">width x height</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12232
12233
12234 </td> <!-- entry_type -->
12235
12236 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12237 <p>Dimensions of the sharpness
12238map</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12239 </td>
12240
12241 <td class="entry_units">
12242 </td>
12243
12244 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]12245 <p>Must be at least 32 x 32</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12246 </td>
12247
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12248 <td class="entry_tags">
12249 </td>
12250
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12251 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12252
12253
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12254 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
12255 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12256
12257
12258
12259
12260
12261
12262 <!-- end of kind -->
12263 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12264 <tr><td colspan="6" class="kind">dynamic</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12265
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]12266 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12267 <tr>
12268 <th class="th_name">Property Name</th>
12269 <th class="th_type">Type</th>
12270 <th class="th_description">Description</th>
12271 <th class="th_units">Units</th>
12272 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12273 <th class="th_tags">Tags</th>
12274 </tr>
12275 </thead>
12276
12277 <tbody>
12278
12279
12280
12281
12282
12283
12284
12285
12286
12287
12288 <tr class="entry" id="dynamic_android.statistics.faceDetectMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12289 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12290 android.<wbr/>statistics.<wbr/>face<wbr/>Detect<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12291 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12292 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]12293 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12294
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]12295 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12296
12297 <ul class="entry_type_enum">
12298 <li>
12299 <span class="entry_type_enum_name">OFF</span>
12300 </li>
12301 <li>
12302 <span class="entry_type_enum_name">SIMPLE</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]12303 <span class="entry_type_enum_notes"><p>Optional Return rectangle and confidence
12304only</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12305 </li>
12306 <li>
12307 <span class="entry_type_enum_name">FULL</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]12308 <span class="entry_type_enum_notes"><p>Optional Return all face
12309metadata</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12310 </li>
12311 </ul>
12312
12313 </td> <!-- entry_type -->
12314
12315 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12316 <p>State of the face detector
12317unit</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12318 </td>
12319
12320 <td class="entry_units">
12321 </td>
12322
12323 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]12324 <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]12325 </td>
12326
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12327 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]12328 <ul class="entry_tags">
12329 <li><a href="#tag_BC">BC</a></li>
12330 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12331 </td>
12332
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12333 </tr>
12334 <tr class="entries_header">
12335 <th class="th_details" colspan="5">Details</th>
12336 </tr>
12337 <tr class="entry_cont">
12338 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12339 <p>Whether face detection is enabled,<wbr/> and whether it
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12340should output just the basic fields or the full set of
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12341fields.<wbr/> Value must be one of the
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]12342<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]12343 </td>
12344 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12345
12346
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12347 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
12348 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12349
12350
12351 <tr class="entry" id="dynamic_android.statistics.faceIds">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12352 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12353 android.<wbr/>statistics.<wbr/>face<wbr/>Ids
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12354 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12355 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]12356 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12357 <span class="entry_type_container">x</span>
12358
12359 <span class="entry_type_array">
12360 n
12361 </span>
Zhijun He3b4c2062013-10-07 11:23:30 -0700[diff] [blame]12362 <span class="entry_type_visibility"> [hidden]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12363
12364
12365 </td> <!-- entry_type -->
12366
12367 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12368 <p>List of unique IDs for detected
12369faces</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12370 </td>
12371
12372 <td class="entry_units">
12373 </td>
12374
12375 <td class="entry_range">
12376 </td>
12377
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12378 <td class="entry_tags">
12379 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]12380 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12381 </ul>
12382 </td>
12383
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12384 </tr>
12385 <tr class="entries_header">
12386 <th class="th_details" colspan="5">Details</th>
12387 </tr>
12388 <tr class="entry_cont">
12389 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12390 <p>Only available if faceDetectMode == FULL</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12391 </td>
12392 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12393
12394
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12395 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
12396 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12397
12398
12399 <tr class="entry" id="dynamic_android.statistics.faceLandmarks">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12400 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12401 android.<wbr/>statistics.<wbr/>face<wbr/>Landmarks
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12402 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12403 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]12404 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12405 <span class="entry_type_container">x</span>
12406
12407 <span class="entry_type_array">
12408 n x 6
12409 </span>
Zhijun He3b4c2062013-10-07 11:23:30 -0700[diff] [blame]12410 <span class="entry_type_visibility"> [hidden]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12411 <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]12412
12413
12414 </td> <!-- entry_type -->
12415
12416 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12417 <p>List of landmarks for detected
12418faces</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12419 </td>
12420
12421 <td class="entry_units">
12422 </td>
12423
12424 <td class="entry_range">
12425 </td>
12426
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12427 <td class="entry_tags">
12428 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]12429 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12430 </ul>
12431 </td>
12432
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12433 </tr>
12434 <tr class="entries_header">
12435 <th class="th_details" colspan="5">Details</th>
12436 </tr>
12437 <tr class="entry_cont">
12438 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12439 <p>Only available if faceDetectMode == FULL</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12440 </td>
12441 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12442
12443
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12444 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
12445 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12446
12447
12448 <tr class="entry" id="dynamic_android.statistics.faceRectangles">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12449 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12450 android.<wbr/>statistics.<wbr/>face<wbr/>Rectangles
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12451 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12452 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]12453 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12454 <span class="entry_type_container">x</span>
12455
12456 <span class="entry_type_array">
12457 n x 4
12458 </span>
Zhijun He3b4c2062013-10-07 11:23:30 -0700[diff] [blame]12459 <span class="entry_type_visibility"> [hidden as rectangle]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12460 <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]12461
12462
12463 </td> <!-- entry_type -->
12464
12465 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12466 <p>List of the bounding rectangles for detected
12467faces</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12468 </td>
12469
12470 <td class="entry_units">
12471 </td>
12472
12473 <td class="entry_range">
12474 </td>
12475
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12476 <td class="entry_tags">
12477 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]12478 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12479 </ul>
12480 </td>
12481
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12482 </tr>
12483 <tr class="entries_header">
12484 <th class="th_details" colspan="5">Details</th>
12485 </tr>
12486 <tr class="entry_cont">
12487 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12488 <p>Only available if faceDetectMode != OFF</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12489 </td>
12490 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12491
12492
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12493 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
12494 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12495
12496
12497 <tr class="entry" id="dynamic_android.statistics.faceScores">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12498 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12499 android.<wbr/>statistics.<wbr/>face<wbr/>Scores
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12500 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12501 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]12502 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12503 <span class="entry_type_container">x</span>
12504
12505 <span class="entry_type_array">
12506 n
12507 </span>
Zhijun He3b4c2062013-10-07 11:23:30 -0700[diff] [blame]12508 <span class="entry_type_visibility"> [hidden]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12509
12510
12511 </td> <!-- entry_type -->
12512
12513 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12514 <p>List of the face confidence scores for
12515detected faces</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12516 </td>
12517
12518 <td class="entry_units">
12519 </td>
12520
12521 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]12522 <p>1-100</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12523 </td>
12524
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12525 <td class="entry_tags">
12526 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]12527 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12528 </ul>
12529 </td>
12530
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12531 </tr>
12532 <tr class="entries_header">
12533 <th class="th_details" colspan="5">Details</th>
12534 </tr>
12535 <tr class="entry_cont">
12536 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12537 <p>Only available if faceDetectMode != OFF.<wbr/> The value should be
12538meaningful (for example,<wbr/> setting 100 at all times is illegal).<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12539 </td>
12540 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12541
12542
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12543 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
12544 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12545
12546
12547 <tr class="entry" id="dynamic_android.statistics.histogram">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12548 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12549 android.<wbr/>statistics.<wbr/>histogram
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12550 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12551 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]12552 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12553 <span class="entry_type_container">x</span>
12554
12555 <span class="entry_type_array">
12556 n x 3
12557 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]12558 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12559 <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]12560
12561
12562 </td> <!-- entry_type -->
12563
12564 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12565 <p>A 3-channel histogram based on the raw
12566sensor data</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12567 </td>
12568
12569 <td class="entry_units">
12570 </td>
12571
12572 <td class="entry_range">
12573 </td>
12574
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12575 <td class="entry_tags">
12576 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]12577 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12578 </ul>
12579 </td>
12580
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12581 </tr>
12582 <tr class="entries_header">
12583 <th class="th_details" colspan="5">Details</th>
12584 </tr>
12585 <tr class="entry_cont">
12586 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12587 <p>The k'th bucket (0-based) covers the input range
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]12588(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]12589(k + 1) * w /<wbr/> N ).<wbr/> If only a monochrome sharpness map is
12590supported,<wbr/> all channels should have the same data</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12591 </td>
12592 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12593
12594
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12595 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
12596 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12597
12598
12599 <tr class="entry" id="dynamic_android.statistics.histogramMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12600 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12601 android.<wbr/>statistics.<wbr/>histogram<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12602 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12603 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]12604 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12605
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]12606 <span class="entry_type_visibility"> [system as boolean]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12607
12608 <ul class="entry_type_enum">
12609 <li>
12610 <span class="entry_type_enum_name">OFF</span>
12611 </li>
12612 <li>
12613 <span class="entry_type_enum_name">ON</span>
12614 </li>
12615 </ul>
12616
12617 </td> <!-- entry_type -->
12618
12619 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12620 <p>Operating mode for histogram
12621generation</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12622 </td>
12623
12624 <td class="entry_units">
12625 </td>
12626
12627 <td class="entry_range">
12628 </td>
12629
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12630 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]12631 <ul class="entry_tags">
12632 <li><a href="#tag_V1">V1</a></li>
12633 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12634 </td>
12635
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12636 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12637
12638
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12639 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
12640 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12641
12642
12643 <tr class="entry" id="dynamic_android.statistics.sharpnessMap">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12644 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12645 android.<wbr/>statistics.<wbr/>sharpness<wbr/>Map
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12646 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12647 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]12648 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12649 <span class="entry_type_container">x</span>
12650
12651 <span class="entry_type_array">
12652 n x m x 3
12653 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]12654 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12655 <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]12656
12657
12658 </td> <!-- entry_type -->
12659
12660 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12661 <p>A 3-channel sharpness map,<wbr/> based on the raw
12662sensor data</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12663 </td>
12664
12665 <td class="entry_units">
12666 </td>
12667
12668 <td class="entry_range">
12669 </td>
12670
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12671 <td class="entry_tags">
12672 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]12673 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12674 </ul>
12675 </td>
12676
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12677 </tr>
12678 <tr class="entries_header">
12679 <th class="th_details" colspan="5">Details</th>
12680 </tr>
12681 <tr class="entry_cont">
12682 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12683 <p>If only a monochrome sharpness map is supported,<wbr/>
12684all channels should have the same data</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12685 </td>
12686 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12687
12688
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12689 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
12690 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12691
12692
12693 <tr class="entry" id="dynamic_android.statistics.sharpnessMapMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12694 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12695 android.<wbr/>statistics.<wbr/>sharpness<wbr/>Map<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12696 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12697 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]12698 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12699
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]12700 <span class="entry_type_visibility"> [system as boolean]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12701
12702 <ul class="entry_type_enum">
12703 <li>
12704 <span class="entry_type_enum_name">OFF</span>
12705 </li>
12706 <li>
12707 <span class="entry_type_enum_name">ON</span>
12708 </li>
12709 </ul>
12710
12711 </td> <!-- entry_type -->
12712
12713 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12714 <p>Operating mode for sharpness map
12715generation</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12716 </td>
12717
12718 <td class="entry_units">
12719 </td>
12720
12721 <td class="entry_range">
12722 </td>
12723
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12724 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]12725 <ul class="entry_tags">
12726 <li><a href="#tag_V1">V1</a></li>
12727 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12728 </td>
12729
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12730 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12731
12732
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12733 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
12734 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12735
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]12736
12737 <tr class="entry" id="dynamic_android.statistics.lensShadingMap">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12738 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12739 android.<wbr/>statistics.<wbr/>lens<wbr/>Shading<wbr/>Map
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12740 </td>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]12741 <td class="entry_type">
12742 <span class="entry_type_name">float</span>
12743 <span class="entry_type_container">x</span>
12744
12745 <span class="entry_type_array">
12746 4 x n x m
12747 </span>
12748 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12749 <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]12750
12751
12752 </td> <!-- entry_type -->
12753
12754 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12755 <p>The shading map is a low-resolution floating-point map
12756that lists the coefficients used to correct for vignetting,<wbr/> for each
12757Bayer color channel.<wbr/></p>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]12758 </td>
12759
12760 <td class="entry_units">
12761 </td>
12762
12763 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]12764 <p>Each gain factor is &gt;= 1</p>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]12765 </td>
12766
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12767 <td class="entry_tags">
12768 </td>
12769
12770 </tr>
12771 <tr class="entries_header">
12772 <th class="th_details" colspan="5">Details</th>
12773 </tr>
12774 <tr class="entry_cont">
12775 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12776 <p>The least shaded section of the image should have a gain factor
12777of 1; all other sections should have gains above 1.<wbr/></p>
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]12778<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]12779must take into account the colorCorrection settings.<wbr/></p>
12780<p>The shading map is for the entire active pixel array,<wbr/> and is not
12781affected by the crop region specified in the request.<wbr/> Each shading map
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]12782entry is the value of the shading compensation map over a specific
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12783pixel on the sensor.<wbr/> Specifically,<wbr/> with a (N x M) resolution shading
12784map,<wbr/> and an active pixel array size (W x H),<wbr/> shading map entry
12785(x,<wbr/>y) ϵ (0 ...<wbr/> N-1,<wbr/> 0 ...<wbr/> M-1) is the value of the shading map at
12786pixel ( ((W-1)/<wbr/>(N-1)) * x,<wbr/> ((H-1)/<wbr/>(M-1)) * y) for the four color channels.<wbr/>
12787The map is assumed to be bilinearly interpolated between the sample points.<wbr/></p>
12788<p>The channel order is [R,<wbr/> Geven,<wbr/> Godd,<wbr/> B],<wbr/> where Geven is the green
12789channel for the even rows of a Bayer pattern,<wbr/> and Godd is the odd rows.<wbr/>
12790The shading map is stored in a fully interleaved format,<wbr/> and its size
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]12791is 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]12792<p>The shading map should have on the order of 30-40 rows and columns,<wbr/>
12793and must be smaller than 64x64.<wbr/></p>
12794<p>As an example,<wbr/> given a very small map defined as:</p>
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]12795<pre><code><a href="#static_android.lens.info.shadingMapSize">android.<wbr/>lens.<wbr/>info.<wbr/>shading<wbr/>Map<wbr/>Size</a> = [ 4,<wbr/> 3 ]
12796<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]12797[ 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/>
12798 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/>
12799 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/>
12800 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/>
12801 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/>
12802 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]12803</code></pre>
12804<p>The low-resolution scaling map images for each channel are
12805(displayed using nearest-neighbor interpolation):</p>
12806<p><img alt="Red lens shading map" src="images/camera2/metadata/android.statistics.lensShadingMap/red_shading.png"/>
12807<img alt="Green (even rows) lens shading map" src="images/camera2/metadata/android.statistics.lensShadingMap/green_e_shading.png"/>
12808<img alt="Green (odd rows) lens shading map" src="images/camera2/metadata/android.statistics.lensShadingMap/green_o_shading.png"/>
12809<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]12810<p>As a visualization only,<wbr/> inverting the full-color map to recover an
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]12811image 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]12812<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]12813 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12814 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12815
12816
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12817 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
12818 <!-- end of entry -->
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]12819
12820
12821 <tr class="entry" id="dynamic_android.statistics.predictedColorGains">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12822 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12823 android.<wbr/>statistics.<wbr/>predicted<wbr/>Color<wbr/>Gains
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12824 </td>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]12825 <td class="entry_type">
12826 <span class="entry_type_name">float</span>
12827 <span class="entry_type_container">x</span>
12828
12829 <span class="entry_type_array">
12830 4
12831 </span>
Igor Murashkin0fe2f132014-01-13 16:59:47 -0800[diff] [blame]12832 <span class="entry_type_visibility"> [hidden]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12833 <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]12834
12835
12836 </td> <!-- entry_type -->
12837
12838 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12839 <p>The best-fit color channel gains calculated
12840by the HAL's statistics units for the current output frame</p>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]12841 </td>
12842
12843 <td class="entry_units">
12844 </td>
12845
12846 <td class="entry_range">
Igor Murashkin0fe2f132014-01-13 16:59:47 -0800[diff] [blame]12847 <p><strong>Deprecated</strong>.<wbr/> Do not use.<wbr/></p>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]12848 </td>
12849
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12850 <td class="entry_tags">
12851 </td>
12852
12853 </tr>
12854 <tr class="entries_header">
12855 <th class="th_details" colspan="5">Details</th>
12856 </tr>
12857 <tr class="entry_cont">
12858 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12859 <p>This may be different than the gains used for this frame,<wbr/>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]12860since statistics processing on data from a new frame
12861typically completes after the transform has already been
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12862applied to that frame.<wbr/></p>
12863<p>The 4 channel gains are defined in Bayer domain,<wbr/>
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]12864see <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]12865<p>This value should always be calculated by the AWB block,<wbr/>
12866regardless of the android.<wbr/>control.<wbr/>* current values.<wbr/></p>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]12867 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12868 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12869
12870
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12871 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
12872 <!-- end of entry -->
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]12873
12874
12875 <tr class="entry" id="dynamic_android.statistics.predictedColorTransform">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12876 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12877 android.<wbr/>statistics.<wbr/>predicted<wbr/>Color<wbr/>Transform
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12878 </td>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]12879 <td class="entry_type">
12880 <span class="entry_type_name">rational</span>
12881 <span class="entry_type_container">x</span>
12882
12883 <span class="entry_type_array">
12884 3 x 3
12885 </span>
Igor Murashkin0fe2f132014-01-13 16:59:47 -0800[diff] [blame]12886 <span class="entry_type_visibility"> [hidden]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12887 <div class="entry_type_notes">3x3 rational matrix in row-major order</div>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]12888
12889
12890 </td> <!-- entry_type -->
12891
12892 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12893 <p>The best-fit color transform matrix estimate
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]12894calculated by the HAL's statistics units for the current
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12895output frame</p>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]12896 </td>
12897
12898 <td class="entry_units">
12899 </td>
12900
12901 <td class="entry_range">
Igor Murashkin0fe2f132014-01-13 16:59:47 -0800[diff] [blame]12902 <p><strong>Deprecated</strong>.<wbr/> Do not use.<wbr/></p>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]12903 </td>
12904
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12905 <td class="entry_tags">
12906 </td>
12907
12908 </tr>
12909 <tr class="entries_header">
12910 <th class="th_details" colspan="5">Details</th>
12911 </tr>
12912 <tr class="entry_cont">
12913 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12914 <p>The HAL must provide the estimate from its
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]12915statistics unit on the white balance transforms to use
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12916for the next frame.<wbr/> These are the values the HAL believes
12917are the best fit for the current output frame.<wbr/> This may
12918be different than the transform used for this frame,<wbr/> since
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]12919statistics processing on data from a new frame typically
12920completes after the transform has already been applied to
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12921that frame.<wbr/></p>
12922<p>These estimates must be provided for all frames,<wbr/> even if
12923capture settings and color transforms are set by the application.<wbr/></p>
12924<p>This value should always be calculated by the AWB block,<wbr/>
12925regardless of the android.<wbr/>control.<wbr/>* current values.<wbr/></p>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]12926 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12927 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12928
12929
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12930 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
12931 <!-- end of entry -->
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]12932
12933
12934 <tr class="entry" id="dynamic_android.statistics.sceneFlicker">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12935 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12936 android.<wbr/>statistics.<wbr/>scene<wbr/>Flicker
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12937 </td>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]12938 <td class="entry_type">
12939 <span class="entry_type_name entry_type_name_enum">byte</span>
12940
12941 <span class="entry_type_visibility"> [public]</span>
12942
12943 <ul class="entry_type_enum">
12944 <li>
12945 <span class="entry_type_enum_name">NONE</span>
12946 </li>
12947 <li>
12948 <span class="entry_type_enum_name">50HZ</span>
12949 </li>
12950 <li>
12951 <span class="entry_type_enum_name">60HZ</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>The HAL estimated scene illumination lighting
12959frequency</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
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]12968 <td class="entry_tags">
12969 </td>
12970
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]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>Report NONE if there doesn't appear to be flickering
12978illumination</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12979 </td>
12980 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12981
12982
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12983 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
12984 <!-- end of entry -->
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]12985
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12986
12987
12988 <!-- end of kind -->
12989 </tbody>
12990
12991 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12992 <tr><td colspan="6" id="section_tonemap" class="section">tonemap</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12993
12994
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12995 <tr><td colspan="6" class="kind">controls</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12996
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]12997 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12998 <tr>
12999 <th class="th_name">Property Name</th>
13000 <th class="th_type">Type</th>
13001 <th class="th_description">Description</th>
13002 <th class="th_units">Units</th>
13003 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13004 <th class="th_tags">Tags</th>
13005 </tr>
13006 </thead>
13007
13008 <tbody>
13009
13010
13011
13012
13013
13014
13015
13016
13017
13018
13019 <tr class="entry" id="controls_android.tonemap.curveBlue">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]13020 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13021 android.<wbr/>tonemap.<wbr/>curve<wbr/>Blue
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]13022 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13023 <td class="entry_type">
Eino-Ville Talvala76548fe2013-01-11 13:57:19 -0800[diff] [blame]13024 <span class="entry_type_name">float</span>
Zhijun He704d1282013-08-19 15:26:33 -0700[diff] [blame]13025 <span class="entry_type_container">x</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13026
Zhijun He704d1282013-08-19 15:26:33 -0700[diff] [blame]13027 <span class="entry_type_array">
13028 n x 2
13029 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]13030 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13031 <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]13032
13033
13034 </td> <!-- entry_type -->
13035
13036 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13037 <p>Table mapping blue input values to output
13038values</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13039 </td>
13040
13041 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13042 same as android.<wbr/>tonemap.<wbr/>curve<wbr/>Red
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13043 </td>
13044
13045 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]13046 <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]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>Tonemapping /<wbr/> contrast /<wbr/> gamma curve for the blue
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]13059channel,<wbr/> to use when <a href="#controls_android.tonemap.mode">android.<wbr/>tonemap.<wbr/>mode</a> is CONTRAST_<wbr/>CURVE.<wbr/></p>
13060<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]13061 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13062 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]13063
13064
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13065 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
13066 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13067
13068
13069 <tr class="entry" id="controls_android.tonemap.curveGreen">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]13070 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13071 android.<wbr/>tonemap.<wbr/>curve<wbr/>Green
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]13072 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13073 <td class="entry_type">
Eino-Ville Talvala76548fe2013-01-11 13:57:19 -0800[diff] [blame]13074 <span class="entry_type_name">float</span>
Zhijun He704d1282013-08-19 15:26:33 -0700[diff] [blame]13075 <span class="entry_type_container">x</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13076
Zhijun He704d1282013-08-19 15:26:33 -0700[diff] [blame]13077 <span class="entry_type_array">
13078 n x 2
13079 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]13080 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13081 <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]13082
13083
13084 </td> <!-- entry_type -->
13085
13086 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13087 <p>Table mapping green input values to output
13088values</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13089 </td>
13090
13091 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13092 same as android.<wbr/>tonemap.<wbr/>curve<wbr/>Red
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13093 </td>
13094
13095 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]13096 <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]13097 </td>
13098
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13099 <td class="entry_tags">
13100 </td>
13101
13102 </tr>
13103 <tr class="entries_header">
13104 <th class="th_details" colspan="5">Details</th>
13105 </tr>
13106 <tr class="entry_cont">
13107 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13108 <p>Tonemapping /<wbr/> contrast /<wbr/> gamma curve for the green
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]13109channel,<wbr/> to use when <a href="#controls_android.tonemap.mode">android.<wbr/>tonemap.<wbr/>mode</a> is CONTRAST_<wbr/>CURVE.<wbr/></p>
13110<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]13111 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13112 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]13113
13114
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13115 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
13116 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13117
13118
13119 <tr class="entry" id="controls_android.tonemap.curveRed">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]13120 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13121 android.<wbr/>tonemap.<wbr/>curve<wbr/>Red
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]13122 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13123 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]13124 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13125 <span class="entry_type_container">x</span>
13126
13127 <span class="entry_type_array">
13128 n x 2
13129 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]13130 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13131 <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]13132
13133
13134 </td> <!-- entry_type -->
13135
13136 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13137 <p>Table mapping red input values to output
13138values</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13139 </td>
13140
13141 <td class="entry_units">
13142 </td>
13143
13144 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]13145 <p>0-1 on input and output coordinates.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13146 </td>
13147
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13148 <td class="entry_tags">
13149 <ul class="entry_tags">
13150 <li><a href="#tag_DNG">DNG</a></li>
13151 </ul>
13152 </td>
13153
13154 </tr>
13155 <tr class="entries_header">
13156 <th class="th_details" colspan="5">Details</th>
13157 </tr>
13158 <tr class="entry_cont">
13159 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13160 <p>Tonemapping /<wbr/> contrast /<wbr/> gamma curve for the red
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]13161channel,<wbr/> to use when <a href="#controls_android.tonemap.mode">android.<wbr/>tonemap.<wbr/>mode</a> is CONTRAST_<wbr/>CURVE.<wbr/></p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]13162<p>Since the input and output ranges may vary depending on
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13163the camera pipeline,<wbr/> the input and output pixel values
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]13164are represented by normalized floating-point values
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13165between 0 and 1,<wbr/> with 0 == black and 1 == white.<wbr/></p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]13166<p>The curve should be linearly interpolated between the
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13167defined points.<wbr/> The points will be listed in increasing
13168order of P_<wbr/>IN.<wbr/> For example,<wbr/> if the array is: [0.<wbr/>0,<wbr/> 0.<wbr/>0,<wbr/>
131690.<wbr/>3,<wbr/> 0.<wbr/>5,<wbr/> 1.<wbr/>0,<wbr/> 1.<wbr/>0],<wbr/> then the input-&gt;output mapping
13170for a few sample points would be: 0 -&gt; 0,<wbr/> 0.<wbr/>15 -&gt;
131710.<wbr/>25,<wbr/> 0.<wbr/>3 -&gt; 0.<wbr/>5,<wbr/> 0.<wbr/>5 -&gt; 0.<wbr/>64</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13172 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13173 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]13174
13175
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13176 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
13177 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13178
13179
13180 <tr class="entry" id="controls_android.tonemap.mode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]13181 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13182 android.<wbr/>tonemap.<wbr/>mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]13183 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13184 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]13185 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13186
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]13187 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13188
13189 <ul class="entry_type_enum">
13190 <li>
13191 <span class="entry_type_enum_name">CONTRAST_CURVE</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]13192 <span class="entry_type_enum_notes"><p>Use the tone mapping curve specified in
13193android.<wbr/>tonemap.<wbr/>curve</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13194 </li>
13195 <li>
13196 <span class="entry_type_enum_name">FAST</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]13197 <span class="entry_type_enum_notes"><p>Must not slow down frame rate relative to raw
13198bayer output</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13199 </li>
13200 <li>
13201 <span class="entry_type_enum_name">HIGH_QUALITY</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]13202 <span class="entry_type_enum_notes"><p>Frame rate may be reduced by high
13203quality</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13204 </li>
13205 </ul>
13206
13207 </td> <!-- entry_type -->
13208
13209 <td class="entry_description">
13210 </td>
13211
13212 <td class="entry_units">
13213 </td>
13214
13215 <td class="entry_range">
13216 </td>
13217
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13218 <td class="entry_tags">
13219 </td>
13220
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13221 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]13222
13223
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13224 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
13225 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13226
13227
13228
13229 <!-- end of kind -->
13230 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13231 <tr><td colspan="6" class="kind">static</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13232
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]13233 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13234 <tr>
13235 <th class="th_name">Property Name</th>
13236 <th class="th_type">Type</th>
13237 <th class="th_description">Description</th>
13238 <th class="th_units">Units</th>
13239 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13240 <th class="th_tags">Tags</th>
13241 </tr>
13242 </thead>
13243
13244 <tbody>
13245
13246
13247
13248
13249
13250
13251
13252
13253
13254
13255 <tr class="entry" id="static_android.tonemap.maxCurvePoints">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]13256 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13257 android.<wbr/>tonemap.<wbr/>max<wbr/>Curve<wbr/>Points
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]13258 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13259 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]13260 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13261
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]13262 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13263
13264
13265 </td> <!-- entry_type -->
13266
13267 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13268 <p>Maximum number of supported points in the
13269tonemap curve</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13270 </td>
13271
13272 <td class="entry_units">
13273 </td>
13274
13275 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame]13276 <p>&gt;= 128</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13277 </td>
13278
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13279 <td class="entry_tags">
13280 </td>
13281
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13282 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]13283
13284
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13285 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
13286 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13287
13288
13289
13290 <!-- end of kind -->
13291 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13292 <tr><td colspan="6" class="kind">dynamic</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13293
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]13294 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13295 <tr>
13296 <th class="th_name">Property Name</th>
13297 <th class="th_type">Type</th>
13298 <th class="th_description">Description</th>
13299 <th class="th_units">Units</th>
13300 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13301 <th class="th_tags">Tags</th>
13302 </tr>
13303 </thead>
13304
13305 <tbody>
13306
13307
13308
13309
13310
13311
13312
13313
13314
13315
13316 <tr class="entry" id="dynamic_android.tonemap.curveBlue">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]13317 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13318 android.<wbr/>tonemap.<wbr/>curve<wbr/>Blue
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]13319 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13320 <td class="entry_type">
Eino-Ville Talvala76548fe2013-01-11 13:57:19 -0800[diff] [blame]13321 <span class="entry_type_name">float</span>
Zhijun He704d1282013-08-19 15:26:33 -0700[diff] [blame]13322 <span class="entry_type_container">x</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13323
Zhijun He704d1282013-08-19 15:26:33 -0700[diff] [blame]13324 <span class="entry_type_array">
13325 n x 2
13326 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]13327 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13328 <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]13329
13330
13331 </td> <!-- entry_type -->
13332
13333 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13334 <p>Table mapping blue input values to output
13335values</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13336 </td>
13337
13338 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13339 same as android.<wbr/>tonemap.<wbr/>curve<wbr/>Red
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13340 </td>
13341
13342 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]13343 <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]13344 </td>
13345
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13346 <td class="entry_tags">
13347 </td>
13348
13349 </tr>
13350 <tr class="entries_header">
13351 <th class="th_details" colspan="5">Details</th>
13352 </tr>
13353 <tr class="entry_cont">
13354 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13355 <p>Tonemapping /<wbr/> contrast /<wbr/> gamma curve for the blue
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]13356channel,<wbr/> to use when <a href="#controls_android.tonemap.mode">android.<wbr/>tonemap.<wbr/>mode</a> is CONTRAST_<wbr/>CURVE.<wbr/></p>
13357<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]13358 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13359 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]13360
13361
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13362 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
13363 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13364
13365
13366 <tr class="entry" id="dynamic_android.tonemap.curveGreen">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]13367 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13368 android.<wbr/>tonemap.<wbr/>curve<wbr/>Green
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]13369 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13370 <td class="entry_type">
Eino-Ville Talvala76548fe2013-01-11 13:57:19 -0800[diff] [blame]13371 <span class="entry_type_name">float</span>
Zhijun He704d1282013-08-19 15:26:33 -0700[diff] [blame]13372 <span class="entry_type_container">x</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13373
Zhijun He704d1282013-08-19 15:26:33 -0700[diff] [blame]13374 <span class="entry_type_array">
13375 n x 2
13376 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]13377 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13378 <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]13379
13380
13381 </td> <!-- entry_type -->
13382
13383 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13384 <p>Table mapping green input values to output
13385values</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13386 </td>
13387
13388 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13389 same as android.<wbr/>tonemap.<wbr/>curve<wbr/>Red
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13390 </td>
13391
13392 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]13393 <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]13394 </td>
13395
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13396 <td class="entry_tags">
13397 </td>
13398
13399 </tr>
13400 <tr class="entries_header">
13401 <th class="th_details" colspan="5">Details</th>
13402 </tr>
13403 <tr class="entry_cont">
13404 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13405 <p>Tonemapping /<wbr/> contrast /<wbr/> gamma curve for the green
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]13406channel,<wbr/> to use when <a href="#controls_android.tonemap.mode">android.<wbr/>tonemap.<wbr/>mode</a> is CONTRAST_<wbr/>CURVE.<wbr/></p>
13407<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]13408 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13409 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]13410
13411
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13412 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
13413 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13414
13415
13416 <tr class="entry" id="dynamic_android.tonemap.curveRed">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]13417 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13418 android.<wbr/>tonemap.<wbr/>curve<wbr/>Red
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]13419 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13420 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]13421 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13422 <span class="entry_type_container">x</span>
13423
13424 <span class="entry_type_array">
13425 n x 2
13426 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]13427 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13428 <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]13429
13430
13431 </td> <!-- entry_type -->
13432
13433 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13434 <p>Table mapping red input values to output
13435values</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13436 </td>
13437
13438 <td class="entry_units">
13439 </td>
13440
13441 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]13442 <p>0-1 on input and output coordinates.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13443 </td>
13444
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13445 <td class="entry_tags">
13446 <ul class="entry_tags">
13447 <li><a href="#tag_DNG">DNG</a></li>
13448 </ul>
13449 </td>
13450
13451 </tr>
13452 <tr class="entries_header">
13453 <th class="th_details" colspan="5">Details</th>
13454 </tr>
13455 <tr class="entry_cont">
13456 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13457 <p>Tonemapping /<wbr/> contrast /<wbr/> gamma curve for the red
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]13458channel,<wbr/> to use when <a href="#controls_android.tonemap.mode">android.<wbr/>tonemap.<wbr/>mode</a> is CONTRAST_<wbr/>CURVE.<wbr/></p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]13459<p>Since the input and output ranges may vary depending on
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13460the camera pipeline,<wbr/> the input and output pixel values
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]13461are represented by normalized floating-point values
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13462between 0 and 1,<wbr/> with 0 == black and 1 == white.<wbr/></p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]13463<p>The curve should be linearly interpolated between the
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13464defined points.<wbr/> The points will be listed in increasing
13465order of P_<wbr/>IN.<wbr/> For example,<wbr/> if the array is: [0.<wbr/>0,<wbr/> 0.<wbr/>0,<wbr/>
134660.<wbr/>3,<wbr/> 0.<wbr/>5,<wbr/> 1.<wbr/>0,<wbr/> 1.<wbr/>0],<wbr/> then the input-&gt;output mapping
13467for a few sample points would be: 0 -&gt; 0,<wbr/> 0.<wbr/>15 -&gt;
134680.<wbr/>25,<wbr/> 0.<wbr/>3 -&gt; 0.<wbr/>5,<wbr/> 0.<wbr/>5 -&gt; 0.<wbr/>64</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13469 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13470 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]13471
13472
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13473 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
13474 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13475
13476
13477 <tr class="entry" id="dynamic_android.tonemap.mode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]13478 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13479 android.<wbr/>tonemap.<wbr/>mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]13480 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13481 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]13482 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13483
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]13484 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13485
13486 <ul class="entry_type_enum">
13487 <li>
13488 <span class="entry_type_enum_name">CONTRAST_CURVE</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]13489 <span class="entry_type_enum_notes"><p>Use the tone mapping curve specified in
13490android.<wbr/>tonemap.<wbr/>curve</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13491 </li>
13492 <li>
13493 <span class="entry_type_enum_name">FAST</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]13494 <span class="entry_type_enum_notes"><p>Must not slow down frame rate relative to raw
13495bayer output</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13496 </li>
13497 <li>
13498 <span class="entry_type_enum_name">HIGH_QUALITY</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]13499 <span class="entry_type_enum_notes"><p>Frame rate may be reduced by high
13500quality</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13501 </li>
13502 </ul>
13503
13504 </td> <!-- entry_type -->
13505
13506 <td class="entry_description">
13507 </td>
13508
13509 <td class="entry_units">
13510 </td>
13511
13512 <td class="entry_range">
13513 </td>
13514
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13515 <td class="entry_tags">
13516 </td>
13517
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13518 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]13519
13520
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13521 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
13522 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13523
13524
13525
13526 <!-- end of kind -->
13527 </tbody>
13528
13529 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13530 <tr><td colspan="6" id="section_led" class="section">led</td></tr>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]13531
13532
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13533 <tr><td colspan="6" class="kind">controls</td></tr>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]13534
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]13535 <thead class="entries_header">
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]13536 <tr>
13537 <th class="th_name">Property Name</th>
13538 <th class="th_type">Type</th>
13539 <th class="th_description">Description</th>
13540 <th class="th_units">Units</th>
13541 <th class="th_range">Range</th>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]13542 <th class="th_tags">Tags</th>
13543 </tr>
13544 </thead>
13545
13546 <tbody>
13547
13548
13549
13550
13551
13552
13553
13554
13555
13556
13557 <tr class="entry" id="controls_android.led.transmit">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]13558 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13559 android.<wbr/>led.<wbr/>transmit
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]13560 </td>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]13561 <td class="entry_type">
13562 <span class="entry_type_name entry_type_name_enum">byte</span>
13563
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]13564 <span class="entry_type_visibility"> [hidden as boolean]</span>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]13565
13566 <ul class="entry_type_enum">
13567 <li>
13568 <span class="entry_type_enum_name">OFF</span>
13569 </li>
13570 <li>
13571 <span class="entry_type_enum_name">ON</span>
13572 </li>
13573 </ul>
13574
13575 </td> <!-- entry_type -->
13576
13577 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13578 <p>This LED is nominally used to indicate to the user
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]13579that the camera is powered on and may be streaming images back to the
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13580Application Processor.<wbr/> In certain rare circumstances,<wbr/> the OS may
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]13581disable this when video is processed locally and not transmitted to
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13582any untrusted applications.<wbr/></p>
13583<p>In particular,<wbr/> the LED <em>must</em> always be on when the data could be
13584transmitted off the device.<wbr/> The LED <em>should</em> always be on whenever
13585data is stored locally on the device.<wbr/></p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]13586<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]13587doesn't violate the above rules.<wbr/></p>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]13588 </td>
13589
13590 <td class="entry_units">
13591 </td>
13592
13593 <td class="entry_range">
13594 </td>
13595
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]13596 <td class="entry_tags">
13597 </td>
13598
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13599 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]13600
13601
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13602 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
13603 <!-- end of entry -->
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]13604
13605
13606
13607 <!-- end of kind -->
13608 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13609 <tr><td colspan="6" class="kind">dynamic</td></tr>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]13610
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]13611 <thead class="entries_header">
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]13612 <tr>
13613 <th class="th_name">Property Name</th>
13614 <th class="th_type">Type</th>
13615 <th class="th_description">Description</th>
13616 <th class="th_units">Units</th>
13617 <th class="th_range">Range</th>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]13618 <th class="th_tags">Tags</th>
13619 </tr>
13620 </thead>
13621
13622 <tbody>
13623
13624
13625
13626
13627
13628
13629
13630
13631
13632
13633 <tr class="entry" id="dynamic_android.led.transmit">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]13634 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13635 android.<wbr/>led.<wbr/>transmit
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]13636 </td>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]13637 <td class="entry_type">
13638 <span class="entry_type_name entry_type_name_enum">byte</span>
13639
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]13640 <span class="entry_type_visibility"> [hidden as boolean]</span>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]13641
13642 <ul class="entry_type_enum">
13643 <li>
13644 <span class="entry_type_enum_name">OFF</span>
13645 </li>
13646 <li>
13647 <span class="entry_type_enum_name">ON</span>
13648 </li>
13649 </ul>
13650
13651 </td> <!-- entry_type -->
13652
13653 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13654 <p>This LED is nominally used to indicate to the user
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]13655that the camera is powered on and may be streaming images back to the
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13656Application Processor.<wbr/> In certain rare circumstances,<wbr/> the OS may
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]13657disable this when video is processed locally and not transmitted to
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13658any untrusted applications.<wbr/></p>
13659<p>In particular,<wbr/> the LED <em>must</em> always be on when the data could be
13660transmitted off the device.<wbr/> The LED <em>should</em> always be on whenever
13661data is stored locally on the device.<wbr/></p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]13662<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]13663doesn't violate the above rules.<wbr/></p>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]13664 </td>
13665
13666 <td class="entry_units">
13667 </td>
13668
13669 <td class="entry_range">
13670 </td>
13671
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]13672 <td class="entry_tags">
13673 </td>
13674
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13675 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]13676
13677
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13678 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
13679 <!-- end of entry -->
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]13680
13681
13682
13683 <!-- end of kind -->
13684 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13685 <tr><td colspan="6" class="kind">static</td></tr>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]13686
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]13687 <thead class="entries_header">
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]13688 <tr>
13689 <th class="th_name">Property Name</th>
13690 <th class="th_type">Type</th>
13691 <th class="th_description">Description</th>
13692 <th class="th_units">Units</th>
13693 <th class="th_range">Range</th>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]13694 <th class="th_tags">Tags</th>
13695 </tr>
13696 </thead>
13697
13698 <tbody>
13699
13700
13701
13702
13703
13704
13705
13706
13707
13708
13709 <tr class="entry" id="static_android.led.availableLeds">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]13710 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13711 android.<wbr/>led.<wbr/>available<wbr/>Leds
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]13712 </td>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]13713 <td class="entry_type">
13714 <span class="entry_type_name entry_type_name_enum">byte</span>
13715 <span class="entry_type_container">x</span>
13716
13717 <span class="entry_type_array">
13718 n
13719 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]13720 <span class="entry_type_visibility"> [hidden]</span>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]13721
13722 <ul class="entry_type_enum">
13723 <li>
13724 <span class="entry_type_enum_name">TRANSMIT</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]13725 <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]13726 </li>
13727 </ul>
13728
13729 </td> <!-- entry_type -->
13730
13731 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13732 <p>A list of camera LEDs that are available on this system.<wbr/></p>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]13733 </td>
13734
13735 <td class="entry_units">
13736 </td>
13737
13738 <td class="entry_range">
13739 </td>
13740
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]13741 <td class="entry_tags">
13742 </td>
13743
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13744 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]13745
13746
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13747 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
13748 <!-- end of entry -->
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]13749
13750
13751
13752 <!-- end of kind -->
13753 </tbody>
13754
13755 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13756 <tr><td colspan="6" id="section_info" class="section">info</td></tr>
Igor Murashkin38b8cae2013-05-23 16:38:59 -0700[diff] [blame]13757
13758
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13759 <tr><td colspan="6" class="kind">static</td></tr>
Igor Murashkin38b8cae2013-05-23 16:38:59 -0700[diff] [blame]13760
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]13761 <thead class="entries_header">
Igor Murashkin38b8cae2013-05-23 16:38:59 -0700[diff] [blame]13762 <tr>
13763 <th class="th_name">Property Name</th>
13764 <th class="th_type">Type</th>
13765 <th class="th_description">Description</th>
13766 <th class="th_units">Units</th>
13767 <th class="th_range">Range</th>
Igor Murashkin38b8cae2013-05-23 16:38:59 -0700[diff] [blame]13768 <th class="th_tags">Tags</th>
13769 </tr>
13770 </thead>
13771
13772 <tbody>
13773
13774
13775
13776
13777
13778
13779
13780
13781
13782
13783 <tr class="entry" id="static_android.info.supportedHardwareLevel">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]13784 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13785 android.<wbr/>info.<wbr/>supported<wbr/>Hardware<wbr/>Level
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]13786 </td>
Igor Murashkin38b8cae2013-05-23 16:38:59 -0700[diff] [blame]13787 <td class="entry_type">
13788 <span class="entry_type_name entry_type_name_enum">byte</span>
13789
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]13790 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin38b8cae2013-05-23 16:38:59 -0700[diff] [blame]13791
13792 <ul class="entry_type_enum">
13793 <li>
13794 <span class="entry_type_enum_name">LIMITED</span>
13795 </li>
13796 <li>
13797 <span class="entry_type_enum_name">FULL</span>
13798 </li>
13799 </ul>
13800
13801 </td> <!-- entry_type -->
13802
13803 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13804 <p>The camera 3 HAL device can implement one of two possible
13805operational modes; limited and full.<wbr/> Full support is
13806expected from new higher-end devices.<wbr/> Limited mode has
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]13807hardware requirements roughly in line with those for a
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13808camera HAL device v1 implementation,<wbr/> and is expected from
13809older or inexpensive devices.<wbr/> Full is a strict superset of
13810limited,<wbr/> and they share the same essential operational flow.<wbr/></p>
13811<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]13812 </td>
13813
13814 <td class="entry_units">
13815 </td>
13816
13817 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]13818 <p>Optional.<wbr/> Default value is LIMITED.<wbr/></p>
Igor Murashkin38b8cae2013-05-23 16:38:59 -0700[diff] [blame]13819 </td>
13820
Igor Murashkin38b8cae2013-05-23 16:38:59 -0700[diff] [blame]13821 <td class="entry_tags">
13822 </td>
13823
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13824 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]13825
13826
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13827 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
13828 <!-- end of entry -->
Igor Murashkin38b8cae2013-05-23 16:38:59 -0700[diff] [blame]13829
13830
13831
13832 <!-- end of kind -->
13833 </tbody>
13834
13835 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13836 <tr><td colspan="6" id="section_blackLevel" class="section">blackLevel</td></tr>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]13837
13838
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13839 <tr><td colspan="6" class="kind">controls</td></tr>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]13840
13841 <thead class="entries_header">
13842 <tr>
13843 <th class="th_name">Property Name</th>
13844 <th class="th_type">Type</th>
13845 <th class="th_description">Description</th>
13846 <th class="th_units">Units</th>
13847 <th class="th_range">Range</th>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]13848 <th class="th_tags">Tags</th>
13849 </tr>
13850 </thead>
13851
13852 <tbody>
13853
13854
13855
13856
13857
13858
13859
13860
13861
13862
13863 <tr class="entry" id="controls_android.blackLevel.lock">
Eino-Ville Talvala7796cfe2013-12-26 13:16:54 -0800[diff] [blame]13864 <td class="entry_name" rowspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13865 android.<wbr/>black<wbr/>Level.<wbr/>lock
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]13866 </td>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]13867 <td class="entry_type">
13868 <span class="entry_type_name entry_type_name_enum">byte</span>
13869
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]13870 <span class="entry_type_visibility"> [public as boolean]</span>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]13871
13872 <ul class="entry_type_enum">
13873 <li>
13874 <span class="entry_type_enum_name">OFF</span>
13875 </li>
13876 <li>
13877 <span class="entry_type_enum_name">ON</span>
13878 </li>
13879 </ul>
13880
13881 </td> <!-- entry_type -->
13882
13883 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13884 <p>Whether black-level compensation is locked
13885to its current values,<wbr/> or is free to vary.<wbr/></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">
13892 </td>
13893
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13894 <td class="entry_tags">
13895 <ul class="entry_tags">
13896 <li><a href="#tag_HAL2">HAL2</a></li>
13897 </ul>
13898 </td>
13899
13900 </tr>
13901 <tr class="entries_header">
13902 <th class="th_details" colspan="5">Details</th>
13903 </tr>
13904 <tr class="entry_cont">
13905 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13906 <p>When set to ON,<wbr/> the values used for black-level
Eino-Ville Talvala7796cfe2013-12-26 13:16:54 -0800[diff] [blame]13907compensation will not change until the lock is set to
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13908OFF.<wbr/></p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]13909<p>Since changes to certain capture parameters (such as
13910exposure time) may require resetting of black level
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13911compensation,<wbr/> the camera device must report whether setting
Eino-Ville Talvala7796cfe2013-12-26 13:16:54 -0800[diff] [blame]13912the black level lock was successful in the output result
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13913metadata.<wbr/></p>
13914<p>For example,<wbr/> if a sequence of requests is as follows:</p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]13915<ul>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13916<li>Request 1: Exposure = 10ms,<wbr/> Black level lock = OFF</li>
13917<li>Request 2: Exposure = 10ms,<wbr/> Black level lock = ON</li>
13918<li>Request 3: Exposure = 10ms,<wbr/> Black level lock = ON</li>
13919<li>Request 4: Exposure = 20ms,<wbr/> Black level lock = ON</li>
13920<li>Request 5: Exposure = 20ms,<wbr/> Black level lock = ON</li>
13921<li>Request 6: Exposure = 20ms,<wbr/> Black level lock = ON</li>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]13922</ul>
Eino-Ville Talvala7796cfe2013-12-26 13:16:54 -0800[diff] [blame]13923<p>And the exposure change in Request 4 requires the camera
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13924device to reset the black level offsets,<wbr/> then the output
Eino-Ville Talvala7796cfe2013-12-26 13:16:54 -0800[diff] [blame]13925result metadata is expected to be:</p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]13926<ul>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13927<li>Result 1: Exposure = 10ms,<wbr/> Black level lock = OFF</li>
13928<li>Result 2: Exposure = 10ms,<wbr/> Black level lock = ON</li>
13929<li>Result 3: Exposure = 10ms,<wbr/> Black level lock = ON</li>
13930<li>Result 4: Exposure = 20ms,<wbr/> Black level lock = OFF</li>
13931<li>Result 5: Exposure = 20ms,<wbr/> Black level lock = ON</li>
13932<li>Result 6: Exposure = 20ms,<wbr/> Black level lock = ON</li>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]13933</ul>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13934<p>This indicates to the application that on frame 4,<wbr/> black
13935levels were reset due to exposure value changes,<wbr/> and pixel
13936values may not be consistent across captures.<wbr/></p>
Eino-Ville Talvala7796cfe2013-12-26 13:16:54 -0800[diff] [blame]13937<p>The camera device will maintain the lock to the extent
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13938possible,<wbr/> only overriding the lock to OFF when changes to
Eino-Ville Talvala7796cfe2013-12-26 13:16:54 -0800[diff] [blame]13939other request parameters require a black level recalculation
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13940or reset.<wbr/></p>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]13941 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13942 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]13943
Eino-Ville Talvala7796cfe2013-12-26 13:16:54 -0800[diff] [blame]13944 <tr class="entries_header">
13945 <th class="th_details" colspan="5">HAL Implementation Details</th>
13946 </tr>
13947 <tr class="entry_cont">
13948 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13949 <p>If for some reason black level locking is no longer possible
13950(for example,<wbr/> the analog gain has changed,<wbr/> which forces
13951black level offsets to be recalculated),<wbr/> then the HAL must
Eino-Ville Talvala7796cfe2013-12-26 13:16:54 -0800[diff] [blame]13952override this request (and it must report 'OFF' when this
13953does happen) until the next capture for which locking is
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13954possible again.<wbr/></p>
Eino-Ville Talvala7796cfe2013-12-26 13:16:54 -0800[diff] [blame]13955 </td>
13956 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]13957
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13958 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
13959 <!-- end of entry -->
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]13960
13961
13962
13963 <!-- end of kind -->
13964 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13965 <tr><td colspan="6" class="kind">dynamic</td></tr>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]13966
13967 <thead class="entries_header">
13968 <tr>
13969 <th class="th_name">Property Name</th>
13970 <th class="th_type">Type</th>
13971 <th class="th_description">Description</th>
13972 <th class="th_units">Units</th>
13973 <th class="th_range">Range</th>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]13974 <th class="th_tags">Tags</th>
13975 </tr>
13976 </thead>
13977
13978 <tbody>
13979
13980
13981
13982
13983
13984
13985
13986
13987
13988
13989 <tr class="entry" id="dynamic_android.blackLevel.lock">
Eino-Ville Talvala7796cfe2013-12-26 13:16:54 -0800[diff] [blame]13990 <td class="entry_name" rowspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13991 android.<wbr/>black<wbr/>Level.<wbr/>lock
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]13992 </td>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]13993 <td class="entry_type">
13994 <span class="entry_type_name entry_type_name_enum">byte</span>
13995
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]13996 <span class="entry_type_visibility"> [public as boolean]</span>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]13997
13998 <ul class="entry_type_enum">
13999 <li>
14000 <span class="entry_type_enum_name">OFF</span>
14001 </li>
14002 <li>
14003 <span class="entry_type_enum_name">ON</span>
14004 </li>
14005 </ul>
14006
14007 </td> <!-- entry_type -->
14008
14009 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]14010 <p>Whether black-level compensation is locked
14011to its current values,<wbr/> or is free to vary.<wbr/></p>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]14012 </td>
14013
14014 <td class="entry_units">
14015 </td>
14016
14017 <td class="entry_range">
14018 </td>
14019
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]14020 <td class="entry_tags">
14021 <ul class="entry_tags">
14022 <li><a href="#tag_HAL2">HAL2</a></li>
14023 </ul>
14024 </td>
14025
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]14026 </tr>
14027 <tr class="entries_header">
14028 <th class="th_details" colspan="5">Details</th>
14029 </tr>
14030 <tr class="entry_cont">
14031 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]14032 <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]14033ON 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]14034a change in other capture settings forced the camera device to
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]14035perform a black level reset.<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]14036 </td>
14037 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]14038
Eino-Ville Talvala7796cfe2013-12-26 13:16:54 -0800[diff] [blame]14039 <tr class="entries_header">
14040 <th class="th_details" colspan="5">HAL Implementation Details</th>
14041 </tr>
14042 <tr class="entry_cont">
14043 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]14044 <p>If for some reason black level locking is no longer possible
14045(for example,<wbr/> the analog gain has changed,<wbr/> which forces
14046black level offsets to be recalculated),<wbr/> then the HAL must
Eino-Ville Talvala7796cfe2013-12-26 13:16:54 -0800[diff] [blame]14047override this request (and it must report 'OFF' when this
14048does happen) until the next capture for which locking is
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]14049possible again.<wbr/></p>
Eino-Ville Talvala7796cfe2013-12-26 13:16:54 -0800[diff] [blame]14050 </td>
14051 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]14052
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]14053 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
14054 <!-- end of entry -->
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]14055
14056
14057
14058 <!-- end of kind -->
14059 </tbody>
14060
14061 <!-- end of section -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]14062<!-- </namespace> -->
14063 </table>
14064
14065 <div class="tags" id="tag_index">
14066 <h2>Tags</h2>
14067 <ul>
14068 <li id="tag_AWB">AWB -
14069 Needed for auto white balance
14070
14071 <ul class="tags_entries">
14072 <li><a href="#controls_android.control.awbMode">android.control.awbMode</a> (controls)</li>
14073 </ul>
14074 </li> <!-- tag_AWB -->
14075 <li id="tag_BC">BC -
14076 Needed for backwards compatibility with old Java API
14077
14078 <ul class="tags_entries">
Eino-Ville Talvala19ce2c12013-12-30 12:03:45 -0800[diff] [blame]14079 <li><a href="#controls_android.control.aeAntibandingMode">android.control.aeAntibandingMode</a> (controls)</li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]14080 <li><a href="#controls_android.control.aeExposureCompensation">android.control.aeExposureCompensation</a> (controls)</li>
14081 <li><a href="#controls_android.control.aeLock">android.control.aeLock</a> (controls)</li>
14082 <li><a href="#controls_android.control.aeMode">android.control.aeMode</a> (controls)</li>
14083 <li><a href="#controls_android.control.aeRegions">android.control.aeRegions</a> (controls)</li>
14084 <li><a href="#controls_android.control.aeTargetFpsRange">android.control.aeTargetFpsRange</a> (controls)</li>
Eino-Ville Talvala3b4383a2013-03-18 09:42:48 -0700[diff] [blame]14085 <li><a href="#controls_android.control.aePrecaptureTrigger">android.control.aePrecaptureTrigger</a> (controls)</li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]14086 <li><a href="#controls_android.control.afMode">android.control.afMode</a> (controls)</li>
14087 <li><a href="#controls_android.control.afRegions">android.control.afRegions</a> (controls)</li>
Eino-Ville Talvala3b4383a2013-03-18 09:42:48 -0700[diff] [blame]14088 <li><a href="#controls_android.control.afTrigger">android.control.afTrigger</a> (controls)</li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]14089 <li><a href="#controls_android.control.awbLock">android.control.awbLock</a> (controls)</li>
14090 <li><a href="#controls_android.control.awbMode">android.control.awbMode</a> (controls)</li>
14091 <li><a href="#controls_android.control.awbRegions">android.control.awbRegions</a> (controls)</li>
14092 <li><a href="#controls_android.control.captureIntent">android.control.captureIntent</a> (controls)</li>
14093 <li><a href="#controls_android.control.effectMode">android.control.effectMode</a> (controls)</li>
14094 <li><a href="#controls_android.control.mode">android.control.mode</a> (controls)</li>
14095 <li><a href="#controls_android.control.sceneMode">android.control.sceneMode</a> (controls)</li>
14096 <li><a href="#controls_android.control.videoStabilizationMode">android.control.videoStabilizationMode</a> (controls)</li>
Eino-Ville Talvala9fa0d902014-01-08 16:16:53 -0800[diff] [blame]14097 <li><a href="#static_android.control.aeAvailableModes">android.control.aeAvailableModes</a> (static)</li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]14098 <li><a href="#static_android.control.aeCompensationRange">android.control.aeCompensationRange</a> (static)</li>
14099 <li><a href="#static_android.control.aeCompensationStep">android.control.aeCompensationStep</a> (static)</li>
14100 <li><a href="#static_android.control.afAvailableModes">android.control.afAvailableModes</a> (static)</li>
14101 <li><a href="#static_android.control.availableEffects">android.control.availableEffects</a> (static)</li>
14102 <li><a href="#static_android.control.availableSceneModes">android.control.availableSceneModes</a> (static)</li>
14103 <li><a href="#static_android.control.availableVideoStabilizationModes">android.control.availableVideoStabilizationModes</a> (static)</li>
14104 <li><a href="#static_android.control.awbAvailableModes">android.control.awbAvailableModes</a> (static)</li>
14105 <li><a href="#static_android.control.maxRegions">android.control.maxRegions</a> (static)</li>
14106 <li><a href="#static_android.control.sceneModeOverrides">android.control.sceneModeOverrides</a> (static)</li>
14107 <li><a href="#controls_android.flash.mode">android.flash.mode</a> (controls)</li>
14108 <li><a href="#static_android.flash.info.available">android.flash.info.available</a> (static)</li>
14109 <li><a href="#controls_android.jpeg.gpsCoordinates">android.jpeg.gpsCoordinates</a> (controls)</li>
14110 <li><a href="#controls_android.jpeg.gpsProcessingMethod">android.jpeg.gpsProcessingMethod</a> (controls)</li>
14111 <li><a href="#controls_android.jpeg.gpsTimestamp">android.jpeg.gpsTimestamp</a> (controls)</li>
14112 <li><a href="#controls_android.jpeg.orientation">android.jpeg.orientation</a> (controls)</li>
14113 <li><a href="#controls_android.jpeg.quality">android.jpeg.quality</a> (controls)</li>
14114 <li><a href="#controls_android.jpeg.thumbnailQuality">android.jpeg.thumbnailQuality</a> (controls)</li>
14115 <li><a href="#controls_android.jpeg.thumbnailSize">android.jpeg.thumbnailSize</a> (controls)</li>
14116 <li><a href="#static_android.jpeg.availableThumbnailSizes">android.jpeg.availableThumbnailSizes</a> (static)</li>
14117 <li><a href="#controls_android.lens.focusDistance">android.lens.focusDistance</a> (controls)</li>
14118 <li><a href="#static_android.lens.info.availableFocalLengths">android.lens.info.availableFocalLengths</a> (static)</li>
14119 <li><a href="#static_android.lens.info.hyperfocalDistance">android.lens.info.hyperfocalDistance</a> (static)</li>
14120 <li><a href="#dynamic_android.lens.focusRange">android.lens.focusRange</a> (dynamic)</li>
14121 <li><a href="#static_android.request.maxNumOutputStreams">android.request.maxNumOutputStreams</a> (static)</li>
14122 <li><a href="#controls_android.scaler.cropRegion">android.scaler.cropRegion</a> (controls)</li>
14123 <li><a href="#static_android.scaler.availableFormats">android.scaler.availableFormats</a> (static)</li>
14124 <li><a href="#static_android.scaler.availableJpegMinDurations">android.scaler.availableJpegMinDurations</a> (static)</li>
14125 <li><a href="#static_android.scaler.availableJpegSizes">android.scaler.availableJpegSizes</a> (static)</li>
Igor Murashkinf11a4df2013-05-07 10:00:46 -0700[diff] [blame]14126 <li><a href="#static_android.scaler.availableMaxDigitalZoom">android.scaler.availableMaxDigitalZoom</a> (static)</li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]14127 <li><a href="#static_android.scaler.availableProcessedMinDurations">android.scaler.availableProcessedMinDurations</a> (static)</li>
14128 <li><a href="#static_android.scaler.availableProcessedSizes">android.scaler.availableProcessedSizes</a> (static)</li>
14129 <li><a href="#static_android.scaler.availableRawMinDurations">android.scaler.availableRawMinDurations</a> (static)</li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]14130 <li><a href="#controls_android.sensor.frameDuration">android.sensor.frameDuration</a> (controls)</li>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]14131 <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]14132 <li><a href="#static_android.sensor.info.maxFrameDuration">android.sensor.info.maxFrameDuration</a> (static)</li>
14133 <li><a href="#static_android.sensor.info.physicalSize">android.sensor.info.physicalSize</a> (static)</li>
14134 <li><a href="#static_android.sensor.info.pixelArraySize">android.sensor.info.pixelArraySize</a> (static)</li>
14135 <li><a href="#static_android.sensor.orientation">android.sensor.orientation</a> (static)</li>
14136 <li><a href="#dynamic_android.sensor.timestamp">android.sensor.timestamp</a> (dynamic)</li>
14137 <li><a href="#controls_android.statistics.faceDetectMode">android.statistics.faceDetectMode</a> (controls)</li>
14138 <li><a href="#dynamic_android.statistics.faceIds">android.statistics.faceIds</a> (dynamic)</li>
14139 <li><a href="#dynamic_android.statistics.faceLandmarks">android.statistics.faceLandmarks</a> (dynamic)</li>
14140 <li><a href="#dynamic_android.statistics.faceRectangles">android.statistics.faceRectangles</a> (dynamic)</li>
14141 <li><a href="#dynamic_android.statistics.faceScores">android.statistics.faceScores</a> (dynamic)</li>
14142 <li><a href="#dynamic_android.lens.focalLength">android.lens.focalLength</a> (dynamic)</li>
14143 <li><a href="#dynamic_android.lens.focusDistance">android.lens.focusDistance</a> (dynamic)</li>
14144 </ul>
14145 </li> <!-- tag_BC -->
14146 <li id="tag_V1">V1 -
14147 New features for first camera 2 release (API1)
14148
14149 <ul class="tags_entries">
14150 <li><a href="#controls_android.demosaic.mode">android.demosaic.mode</a> (controls)</li>
14151 <li><a href="#controls_android.flash.firingPower">android.flash.firingPower</a> (controls)</li>
14152 <li><a href="#controls_android.flash.firingTime">android.flash.firingTime</a> (controls)</li>
14153 <li><a href="#static_android.flash.info.chargeDuration">android.flash.info.chargeDuration</a> (static)</li>
14154 <li><a href="#controls_android.hotPixel.mode">android.hotPixel.mode</a> (controls)</li>
14155 <li><a href="#controls_android.lens.aperture">android.lens.aperture</a> (controls)</li>
14156 <li><a href="#controls_android.lens.filterDensity">android.lens.filterDensity</a> (controls)</li>
14157 <li><a href="#controls_android.lens.focalLength">android.lens.focalLength</a> (controls)</li>
14158 <li><a href="#controls_android.lens.focusDistance">android.lens.focusDistance</a> (controls)</li>
14159 <li><a href="#controls_android.lens.opticalStabilizationMode">android.lens.opticalStabilizationMode</a> (controls)</li>
14160 <li><a href="#static_android.lens.info.availableApertures">android.lens.info.availableApertures</a> (static)</li>
14161 <li><a href="#static_android.lens.info.availableFilterDensities">android.lens.info.availableFilterDensities</a> (static)</li>
14162 <li><a href="#static_android.lens.info.availableFocalLengths">android.lens.info.availableFocalLengths</a> (static)</li>
14163 <li><a href="#static_android.lens.info.availableOpticalStabilization">android.lens.info.availableOpticalStabilization</a> (static)</li>
14164 <li><a href="#static_android.lens.info.geometricCorrectionMapSize">android.lens.info.geometricCorrectionMapSize</a> (static)</li>
14165 <li><a href="#static_android.lens.info.minimumFocusDistance">android.lens.info.minimumFocusDistance</a> (static)</li>
14166 <li><a href="#static_android.lens.info.shadingMapSize">android.lens.info.shadingMapSize</a> (static)</li>
14167 <li><a href="#static_android.lens.position">android.lens.position</a> (static)</li>
14168 <li><a href="#dynamic_android.lens.state">android.lens.state</a> (dynamic)</li>
14169 <li><a href="#controls_android.noiseReduction.mode">android.noiseReduction.mode</a> (controls)</li>
14170 <li><a href="#controls_android.request.id">android.request.id</a> (controls)</li>
14171 <li><a href="#controls_android.sensor.exposureTime">android.sensor.exposureTime</a> (controls)</li>
14172 <li><a href="#controls_android.sensor.frameDuration">android.sensor.frameDuration</a> (controls)</li>
14173 <li><a href="#controls_android.sensor.sensitivity">android.sensor.sensitivity</a> (controls)</li>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]14174 <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]14175 <li><a href="#static_android.sensor.info.exposureTimeRange">android.sensor.info.exposureTimeRange</a> (static)</li>
14176 <li><a href="#static_android.sensor.info.maxFrameDuration">android.sensor.info.maxFrameDuration</a> (static)</li>
14177 <li><a href="#static_android.sensor.info.physicalSize">android.sensor.info.physicalSize</a> (static)</li>
14178 <li><a href="#static_android.sensor.baseGainFactor">android.sensor.baseGainFactor</a> (static)</li>
14179 <li><a href="#static_android.sensor.maxAnalogSensitivity">android.sensor.maxAnalogSensitivity</a> (static)</li>
14180 <li><a href="#static_android.sensor.noiseModelCoefficients">android.sensor.noiseModelCoefficients</a> (static)</li>
14181 <li><a href="#controls_android.statistics.histogramMode">android.statistics.histogramMode</a> (controls)</li>
14182 <li><a href="#controls_android.statistics.sharpnessMapMode">android.statistics.sharpnessMapMode</a> (controls)</li>
14183 <li><a href="#dynamic_android.statistics.histogram">android.statistics.histogram</a> (dynamic)</li>
14184 <li><a href="#dynamic_android.statistics.sharpnessMap">android.statistics.sharpnessMap</a> (dynamic)</li>
14185 <li><a href="#dynamic_android.hotPixel.mode">android.hotPixel.mode</a> (dynamic)</li>
14186 <li><a href="#dynamic_android.lens.aperture">android.lens.aperture</a> (dynamic)</li>
14187 <li><a href="#dynamic_android.lens.filterDensity">android.lens.filterDensity</a> (dynamic)</li>
14188 <li><a href="#dynamic_android.lens.opticalStabilizationMode">android.lens.opticalStabilizationMode</a> (dynamic)</li>
14189 </ul>
14190 </li> <!-- tag_V1 -->
14191 <li id="tag_ADV">ADV - None
14192 <ul class="tags_entries">
14193 <li><a href="#static_android.flash.colorTemperature">android.flash.colorTemperature</a> (static)</li>
14194 <li><a href="#static_android.flash.maxEnergy">android.flash.maxEnergy</a> (static)</li>
14195 <li><a href="#controls_android.geometric.strength">android.geometric.strength</a> (controls)</li>
14196 <li><a href="#static_android.hotPixel.info.map">android.hotPixel.info.map</a> (static)</li>
14197 <li><a href="#static_android.lens.opticalAxisAngle">android.lens.opticalAxisAngle</a> (static)</li>
14198 <li><a href="#controls_android.shading.strength">android.shading.strength</a> (controls)</li>
14199 </ul>
14200 </li> <!-- tag_ADV -->
14201 <li id="tag_DNG">DNG -
14202 Needed for DNG file support
14203
14204 <ul class="tags_entries">
14205 <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]14206 <li><a href="#static_android.sensor.info.activeArraySize">android.sensor.info.activeArraySize</a> (static)</li>
14207 <li><a href="#static_android.sensor.info.colorFilterArrangement">android.sensor.info.colorFilterArrangement</a> (static)</li>
14208 <li><a href="#static_android.sensor.info.pixelArraySize">android.sensor.info.pixelArraySize</a> (static)</li>
14209 <li><a href="#static_android.sensor.info.whiteLevel">android.sensor.info.whiteLevel</a> (static)</li>
14210 <li><a href="#static_android.sensor.blackLevelPattern">android.sensor.blackLevelPattern</a> (static)</li>
14211 <li><a href="#static_android.sensor.calibrationTransform1">android.sensor.calibrationTransform1</a> (static)</li>
14212 <li><a href="#static_android.sensor.calibrationTransform2">android.sensor.calibrationTransform2</a> (static)</li>
14213 <li><a href="#static_android.sensor.colorTransform1">android.sensor.colorTransform1</a> (static)</li>
14214 <li><a href="#static_android.sensor.colorTransform2">android.sensor.colorTransform2</a> (static)</li>
14215 <li><a href="#static_android.sensor.forwardMatrix1">android.sensor.forwardMatrix1</a> (static)</li>
14216 <li><a href="#static_android.sensor.forwardMatrix2">android.sensor.forwardMatrix2</a> (static)</li>
14217 <li><a href="#static_android.sensor.referenceIlluminant1">android.sensor.referenceIlluminant1</a> (static)</li>
14218 <li><a href="#controls_android.tonemap.curveRed">android.tonemap.curveRed</a> (controls)</li>
14219 </ul>
14220 </li> <!-- tag_DNG -->
14221 <li id="tag_EXIF">EXIF - None
14222 <ul class="tags_entries">
14223 <li><a href="#static_android.sensor.referenceIlluminant1">android.sensor.referenceIlluminant1</a> (static)</li>
14224 </ul>
14225 </li> <!-- tag_EXIF -->
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]14226 <li id="tag_HAL2">HAL2 -
Alex Rayef40ad62013-10-01 17:52:33 -0700[diff] [blame]14227 Entry is only used by camera device HAL 2.x
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]14228
14229 <ul class="tags_entries">
14230 <li><a href="#controls_android.request.inputStreams">android.request.inputStreams</a> (controls)</li>
14231 <li><a href="#controls_android.request.outputStreams">android.request.outputStreams</a> (controls)</li>
14232 <li><a href="#controls_android.request.type">android.request.type</a> (controls)</li>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]14233 <li><a href="#controls_android.blackLevel.lock">android.blackLevel.lock</a> (controls)</li>
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]14234 </ul>
14235 </li> <!-- tag_HAL2 -->
Alex Rayef40ad62013-10-01 17:52:33 -0700[diff] [blame]14236 <li id="tag_FULL">FULL -
14237 Entry is required for full hardware level devices, and optional for other hardware levels
14238
14239 <ul class="tags_entries">
14240 <li><a href="#static_android.sensor.baseGainFactor">android.sensor.baseGainFactor</a> (static)</li>
14241 <li><a href="#static_android.sensor.maxAnalogSensitivity">android.sensor.maxAnalogSensitivity</a> (static)</li>
14242 <li><a href="#dynamic_android.sensor.temperature">android.sensor.temperature</a> (dynamic)</li>
14243 </ul>
14244 </li> <!-- tag_FULL -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]14245 </ul>
14246 </div>
14247
14248 [ <a href="#">top</a> ]
14249
14250</body>
14251</html>