Gitiles
Code Review Sign In
gerrit-public.fairphone.software / platform / system / media / 9e28ea7c5f7ea4550827414ce6f8f3818f90453c / . / camera / docs / docs.html
blob: bd752bb7ed1a9f9245b5dfa63fc8b835b748dac2 [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
721and <a href="#controls_android.colorCorrection.gains">android.<wbr/>color<wbr/>Correction.<wbr/>gains</a> to do color conversion</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]722 </li>
723 <li>
724 <span class="entry_type_enum_name">FAST</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]725 <span class="entry_type_enum_notes"><p>Must not slow down frame rate relative to raw
726bayer output</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]727 </li>
728 <li>
729 <span class="entry_type_enum_name">HIGH_QUALITY</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]730 <span class="entry_type_enum_notes"><p>Frame rate may be reduced by high
731quality</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]732 </li>
733 </ul>
734
735 </td> <!-- entry_type -->
736
737 <td class="entry_description">
738 </td>
739
740 <td class="entry_units">
741 </td>
742
743 <td class="entry_range">
744 </td>
745
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]746 <td class="entry_tags">
747 </td>
748
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]749 </tr>
750 <tr class="entries_header">
751 <th class="th_details" colspan="5">Details</th>
752 </tr>
753 <tr class="entry_cont">
754 <td class="entry_details" colspan="5">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]755 <p>When <a href="#controls_android.control.awbMode">android.<wbr/>control.<wbr/>awb<wbr/>Mode</a> is not OFF,<wbr/> TRANSFORM_<wbr/>MATRIX
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]756should be ignored.<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]757 </td>
758 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]759
760
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]761 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
762 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]763
764
765 <tr class="entry" id="controls_android.colorCorrection.transform">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]766 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]767 android.<wbr/>color<wbr/>Correction.<wbr/>transform
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]768 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]769 <td class="entry_type">
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]770 <span class="entry_type_name">rational</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]771 <span class="entry_type_container">x</span>
772
773 <span class="entry_type_array">
774 3 x 3
775 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]776 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]777 <div class="entry_type_notes">3x3 rational matrix in row-major order</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]778
779
780 </td> <!-- entry_type -->
781
782 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]783 <p>A color transform matrix to use to transform
784from sensor RGB color space to output linear sRGB color space</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]785 </td>
786
787 <td class="entry_units">
788 </td>
789
790 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]791 <p>Output values are expected to be in the range
792(0,<wbr/>1)</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]793 </td>
794
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]795 <td class="entry_tags">
796 </td>
797
798 </tr>
799 <tr class="entries_header">
800 <th class="th_details" colspan="5">Details</th>
801 </tr>
802 <tr class="entry_cont">
803 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]804 <p>This matrix is either set by HAL when the request
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]805<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]806directly by the application in the request when the
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]807<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]808<p>In the latter case,<wbr/> the HAL may round the matrix to account
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]809for precision issues; the final rounded matrix should be
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]810reported back in this matrix result metadata.<wbr/></p>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]811 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]812 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]813
814
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]815 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
816 <!-- end of entry -->
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]817
818
819 <tr class="entry" id="controls_android.colorCorrection.gains">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]820 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]821 android.<wbr/>color<wbr/>Correction.<wbr/>gains
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]822 </td>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]823 <td class="entry_type">
824 <span class="entry_type_name">float</span>
825 <span class="entry_type_container">x</span>
826
827 <span class="entry_type_array">
828 4
829 </span>
830 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]831 <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]832
833
834 </td> <!-- entry_type -->
835
836 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]837 <p>Gains applying to Bayer color channels for
838white-balance</p>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]839 </td>
840
841 <td class="entry_units">
842 </td>
843
844 <td class="entry_range">
845 </td>
846
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]847 <td class="entry_tags">
848 </td>
849
850 </tr>
851 <tr class="entries_header">
852 <th class="th_details" colspan="5">Details</th>
853 </tr>
854 <tr class="entry_cont">
855 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]856 <p>The 4-channel white-balance gains are defined in
857the order of [R G_<wbr/>even G_<wbr/>odd B],<wbr/> where G_<wbr/>even is the gain
858for green pixels on even rows of the output,<wbr/> and G_<wbr/>odd
859is the gain for greenpixels on the odd rows.<wbr/> if a HAL
860does not support a separate gain for even/<wbr/>odd green channels,<wbr/>
861it should use the G_<wbr/>even value,<wbr/>and write G_<wbr/>odd equal to
862G_<wbr/>even in the output result metadata.<wbr/></p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]863<p>This array is either set by HAL when the request
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]864<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]865directly by the application in the request when the
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]866<a href="#controls_android.colorCorrection.mode">android.<wbr/>color<wbr/>Correction.<wbr/>mode</a> is TRANSFORM_<wbr/>MATRIX.<wbr/></p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]867<p>The ouput should be the gains actually applied by the HAL to
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]868the current frame.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]869 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]870 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]871
872
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]873 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
874 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]875
876
877
878 <!-- end of kind -->
879 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]880 <tr><td colspan="6" class="kind">dynamic</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]881
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]882 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]883 <tr>
884 <th class="th_name">Property Name</th>
885 <th class="th_type">Type</th>
886 <th class="th_description">Description</th>
887 <th class="th_units">Units</th>
888 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]889 <th class="th_tags">Tags</th>
890 </tr>
891 </thead>
892
893 <tbody>
894
895
896
897
898
899
900
901
902
903
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]904 <tr class="entry" id="dynamic_android.colorCorrection.transform">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]905 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]906 android.<wbr/>color<wbr/>Correction.<wbr/>transform
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]907 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]908 <td class="entry_type">
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]909 <span class="entry_type_name">rational</span>
910 <span class="entry_type_container">x</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]911
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]912 <span class="entry_type_array">
913 3 x 3
914 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]915 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]916 <div class="entry_type_notes">3x3 rational matrix in row-major order</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]917
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]918
919 </td> <!-- entry_type -->
920
921 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]922 <p>A color transform matrix to use to transform
923from sensor RGB color space to output linear sRGB color space</p>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]924 </td>
925
926 <td class="entry_units">
927 </td>
928
929 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]930 <p>Output values are expected to be in the range
931(0,<wbr/>1)</p>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]932 </td>
933
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]934 <td class="entry_tags">
935 </td>
936
937 </tr>
938 <tr class="entries_header">
939 <th class="th_details" colspan="5">Details</th>
940 </tr>
941 <tr class="entry_cont">
942 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]943 <p>This matrix is either set by HAL when the request
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]944<a href="#controls_android.colorCorrection.mode">android.<wbr/>color<wbr/>Correction.<wbr/>mode</a> is not TRANSFORM_<wbr/>MATRIX,<wbr/> or
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]945directly by the application in the request when the
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]946<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]947<p>In the latter case,<wbr/> the HAL may round the matrix to account
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]948for precision issues; the final rounded matrix should be
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]949reported back in this matrix result metadata.<wbr/></p>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]950 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]951 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]952
953
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]954 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
955 <!-- end of entry -->
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]956
957
958 <tr class="entry" id="dynamic_android.colorCorrection.gains">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]959 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]960 android.<wbr/>color<wbr/>Correction.<wbr/>gains
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]961 </td>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]962 <td class="entry_type">
963 <span class="entry_type_name">float</span>
964 <span class="entry_type_container">x</span>
965
966 <span class="entry_type_array">
967 4
968 </span>
969 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]970 <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]971
972
973 </td> <!-- entry_type -->
974
975 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]976 <p>Gains applying to Bayer color channels for
977white-balance</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]978 </td>
979
980 <td class="entry_units">
981 </td>
982
983 <td class="entry_range">
984 </td>
985
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]986 <td class="entry_tags">
987 </td>
988
989 </tr>
990 <tr class="entries_header">
991 <th class="th_details" colspan="5">Details</th>
992 </tr>
993 <tr class="entry_cont">
994 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]995 <p>The 4-channel white-balance gains are defined in
996the order of [R G_<wbr/>even G_<wbr/>odd B],<wbr/> where G_<wbr/>even is the gain
997for green pixels on even rows of the output,<wbr/> and G_<wbr/>odd
998is the gain for greenpixels on the odd rows.<wbr/> if a HAL
999does not support a separate gain for even/<wbr/>odd green channels,<wbr/>
1000it should use the G_<wbr/>even value,<wbr/>and write G_<wbr/>odd equal to
1001G_<wbr/>even in the output result metadata.<wbr/></p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]1002<p>This array is either set by HAL when the request
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]1003<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]1004directly by the application in the request when the
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]1005<a href="#controls_android.colorCorrection.mode">android.<wbr/>color<wbr/>Correction.<wbr/>mode</a> is TRANSFORM_<wbr/>MATRIX.<wbr/></p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]1006<p>The ouput should be the gains actually applied by the HAL to
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1007the current frame.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1008 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1009 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1010
1011
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1012 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
1013 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1014
1015
1016
1017 <!-- end of kind -->
1018 </tbody>
1019
1020 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1021 <tr><td colspan="6" id="section_control" class="section">control</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1022
1023
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1024 <tr><td colspan="6" class="kind">controls</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1025
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]1026 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1027 <tr>
1028 <th class="th_name">Property Name</th>
1029 <th class="th_type">Type</th>
1030 <th class="th_description">Description</th>
1031 <th class="th_units">Units</th>
1032 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1033 <th class="th_tags">Tags</th>
1034 </tr>
1035 </thead>
1036
1037 <tbody>
1038
1039
1040
1041
1042
1043
1044
1045
1046
1047
1048 <tr class="entry" id="controls_android.control.aeAntibandingMode">
Eino-Ville Talvala19ce2c12013-12-30 12:03:45 -0800[diff] [blame]1049 <td class="entry_name" rowspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1050 android.<wbr/>control.<wbr/>ae<wbr/>Antibanding<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1051 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1052 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]1053 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1054
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]1055 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1056
1057 <ul class="entry_type_enum">
1058 <li>
1059 <span class="entry_type_enum_name">OFF</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]1060 <span class="entry_type_enum_notes"><p>The camera device will not adjust exposure duration to
1061avoid banding problems.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1062 </li>
1063 <li>
1064 <span class="entry_type_enum_name">50HZ</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]1065 <span class="entry_type_enum_notes"><p>The camera device will adjust exposure duration to
1066avoid banding problems with 50Hz illumination sources.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1067 </li>
1068 <li>
1069 <span class="entry_type_enum_name">60HZ</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]1070 <span class="entry_type_enum_notes"><p>The camera device will adjust exposure duration to
1071avoid banding problems with 60Hz illumination
1072sources.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1073 </li>
1074 <li>
1075 <span class="entry_type_enum_name">AUTO</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]1076 <span class="entry_type_enum_notes"><p>The camera device will automatically adapt its
1077antibanding routine to the current illumination
1078conditions.<wbr/> This is the default.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1079 </li>
1080 </ul>
1081
1082 </td> <!-- entry_type -->
1083
1084 <td class="entry_description">
Eino-Ville Talvala19ce2c12013-12-30 12:03:45 -0800[diff] [blame]1085 <p>The desired setting for the camera device's auto-exposure
1086algorithm's antibanding compensation.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1087 </td>
1088
1089 <td class="entry_units">
1090 </td>
1091
1092 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]1093 <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]1094 </td>
1095
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1096 <td class="entry_tags">
Eino-Ville Talvala19ce2c12013-12-30 12:03:45 -0800[diff] [blame]1097 <ul class="entry_tags">
1098 <li><a href="#tag_BC">BC</a></li>
1099 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1100 </td>
1101
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1102 </tr>
Eino-Ville Talvala19ce2c12013-12-30 12:03:45 -0800[diff] [blame]1103 <tr class="entries_header">
1104 <th class="th_details" colspan="5">Details</th>
1105 </tr>
1106 <tr class="entry_cont">
1107 <td class="entry_details" colspan="5">
1108 <p>Some kinds of lighting fixtures,<wbr/> such as some fluorescent
1109lights,<wbr/> flicker at the rate of the power supply frequency
1110(60Hz or 50Hz,<wbr/> depending on country).<wbr/> While this is
1111typically not noticeable to a person,<wbr/> it can be visible to
1112a camera device.<wbr/> If a camera sets its exposure time to the
1113wrong value,<wbr/> the flicker may become visible in the
1114viewfinder as flicker or in a final captured image,<wbr/> as a
1115set of variable-brightness bands across the image.<wbr/></p>
1116<p>Therefore,<wbr/> the auto-exposure routines of camera devices
1117include antibanding routines that ensure that the chosen
1118exposure value will not cause such banding.<wbr/> The choice of
1119exposure time depends on the rate of flicker,<wbr/> which the
1120camera device can detect automatically,<wbr/> or the expected
1121rate can be selected by the application using this
1122control.<wbr/></p>
1123<p>A given camera device may not support all of the possible
1124options for the antibanding mode.<wbr/> The
1125<a href="#static_android.control.aeAvailableAntibandingModes">android.<wbr/>control.<wbr/>ae<wbr/>Available<wbr/>Antibanding<wbr/>Modes</a> key contains
1126the available modes for a given camera device.<wbr/></p>
1127<p>The default mode is AUTO,<wbr/> which must be supported by all
1128camera devices.<wbr/></p>
1129<p>If manual exposure control is enabled (by setting
1130<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/>
1131then this setting has no effect,<wbr/> and the application must
1132ensure it selects exposure times that do not cause banding
1133issues.<wbr/> The <a href="#dynamic_android.statistics.sceneFlicker">android.<wbr/>statistics.<wbr/>scene<wbr/>Flicker</a> key can assist
1134the application in this.<wbr/></p>
1135 </td>
1136 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1137
Eino-Ville Talvala19ce2c12013-12-30 12:03:45 -0800[diff] [blame]1138 <tr class="entries_header">
1139 <th class="th_details" colspan="5">HAL Implementation Details</th>
1140 </tr>
1141 <tr class="entry_cont">
1142 <td class="entry_details" colspan="5">
1143 <p>For all capture request templates,<wbr/> this field must be set
1144to AUTO.<wbr/> AUTO is the only mode that must supported;
1145OFF,<wbr/> 50HZ,<wbr/> 60HZ are all optional.<wbr/></p>
1146<p>If manual exposure control is enabled (by setting
1147<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/>
1148then the exposure values provided by the application must not be
1149adjusted for antibanding.<wbr/></p>
1150 </td>
1151 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1152
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1153 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
1154 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1155
1156
1157 <tr class="entry" id="controls_android.control.aeExposureCompensation">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1158 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1159 android.<wbr/>control.<wbr/>ae<wbr/>Exposure<wbr/>Compensation
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1160 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1161 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]1162 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1163
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]1164 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1165
1166
1167 </td> <!-- entry_type -->
1168
1169 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1170 <p>Adjustment to AE target image
1171brightness</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1172 </td>
1173
1174 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1175 count of positive/<wbr/>negative EV steps
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1176 </td>
1177
1178 <td class="entry_range">
1179 </td>
1180
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1181 <td class="entry_tags">
1182 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]1183 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1184 </ul>
1185 </td>
1186
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1187 </tr>
1188 <tr class="entries_header">
1189 <th class="th_details" colspan="5">Details</th>
1190 </tr>
1191 <tr class="entry_cont">
1192 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1193 <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]1194exposure compensation of +2 EV; -3 will mean an exposure
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1195compensation of -1</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1196 </td>
1197 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1198
1199
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1200 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
1201 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1202
1203
1204 <tr class="entry" id="controls_android.control.aeLock">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1205 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1206 android.<wbr/>control.<wbr/>ae<wbr/>Lock
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1207 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1208 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]1209 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1210
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]1211 <span class="entry_type_visibility"> [public as boolean]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1212
1213 <ul class="entry_type_enum">
1214 <li>
Eino-Ville Talvala76548fe2013-01-11 13:57:19 -0800[diff] [blame]1215 <span class="entry_type_enum_name">OFF</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]1216 <span class="entry_type_enum_notes"><p>Autoexposure lock is disabled; the AE algorithm
1217is free to update its parameters.<wbr/></p></span>
Eino-Ville Talvala76548fe2013-01-11 13:57:19 -0800[diff] [blame]1218 </li>
1219 <li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1220 <span class="entry_type_enum_name">ON</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]1221 <span class="entry_type_enum_notes"><p>Autoexposure lock is enabled; the AE algorithm
1222must not update the exposure and sensitivity parameters
1223while the lock is active</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1224 </li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1225 </ul>
1226
1227 </td> <!-- entry_type -->
1228
1229 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1230 <p>Whether AE is currently locked to its latest
1231calculated values</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1232 </td>
1233
1234 <td class="entry_units">
1235 </td>
1236
1237 <td class="entry_range">
1238 </td>
1239
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1240 <td class="entry_tags">
1241 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]1242 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1243 </ul>
1244 </td>
1245
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1246 </tr>
1247 <tr class="entries_header">
1248 <th class="th_details" colspan="5">Details</th>
1249 </tr>
1250 <tr class="entry_cont">
1251 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1252 <p>Note that even when AE is locked,<wbr/> the flash may be
1253fired if the AE mode is ON_<wbr/>AUTO_<wbr/>FLASH /<wbr/> ON_<wbr/>ALWAYS_<wbr/>FLASH /<wbr/>
1254ON_<wbr/>AUTO_<wbr/>FLASH_<wbr/>REDEYE.<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1255 </td>
1256 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1257
1258
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1259 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
1260 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1261
1262
1263 <tr class="entry" id="controls_android.control.aeMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1264 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1265 android.<wbr/>control.<wbr/>ae<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1266 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1267 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]1268 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1269
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]1270 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1271
1272 <ul class="entry_type_enum">
1273 <li>
1274 <span class="entry_type_enum_name">OFF</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]1275 <span class="entry_type_enum_notes"><p>The camera device's autoexposure routine is disabled;
1276the application-selected <a href="#controls_android.sensor.exposureTime">android.<wbr/>sensor.<wbr/>exposure<wbr/>Time</a>,<wbr/>
1277<a href="#controls_android.sensor.sensitivity">android.<wbr/>sensor.<wbr/>sensitivity</a> and
1278<a href="#controls_android.sensor.frameDuration">android.<wbr/>sensor.<wbr/>frame<wbr/>Duration</a> are used by the camera
1279device,<wbr/> along with android.<wbr/>flash.<wbr/>* fields,<wbr/> if there's
1280a flash unit for this camera device.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1281 </li>
1282 <li>
1283 <span class="entry_type_enum_name">ON</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]1284 <span class="entry_type_enum_notes"><p>The camera device's autoexposure routine is active,<wbr/>
1285with no flash control.<wbr/> The application's values for
1286<a href="#controls_android.sensor.exposureTime">android.<wbr/>sensor.<wbr/>exposure<wbr/>Time</a>,<wbr/>
1287<a href="#controls_android.sensor.sensitivity">android.<wbr/>sensor.<wbr/>sensitivity</a>,<wbr/> and
1288<a href="#controls_android.sensor.frameDuration">android.<wbr/>sensor.<wbr/>frame<wbr/>Duration</a> are ignored.<wbr/> The
1289application has control over the various
1290android.<wbr/>flash.<wbr/>* fields.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1291 </li>
1292 <li>
1293 <span class="entry_type_enum_name">ON_AUTO_FLASH</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]1294 <span class="entry_type_enum_notes"><p>Like ON,<wbr/> except that the camera device also controls
1295the camera's flash unit,<wbr/> firing it in low-light
1296conditions.<wbr/> The flash may be fired during a
1297precapture sequence (triggered by
1298<a href="#controls_android.control.aePrecaptureTrigger">android.<wbr/>control.<wbr/>ae<wbr/>Precapture<wbr/>Trigger</a>) and may be fired
1299for captures for which the
1300<a href="#controls_android.control.captureIntent">android.<wbr/>control.<wbr/>capture<wbr/>Intent</a> field is set to
1301STILL_<wbr/>CAPTURE</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1302 </li>
1303 <li>
1304 <span class="entry_type_enum_name">ON_ALWAYS_FLASH</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]1305 <span class="entry_type_enum_notes"><p>Like ON,<wbr/> except that the camera device also controls
1306the camera's flash unit,<wbr/> always firing it for still
1307captures.<wbr/> The flash may be fired during a precapture
1308sequence (triggered by
1309<a href="#controls_android.control.aePrecaptureTrigger">android.<wbr/>control.<wbr/>ae<wbr/>Precapture<wbr/>Trigger</a>) and will always
1310be fired for captures for which the
1311<a href="#controls_android.control.captureIntent">android.<wbr/>control.<wbr/>capture<wbr/>Intent</a> field is set to
1312STILL_<wbr/>CAPTURE</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1313 </li>
1314 <li>
1315 <span class="entry_type_enum_name">ON_AUTO_FLASH_REDEYE</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]1316 <span class="entry_type_enum_notes"><p>Like ON_<wbr/>AUTO_<wbr/>FLASH,<wbr/> but with automatic red eye
1317reduction.<wbr/> If deemed necessary by the camera device,<wbr/>
1318a red eye reduction flash will fire during the
1319precapture sequence.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1320 </li>
1321 </ul>
1322
1323 </td> <!-- entry_type -->
1324
1325 <td class="entry_description">
Eino-Ville Talvala9fa0d902014-01-08 16:16:53 -0800[diff] [blame]1326 <p>The desired mode for the camera device's
1327auto-exposure routine.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1328 </td>
1329
1330 <td class="entry_units">
1331 </td>
1332
1333 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]1334 <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]1335 </td>
1336
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1337 <td class="entry_tags">
1338 <ul class="entry_tags">
1339 <li><a href="#tag_BC">BC</a></li>
1340 </ul>
1341 </td>
1342
1343 </tr>
1344 <tr class="entries_header">
1345 <th class="th_details" colspan="5">Details</th>
1346 </tr>
1347 <tr class="entry_cont">
1348 <td class="entry_details" colspan="5">
Eino-Ville Talvala9fa0d902014-01-08 16:16:53 -0800[diff] [blame]1349 <p>This control is only effective if <a href="#controls_android.control.mode">android.<wbr/>control.<wbr/>mode</a> is
1350AUTO.<wbr/></p>
1351<p>When set to any of the ON modes,<wbr/> the camera device's
1352auto-exposure routine is enabled,<wbr/> overriding the
1353application's selected exposure time,<wbr/> sensor sensitivity,<wbr/>
1354and frame duration (<a href="#controls_android.sensor.exposureTime">android.<wbr/>sensor.<wbr/>exposure<wbr/>Time</a>,<wbr/>
1355<a href="#controls_android.sensor.sensitivity">android.<wbr/>sensor.<wbr/>sensitivity</a>,<wbr/> and
1356<a href="#controls_android.sensor.frameDuration">android.<wbr/>sensor.<wbr/>frame<wbr/>Duration</a>).<wbr/> If one of the FLASH modes
1357is selected,<wbr/> the camera device's flash unit controls are
1358also overridden.<wbr/></p>
1359<p>The FLASH modes are only available if the camera device
1360has a flash unit (<a href="#static_android.flash.info.available">android.<wbr/>flash.<wbr/>info.<wbr/>available</a> is <code>true</code>).<wbr/></p>
1361<p>If flash TORCH mode is desired,<wbr/> this field must be set to
1362ON or OFF,<wbr/> and <a href="#controls_android.flash.mode">android.<wbr/>flash.<wbr/>mode</a> set to TORCH.<wbr/></p>
1363<p>When set to any of the ON modes,<wbr/> the values chosen by the
1364camera device auto-exposure routine for the overridden
1365fields for a given capture will be available in its
1366CaptureResult.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1367 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1368 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1369
1370
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1371 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
1372 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1373
1374
1375 <tr class="entry" id="controls_android.control.aeRegions">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1376 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1377 android.<wbr/>control.<wbr/>ae<wbr/>Regions
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1378 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1379 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]1380 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1381 <span class="entry_type_container">x</span>
1382
1383 <span class="entry_type_array">
1384 5 x area_count
1385 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]1386 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1387
1388
1389 </td> <!-- entry_type -->
1390
1391 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1392 <p>List of areas to use for
1393metering</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1394 </td>
1395
1396 <td class="entry_units">
1397 </td>
1398
1399 <td class="entry_range">
1400 </td>
1401
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1402 <td class="entry_tags">
1403 <ul class="entry_tags">
1404 <li><a href="#tag_BC">BC</a></li>
1405 </ul>
1406 </td>
1407
1408 </tr>
1409 <tr class="entries_header">
1410 <th class="th_details" colspan="5">Details</th>
1411 </tr>
1412 <tr class="entry_cont">
1413 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1414 <p>Each area is a rectangle plus weight: xmin,<wbr/> ymin,<wbr/>
1415xmax,<wbr/> ymax,<wbr/> weight.<wbr/> The rectangle is defined inclusive of the
1416specified coordinates.<wbr/></p>
1417<p>The coordinate system is based on the active pixel array,<wbr/>
1418with (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]1419(<a href="#static_android.sensor.info.activeArraySize">android.<wbr/>sensor.<wbr/>info.<wbr/>active<wbr/>Array<wbr/>Size</a>.<wbr/>width - 1,<wbr/>
1420<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]1421bottom-right pixel in the active pixel array.<wbr/> The weight
1422should be nonnegative.<wbr/></p>
1423<p>If all regions have 0 weight,<wbr/> then no specific metering area
1424needs to be used by the HAL.<wbr/> If the metering region is
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]1425outside 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]1426should ignore the sections outside the region and output the
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1427used sections in the frame metadata</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1428 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1429 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1430
1431
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1432 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
1433 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1434
1435
1436 <tr class="entry" id="controls_android.control.aeTargetFpsRange">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1437 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1438 android.<wbr/>control.<wbr/>ae<wbr/>Target<wbr/>Fps<wbr/>Range
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1439 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1440 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]1441 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1442 <span class="entry_type_container">x</span>
1443
1444 <span class="entry_type_array">
1445 2
1446 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]1447 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1448
1449
1450 </td> <!-- entry_type -->
1451
1452 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1453 <p>Range over which fps can be adjusted to
1454maintain exposure</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1455 </td>
1456
1457 <td class="entry_units">
1458 </td>
1459
1460 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]1461 <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]1462 </td>
1463
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1464 <td class="entry_tags">
1465 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]1466 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1467 </ul>
1468 </td>
1469
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1470 </tr>
1471 <tr class="entries_header">
1472 <th class="th_details" colspan="5">Details</th>
1473 </tr>
1474 <tr class="entry_cont">
1475 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1476 <p>Only constrains AE algorithm,<wbr/> not manual control
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]1477of <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]1478 </td>
1479 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1480
1481
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1482 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
1483 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1484
1485
Eino-Ville Talvala3b4383a2013-03-18 09:42:48 -0700[diff] [blame]1486 <tr class="entry" id="controls_android.control.aePrecaptureTrigger">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1487 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1488 android.<wbr/>control.<wbr/>ae<wbr/>Precapture<wbr/>Trigger
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1489 </td>
Eino-Ville Talvala3b4383a2013-03-18 09:42:48 -0700[diff] [blame]1490 <td class="entry_type">
1491 <span class="entry_type_name entry_type_name_enum">byte</span>
1492
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]1493 <span class="entry_type_visibility"> [public]</span>
Eino-Ville Talvala3b4383a2013-03-18 09:42:48 -0700[diff] [blame]1494
1495 <ul class="entry_type_enum">
1496 <li>
1497 <span class="entry_type_enum_name">IDLE</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]1498 <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]1499 </li>
1500 <li>
1501 <span class="entry_type_enum_name">START</span>
Zhijun He92e698d2014-01-13 16:24:31 -0800[diff] [blame]1502 <span class="entry_type_enum_notes"><p>The precapture metering sequence will be started
1503by the camera device.<wbr/> The exact effect of the precapture
1504trigger depends on the current AE mode and state.<wbr/></p></span>
Eino-Ville Talvala3b4383a2013-03-18 09:42:48 -0700[diff] [blame]1505 </li>
1506 </ul>
1507
1508 </td> <!-- entry_type -->
1509
1510 <td class="entry_description">
Zhijun He92e698d2014-01-13 16:24:31 -0800[diff] [blame]1511 <p>Whether the camera device will trigger a precapture
1512metering sequence when it processes this request.<wbr/></p>
Eino-Ville Talvala3b4383a2013-03-18 09:42:48 -0700[diff] [blame]1513 </td>
1514
1515 <td class="entry_units">
1516 </td>
1517
1518 <td class="entry_range">
1519 </td>
1520
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1521 <td class="entry_tags">
1522 <ul class="entry_tags">
1523 <li><a href="#tag_BC">BC</a></li>
1524 </ul>
1525 </td>
1526
1527 </tr>
1528 <tr class="entries_header">
1529 <th class="th_details" colspan="5">Details</th>
1530 </tr>
1531 <tr class="entry_cont">
1532 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1533 <p>This entry is normally set to IDLE,<wbr/> or is not
1534included at all in the request settings.<wbr/> When included and
Zhijun He92e698d2014-01-13 16:24:31 -0800[diff] [blame]1535set to START,<wbr/> the camera device will trigger the autoexposure
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1536precapture metering sequence.<wbr/></p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]1537<p>The effect of AE precapture trigger depends on the current
Zhijun He92e698d2014-01-13 16:24:31 -0800[diff] [blame]1538AE mode and state; see <a href="#dynamic_android.control.aeState">android.<wbr/>control.<wbr/>ae<wbr/>State</a> for AE precapture
1539state transition details.<wbr/></p>
Eino-Ville Talvala3b4383a2013-03-18 09:42:48 -0700[diff] [blame]1540 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1541 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1542
1543
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1544 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
1545 <!-- end of entry -->
Eino-Ville Talvala3b4383a2013-03-18 09:42:48 -0700[diff] [blame]1546
1547
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1548 <tr class="entry" id="controls_android.control.afMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1549 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1550 android.<wbr/>control.<wbr/>af<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1551 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1552 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]1553 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1554
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]1555 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1556
1557 <ul class="entry_type_enum">
1558 <li>
1559 <span class="entry_type_enum_name">OFF</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]1560 <span class="entry_type_enum_notes"><p>The auto-focus routine does not control the lens;
1561<a href="#controls_android.lens.focusDistance">android.<wbr/>lens.<wbr/>focus<wbr/>Distance</a> is controlled by the
1562application</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1563 </li>
1564 <li>
1565 <span class="entry_type_enum_name">AUTO</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]1566 <span class="entry_type_enum_notes"><p>If lens is not fixed focus.<wbr/></p>
1567<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
1568is fixed-focus.<wbr/> In this mode,<wbr/> the lens does not move unless
1569the autofocus trigger action is called.<wbr/> When that trigger
1570is activated,<wbr/> AF must transition to ACTIVE_<wbr/>SCAN,<wbr/> then to
1571the outcome of the scan (FOCUSED or NOT_<wbr/>FOCUSED).<wbr/></p>
1572<p>Triggering AF_<wbr/>CANCEL resets the lens position to default,<wbr/>
1573and sets the AF state to INACTIVE.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1574 </li>
1575 <li>
1576 <span class="entry_type_enum_name">MACRO</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]1577 <span class="entry_type_enum_notes"><p>In this mode,<wbr/> the lens does not move unless the
1578autofocus trigger action is called.<wbr/></p>
1579<p>When that trigger is activated,<wbr/> AF must transition to
1580ACTIVE_<wbr/>SCAN,<wbr/> then to the outcome of the scan (FOCUSED or
1581NOT_<wbr/>FOCUSED).<wbr/> Triggering cancel AF resets the lens
1582position to default,<wbr/> and sets the AF state to
1583INACTIVE.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1584 </li>
1585 <li>
1586 <span class="entry_type_enum_name">CONTINUOUS_VIDEO</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]1587 <span class="entry_type_enum_notes"><p>In this mode,<wbr/> the AF algorithm modifies the lens
1588position continually to attempt to provide a
1589constantly-in-focus image stream.<wbr/></p>
1590<p>The focusing behavior should be suitable for good quality
1591video recording; typically this means slower focus
1592movement and no overshoots.<wbr/> When the AF trigger is not
1593involved,<wbr/> the AF algorithm should start in INACTIVE state,<wbr/>
1594and then transition into PASSIVE_<wbr/>SCAN and PASSIVE_<wbr/>FOCUSED
1595states as appropriate.<wbr/> When the AF trigger is activated,<wbr/>
1596the algorithm should immediately transition into
1597AF_<wbr/>FOCUSED or AF_<wbr/>NOT_<wbr/>FOCUSED as appropriate,<wbr/> and lock the
1598lens position until a cancel AF trigger is received.<wbr/></p>
1599<p>Once cancel is received,<wbr/> the algorithm should transition
1600back to INACTIVE and resume passive scan.<wbr/> Note that this
1601behavior is not identical to CONTINUOUS_<wbr/>PICTURE,<wbr/> since an
1602ongoing PASSIVE_<wbr/>SCAN must immediately be
1603canceled.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1604 </li>
1605 <li>
1606 <span class="entry_type_enum_name">CONTINUOUS_PICTURE</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]1607 <span class="entry_type_enum_notes"><p>In this mode,<wbr/> the AF algorithm modifies the lens
1608position continually to attempt to provide a
1609constantly-in-focus image stream.<wbr/></p>
1610<p>The focusing behavior should be suitable for still image
1611capture; typically this means focusing as fast as
1612possible.<wbr/> When the AF trigger is not involved,<wbr/> the AF
1613algorithm should start in INACTIVE state,<wbr/> and then
1614transition into PASSIVE_<wbr/>SCAN and PASSIVE_<wbr/>FOCUSED states as
1615appropriate as it attempts to maintain focus.<wbr/> When the AF
1616trigger is activated,<wbr/> the algorithm should finish its
1617PASSIVE_<wbr/>SCAN if active,<wbr/> and then transition into
1618AF_<wbr/>FOCUSED or AF_<wbr/>NOT_<wbr/>FOCUSED as appropriate,<wbr/> and lock the
1619lens position until a cancel AF trigger is received.<wbr/></p>
1620<p>When the AF cancel trigger is activated,<wbr/> the algorithm
1621should transition back to INACTIVE and then act as if it
1622has just been started.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1623 </li>
1624 <li>
1625 <span class="entry_type_enum_name">EDOF</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]1626 <span class="entry_type_enum_notes"><p>Extended depth of field (digital focus).<wbr/> AF
1627trigger is ignored,<wbr/> AF state should always be
1628INACTIVE.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1629 </li>
1630 </ul>
1631
1632 </td> <!-- entry_type -->
1633
1634 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1635 <p>Whether AF is currently enabled,<wbr/> and what
1636mode it is set to</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1637 </td>
1638
1639 <td class="entry_units">
1640 </td>
1641
1642 <td class="entry_range">
Zhijun He7787f7f2014-01-14 16:30:31 -0800[diff] [blame]1643 <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]1644 </td>
1645
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1646 <td class="entry_tags">
1647 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]1648 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1649 </ul>
1650 </td>
1651
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1652 </tr>
1653 <tr class="entries_header">
1654 <th class="th_details" colspan="5">Details</th>
1655 </tr>
1656 <tr class="entry_cont">
1657 <td class="entry_details" colspan="5">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]1658 <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]1659<p>If the lens is controlled by the camera device auto-focus algorithm,<wbr/>
1660the camera device will report the current AF status in android.<wbr/>control.<wbr/>af<wbr/>State
1661in result metadata.<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1662 </td>
1663 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1664
1665
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1666 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
1667 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1668
1669
1670 <tr class="entry" id="controls_android.control.afRegions">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1671 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1672 android.<wbr/>control.<wbr/>af<wbr/>Regions
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1673 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1674 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]1675 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1676 <span class="entry_type_container">x</span>
1677
1678 <span class="entry_type_array">
1679 5 x area_count
1680 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]1681 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1682
1683
1684 </td> <!-- entry_type -->
1685
1686 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1687 <p>List of areas to use for focus
1688estimation</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1689 </td>
1690
1691 <td class="entry_units">
1692 </td>
1693
1694 <td class="entry_range">
1695 </td>
1696
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1697 <td class="entry_tags">
1698 <ul class="entry_tags">
1699 <li><a href="#tag_BC">BC</a></li>
1700 </ul>
1701 </td>
1702
1703 </tr>
1704 <tr class="entries_header">
1705 <th class="th_details" colspan="5">Details</th>
1706 </tr>
1707 <tr class="entry_cont">
1708 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1709 <p>Each area is a rectangle plus weight: xmin,<wbr/> ymin,<wbr/>
1710xmax,<wbr/> ymax,<wbr/> weight.<wbr/> The rectangle is defined inclusive of the
1711specified coordinates.<wbr/></p>
1712<p>The coordinate system is based on the active pixel array,<wbr/>
1713with (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]1714(<a href="#static_android.sensor.info.activeArraySize">android.<wbr/>sensor.<wbr/>info.<wbr/>active<wbr/>Array<wbr/>Size</a>.<wbr/>width - 1,<wbr/>
1715<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]1716bottom-right pixel in the active pixel array.<wbr/> The weight
1717should be nonnegative.<wbr/></p>
1718<p>If all regions have 0 weight,<wbr/> then no specific focus area
1719needs to be used by the HAL.<wbr/> If the focusing region is
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]1720outside 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]1721should ignore the sections outside the region and output the
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1722used sections in the frame metadata</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1723 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1724 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1725
1726
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1727 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
1728 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1729
1730
Eino-Ville Talvala3b4383a2013-03-18 09:42:48 -0700[diff] [blame]1731 <tr class="entry" id="controls_android.control.afTrigger">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1732 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1733 android.<wbr/>control.<wbr/>af<wbr/>Trigger
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1734 </td>
Eino-Ville Talvala3b4383a2013-03-18 09:42:48 -0700[diff] [blame]1735 <td class="entry_type">
1736 <span class="entry_type_name entry_type_name_enum">byte</span>
1737
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]1738 <span class="entry_type_visibility"> [public]</span>
Eino-Ville Talvala3b4383a2013-03-18 09:42:48 -0700[diff] [blame]1739
1740 <ul class="entry_type_enum">
1741 <li>
1742 <span class="entry_type_enum_name">IDLE</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]1743 <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]1744 </li>
1745 <li>
1746 <span class="entry_type_enum_name">START</span>
Zhijun He92e698d2014-01-13 16:24:31 -0800[diff] [blame]1747 <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]1748 </li>
1749 <li>
1750 <span class="entry_type_enum_name">CANCEL</span>
Zhijun He92e698d2014-01-13 16:24:31 -0800[diff] [blame]1751 <span class="entry_type_enum_notes"><p>Autofocus will return to its initial
1752state,<wbr/> and cancel any currently active trigger.<wbr/></p></span>
Eino-Ville Talvala3b4383a2013-03-18 09:42:48 -0700[diff] [blame]1753 </li>
1754 </ul>
1755
1756 </td> <!-- entry_type -->
1757
1758 <td class="entry_description">
Zhijun He92e698d2014-01-13 16:24:31 -0800[diff] [blame]1759 <p>Whether the camera device will trigger autofocus for this request.<wbr/></p>
Eino-Ville Talvala3b4383a2013-03-18 09:42:48 -0700[diff] [blame]1760 </td>
1761
1762 <td class="entry_units">
1763 </td>
1764
1765 <td class="entry_range">
1766 </td>
1767
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1768 <td class="entry_tags">
1769 <ul class="entry_tags">
1770 <li><a href="#tag_BC">BC</a></li>
1771 </ul>
1772 </td>
1773
1774 </tr>
1775 <tr class="entries_header">
1776 <th class="th_details" colspan="5">Details</th>
1777 </tr>
1778 <tr class="entry_cont">
1779 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1780 <p>This entry is normally set to IDLE,<wbr/> or is not
1781included at all in the request settings.<wbr/></p>
Zhijun He92e698d2014-01-13 16:24:31 -0800[diff] [blame]1782<p>When included and set to START,<wbr/> the camera device will trigger the
1783autofocus algorithm.<wbr/> If autofocus is disabled,<wbr/> this trigger has no effect.<wbr/></p>
1784<p>When set to CANCEL,<wbr/> the camera device will cancel any active trigger,<wbr/>
1785and return to its initial AF state.<wbr/></p>
1786<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]1787 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1788 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1789
1790
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1791 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
1792 <!-- end of entry -->
Eino-Ville Talvala3b4383a2013-03-18 09:42:48 -0700[diff] [blame]1793
1794
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1795 <tr class="entry" id="controls_android.control.awbLock">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1796 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1797 android.<wbr/>control.<wbr/>awb<wbr/>Lock
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1798 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1799 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]1800 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1801
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]1802 <span class="entry_type_visibility"> [public as boolean]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1803
1804 <ul class="entry_type_enum">
1805 <li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1806 <span class="entry_type_enum_name">OFF</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]1807 <span class="entry_type_enum_notes"><p>Auto-whitebalance lock is disabled; the AWB
1808algorithm is free to update its parameters if in AUTO
1809mode.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1810 </li>
Eino-Ville Talvala76548fe2013-01-11 13:57:19 -0800[diff] [blame]1811 <li>
1812 <span class="entry_type_enum_name">ON</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]1813 <span class="entry_type_enum_notes"><p>Auto-whitebalance lock is enabled; the AWB
1814algorithm must not update the exposure and sensitivity
1815parameters while the lock is active</p></span>
Eino-Ville Talvala76548fe2013-01-11 13:57:19 -0800[diff] [blame]1816 </li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1817 </ul>
1818
1819 </td> <!-- entry_type -->
1820
1821 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1822 <p>Whether AWB is currently locked to its
1823latest calculated values</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1824 </td>
1825
1826 <td class="entry_units">
1827 </td>
1828
1829 <td class="entry_range">
1830 </td>
1831
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1832 <td class="entry_tags">
1833 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]1834 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1835 </ul>
1836 </td>
1837
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1838 </tr>
1839 <tr class="entries_header">
1840 <th class="th_details" colspan="5">Details</th>
1841 </tr>
1842 <tr class="entry_cont">
1843 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1844 <p>Note that AWB lock is only meaningful for AUTO
1845mode; in other modes,<wbr/> AWB is already fixed to a specific
1846setting</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1847 </td>
1848 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1849
1850
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1851 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
1852 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1853
1854
1855 <tr class="entry" id="controls_android.control.awbMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1856 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1857 android.<wbr/>control.<wbr/>awb<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1858 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1859 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]1860 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1861
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]1862 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1863
1864 <ul class="entry_type_enum">
1865 <li>
1866 <span class="entry_type_enum_name">OFF</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]1867 <span class="entry_type_enum_notes"><p>The camera device's auto white balance routine is disabled;
1868the application-selected color transform matrix
1869(<a href="#controls_android.colorCorrection.transform">android.<wbr/>color<wbr/>Correction.<wbr/>transform</a>) and gains
1870(<a href="#controls_android.colorCorrection.gains">android.<wbr/>color<wbr/>Correction.<wbr/>gains</a>) are used by the camera
1871device for manual white balance control.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1872 </li>
1873 <li>
1874 <span class="entry_type_enum_name">AUTO</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]1875 <span class="entry_type_enum_notes"><p>The camera device's auto white balance routine is active;
1876the application's values for android.<wbr/>color<wbr/>Correction.<wbr/>transform
1877and <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]1878 </li>
1879 <li>
1880 <span class="entry_type_enum_name">INCANDESCENT</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]1881 <span class="entry_type_enum_notes"><p>The camera device's auto white balance routine is disabled;
1882the camera device uses incandescent light as the assumed scene
1883illumination for white balance.<wbr/> While the exact white balance
1884transforms are up to the camera device,<wbr/> they will approximately
1885match the CIE standard illuminant A.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1886 </li>
1887 <li>
1888 <span class="entry_type_enum_name">FLUORESCENT</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]1889 <span class="entry_type_enum_notes"><p>The camera device's auto white balance routine is disabled;
1890the camera device uses fluorescent light as the assumed scene
1891illumination for white balance.<wbr/> While the exact white balance
1892transforms are up to the camera device,<wbr/> they will approximately
1893match the CIE standard illuminant F2.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1894 </li>
1895 <li>
1896 <span class="entry_type_enum_name">WARM_FLUORESCENT</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]1897 <span class="entry_type_enum_notes"><p>The camera device's auto white balance routine is disabled;
1898the camera device uses warm fluorescent light as the assumed scene
1899illumination for white balance.<wbr/> While the exact white balance
1900transforms are up to the camera device,<wbr/> they will approximately
1901match the CIE standard illuminant F4.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1902 </li>
1903 <li>
1904 <span class="entry_type_enum_name">DAYLIGHT</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]1905 <span class="entry_type_enum_notes"><p>The camera device's auto white balance routine is disabled;
1906the camera device uses daylight light as the assumed scene
1907illumination for white balance.<wbr/> While the exact white balance
1908transforms are up to the camera device,<wbr/> they will approximately
1909match the CIE standard illuminant D65.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1910 </li>
1911 <li>
1912 <span class="entry_type_enum_name">CLOUDY_DAYLIGHT</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]1913 <span class="entry_type_enum_notes"><p>The camera device's auto white balance routine is disabled;
1914the camera device uses cloudy daylight light as the assumed scene
1915illumination for white balance.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1916 </li>
1917 <li>
1918 <span class="entry_type_enum_name">TWILIGHT</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]1919 <span class="entry_type_enum_notes"><p>The camera device's auto white balance routine is disabled;
1920the camera device uses twilight light as the assumed scene
1921illumination for white balance.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1922 </li>
1923 <li>
1924 <span class="entry_type_enum_name">SHADE</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]1925 <span class="entry_type_enum_notes"><p>The camera device's auto white balance routine is disabled;
1926the camera device uses shade light as the assumed scene
1927illumination for white balance.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1928 </li>
1929 </ul>
1930
1931 </td> <!-- entry_type -->
1932
1933 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1934 <p>Whether AWB is currently setting the color
1935transform fields,<wbr/> and what its illumination target
1936is</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1937 </td>
1938
1939 <td class="entry_units">
1940 </td>
1941
1942 <td class="entry_range">
Zhijun He7787f7f2014-01-14 16:30:31 -0800[diff] [blame]1943 <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]1944 </td>
1945
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1946 <td class="entry_tags">
1947 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]1948 <li><a href="#tag_BC">BC</a></li>
1949 <li><a href="#tag_AWB">AWB</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1950 </ul>
1951 </td>
1952
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1953 </tr>
1954 <tr class="entries_header">
1955 <th class="th_details" colspan="5">Details</th>
1956 </tr>
1957 <tr class="entry_cont">
1958 <td class="entry_details" colspan="5">
Zhijun He7787f7f2014-01-14 16:30:31 -0800[diff] [blame]1959 <p>This control is only effective if <a href="#controls_android.control.mode">android.<wbr/>control.<wbr/>mode</a> is AUTO.<wbr/></p>
1960<p>When set to the ON mode,<wbr/> the camera device's auto white balance
1961routine is enabled,<wbr/> overriding the application's selected
1962<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
1963<a href="#controls_android.colorCorrection.mode">android.<wbr/>color<wbr/>Correction.<wbr/>mode</a>.<wbr/></p>
1964<p>When set to the OFF mode,<wbr/> the camera device's auto white balance
1965routine is disabled.<wbr/> The applicantion manually controls the white
1966balance by <a href="#controls_android.colorCorrection.transform">android.<wbr/>color<wbr/>Correction.<wbr/>transform</a>,<wbr/> android.<wbr/>color<wbr/>Correction.<wbr/>gains
1967and <a href="#controls_android.colorCorrection.mode">android.<wbr/>color<wbr/>Correction.<wbr/>mode</a>.<wbr/></p>
1968<p>When set to any other modes,<wbr/> the camera device's auto white balance
1969routine is disabled.<wbr/> The camera device uses each particular illumination
1970target for white balance adjustment.<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1971 </td>
1972 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1973
1974
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1975 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
1976 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1977
1978
1979 <tr class="entry" id="controls_android.control.awbRegions">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1980 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1981 android.<wbr/>control.<wbr/>awb<wbr/>Regions
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1982 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1983 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]1984 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1985 <span class="entry_type_container">x</span>
1986
1987 <span class="entry_type_array">
1988 5 x area_count
1989 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]1990 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1991
1992
1993 </td> <!-- entry_type -->
1994
1995 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1996 <p>List of areas to use for illuminant
1997estimation</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1998 </td>
1999
2000 <td class="entry_units">
2001 </td>
2002
2003 <td class="entry_range">
2004 </td>
2005
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2006 <td class="entry_tags">
2007 <ul class="entry_tags">
2008 <li><a href="#tag_BC">BC</a></li>
2009 </ul>
2010 </td>
2011
2012 </tr>
2013 <tr class="entries_header">
2014 <th class="th_details" colspan="5">Details</th>
2015 </tr>
2016 <tr class="entry_cont">
2017 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2018 <p>Only used in AUTO mode.<wbr/></p>
2019<p>Each area is a rectangle plus weight: xmin,<wbr/> ymin,<wbr/>
2020xmax,<wbr/> ymax,<wbr/> weight.<wbr/> The rectangle is defined inclusive of the
2021specified coordinates.<wbr/></p>
2022<p>The coordinate system is based on the active pixel array,<wbr/>
2023with (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]2024(<a href="#static_android.sensor.info.activeArraySize">android.<wbr/>sensor.<wbr/>info.<wbr/>active<wbr/>Array<wbr/>Size</a>.<wbr/>width - 1,<wbr/>
2025<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]2026bottom-right pixel in the active pixel array.<wbr/> The weight
2027should be nonnegative.<wbr/></p>
2028<p>If all regions have 0 weight,<wbr/> then no specific metering area
2029needs to be used by the HAL.<wbr/> If the metering region is
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]2030outside 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]2031should ignore the sections outside the region and output the
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2032used sections in the frame metadata</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2033 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2034 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2035
2036
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2037 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
2038 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2039
2040
2041 <tr class="entry" id="controls_android.control.captureIntent">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2042 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2043 android.<wbr/>control.<wbr/>capture<wbr/>Intent
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2044 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2045 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]2046 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2047
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2048 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2049
2050 <ul class="entry_type_enum">
2051 <li>
2052 <span class="entry_type_enum_name">CUSTOM</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]2053 <span class="entry_type_enum_notes"><p>This request doesn't fall into the other
2054categories.<wbr/> Default to preview-like
2055behavior.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2056 </li>
2057 <li>
2058 <span class="entry_type_enum_name">PREVIEW</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]2059 <span class="entry_type_enum_notes"><p>This request is for a preview-like usecase.<wbr/> The
2060precapture trigger may be used to start off a metering
2061w/<wbr/>flash sequence</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2062 </li>
2063 <li>
2064 <span class="entry_type_enum_name">STILL_CAPTURE</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]2065 <span class="entry_type_enum_notes"><p>This request is for a still capture-type
2066usecase.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2067 </li>
2068 <li>
2069 <span class="entry_type_enum_name">VIDEO_RECORD</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]2070 <span class="entry_type_enum_notes"><p>This request is for a video recording
2071usecase.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2072 </li>
2073 <li>
2074 <span class="entry_type_enum_name">VIDEO_SNAPSHOT</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]2075 <span class="entry_type_enum_notes"><p>This request is for a video snapshot (still
2076image while recording video) usecase</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2077 </li>
2078 <li>
2079 <span class="entry_type_enum_name">ZERO_SHUTTER_LAG</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]2080 <span class="entry_type_enum_notes"><p>This request is for a ZSL usecase; the
2081application will stream full-resolution images and
2082reprocess one or several later for a final
2083capture</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2084 </li>
2085 </ul>
2086
2087 </td> <!-- entry_type -->
2088
2089 <td class="entry_description">
Zhijun Heea27bc32014-01-15 13:47:59 -0800[diff] [blame]2090 <p>Information to the camera device 3A (auto-exposure,<wbr/>
2091auto-focus,<wbr/> auto-white balance) routines about the purpose
2092of this capture,<wbr/> to help the camera device to decide optimal 3A
2093strategy.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2094 </td>
2095
2096 <td class="entry_units">
2097 </td>
2098
2099 <td class="entry_range">
Zhijun Heea27bc32014-01-15 13:47:59 -0800[diff] [blame]2100 <p>All must be supported</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2101 </td>
2102
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2103 <td class="entry_tags">
2104 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]2105 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2106 </ul>
2107 </td>
2108
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2109 </tr>
2110 <tr class="entries_header">
2111 <th class="th_details" colspan="5">Details</th>
2112 </tr>
2113 <tr class="entry_cont">
2114 <td class="entry_details" colspan="5">
Zhijun Heea27bc32014-01-15 13:47:59 -0800[diff] [blame]2115 <p>This control is only effective if <code><a href="#controls_android.control.mode">android.<wbr/>control.<wbr/>mode</a> != OFF</code>
2116and any 3A routine is active.<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2117 </td>
2118 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2119
2120
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2121 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
2122 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2123
2124
2125 <tr class="entry" id="controls_android.control.effectMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2126 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2127 android.<wbr/>control.<wbr/>effect<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2128 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2129 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]2130 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2131
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2132 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2133
2134 <ul class="entry_type_enum">
2135 <li>
2136 <span class="entry_type_enum_name">OFF</span>
2137 </li>
2138 <li>
2139 <span class="entry_type_enum_name">MONO</span>
2140 <span class="entry_type_enum_optional">optional</span>
2141 </li>
2142 <li>
2143 <span class="entry_type_enum_name">NEGATIVE</span>
2144 <span class="entry_type_enum_optional">optional</span>
2145 </li>
2146 <li>
2147 <span class="entry_type_enum_name">SOLARIZE</span>
2148 <span class="entry_type_enum_optional">optional</span>
2149 </li>
2150 <li>
2151 <span class="entry_type_enum_name">SEPIA</span>
2152 <span class="entry_type_enum_optional">optional</span>
2153 </li>
2154 <li>
2155 <span class="entry_type_enum_name">POSTERIZE</span>
2156 <span class="entry_type_enum_optional">optional</span>
2157 </li>
2158 <li>
2159 <span class="entry_type_enum_name">WHITEBOARD</span>
2160 <span class="entry_type_enum_optional">optional</span>
2161 </li>
2162 <li>
2163 <span class="entry_type_enum_name">BLACKBOARD</span>
2164 <span class="entry_type_enum_optional">optional</span>
2165 </li>
2166 <li>
2167 <span class="entry_type_enum_name">AQUA</span>
2168 <span class="entry_type_enum_optional">optional</span>
2169 </li>
2170 </ul>
2171
2172 </td> <!-- entry_type -->
2173
2174 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2175 <p>Whether any special color effect is in use.<wbr/>
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]2176Only 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]2177 </td>
2178
2179 <td class="entry_units">
2180 </td>
2181
2182 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]2183 <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]2184 </td>
2185
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2186 <td class="entry_tags">
2187 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]2188 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2189 </ul>
2190 </td>
2191
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2192 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2193
2194
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2195 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
2196 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2197
2198
2199 <tr class="entry" id="controls_android.control.mode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2200 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2201 android.<wbr/>control.<wbr/>mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2202 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2203 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]2204 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2205
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2206 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2207
2208 <ul class="entry_type_enum">
2209 <li>
2210 <span class="entry_type_enum_name">OFF</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]2211 <span class="entry_type_enum_notes"><p>Full application control of pipeline.<wbr/> All 3A
2212routines are disabled,<wbr/> no other settings in
2213android.<wbr/>control.<wbr/>* have any effect</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2214 </li>
2215 <li>
2216 <span class="entry_type_enum_name">AUTO</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]2217 <span class="entry_type_enum_notes"><p>Use settings for each individual 3A routine.<wbr/>
2218Manual control of capture parameters is disabled.<wbr/> All
2219controls in android.<wbr/>control.<wbr/>* besides sceneMode take
2220effect</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2221 </li>
2222 <li>
2223 <span class="entry_type_enum_name">USE_SCENE_MODE</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]2224 <span class="entry_type_enum_notes"><p>Use specific scene mode.<wbr/> Enabling this disables
2225control.<wbr/>aeMode,<wbr/> control.<wbr/>awbMode and control.<wbr/>afMode
2226controls; the HAL must ignore those settings while
2227USE_<wbr/>SCENE_<wbr/>MODE is active (except for FACE_<wbr/>PRIORITY
2228scene mode).<wbr/> Other control entries are still active.<wbr/>
2229This setting can only be used if availableSceneModes !=
2230UNSUPPORTED</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2231 </li>
2232 </ul>
2233
2234 </td> <!-- entry_type -->
2235
2236 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2237 <p>Overall mode of 3A control
2238routines</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2239 </td>
2240
2241 <td class="entry_units">
2242 </td>
2243
2244 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]2245 <p>all must be supported</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2246 </td>
2247
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2248 <td class="entry_tags">
2249 <ul class="entry_tags">
2250 <li><a href="#tag_BC">BC</a></li>
2251 </ul>
2252 </td>
2253
2254 </tr>
2255 <tr class="entries_header">
2256 <th class="th_details" colspan="5">Details</th>
2257 </tr>
2258 <tr class="entry_cont">
2259 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2260 <p>High-level 3A control.<wbr/> When set to OFF,<wbr/> all 3A control
Zhijun Hef90eeaf2014-01-16 12:13:35 -0800[diff] [blame]2261by the camera device is disabled.<wbr/> The application must set the fields for
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2262capture parameters itself.<wbr/></p>
2263<p>When set to AUTO,<wbr/> the individual algorithm controls in
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]2264android.<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]2265<p>When set to USE_<wbr/>SCENE_<wbr/>MODE,<wbr/> the individual controls in
Zhijun Hef90eeaf2014-01-16 12:13:35 -0800[diff] [blame]2266android.<wbr/>control.<wbr/>* are mostly disabled,<wbr/> and the camera device implements
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2267one of the scene mode settings (such as ACTION,<wbr/> SUNSET,<wbr/> or PARTY)
Zhijun Hef90eeaf2014-01-16 12:13:35 -0800[diff] [blame]2268as it wishes.<wbr/> The camera device scene mode 3A settings are provided by
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]2269<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]2270 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2271 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2272
2273
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2274 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
2275 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2276
2277
2278 <tr class="entry" id="controls_android.control.sceneMode">
Ruben Brunk9e28ea72014-01-14 18:55:29 -0800[diff] [blame^]2279 <td class="entry_name" rowspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2280 android.<wbr/>control.<wbr/>scene<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2281 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2282 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]2283 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2284
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2285 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2286
2287 <ul class="entry_type_enum">
2288 <li>
Ruben Brunk9e28ea72014-01-14 18:55:29 -0800[diff] [blame^]2289 <span class="entry_type_enum_name">DISABLED</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2290 <span class="entry_type_enum_value">0</span>
Ruben Brunk9e28ea72014-01-14 18:55:29 -0800[diff] [blame^]2291 <span class="entry_type_enum_notes"><p>Indicates that no scene modes are set for a given capture request.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2292 </li>
2293 <li>
2294 <span class="entry_type_enum_name">FACE_PRIORITY</span>
Ruben Brunk9e28ea72014-01-14 18:55:29 -0800[diff] [blame^]2295 <span class="entry_type_enum_notes"><p>If face detection support exists,<wbr/> use face
2296detection data for auto-focus,<wbr/> auto-white balance,<wbr/> and
2297auto-exposure routines.<wbr/> If face detection statistics are
2298disabled (i.<wbr/>e.<wbr/> <a href="#controls_android.statistics.faceDetectMode">android.<wbr/>statistics.<wbr/>face<wbr/>Detect<wbr/>Mode</a> is set to OFF),<wbr/>
2299this should still operate correctly (but will not return
2300face detection statistics to the framework).<wbr/></p>
2301<p>Unlike the other scene modes,<wbr/> <a href="#controls_android.control.aeMode">android.<wbr/>control.<wbr/>ae<wbr/>Mode</a>,<wbr/>
2302<a href="#controls_android.control.awbMode">android.<wbr/>control.<wbr/>awb<wbr/>Mode</a>,<wbr/> and android.<wbr/>control.<wbr/>af<wbr/>Mode
2303remain active when FACE_<wbr/>PRIORITY is set.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2304 </li>
2305 <li>
2306 <span class="entry_type_enum_name">ACTION</span>
2307 <span class="entry_type_enum_optional">optional</span>
Ruben Brunk9e28ea72014-01-14 18:55:29 -0800[diff] [blame^]2308 <span class="entry_type_enum_notes"><p>Optimized for photos of quickly moving objects.<wbr/>
2309Similar to SPORTS.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2310 </li>
2311 <li>
2312 <span class="entry_type_enum_name">PORTRAIT</span>
2313 <span class="entry_type_enum_optional">optional</span>
Ruben Brunk9e28ea72014-01-14 18:55:29 -0800[diff] [blame^]2314 <span class="entry_type_enum_notes"><p>Optimized for still photos of people.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2315 </li>
2316 <li>
2317 <span class="entry_type_enum_name">LANDSCAPE</span>
2318 <span class="entry_type_enum_optional">optional</span>
Ruben Brunk9e28ea72014-01-14 18:55:29 -0800[diff] [blame^]2319 <span class="entry_type_enum_notes"><p>Optimized for photos of distant macroscopic objects.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2320 </li>
2321 <li>
2322 <span class="entry_type_enum_name">NIGHT</span>
2323 <span class="entry_type_enum_optional">optional</span>
Ruben Brunk9e28ea72014-01-14 18:55:29 -0800[diff] [blame^]2324 <span class="entry_type_enum_notes"><p>Optimized for low-light settings.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2325 </li>
2326 <li>
2327 <span class="entry_type_enum_name">NIGHT_PORTRAIT</span>
2328 <span class="entry_type_enum_optional">optional</span>
Ruben Brunk9e28ea72014-01-14 18:55:29 -0800[diff] [blame^]2329 <span class="entry_type_enum_notes"><p>Optimized for still photos of people in low-light
2330settings.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2331 </li>
2332 <li>
2333 <span class="entry_type_enum_name">THEATRE</span>
2334 <span class="entry_type_enum_optional">optional</span>
Ruben Brunk9e28ea72014-01-14 18:55:29 -0800[diff] [blame^]2335 <span class="entry_type_enum_notes"><p>Optimized for dim,<wbr/> indoor settings where flash must
2336remain off.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2337 </li>
2338 <li>
2339 <span class="entry_type_enum_name">BEACH</span>
2340 <span class="entry_type_enum_optional">optional</span>
Ruben Brunk9e28ea72014-01-14 18:55:29 -0800[diff] [blame^]2341 <span class="entry_type_enum_notes"><p>Optimized for bright,<wbr/> outdoor beach settings.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2342 </li>
2343 <li>
2344 <span class="entry_type_enum_name">SNOW</span>
2345 <span class="entry_type_enum_optional">optional</span>
Ruben Brunk9e28ea72014-01-14 18:55:29 -0800[diff] [blame^]2346 <span class="entry_type_enum_notes"><p>Optimized for bright,<wbr/> outdoor settings containing snow.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2347 </li>
2348 <li>
2349 <span class="entry_type_enum_name">SUNSET</span>
2350 <span class="entry_type_enum_optional">optional</span>
Ruben Brunk9e28ea72014-01-14 18:55:29 -0800[diff] [blame^]2351 <span class="entry_type_enum_notes"><p>Optimized for scenes of the setting sun.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2352 </li>
2353 <li>
2354 <span class="entry_type_enum_name">STEADYPHOTO</span>
2355 <span class="entry_type_enum_optional">optional</span>
Ruben Brunk9e28ea72014-01-14 18:55:29 -0800[diff] [blame^]2356 <span class="entry_type_enum_notes"><p>Optimized to avoid blurry photos due to small amounts of
2357device motion (for example: due to hand shake).<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2358 </li>
2359 <li>
2360 <span class="entry_type_enum_name">FIREWORKS</span>
2361 <span class="entry_type_enum_optional">optional</span>
Ruben Brunk9e28ea72014-01-14 18:55:29 -0800[diff] [blame^]2362 <span class="entry_type_enum_notes"><p>Optimized for nighttime photos of fireworks.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2363 </li>
2364 <li>
2365 <span class="entry_type_enum_name">SPORTS</span>
2366 <span class="entry_type_enum_optional">optional</span>
Ruben Brunk9e28ea72014-01-14 18:55:29 -0800[diff] [blame^]2367 <span class="entry_type_enum_notes"><p>Optimized for photos of quickly moving people.<wbr/>
2368Similar to ACTION.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2369 </li>
2370 <li>
2371 <span class="entry_type_enum_name">PARTY</span>
2372 <span class="entry_type_enum_optional">optional</span>
Ruben Brunk9e28ea72014-01-14 18:55:29 -0800[diff] [blame^]2373 <span class="entry_type_enum_notes"><p>Optimized for dim,<wbr/> indoor settings with multiple moving
2374people.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2375 </li>
2376 <li>
2377 <span class="entry_type_enum_name">CANDLELIGHT</span>
2378 <span class="entry_type_enum_optional">optional</span>
Ruben Brunk9e28ea72014-01-14 18:55:29 -0800[diff] [blame^]2379 <span class="entry_type_enum_notes"><p>Optimized for dim settings where the main light source
2380is a flame.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2381 </li>
2382 <li>
2383 <span class="entry_type_enum_name">BARCODE</span>
2384 <span class="entry_type_enum_optional">optional</span>
Ruben Brunk9e28ea72014-01-14 18:55:29 -0800[diff] [blame^]2385 <span class="entry_type_enum_notes"><p>Optimized for accurately capturing a photo of barcode
2386for use by camera applications that wish to read the
2387barcode value.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2388 </li>
2389 </ul>
2390
2391 </td> <!-- entry_type -->
2392
2393 <td class="entry_description">
Ruben Brunk9e28ea72014-01-14 18:55:29 -0800[diff] [blame^]2394 <p>A camera mode optimized for conditions typical in a particular
2395capture setting.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2396 </td>
2397
2398 <td class="entry_units">
2399 </td>
2400
2401 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]2402 <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]2403 </td>
2404
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2405 <td class="entry_tags">
2406 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]2407 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2408 </ul>
2409 </td>
2410
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2411 </tr>
Ruben Brunk9e28ea72014-01-14 18:55:29 -0800[diff] [blame^]2412 <tr class="entries_header">
2413 <th class="th_details" colspan="5">Details</th>
2414 </tr>
2415 <tr class="entry_cont">
2416 <td class="entry_details" colspan="5">
2417 <p>This is the mode that that is active when
2418<code><a href="#controls_android.control.mode">android.<wbr/>control.<wbr/>mode</a> == USE_<wbr/>SCENE_<wbr/>MODE</code>.<wbr/> Aside from FACE_<wbr/>PRIORITY,<wbr/>
2419these modes will disable <a href="#controls_android.control.aeMode">android.<wbr/>control.<wbr/>ae<wbr/>Mode</a>,<wbr/>
2420<a href="#controls_android.control.awbMode">android.<wbr/>control.<wbr/>awb<wbr/>Mode</a>,<wbr/> and <a href="#controls_android.control.afMode">android.<wbr/>control.<wbr/>af<wbr/>Mode</a> while in use.<wbr/></p>
2421<p>The interpretation and implementation of these scene modes is left
2422to the implementor of the camera device.<wbr/> Their behavior will not be
2423consistent across all devices,<wbr/> and any given device may only implement
2424a subset of these modes.<wbr/></p>
2425 </td>
2426 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2427
Ruben Brunk9e28ea72014-01-14 18:55:29 -0800[diff] [blame^]2428 <tr class="entries_header">
2429 <th class="th_details" colspan="5">HAL Implementation Details</th>
2430 </tr>
2431 <tr class="entry_cont">
2432 <td class="entry_details" colspan="5">
2433 <p>HAL implementations that include scene modes are expected to provide
2434the per-scene settings to use for <a href="#controls_android.control.aeMode">android.<wbr/>control.<wbr/>ae<wbr/>Mode</a>,<wbr/>
2435<a href="#controls_android.control.awbMode">android.<wbr/>control.<wbr/>awb<wbr/>Mode</a>,<wbr/> and <a href="#controls_android.control.afMode">android.<wbr/>control.<wbr/>af<wbr/>Mode</a> in
2436<a href="#static_android.control.sceneModeOverrides">android.<wbr/>control.<wbr/>scene<wbr/>Mode<wbr/>Overrides</a>.<wbr/></p>
2437 </td>
2438 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2439
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2440 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
2441 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2442
2443
2444 <tr class="entry" id="controls_android.control.videoStabilizationMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2445 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2446 android.<wbr/>control.<wbr/>video<wbr/>Stabilization<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2447 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2448 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]2449 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2450
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]2451 <span class="entry_type_visibility"> [public as boolean]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2452
2453 <ul class="entry_type_enum">
2454 <li>
2455 <span class="entry_type_enum_name">OFF</span>
2456 </li>
2457 <li>
2458 <span class="entry_type_enum_name">ON</span>
2459 </li>
2460 </ul>
2461
2462 </td> <!-- entry_type -->
2463
2464 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2465 <p>Whether video stabilization is
2466active</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2467 </td>
2468
2469 <td class="entry_units">
2470 </td>
2471
2472 <td class="entry_range">
2473 </td>
2474
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2475 <td class="entry_tags">
2476 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]2477 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2478 </ul>
2479 </td>
2480
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2481 </tr>
2482 <tr class="entries_header">
2483 <th class="th_details" colspan="5">Details</th>
2484 </tr>
2485 <tr class="entry_cont">
2486 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2487 <p>If enabled,<wbr/> video stabilization can modify the
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]2488<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]2489stabilized</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2490 </td>
2491 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2492
2493
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2494 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
2495 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2496
2497
2498
2499 <!-- end of kind -->
2500 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2501 <tr><td colspan="6" class="kind">static</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2502
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2503 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2504 <tr>
2505 <th class="th_name">Property Name</th>
2506 <th class="th_type">Type</th>
2507 <th class="th_description">Description</th>
2508 <th class="th_units">Units</th>
2509 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2510 <th class="th_tags">Tags</th>
2511 </tr>
2512 </thead>
2513
2514 <tbody>
2515
2516
2517
2518
2519
2520
2521
2522
2523
2524
2525 <tr class="entry" id="static_android.control.aeAvailableAntibandingModes">
Eino-Ville Talvala19ce2c12013-12-30 12:03:45 -0800[diff] [blame]2526 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2527 android.<wbr/>control.<wbr/>ae<wbr/>Available<wbr/>Antibanding<wbr/>Modes
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2528 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2529 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]2530 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2531 <span class="entry_type_container">x</span>
2532
2533 <span class="entry_type_array">
2534 n
2535 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2536 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2537 <div class="entry_type_notes">list of enums</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2538
2539
2540 </td> <!-- entry_type -->
2541
2542 <td class="entry_description">
Eino-Ville Talvala19ce2c12013-12-30 12:03:45 -0800[diff] [blame]2543 <p>The set of auto-exposure antibanding modes that are
2544supported by this camera device.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2545 </td>
2546
2547 <td class="entry_units">
2548 </td>
2549
2550 <td class="entry_range">
2551 </td>
2552
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2553 <td class="entry_tags">
2554 </td>
2555
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2556 </tr>
Eino-Ville Talvala19ce2c12013-12-30 12:03:45 -0800[diff] [blame]2557 <tr class="entries_header">
2558 <th class="th_details" colspan="5">Details</th>
2559 </tr>
2560 <tr class="entry_cont">
2561 <td class="entry_details" colspan="5">
2562 <p>Not all of the auto-exposure anti-banding modes may be
2563supported by a given camera device.<wbr/> This field lists the
2564valid anti-banding modes that the application may request
2565for this camera device; they must include AUTO.<wbr/></p>
2566 </td>
2567 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2568
2569
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2570 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
2571 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2572
2573
2574 <tr class="entry" id="static_android.control.aeAvailableModes">
Eino-Ville Talvala9fa0d902014-01-08 16:16:53 -0800[diff] [blame]2575 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2576 android.<wbr/>control.<wbr/>ae<wbr/>Available<wbr/>Modes
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2577 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2578 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]2579 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2580 <span class="entry_type_container">x</span>
2581
2582 <span class="entry_type_array">
2583 n
2584 </span>
Eino-Ville Talvala9fa0d902014-01-08 16:16:53 -0800[diff] [blame]2585 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2586 <div class="entry_type_notes">list of enums</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2587
2588
2589 </td> <!-- entry_type -->
2590
2591 <td class="entry_description">
Eino-Ville Talvala9fa0d902014-01-08 16:16:53 -0800[diff] [blame]2592 <p>The set of auto-exposure modes that are supported by this
2593camera device.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2594 </td>
2595
2596 <td class="entry_units">
2597 </td>
2598
2599 <td class="entry_range">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2600 </td>
2601
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2602 <td class="entry_tags">
Eino-Ville Talvala9fa0d902014-01-08 16:16:53 -0800[diff] [blame]2603 <ul class="entry_tags">
2604 <li><a href="#tag_BC">BC</a></li>
2605 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2606 </td>
2607
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2608 </tr>
Eino-Ville Talvala9fa0d902014-01-08 16:16:53 -0800[diff] [blame]2609 <tr class="entries_header">
2610 <th class="th_details" colspan="5">Details</th>
2611 </tr>
2612 <tr class="entry_cont">
2613 <td class="entry_details" colspan="5">
2614 <p>Not all the auto-exposure modes may be supported by a
2615given camera device,<wbr/> especially if no flash unit is
2616available.<wbr/> This entry lists the valid modes for
2617<a href="#controls_android.control.aeMode">android.<wbr/>control.<wbr/>ae<wbr/>Mode</a> for this camera device.<wbr/></p>
2618<p>All camera devices support ON,<wbr/> and all camera devices with
2619flash units support ON_<wbr/>AUTO_<wbr/>FLASH and
2620ON_<wbr/>ALWAYS_<wbr/>FLASH.<wbr/></p>
2621<p>Full-capability camera devices always support OFF mode,<wbr/>
2622which enables application control of camera exposure time,<wbr/>
2623sensitivity,<wbr/> and frame duration.<wbr/></p>
2624 </td>
2625 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2626
2627
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2628 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
2629 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2630
2631
2632 <tr class="entry" id="static_android.control.aeAvailableTargetFpsRanges">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2633 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2634 android.<wbr/>control.<wbr/>ae<wbr/>Available<wbr/>Target<wbr/>Fps<wbr/>Ranges
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2635 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2636 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]2637 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2638 <span class="entry_type_container">x</span>
2639
2640 <span class="entry_type_array">
2641 2 x n
2642 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2643 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2644 <div class="entry_type_notes">list of pairs of frame rates</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2645
2646
2647 </td> <!-- entry_type -->
2648
2649 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2650 <p>List of frame rate ranges supported by the
2651AE algorithm/<wbr/>hardware</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2652 </td>
2653
2654 <td class="entry_units">
2655 </td>
2656
2657 <td class="entry_range">
2658 </td>
2659
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2660 <td class="entry_tags">
2661 </td>
2662
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2663 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2664
2665
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2666 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
2667 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2668
2669
2670 <tr class="entry" id="static_android.control.aeCompensationRange">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2671 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2672 android.<wbr/>control.<wbr/>ae<wbr/>Compensation<wbr/>Range
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2673 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2674 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]2675 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2676 <span class="entry_type_container">x</span>
2677
2678 <span class="entry_type_array">
2679 2
2680 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2681 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2682
2683
2684 </td> <!-- entry_type -->
2685
2686 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2687 <p>Maximum and minimum exposure compensation
2688setting,<wbr/> in counts of
2689android.<wbr/>control.<wbr/>ae<wbr/>Compensation<wbr/>Step<wbr/>Size</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2690 </td>
2691
2692 <td class="entry_units">
2693 </td>
2694
2695 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]2696 <p>At least (-2,<wbr/>2)/<wbr/>(exp compensation step
2697size)</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2698 </td>
2699
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2700 <td class="entry_tags">
2701 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]2702 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2703 </ul>
2704 </td>
2705
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2706 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2707
2708
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2709 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
2710 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2711
2712
2713 <tr class="entry" id="static_android.control.aeCompensationStep">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2714 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2715 android.<wbr/>control.<wbr/>ae<wbr/>Compensation<wbr/>Step
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2716 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2717 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]2718 <span class="entry_type_name">rational</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2719
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2720 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2721
2722
2723 </td> <!-- entry_type -->
2724
2725 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2726 <p>Smallest step by which exposure compensation
2727can be changed</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2728 </td>
2729
2730 <td class="entry_units">
2731 </td>
2732
2733 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]2734 <p>&lt;= 1/<wbr/>2</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2735 </td>
2736
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2737 <td class="entry_tags">
2738 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]2739 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2740 </ul>
2741 </td>
2742
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2743 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2744
2745
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2746 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
2747 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2748
2749
2750 <tr class="entry" id="static_android.control.afAvailableModes">
Zhijun Hef163fa92014-01-14 09:59:04 -0800[diff] [blame]2751 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2752 android.<wbr/>control.<wbr/>af<wbr/>Available<wbr/>Modes
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2753 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2754 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]2755 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2756 <span class="entry_type_container">x</span>
2757
2758 <span class="entry_type_array">
2759 n
2760 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2761 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2762 <div class="entry_type_notes">List of enums</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2763
2764
2765 </td> <!-- entry_type -->
2766
2767 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2768 <p>List of AF modes that can be
Zhijun Hef163fa92014-01-14 09:59:04 -0800[diff] [blame]2769selected 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]2770 </td>
2771
2772 <td class="entry_units">
2773 </td>
2774
2775 <td class="entry_range">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2776 </td>
2777
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2778 <td class="entry_tags">
2779 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]2780 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2781 </ul>
2782 </td>
2783
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2784 </tr>
Zhijun Hef163fa92014-01-14 09:59:04 -0800[diff] [blame]2785 <tr class="entries_header">
2786 <th class="th_details" colspan="5">Details</th>
2787 </tr>
2788 <tr class="entry_cont">
2789 <td class="entry_details" colspan="5">
2790 <p>Not all the auto-focus modes may be supported by a
2791given camera device.<wbr/> This entry lists the valid modes for
2792<a href="#controls_android.control.afMode">android.<wbr/>control.<wbr/>af<wbr/>Mode</a> for this camera device.<wbr/></p>
2793<p>All camera devices will support OFF mode,<wbr/> and all camera devices with
2794adjustable 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>)
2795will support AUTO mode.<wbr/></p>
2796 </td>
2797 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2798
2799
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2800 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
2801 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2802
2803
2804 <tr class="entry" id="static_android.control.availableEffects">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2805 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2806 android.<wbr/>control.<wbr/>available<wbr/>Effects
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2807 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2808 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]2809 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2810 <span class="entry_type_container">x</span>
2811
2812 <span class="entry_type_array">
2813 n
2814 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2815 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2816 <div class="entry_type_notes">list of enums</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2817
2818
2819 </td> <!-- entry_type -->
2820
2821 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2822 <p>what subset of the full color effect enum
2823list is supported</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2824 </td>
2825
2826 <td class="entry_units">
2827 </td>
2828
2829 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]2830 <p>OFF must be listed</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2831 </td>
2832
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2833 <td class="entry_tags">
2834 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]2835 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2836 </ul>
2837 </td>
2838
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2839 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2840
2841
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2842 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
2843 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2844
2845
2846 <tr class="entry" id="static_android.control.availableSceneModes">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2847 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2848 android.<wbr/>control.<wbr/>available<wbr/>Scene<wbr/>Modes
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2849 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2850 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]2851 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2852 <span class="entry_type_container">x</span>
2853
2854 <span class="entry_type_array">
2855 n
2856 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2857 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2858 <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]2859
2860
2861 </td> <!-- entry_type -->
2862
2863 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2864 <p>what subset of the scene mode enum list is
2865supported.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2866 </td>
2867
2868 <td class="entry_units">
2869 </td>
2870
2871 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]2872 <p>SCENE_<wbr/>MODE_<wbr/>FACE_<wbr/>PRIORITY must be supported if face
2873detection is supported</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2874 </td>
2875
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2876 <td class="entry_tags">
2877 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]2878 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2879 </ul>
2880 </td>
2881
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2882 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2883
2884
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2885 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
2886 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2887
2888
2889 <tr class="entry" id="static_android.control.availableVideoStabilizationModes">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2890 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2891 android.<wbr/>control.<wbr/>available<wbr/>Video<wbr/>Stabilization<wbr/>Modes
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2892 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2893 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]2894 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2895 <span class="entry_type_container">x</span>
2896
2897 <span class="entry_type_array">
2898 n
2899 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2900 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2901 <div class="entry_type_notes">List of enums.<wbr/></div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2902
2903
2904 </td> <!-- entry_type -->
2905
2906 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2907 <p>List of video stabilization modes that can
2908be supported</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2909 </td>
2910
2911 <td class="entry_units">
2912 </td>
2913
2914 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]2915 <p>OFF must be included</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2916 </td>
2917
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2918 <td class="entry_tags">
2919 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]2920 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2921 </ul>
2922 </td>
2923
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2924 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2925
2926
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2927 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
2928 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2929
2930
2931 <tr class="entry" id="static_android.control.awbAvailableModes">
Zhijun He7787f7f2014-01-14 16:30:31 -0800[diff] [blame]2932 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2933 android.<wbr/>control.<wbr/>awb<wbr/>Available<wbr/>Modes
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2934 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2935 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]2936 <span class="entry_type_name">byte</span>
Alex Raya4251d92013-04-30 16:43:44 -0700[diff] [blame]2937 <span class="entry_type_container">x</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2938
Alex Raya4251d92013-04-30 16:43:44 -0700[diff] [blame]2939 <span class="entry_type_array">
2940 n
2941 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2942 <span class="entry_type_visibility"> [public]</span>
Zhijun He7787f7f2014-01-14 16:30:31 -0800[diff] [blame]2943 <div class="entry_type_notes">List of enums</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2944
2945
2946 </td> <!-- entry_type -->
2947
2948 <td class="entry_description">
Zhijun He7787f7f2014-01-14 16:30:31 -0800[diff] [blame]2949 <p>The set of auto-white-balance modes (<a href="#controls_android.control.awbMode">android.<wbr/>control.<wbr/>awb<wbr/>Mode</a>)
2950that are supported by this camera device.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2951 </td>
2952
2953 <td class="entry_units">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2954 </td>
2955
2956 <td class="entry_range">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2957 </td>
2958
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2959 <td class="entry_tags">
2960 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]2961 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2962 </ul>
2963 </td>
2964
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2965 </tr>
Zhijun He7787f7f2014-01-14 16:30:31 -0800[diff] [blame]2966 <tr class="entries_header">
2967 <th class="th_details" colspan="5">Details</th>
2968 </tr>
2969 <tr class="entry_cont">
2970 <td class="entry_details" colspan="5">
2971 <p>Not all the auto-white-balance modes may be supported by a
2972given camera device.<wbr/> This entry lists the valid modes for
2973<a href="#controls_android.control.awbMode">android.<wbr/>control.<wbr/>awb<wbr/>Mode</a> for this camera device.<wbr/></p>
2974<p>All camera devices will support ON mode.<wbr/></p>
2975<p>Full-capability camera devices will always support OFF mode,<wbr/>
2976which enables application control of white balance,<wbr/> by using
2977<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>
2978 </td>
2979 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2980
2981
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2982 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
2983 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2984
2985
2986 <tr class="entry" id="static_android.control.maxRegions">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2987 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2988 android.<wbr/>control.<wbr/>max<wbr/>Regions
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2989 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2990 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]2991 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2992
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2993 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2994
2995
2996 </td> <!-- entry_type -->
2997
2998 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2999 <p>For AE,<wbr/> AWB,<wbr/> and AF,<wbr/> how many individual
3000regions can be listed for metering?</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3001 </td>
3002
3003 <td class="entry_units">
3004 </td>
3005
3006 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame]3007 <p>&gt;= 1</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3008 </td>
3009
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3010 <td class="entry_tags">
3011 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]3012 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3013 </ul>
3014 </td>
3015
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3016 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3017
3018
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3019 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
3020 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3021
3022
3023 <tr class="entry" id="static_android.control.sceneModeOverrides">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3024 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3025 android.<wbr/>control.<wbr/>scene<wbr/>Mode<wbr/>Overrides
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3026 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3027 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]3028 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3029 <span class="entry_type_container">x</span>
3030
3031 <span class="entry_type_array">
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3032 3 x length(availableSceneModes)
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3033 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3034 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3035
3036
3037 </td> <!-- entry_type -->
3038
3039 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3040 <p>List of AE,<wbr/> AWB,<wbr/> and AF modes to use for
3041each available scene mode</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3042 </td>
3043
3044 <td class="entry_units">
3045 </td>
3046
3047 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]3048 <p>For each listed scene mode,<wbr/> lists the aeMode,<wbr/>
3049awbMode,<wbr/> and afMode that the HAL wants to use for that
3050scene mode.<wbr/></p>
3051<p>For each entry,<wbr/> the order is {aeMode,<wbr/> awbMode,<wbr/> afMode} in
3052order of increasing index</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3053 </td>
3054
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3055 <td class="entry_tags">
3056 <ul class="entry_tags">
3057 <li><a href="#tag_BC">BC</a></li>
3058 </ul>
3059 </td>
3060
3061 </tr>
3062 <tr class="entries_header">
3063 <th class="th_details" colspan="5">Details</th>
3064 </tr>
3065 <tr class="entry_cont">
3066 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3067 <p>When a scene mode is enabled,<wbr/> the HAL is expected
3068to override aeMode,<wbr/> awbMode,<wbr/> and afMode with its
3069preferred settings for that scene mode.<wbr/></p>
3070<p>To simplify communication with old camera API applications,<wbr/>
3071the service wants this override list in the static metadata.<wbr/>
3072The order of this list matches that of availableSceneModes,<wbr/>
3073with 3 entires for each scene mode.<wbr/> The overrides listed
3074for SCENE_<wbr/>MODE_<wbr/>FACE_<wbr/>PRIORITY are ignored,<wbr/> since for that
3075mode,<wbr/> the application-set aeMode,<wbr/> awbMode,<wbr/> and afMode are
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]3076used instead,<wbr/> like they are when <a href="#controls_android.control.mode">android.<wbr/>control.<wbr/>mode</a> is
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3077AUTO.<wbr/></p>
3078<p>It is recommended that for FACE_<wbr/>PRIORITY,<wbr/> the overrides
3079should be set to 0.<wbr/> As an example,<wbr/> if availableSceneModes is
3080{ FACE_<wbr/>PRIORITY,<wbr/> ACTION,<wbr/> NIGHT },<wbr/> then the service expects
3081this field to have 9 entries; for example { 0 ,<wbr/> 0,<wbr/> 0,<wbr/>
3082ON_<wbr/>AUTO_<wbr/>FLASH,<wbr/> AUTO,<wbr/> CONTINUOUS_<wbr/>PICTURE,<wbr/> ON_<wbr/>AUTO_<wbr/>FLASH,<wbr/>
3083INCANDESCENT,<wbr/> AUTO }</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3084 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3085 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3086
3087
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3088 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
3089 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3090
3091
3092
3093 <!-- end of kind -->
3094 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3095 <tr><td colspan="6" class="kind">dynamic</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3096
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3097 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3098 <tr>
3099 <th class="th_name">Property Name</th>
3100 <th class="th_type">Type</th>
3101 <th class="th_description">Description</th>
3102 <th class="th_units">Units</th>
3103 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3104 <th class="th_tags">Tags</th>
3105 </tr>
3106 </thead>
3107
3108 <tbody>
3109
3110
3111
3112
3113
3114
3115
3116
3117
3118
3119 <tr class="entry" id="dynamic_android.control.aePrecaptureId">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3120 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3121 android.<wbr/>control.<wbr/>ae<wbr/>Precapture<wbr/>Id
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3122 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3123 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]3124 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3125
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3126 <span class="entry_type_visibility"> [hidden]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3127
3128
3129 </td> <!-- entry_type -->
3130
3131 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3132 <p>The ID sent with the latest
3133CAMERA2_<wbr/>TRIGGER_<wbr/>PRECAPTURE_<wbr/>METERING call</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3134 </td>
3135
3136 <td class="entry_units">
3137 </td>
3138
3139 <td class="entry_range">
3140 </td>
3141
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3142 <td class="entry_tags">
3143 </td>
3144
3145 </tr>
3146 <tr class="entries_header">
3147 <th class="th_details" colspan="5">Details</th>
3148 </tr>
3149 <tr class="entry_cont">
3150 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3151 <p>Must be 0 if no
3152CAMERA2_<wbr/>TRIGGER_<wbr/>PRECAPTURE_<wbr/>METERING trigger received yet
3153by HAL.<wbr/> Always updated even if AE algorithm ignores the
3154trigger</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3155 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3156 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3157
3158
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3159 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
3160 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3161
3162
Eino-Ville Talvala9fa0d902014-01-08 16:16:53 -0800[diff] [blame]3163 <tr class="entry" id="dynamic_android.control.aeMode">
3164 <td class="entry_name" rowspan="3">
3165 android.<wbr/>control.<wbr/>ae<wbr/>Mode
3166 </td>
3167 <td class="entry_type">
3168 <span class="entry_type_name entry_type_name_enum">byte</span>
3169
3170 <span class="entry_type_visibility"> [public]</span>
3171
3172 <ul class="entry_type_enum">
3173 <li>
3174 <span class="entry_type_enum_name">OFF</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]3175 <span class="entry_type_enum_notes"><p>The camera device's autoexposure routine is disabled;
3176the application-selected <a href="#controls_android.sensor.exposureTime">android.<wbr/>sensor.<wbr/>exposure<wbr/>Time</a>,<wbr/>
3177<a href="#controls_android.sensor.sensitivity">android.<wbr/>sensor.<wbr/>sensitivity</a> and
3178<a href="#controls_android.sensor.frameDuration">android.<wbr/>sensor.<wbr/>frame<wbr/>Duration</a> are used by the camera
3179device,<wbr/> along with android.<wbr/>flash.<wbr/>* fields,<wbr/> if there's
3180a flash unit for this camera device.<wbr/></p></span>
Eino-Ville Talvala9fa0d902014-01-08 16:16:53 -0800[diff] [blame]3181 </li>
3182 <li>
3183 <span class="entry_type_enum_name">ON</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]3184 <span class="entry_type_enum_notes"><p>The camera device's autoexposure routine is active,<wbr/>
3185with no flash control.<wbr/> The application's values for
3186<a href="#controls_android.sensor.exposureTime">android.<wbr/>sensor.<wbr/>exposure<wbr/>Time</a>,<wbr/>
3187<a href="#controls_android.sensor.sensitivity">android.<wbr/>sensor.<wbr/>sensitivity</a>,<wbr/> and
3188<a href="#controls_android.sensor.frameDuration">android.<wbr/>sensor.<wbr/>frame<wbr/>Duration</a> are ignored.<wbr/> The
3189application has control over the various
3190android.<wbr/>flash.<wbr/>* fields.<wbr/></p></span>
Eino-Ville Talvala9fa0d902014-01-08 16:16:53 -0800[diff] [blame]3191 </li>
3192 <li>
3193 <span class="entry_type_enum_name">ON_AUTO_FLASH</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]3194 <span class="entry_type_enum_notes"><p>Like ON,<wbr/> except that the camera device also controls
3195the camera's flash unit,<wbr/> firing it in low-light
3196conditions.<wbr/> The flash may be fired during a
3197precapture sequence (triggered by
3198<a href="#controls_android.control.aePrecaptureTrigger">android.<wbr/>control.<wbr/>ae<wbr/>Precapture<wbr/>Trigger</a>) and may be fired
3199for captures for which the
3200<a href="#controls_android.control.captureIntent">android.<wbr/>control.<wbr/>capture<wbr/>Intent</a> field is set to
3201STILL_<wbr/>CAPTURE</p></span>
Eino-Ville Talvala9fa0d902014-01-08 16:16:53 -0800[diff] [blame]3202 </li>
3203 <li>
3204 <span class="entry_type_enum_name">ON_ALWAYS_FLASH</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]3205 <span class="entry_type_enum_notes"><p>Like ON,<wbr/> except that the camera device also controls
3206the camera's flash unit,<wbr/> always firing it for still
3207captures.<wbr/> The flash may be fired during a precapture
3208sequence (triggered by
3209<a href="#controls_android.control.aePrecaptureTrigger">android.<wbr/>control.<wbr/>ae<wbr/>Precapture<wbr/>Trigger</a>) and will always
3210be fired for captures for which the
3211<a href="#controls_android.control.captureIntent">android.<wbr/>control.<wbr/>capture<wbr/>Intent</a> field is set to
3212STILL_<wbr/>CAPTURE</p></span>
Eino-Ville Talvala9fa0d902014-01-08 16:16:53 -0800[diff] [blame]3213 </li>
3214 <li>
3215 <span class="entry_type_enum_name">ON_AUTO_FLASH_REDEYE</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]3216 <span class="entry_type_enum_notes"><p>Like ON_<wbr/>AUTO_<wbr/>FLASH,<wbr/> but with automatic red eye
3217reduction.<wbr/> If deemed necessary by the camera device,<wbr/>
3218a red eye reduction flash will fire during the
3219precapture sequence.<wbr/></p></span>
Eino-Ville Talvala9fa0d902014-01-08 16:16:53 -0800[diff] [blame]3220 </li>
3221 </ul>
3222
3223 </td> <!-- entry_type -->
3224
3225 <td class="entry_description">
3226 <p>The desired mode for the camera device's
3227auto-exposure routine.<wbr/></p>
3228 </td>
3229
3230 <td class="entry_units">
3231 </td>
3232
3233 <td class="entry_range">
3234 <p><a href="#static_android.control.aeAvailableModes">android.<wbr/>control.<wbr/>ae<wbr/>Available<wbr/>Modes</a></p>
3235 </td>
3236
3237 <td class="entry_tags">
3238 <ul class="entry_tags">
3239 <li><a href="#tag_BC">BC</a></li>
3240 </ul>
3241 </td>
3242
3243 </tr>
3244 <tr class="entries_header">
3245 <th class="th_details" colspan="5">Details</th>
3246 </tr>
3247 <tr class="entry_cont">
3248 <td class="entry_details" colspan="5">
3249 <p>This control is only effective if <a href="#controls_android.control.mode">android.<wbr/>control.<wbr/>mode</a> is
3250AUTO.<wbr/></p>
3251<p>When set to any of the ON modes,<wbr/> the camera device's
3252auto-exposure routine is enabled,<wbr/> overriding the
3253application's selected exposure time,<wbr/> sensor sensitivity,<wbr/>
3254and frame duration (<a href="#controls_android.sensor.exposureTime">android.<wbr/>sensor.<wbr/>exposure<wbr/>Time</a>,<wbr/>
3255<a href="#controls_android.sensor.sensitivity">android.<wbr/>sensor.<wbr/>sensitivity</a>,<wbr/> and
3256<a href="#controls_android.sensor.frameDuration">android.<wbr/>sensor.<wbr/>frame<wbr/>Duration</a>).<wbr/> If one of the FLASH modes
3257is selected,<wbr/> the camera device's flash unit controls are
3258also overridden.<wbr/></p>
3259<p>The FLASH modes are only available if the camera device
3260has a flash unit (<a href="#static_android.flash.info.available">android.<wbr/>flash.<wbr/>info.<wbr/>available</a> is <code>true</code>).<wbr/></p>
3261<p>If flash TORCH mode is desired,<wbr/> this field must be set to
3262ON or OFF,<wbr/> and <a href="#controls_android.flash.mode">android.<wbr/>flash.<wbr/>mode</a> set to TORCH.<wbr/></p>
3263<p>When set to any of the ON modes,<wbr/> the values chosen by the
3264camera device auto-exposure routine for the overridden
3265fields for a given capture will be available in its
3266CaptureResult.<wbr/></p>
3267 </td>
3268 </tr>
3269
3270
3271 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
3272 <!-- end of entry -->
3273
3274
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3275 <tr class="entry" id="dynamic_android.control.aeRegions">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3276 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3277 android.<wbr/>control.<wbr/>ae<wbr/>Regions
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3278 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3279 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]3280 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3281 <span class="entry_type_container">x</span>
3282
3283 <span class="entry_type_array">
3284 5 x area_count
3285 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3286 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3287
3288
3289 </td> <!-- entry_type -->
3290
3291 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3292 <p>List of areas to use for
3293metering</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3294 </td>
3295
3296 <td class="entry_units">
3297 </td>
3298
3299 <td class="entry_range">
3300 </td>
3301
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3302 <td class="entry_tags">
3303 <ul class="entry_tags">
3304 <li><a href="#tag_BC">BC</a></li>
3305 </ul>
3306 </td>
3307
3308 </tr>
3309 <tr class="entries_header">
3310 <th class="th_details" colspan="5">Details</th>
3311 </tr>
3312 <tr class="entry_cont">
3313 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3314 <p>Each area is a rectangle plus weight: xmin,<wbr/> ymin,<wbr/>
3315xmax,<wbr/> ymax,<wbr/> weight.<wbr/> The rectangle is defined inclusive of the
3316specified coordinates.<wbr/></p>
3317<p>The coordinate system is based on the active pixel array,<wbr/>
3318with (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]3319(<a href="#static_android.sensor.info.activeArraySize">android.<wbr/>sensor.<wbr/>info.<wbr/>active<wbr/>Array<wbr/>Size</a>.<wbr/>width - 1,<wbr/>
3320<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]3321bottom-right pixel in the active pixel array.<wbr/> The weight
3322should be nonnegative.<wbr/></p>
3323<p>If all regions have 0 weight,<wbr/> then no specific metering area
3324needs to be used by the HAL.<wbr/> If the metering region is
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]3325outside 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]3326should ignore the sections outside the region and output the
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3327used sections in the frame metadata</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3328 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3329 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3330
3331
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3332 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
3333 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3334
3335
3336 <tr class="entry" id="dynamic_android.control.aeState">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3337 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3338 android.<wbr/>control.<wbr/>ae<wbr/>State
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3339 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3340 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]3341 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3342
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3343 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3344
3345 <ul class="entry_type_enum">
3346 <li>
3347 <span class="entry_type_enum_name">INACTIVE</span>
Zhijun He92e698d2014-01-13 16:24:31 -0800[diff] [blame]3348 <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]3349this state.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3350 </li>
3351 <li>
3352 <span class="entry_type_enum_name">SEARCHING</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]3353 <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]3354for the current scene.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3355 </li>
3356 <li>
3357 <span class="entry_type_enum_name">CONVERGED</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]3358 <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]3359current scene.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3360 </li>
3361 <li>
3362 <span class="entry_type_enum_name">LOCKED</span>
Zhijun He92e698d2014-01-13 16:24:31 -0800[diff] [blame]3363 <span class="entry_type_enum_notes"><p>AE has been locked.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3364 </li>
3365 <li>
3366 <span class="entry_type_enum_name">FLASH_REQUIRED</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]3367 <span class="entry_type_enum_notes"><p>AE has a good set of control values,<wbr/> but flash
3368needs to be fired for good quality still
Zhijun He92e698d2014-01-13 16:24:31 -0800[diff] [blame]3369capture.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3370 </li>
3371 <li>
3372 <span class="entry_type_enum_name">PRECAPTURE</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]3373 <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]3374(through the <a href="#controls_android.control.aePrecaptureTrigger">android.<wbr/>control.<wbr/>ae<wbr/>Precapture<wbr/>Trigger</a> START),<wbr/>
3375and is currently executing it.<wbr/> Once PRECAPTURE
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]3376completes,<wbr/> AE will transition to CONVERGED or
Zhijun He92e698d2014-01-13 16:24:31 -0800[diff] [blame]3377FLASH_<wbr/>REQUIRED as appropriate.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3378 </li>
3379 </ul>
3380
3381 </td> <!-- entry_type -->
3382
3383 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3384 <p>Current state of AE algorithm</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3385 </td>
3386
3387 <td class="entry_units">
3388 </td>
3389
3390 <td class="entry_range">
3391 </td>
3392
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3393 <td class="entry_tags">
3394 </td>
3395
3396 </tr>
3397 <tr class="entries_header">
3398 <th class="th_details" colspan="5">Details</th>
3399 </tr>
3400 <tr class="entry_cont">
3401 <td class="entry_details" colspan="5">
Zhijun He92e698d2014-01-13 16:24:31 -0800[diff] [blame]3402 <p>Switching between or enabling AE modes (<a href="#controls_android.control.aeMode">android.<wbr/>control.<wbr/>ae<wbr/>Mode</a>) always
3403resets the AE state to INACTIVE.<wbr/> Similarly,<wbr/> switching between <a href="#controls_android.control.mode">android.<wbr/>control.<wbr/>mode</a>,<wbr/>
3404or <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
3405the algorithm states to INACTIVE.<wbr/></p>
3406<p>The camera device can do several state transitions between two results,<wbr/> if it is
3407allowed by the state transition table.<wbr/> For example: INACTIVE may never actually be
3408seen in a result.<wbr/></p>
3409<p>The state in the result is the state for this image (in sync with this image): if
3410AE state becomes CONVERGED,<wbr/> then the image data associated with this result should
3411be good to use.<wbr/></p>
3412<p>Below are state transition tables for different AE modes.<wbr/></p>
3413<table>
3414<thead>
3415<tr>
3416<th align="center">State</th>
3417<th align="center">Transition Cause</th>
3418<th align="center">New State</th>
3419<th align="center">Notes</th>
3420</tr>
3421</thead>
3422<tbody>
3423<tr>
3424<td align="center">INACTIVE</td>
3425<td align="center"></td>
3426<td align="center">INACTIVE</td>
3427<td align="center">Camera device auto exposure algorithm is disabled</td>
3428</tr>
3429</tbody>
3430</table>
3431<p>When <a href="#controls_android.control.aeMode">android.<wbr/>control.<wbr/>ae<wbr/>Mode</a> is AE_<wbr/>MODE_<wbr/>ON_<wbr/>*:</p>
3432<table>
3433<thead>
3434<tr>
3435<th align="center">State</th>
3436<th align="center">Transition Cause</th>
3437<th align="center">New State</th>
3438<th align="center">Notes</th>
3439</tr>
3440</thead>
3441<tbody>
3442<tr>
3443<td align="center">INACTIVE</td>
3444<td align="center">Camera device initiates AE scan</td>
3445<td align="center">SEARCHING</td>
3446<td align="center">Values changing</td>
3447</tr>
3448<tr>
3449<td align="center">INACTIVE</td>
3450<td align="center"><a href="#controls_android.control.aeLock">android.<wbr/>control.<wbr/>ae<wbr/>Lock</a> is ON</td>
3451<td align="center">LOCKED</td>
3452<td align="center">Values locked</td>
3453</tr>
3454<tr>
3455<td align="center">SEARCHING</td>
3456<td align="center">Camera device finishes AE scan</td>
3457<td align="center">CONVERGED</td>
3458<td align="center">Good values,<wbr/> not changing</td>
3459</tr>
3460<tr>
3461<td align="center">SEARCHING</td>
3462<td align="center">Camera device finishes AE scan</td>
3463<td align="center">FLASH_<wbr/>REQUIRED</td>
3464<td align="center">Converged but too dark w/<wbr/>o flash</td>
3465</tr>
3466<tr>
3467<td align="center">SEARCHING</td>
3468<td align="center"><a href="#controls_android.control.aeLock">android.<wbr/>control.<wbr/>ae<wbr/>Lock</a> is ON</td>
3469<td align="center">LOCKED</td>
3470<td align="center">Values locked</td>
3471</tr>
3472<tr>
3473<td align="center">CONVERGED</td>
3474<td align="center">Camera device initiates AE scan</td>
3475<td align="center">SEARCHING</td>
3476<td align="center">Values changing</td>
3477</tr>
3478<tr>
3479<td align="center">CONVERGED</td>
3480<td align="center"><a href="#controls_android.control.aeLock">android.<wbr/>control.<wbr/>ae<wbr/>Lock</a> is ON</td>
3481<td align="center">LOCKED</td>
3482<td align="center">Values locked</td>
3483</tr>
3484<tr>
3485<td align="center">FLASH_<wbr/>REQUIRED</td>
3486<td align="center">Camera device initiates AE scan</td>
3487<td align="center">SEARCHING</td>
3488<td align="center">Values changing</td>
3489</tr>
3490<tr>
3491<td align="center">FLASH_<wbr/>REQUIRED</td>
3492<td align="center"><a href="#controls_android.control.aeLock">android.<wbr/>control.<wbr/>ae<wbr/>Lock</a> is ON</td>
3493<td align="center">LOCKED</td>
3494<td align="center">Values locked</td>
3495</tr>
3496<tr>
3497<td align="center">LOCKED</td>
3498<td align="center"><a href="#controls_android.control.aeLock">android.<wbr/>control.<wbr/>ae<wbr/>Lock</a> is OFF</td>
3499<td align="center">SEARCHING</td>
3500<td align="center">Values not good after unlock</td>
3501</tr>
3502<tr>
3503<td align="center">LOCKED</td>
3504<td align="center"><a href="#controls_android.control.aeLock">android.<wbr/>control.<wbr/>ae<wbr/>Lock</a> is OFF</td>
3505<td align="center">CONVERGED</td>
3506<td align="center">Values good after unlock</td>
3507</tr>
3508<tr>
3509<td align="center">LOCKED</td>
3510<td align="center"><a href="#controls_android.control.aeLock">android.<wbr/>control.<wbr/>ae<wbr/>Lock</a> is OFF</td>
3511<td align="center">FLASH_<wbr/>REQUIRED</td>
3512<td align="center">Exposure good,<wbr/> but too dark</td>
3513</tr>
3514<tr>
3515<td align="center">PRECAPTURE</td>
3516<td align="center">Sequence done.<wbr/> <a href="#controls_android.control.aeLock">android.<wbr/>control.<wbr/>ae<wbr/>Lock</a> is OFF</td>
3517<td align="center">CONVERGED</td>
3518<td align="center">Ready for high-quality capture</td>
3519</tr>
3520<tr>
3521<td align="center">PRECAPTURE</td>
3522<td align="center">Sequence done.<wbr/> <a href="#controls_android.control.aeLock">android.<wbr/>control.<wbr/>ae<wbr/>Lock</a> is ON</td>
3523<td align="center">LOCKED</td>
3524<td align="center">Ready for high-quality capture</td>
3525</tr>
3526<tr>
3527<td align="center">Any state</td>
3528<td align="center"><a href="#controls_android.control.aePrecaptureTrigger">android.<wbr/>control.<wbr/>ae<wbr/>Precapture<wbr/>Trigger</a> is START</td>
3529<td align="center">PRECAPTURE</td>
3530<td align="center">Start AE precapture metering sequence</td>
3531</tr>
3532</tbody>
3533</table>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3534 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3535 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3536
3537
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3538 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
3539 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3540
3541
3542 <tr class="entry" id="dynamic_android.control.afMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3543 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3544 android.<wbr/>control.<wbr/>af<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3545 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3546 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]3547 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3548
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3549 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3550
3551 <ul class="entry_type_enum">
3552 <li>
3553 <span class="entry_type_enum_name">OFF</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]3554 <span class="entry_type_enum_notes"><p>The auto-focus routine does not control the lens;
3555<a href="#controls_android.lens.focusDistance">android.<wbr/>lens.<wbr/>focus<wbr/>Distance</a> is controlled by the
3556application</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3557 </li>
3558 <li>
3559 <span class="entry_type_enum_name">AUTO</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]3560 <span class="entry_type_enum_notes"><p>If lens is not fixed focus.<wbr/></p>
3561<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
3562is fixed-focus.<wbr/> In this mode,<wbr/> the lens does not move unless
3563the autofocus trigger action is called.<wbr/> When that trigger
3564is activated,<wbr/> AF must transition to ACTIVE_<wbr/>SCAN,<wbr/> then to
3565the outcome of the scan (FOCUSED or NOT_<wbr/>FOCUSED).<wbr/></p>
3566<p>Triggering AF_<wbr/>CANCEL resets the lens position to default,<wbr/>
3567and sets the AF state to INACTIVE.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3568 </li>
3569 <li>
3570 <span class="entry_type_enum_name">MACRO</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]3571 <span class="entry_type_enum_notes"><p>In this mode,<wbr/> the lens does not move unless the
3572autofocus trigger action is called.<wbr/></p>
3573<p>When that trigger is activated,<wbr/> AF must transition to
3574ACTIVE_<wbr/>SCAN,<wbr/> then to the outcome of the scan (FOCUSED or
3575NOT_<wbr/>FOCUSED).<wbr/> Triggering cancel AF resets the lens
3576position to default,<wbr/> and sets the AF state to
3577INACTIVE.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3578 </li>
3579 <li>
3580 <span class="entry_type_enum_name">CONTINUOUS_VIDEO</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]3581 <span class="entry_type_enum_notes"><p>In this mode,<wbr/> the AF algorithm modifies the lens
3582position continually to attempt to provide a
3583constantly-in-focus image stream.<wbr/></p>
3584<p>The focusing behavior should be suitable for good quality
3585video recording; typically this means slower focus
3586movement and no overshoots.<wbr/> When the AF trigger is not
3587involved,<wbr/> the AF algorithm should start in INACTIVE state,<wbr/>
3588and then transition into PASSIVE_<wbr/>SCAN and PASSIVE_<wbr/>FOCUSED
3589states as appropriate.<wbr/> When the AF trigger is activated,<wbr/>
3590the algorithm should immediately transition into
3591AF_<wbr/>FOCUSED or AF_<wbr/>NOT_<wbr/>FOCUSED as appropriate,<wbr/> and lock the
3592lens position until a cancel AF trigger is received.<wbr/></p>
3593<p>Once cancel is received,<wbr/> the algorithm should transition
3594back to INACTIVE and resume passive scan.<wbr/> Note that this
3595behavior is not identical to CONTINUOUS_<wbr/>PICTURE,<wbr/> since an
3596ongoing PASSIVE_<wbr/>SCAN must immediately be
3597canceled.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3598 </li>
3599 <li>
3600 <span class="entry_type_enum_name">CONTINUOUS_PICTURE</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]3601 <span class="entry_type_enum_notes"><p>In this mode,<wbr/> the AF algorithm modifies the lens
3602position continually to attempt to provide a
3603constantly-in-focus image stream.<wbr/></p>
3604<p>The focusing behavior should be suitable for still image
3605capture; typically this means focusing as fast as
3606possible.<wbr/> When the AF trigger is not involved,<wbr/> the AF
3607algorithm should start in INACTIVE state,<wbr/> and then
3608transition into PASSIVE_<wbr/>SCAN and PASSIVE_<wbr/>FOCUSED states as
3609appropriate as it attempts to maintain focus.<wbr/> When the AF
3610trigger is activated,<wbr/> the algorithm should finish its
3611PASSIVE_<wbr/>SCAN if active,<wbr/> and then transition into
3612AF_<wbr/>FOCUSED or AF_<wbr/>NOT_<wbr/>FOCUSED as appropriate,<wbr/> and lock the
3613lens position until a cancel AF trigger is received.<wbr/></p>
3614<p>When the AF cancel trigger is activated,<wbr/> the algorithm
3615should transition back to INACTIVE and then act as if it
3616has just been started.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3617 </li>
3618 <li>
3619 <span class="entry_type_enum_name">EDOF</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]3620 <span class="entry_type_enum_notes"><p>Extended depth of field (digital focus).<wbr/> AF
3621trigger is ignored,<wbr/> AF state should always be
3622INACTIVE.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3623 </li>
3624 </ul>
3625
3626 </td> <!-- entry_type -->
3627
3628 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3629 <p>Whether AF is currently enabled,<wbr/> and what
3630mode it is set to</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3631 </td>
3632
3633 <td class="entry_units">
3634 </td>
3635
3636 <td class="entry_range">
Zhijun He7787f7f2014-01-14 16:30:31 -0800[diff] [blame]3637 <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]3638 </td>
3639
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3640 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]3641 <ul class="entry_tags">
3642 <li><a href="#tag_BC">BC</a></li>
3643 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3644 </td>
3645
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3646 </tr>
3647 <tr class="entries_header">
3648 <th class="th_details" colspan="5">Details</th>
3649 </tr>
3650 <tr class="entry_cont">
3651 <td class="entry_details" colspan="5">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]3652 <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]3653<p>If the lens is controlled by the camera device auto-focus algorithm,<wbr/>
3654the camera device will report the current AF status in android.<wbr/>control.<wbr/>af<wbr/>State
3655in result metadata.<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3656 </td>
3657 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3658
3659
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3660 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
3661 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3662
3663
3664 <tr class="entry" id="dynamic_android.control.afRegions">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3665 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3666 android.<wbr/>control.<wbr/>af<wbr/>Regions
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3667 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3668 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]3669 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3670 <span class="entry_type_container">x</span>
3671
3672 <span class="entry_type_array">
3673 5 x area_count
3674 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3675 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3676
3677
3678 </td> <!-- entry_type -->
3679
3680 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3681 <p>List of areas to use for focus
3682estimation</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3683 </td>
3684
3685 <td class="entry_units">
3686 </td>
3687
3688 <td class="entry_range">
3689 </td>
3690
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3691 <td class="entry_tags">
3692 <ul class="entry_tags">
3693 <li><a href="#tag_BC">BC</a></li>
3694 </ul>
3695 </td>
3696
3697 </tr>
3698 <tr class="entries_header">
3699 <th class="th_details" colspan="5">Details</th>
3700 </tr>
3701 <tr class="entry_cont">
3702 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3703 <p>Each area is a rectangle plus weight: xmin,<wbr/> ymin,<wbr/>
3704xmax,<wbr/> ymax,<wbr/> weight.<wbr/> The rectangle is defined inclusive of the
3705specified coordinates.<wbr/></p>
3706<p>The coordinate system is based on the active pixel array,<wbr/>
3707with (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]3708(<a href="#static_android.sensor.info.activeArraySize">android.<wbr/>sensor.<wbr/>info.<wbr/>active<wbr/>Array<wbr/>Size</a>.<wbr/>width - 1,<wbr/>
3709<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]3710bottom-right pixel in the active pixel array.<wbr/> The weight
3711should be nonnegative.<wbr/></p>
3712<p>If all regions have 0 weight,<wbr/> then no specific focus area
3713needs to be used by the HAL.<wbr/> If the focusing region is
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]3714outside 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]3715should ignore the sections outside the region and output the
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3716used sections in the frame metadata</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3717 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3718 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3719
3720
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3721 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
3722 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3723
3724
3725 <tr class="entry" id="dynamic_android.control.afState">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3726 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3727 android.<wbr/>control.<wbr/>af<wbr/>State
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3728 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3729 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]3730 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3731
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3732 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3733
3734 <ul class="entry_type_enum">
3735 <li>
3736 <span class="entry_type_enum_name">INACTIVE</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]3737 <span class="entry_type_enum_notes"><p>AF off or has not yet tried to scan/<wbr/>been asked
3738to scan.<wbr/> When a camera device is opened,<wbr/> it starts in
3739this state.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3740 </li>
3741 <li>
3742 <span class="entry_type_enum_name">PASSIVE_SCAN</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]3743 <span class="entry_type_enum_notes"><p>if CONTINUOUS_<wbr/>* modes are supported.<wbr/> AF is
3744currently doing an AF scan initiated by a continuous
3745autofocus mode</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3746 </li>
3747 <li>
3748 <span class="entry_type_enum_name">PASSIVE_FOCUSED</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]3749 <span class="entry_type_enum_notes"><p>if CONTINUOUS_<wbr/>* modes are supported.<wbr/> AF currently
3750believes it is in focus,<wbr/> but may restart scanning at
3751any time.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3752 </li>
3753 <li>
3754 <span class="entry_type_enum_name">ACTIVE_SCAN</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]3755 <span class="entry_type_enum_notes"><p>if AUTO or MACRO modes are supported.<wbr/> AF is doing
3756an AF scan because it was triggered by AF
3757trigger</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3758 </li>
3759 <li>
3760 <span class="entry_type_enum_name">FOCUSED_LOCKED</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]3761 <span class="entry_type_enum_notes"><p>if any AF mode besides OFF is supported.<wbr/> AF
3762believes it is focused correctly and is
3763locked</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3764 </li>
3765 <li>
3766 <span class="entry_type_enum_name">NOT_FOCUSED_LOCKED</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]3767 <span class="entry_type_enum_notes"><p>if any AF mode besides OFF is supported.<wbr/> AF has
3768failed to focus successfully and is
3769locked</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3770 </li>
Eino-Ville Talvala492ba7c2013-09-20 17:24:00 -0700[diff] [blame]3771 <li>
3772 <span class="entry_type_enum_name">PASSIVE_UNFOCUSED</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]3773 <span class="entry_type_enum_notes"><p>if CONTINUOUS_<wbr/>* modes are supported.<wbr/> AF finished a
3774passive scan without finding focus,<wbr/> and may restart
3775scanning at any time.<wbr/></p></span>
Eino-Ville Talvala492ba7c2013-09-20 17:24:00 -0700[diff] [blame]3776 </li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3777 </ul>
3778
3779 </td> <!-- entry_type -->
3780
3781 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3782 <p>Current state of AF algorithm</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3783 </td>
3784
3785 <td class="entry_units">
3786 </td>
3787
3788 <td class="entry_range">
3789 </td>
3790
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3791 <td class="entry_tags">
3792 </td>
3793
3794 </tr>
3795 <tr class="entries_header">
3796 <th class="th_details" colspan="5">Details</th>
3797 </tr>
3798 <tr class="entry_cont">
3799 <td class="entry_details" colspan="5">
Zhijun He92e698d2014-01-13 16:24:31 -0800[diff] [blame]3800 <p>Switching between or enabling AF modes (<a href="#controls_android.control.afMode">android.<wbr/>control.<wbr/>af<wbr/>Mode</a>) always
3801resets the AF state to INACTIVE.<wbr/> Similarly,<wbr/> switching between <a href="#controls_android.control.mode">android.<wbr/>control.<wbr/>mode</a>,<wbr/>
3802or <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
3803the algorithm states to INACTIVE.<wbr/></p>
3804<p>The camera device can do several state transitions between two results,<wbr/> if it is
3805allowed by the state transition table.<wbr/> For example: INACTIVE may never actually be
3806seen in a result.<wbr/></p>
3807<p>The state in the result is the state for this image (in sync with this image): if
3808AF state becomes FOCUSED,<wbr/> then the image data associated with this result should
3809be sharp.<wbr/></p>
3810<p>Below are state transition tables for different AF modes.<wbr/></p>
3811<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>
3812<table>
3813<thead>
3814<tr>
3815<th align="center">State</th>
3816<th align="center">Transition Cause</th>
3817<th align="center">New State</th>
3818<th align="center">Notes</th>
3819</tr>
3820</thead>
3821<tbody>
3822<tr>
3823<td align="center">INACTIVE</td>
3824<td align="center"></td>
3825<td align="center">INACTIVE</td>
3826<td align="center">Never changes</td>
3827</tr>
3828</tbody>
3829</table>
3830<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>
3831<table>
3832<thead>
3833<tr>
3834<th align="center">State</th>
3835<th align="center">Transition Cause</th>
3836<th align="center">New State</th>
3837<th align="center">Notes</th>
3838</tr>
3839</thead>
3840<tbody>
3841<tr>
3842<td align="center">INACTIVE</td>
3843<td align="center">AF_<wbr/>TRIGGER</td>
3844<td align="center">ACTIVE_<wbr/>SCAN</td>
3845<td align="center">Start AF sweep,<wbr/> Lens now moving</td>
3846</tr>
3847<tr>
3848<td align="center">ACTIVE_<wbr/>SCAN</td>
3849<td align="center">AF sweep done</td>
3850<td align="center">FOCUSED_<wbr/>LOCKED</td>
3851<td align="center">Focused,<wbr/> Lens now locked</td>
3852</tr>
3853<tr>
3854<td align="center">ACTIVE_<wbr/>SCAN</td>
3855<td align="center">AF sweep done</td>
3856<td align="center">NOT_<wbr/>FOCUSED_<wbr/>LOCKED</td>
3857<td align="center">Not focused,<wbr/> Lens now locked</td>
3858</tr>
3859<tr>
3860<td align="center">ACTIVE_<wbr/>SCAN</td>
3861<td align="center">AF_<wbr/>CANCEL</td>
3862<td align="center">INACTIVE</td>
3863<td align="center">Cancel/<wbr/>reset AF,<wbr/> Lens now locked</td>
3864</tr>
3865<tr>
3866<td align="center">FOCUSED_<wbr/>LOCKED</td>
3867<td align="center">AF_<wbr/>CANCEL</td>
3868<td align="center">INACTIVE</td>
3869<td align="center">Cancel/<wbr/>reset AF</td>
3870</tr>
3871<tr>
3872<td align="center">FOCUSED_<wbr/>LOCKED</td>
3873<td align="center">AF_<wbr/>TRIGGER</td>
3874<td align="center">ACTIVE_<wbr/>SCAN</td>
3875<td align="center">Start new sweep,<wbr/> Lens now moving</td>
3876</tr>
3877<tr>
3878<td align="center">NOT_<wbr/>FOCUSED_<wbr/>LOCKED</td>
3879<td align="center">AF_<wbr/>CANCEL</td>
3880<td align="center">INACTIVE</td>
3881<td align="center">Cancel/<wbr/>reset AF</td>
3882</tr>
3883<tr>
3884<td align="center">NOT_<wbr/>FOCUSED_<wbr/>LOCKED</td>
3885<td align="center">AF_<wbr/>TRIGGER</td>
3886<td align="center">ACTIVE_<wbr/>SCAN</td>
3887<td align="center">Start new sweep,<wbr/> Lens now moving</td>
3888</tr>
3889<tr>
3890<td align="center">Any state</td>
3891<td align="center">Mode change</td>
3892<td align="center">INACTIVE</td>
3893<td align="center"></td>
3894</tr>
3895</tbody>
3896</table>
3897<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>
3898<table>
3899<thead>
3900<tr>
3901<th align="center">State</th>
3902<th align="center">Transition Cause</th>
3903<th align="center">New State</th>
3904<th align="center">Notes</th>
3905</tr>
3906</thead>
3907<tbody>
3908<tr>
3909<td align="center">INACTIVE</td>
3910<td align="center">Camera device initiates new scan</td>
3911<td align="center">PASSIVE_<wbr/>SCAN</td>
3912<td align="center">Start AF scan,<wbr/> Lens now moving</td>
3913</tr>
3914<tr>
3915<td align="center">INACTIVE</td>
3916<td align="center">AF_<wbr/>TRIGGER</td>
3917<td align="center">NOT_<wbr/>FOCUSED_<wbr/>LOCKED</td>
3918<td align="center">AF state query,<wbr/> Lens now locked</td>
3919</tr>
3920<tr>
3921<td align="center">PASSIVE_<wbr/>SCAN</td>
3922<td align="center">Camera device completes current scan</td>
3923<td align="center">PASSIVE_<wbr/>FOCUSED</td>
3924<td align="center">End AF scan,<wbr/> Lens now locked</td>
3925</tr>
3926<tr>
3927<td align="center">PASSIVE_<wbr/>SCAN</td>
3928<td align="center">Camera device fails current scan</td>
3929<td align="center">PASSIVE_<wbr/>UNFOCUSED</td>
3930<td align="center">End AF scan,<wbr/> Lens now locked</td>
3931</tr>
3932<tr>
3933<td align="center">PASSIVE_<wbr/>SCAN</td>
3934<td align="center">AF_<wbr/>TRIGGER</td>
3935<td align="center">FOCUSED_<wbr/>LOCKED</td>
3936<td align="center">Immediate trans.<wbr/> If focus is good,<wbr/> Lens now locked</td>
3937</tr>
3938<tr>
3939<td align="center">PASSIVE_<wbr/>SCAN</td>
3940<td align="center">AF_<wbr/>TRIGGER</td>
3941<td align="center">NOT_<wbr/>FOCUSED_<wbr/>LOCKED</td>
3942<td align="center">Immediate trans.<wbr/> if focus is bad,<wbr/> Lens now locked</td>
3943</tr>
3944<tr>
3945<td align="center">PASSIVE_<wbr/>SCAN</td>
3946<td align="center">AF_<wbr/>CANCEL</td>
3947<td align="center">INACTIVE</td>
3948<td align="center">Reset lens position,<wbr/> Lens now locked</td>
3949</tr>
3950<tr>
3951<td align="center">PASSIVE_<wbr/>FOCUSED</td>
3952<td align="center">Camera device initiates new scan</td>
3953<td align="center">PASSIVE_<wbr/>SCAN</td>
3954<td align="center">Start AF scan,<wbr/> Lens now moving</td>
3955</tr>
3956<tr>
3957<td align="center">PASSIVE_<wbr/>UNFOCUSED</td>
3958<td align="center">Camera device initiates new scan</td>
3959<td align="center">PASSIVE_<wbr/>SCAN</td>
3960<td align="center">Start AF scan,<wbr/> Lens now moving</td>
3961</tr>
3962<tr>
3963<td align="center">PASSIVE_<wbr/>FOCUSED</td>
3964<td align="center">AF_<wbr/>TRIGGER</td>
3965<td align="center">FOCUSED_<wbr/>LOCKED</td>
3966<td align="center">Immediate trans.<wbr/> Lens now locked</td>
3967</tr>
3968<tr>
3969<td align="center">PASSIVE_<wbr/>UNFOCUSED</td>
3970<td align="center">AF_<wbr/>TRIGGER</td>
3971<td align="center">NOT_<wbr/>FOCUSED_<wbr/>LOCKED</td>
3972<td align="center">Immediate trans.<wbr/> Lens now locked</td>
3973</tr>
3974<tr>
3975<td align="center">FOCUSED_<wbr/>LOCKED</td>
3976<td align="center">AF_<wbr/>TRIGGER</td>
3977<td align="center">FOCUSED_<wbr/>LOCKED</td>
3978<td align="center">No effect</td>
3979</tr>
3980<tr>
3981<td align="center">FOCUSED_<wbr/>LOCKED</td>
3982<td align="center">AF_<wbr/>CANCEL</td>
3983<td align="center">INACTIVE</td>
3984<td align="center">Restart AF scan</td>
3985</tr>
3986<tr>
3987<td align="center">NOT_<wbr/>FOCUSED_<wbr/>LOCKED</td>
3988<td align="center">AF_<wbr/>TRIGGER</td>
3989<td align="center">NOT_<wbr/>FOCUSED_<wbr/>LOCKED</td>
3990<td align="center">No effect</td>
3991</tr>
3992<tr>
3993<td align="center">NOT_<wbr/>FOCUSED_<wbr/>LOCKED</td>
3994<td align="center">AF_<wbr/>CANCEL</td>
3995<td align="center">INACTIVE</td>
3996<td align="center">Restart AF scan</td>
3997</tr>
3998</tbody>
3999</table>
4000<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>
4001<table>
4002<thead>
4003<tr>
4004<th align="center">State</th>
4005<th align="center">Transition Cause</th>
4006<th align="center">New State</th>
4007<th align="center">Notes</th>
4008</tr>
4009</thead>
4010<tbody>
4011<tr>
4012<td align="center">INACTIVE</td>
4013<td align="center">Camera device initiates new scan</td>
4014<td align="center">PASSIVE_<wbr/>SCAN</td>
4015<td align="center">Start AF scan,<wbr/> Lens now moving</td>
4016</tr>
4017<tr>
4018<td align="center">INACTIVE</td>
4019<td align="center">AF_<wbr/>TRIGGER</td>
4020<td align="center">NOT_<wbr/>FOCUSED_<wbr/>LOCKED</td>
4021<td align="center">AF state query,<wbr/> Lens now locked</td>
4022</tr>
4023<tr>
4024<td align="center">PASSIVE_<wbr/>SCAN</td>
4025<td align="center">Camera device completes current scan</td>
4026<td align="center">PASSIVE_<wbr/>FOCUSED</td>
4027<td align="center">End AF scan,<wbr/> Lens now locked</td>
4028</tr>
4029<tr>
4030<td align="center">PASSIVE_<wbr/>SCAN</td>
4031<td align="center">Camera device fails current scan</td>
4032<td align="center">PASSIVE_<wbr/>UNFOCUSED</td>
4033<td align="center">End AF scan,<wbr/> Lens now locked</td>
4034</tr>
4035<tr>
4036<td align="center">PASSIVE_<wbr/>SCAN</td>
4037<td align="center">AF_<wbr/>TRIGGER</td>
4038<td align="center">FOCUSED_<wbr/>LOCKED</td>
4039<td align="center">Eventual trans.<wbr/> once focus good,<wbr/> Lens now locked</td>
4040</tr>
4041<tr>
4042<td align="center">PASSIVE_<wbr/>SCAN</td>
4043<td align="center">AF_<wbr/>TRIGGER</td>
4044<td align="center">NOT_<wbr/>FOCUSED_<wbr/>LOCKED</td>
4045<td align="center">Eventual trans.<wbr/> if cannot focus,<wbr/> Lens now locked</td>
4046</tr>
4047<tr>
4048<td align="center">PASSIVE_<wbr/>SCAN</td>
4049<td align="center">AF_<wbr/>CANCEL</td>
4050<td align="center">INACTIVE</td>
4051<td align="center">Reset lens position,<wbr/> Lens now locked</td>
4052</tr>
4053<tr>
4054<td align="center">PASSIVE_<wbr/>FOCUSED</td>
4055<td align="center">Camera device initiates new scan</td>
4056<td align="center">PASSIVE_<wbr/>SCAN</td>
4057<td align="center">Start AF scan,<wbr/> Lens now moving</td>
4058</tr>
4059<tr>
4060<td align="center">PASSIVE_<wbr/>UNFOCUSED</td>
4061<td align="center">Camera device initiates new scan</td>
4062<td align="center">PASSIVE_<wbr/>SCAN</td>
4063<td align="center">Start AF scan,<wbr/> Lens now moving</td>
4064</tr>
4065<tr>
4066<td align="center">PASSIVE_<wbr/>FOCUSED</td>
4067<td align="center">AF_<wbr/>TRIGGER</td>
4068<td align="center">FOCUSED_<wbr/>LOCKED</td>
4069<td align="center">Immediate trans.<wbr/> Lens now locked</td>
4070</tr>
4071<tr>
4072<td align="center">PASSIVE_<wbr/>UNFOCUSED</td>
4073<td align="center">AF_<wbr/>TRIGGER</td>
4074<td align="center">NOT_<wbr/>FOCUSED_<wbr/>LOCKED</td>
4075<td align="center">Immediate trans.<wbr/> Lens now locked</td>
4076</tr>
4077<tr>
4078<td align="center">FOCUSED_<wbr/>LOCKED</td>
4079<td align="center">AF_<wbr/>TRIGGER</td>
4080<td align="center">FOCUSED_<wbr/>LOCKED</td>
4081<td align="center">No effect</td>
4082</tr>
4083<tr>
4084<td align="center">FOCUSED_<wbr/>LOCKED</td>
4085<td align="center">AF_<wbr/>CANCEL</td>
4086<td align="center">INACTIVE</td>
4087<td align="center">Restart AF scan</td>
4088</tr>
4089<tr>
4090<td align="center">NOT_<wbr/>FOCUSED_<wbr/>LOCKED</td>
4091<td align="center">AF_<wbr/>TRIGGER</td>
4092<td align="center">NOT_<wbr/>FOCUSED_<wbr/>LOCKED</td>
4093<td align="center">No effect</td>
4094</tr>
4095<tr>
4096<td align="center">NOT_<wbr/>FOCUSED_<wbr/>LOCKED</td>
4097<td align="center">AF_<wbr/>CANCEL</td>
4098<td align="center">INACTIVE</td>
4099<td align="center">Restart AF scan</td>
4100</tr>
4101</tbody>
4102</table>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4103 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4104 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4105
4106
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4107 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
4108 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4109
4110
4111 <tr class="entry" id="dynamic_android.control.afTriggerId">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4112 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4113 android.<wbr/>control.<wbr/>af<wbr/>Trigger<wbr/>Id
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4114 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4115 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4116 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4117
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4118 <span class="entry_type_visibility"> [hidden]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4119
4120
4121 </td> <!-- entry_type -->
4122
4123 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4124 <p>The ID sent with the latest
4125CAMERA2_<wbr/>TRIGGER_<wbr/>AUTOFOCUS call</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4126 </td>
4127
4128 <td class="entry_units">
4129 </td>
4130
4131 <td class="entry_range">
4132 </td>
4133
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4134 <td class="entry_tags">
4135 </td>
4136
4137 </tr>
4138 <tr class="entries_header">
4139 <th class="th_details" colspan="5">Details</th>
4140 </tr>
4141 <tr class="entry_cont">
4142 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4143 <p>Must be 0 if no CAMERA2_<wbr/>TRIGGER_<wbr/>AUTOFOCUS trigger
4144received yet by HAL.<wbr/> Always updated even if AF algorithm
4145ignores the trigger</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4146 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4147 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4148
4149
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4150 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
4151 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4152
4153
4154 <tr class="entry" id="dynamic_android.control.awbMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4155 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4156 android.<wbr/>control.<wbr/>awb<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4157 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4158 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4159 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4160
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4161 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4162
4163 <ul class="entry_type_enum">
4164 <li>
4165 <span class="entry_type_enum_name">OFF</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]4166 <span class="entry_type_enum_notes"><p>The camera device's auto white balance routine is disabled;
4167the application-selected color transform matrix
4168(<a href="#controls_android.colorCorrection.transform">android.<wbr/>color<wbr/>Correction.<wbr/>transform</a>) and gains
4169(<a href="#controls_android.colorCorrection.gains">android.<wbr/>color<wbr/>Correction.<wbr/>gains</a>) are used by the camera
4170device for manual white balance control.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4171 </li>
4172 <li>
4173 <span class="entry_type_enum_name">AUTO</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]4174 <span class="entry_type_enum_notes"><p>The camera device's auto white balance routine is active;
4175the application's values for android.<wbr/>color<wbr/>Correction.<wbr/>transform
4176and <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]4177 </li>
4178 <li>
4179 <span class="entry_type_enum_name">INCANDESCENT</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 camera device uses incandescent light as the assumed scene
4182illumination for white balance.<wbr/> While the exact white balance
4183transforms are up to the camera device,<wbr/> they will approximately
4184match the CIE standard illuminant A.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4185 </li>
4186 <li>
4187 <span class="entry_type_enum_name">FLUORESCENT</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 disabled;
4189the camera device uses fluorescent light as the assumed scene
4190illumination for white balance.<wbr/> While the exact white balance
4191transforms are up to the camera device,<wbr/> they will approximately
4192match the CIE standard illuminant F2.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4193 </li>
4194 <li>
4195 <span class="entry_type_enum_name">WARM_FLUORESCENT</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]4196 <span class="entry_type_enum_notes"><p>The camera device's auto white balance routine is disabled;
4197the camera device uses warm fluorescent light as the assumed scene
4198illumination for white balance.<wbr/> While the exact white balance
4199transforms are up to the camera device,<wbr/> they will approximately
4200match the CIE standard illuminant F4.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4201 </li>
4202 <li>
4203 <span class="entry_type_enum_name">DAYLIGHT</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]4204 <span class="entry_type_enum_notes"><p>The camera device's auto white balance routine is disabled;
4205the camera device uses daylight light as the assumed scene
4206illumination for white balance.<wbr/> While the exact white balance
4207transforms are up to the camera device,<wbr/> they will approximately
4208match the CIE standard illuminant D65.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4209 </li>
4210 <li>
4211 <span class="entry_type_enum_name">CLOUDY_DAYLIGHT</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]4212 <span class="entry_type_enum_notes"><p>The camera device's auto white balance routine is disabled;
4213the camera device uses cloudy daylight light as the assumed scene
4214illumination for white balance.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4215 </li>
4216 <li>
4217 <span class="entry_type_enum_name">TWILIGHT</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 twilight light as the assumed scene
4220illumination for white balance.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4221 </li>
4222 <li>
4223 <span class="entry_type_enum_name">SHADE</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]4224 <span class="entry_type_enum_notes"><p>The camera device's auto white balance routine is disabled;
4225the camera device uses shade light as the assumed scene
4226illumination for white balance.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4227 </li>
4228 </ul>
4229
4230 </td> <!-- entry_type -->
4231
4232 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4233 <p>Whether AWB is currently setting the color
4234transform fields,<wbr/> and what its illumination target
4235is</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4236 </td>
4237
4238 <td class="entry_units">
4239 </td>
4240
4241 <td class="entry_range">
Zhijun He7787f7f2014-01-14 16:30:31 -0800[diff] [blame]4242 <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]4243 </td>
4244
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4245 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]4246 <ul class="entry_tags">
4247 <li><a href="#tag_BC">BC</a></li>
4248 <li><a href="#tag_AWB">AWB</a></li>
4249 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4250 </td>
4251
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4252 </tr>
4253 <tr class="entries_header">
4254 <th class="th_details" colspan="5">Details</th>
4255 </tr>
4256 <tr class="entry_cont">
4257 <td class="entry_details" colspan="5">
Zhijun He7787f7f2014-01-14 16:30:31 -0800[diff] [blame]4258 <p>This control is only effective if <a href="#controls_android.control.mode">android.<wbr/>control.<wbr/>mode</a> is AUTO.<wbr/></p>
4259<p>When set to the ON mode,<wbr/> the camera device's auto white balance
4260routine is enabled,<wbr/> overriding the application's selected
4261<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
4262<a href="#controls_android.colorCorrection.mode">android.<wbr/>color<wbr/>Correction.<wbr/>mode</a>.<wbr/></p>
4263<p>When set to the OFF mode,<wbr/> the camera device's auto white balance
4264routine is disabled.<wbr/> The applicantion manually controls the white
4265balance by <a href="#controls_android.colorCorrection.transform">android.<wbr/>color<wbr/>Correction.<wbr/>transform</a>,<wbr/> android.<wbr/>color<wbr/>Correction.<wbr/>gains
4266and <a href="#controls_android.colorCorrection.mode">android.<wbr/>color<wbr/>Correction.<wbr/>mode</a>.<wbr/></p>
4267<p>When set to any other modes,<wbr/> the camera device's auto white balance
4268routine is disabled.<wbr/> The camera device uses each particular illumination
4269target for white balance adjustment.<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4270 </td>
4271 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4272
4273
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4274 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
4275 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4276
4277
4278 <tr class="entry" id="dynamic_android.control.awbRegions">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4279 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4280 android.<wbr/>control.<wbr/>awb<wbr/>Regions
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4281 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4282 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4283 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4284 <span class="entry_type_container">x</span>
4285
4286 <span class="entry_type_array">
4287 5 x area_count
4288 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4289 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4290
4291
4292 </td> <!-- entry_type -->
4293
4294 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4295 <p>List of areas to use for illuminant
4296estimation</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4297 </td>
4298
4299 <td class="entry_units">
4300 </td>
4301
4302 <td class="entry_range">
4303 </td>
4304
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4305 <td class="entry_tags">
4306 <ul class="entry_tags">
4307 <li><a href="#tag_BC">BC</a></li>
4308 </ul>
4309 </td>
4310
4311 </tr>
4312 <tr class="entries_header">
4313 <th class="th_details" colspan="5">Details</th>
4314 </tr>
4315 <tr class="entry_cont">
4316 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4317 <p>Only used in AUTO mode.<wbr/></p>
4318<p>Each area is a rectangle plus weight: xmin,<wbr/> ymin,<wbr/>
4319xmax,<wbr/> ymax,<wbr/> weight.<wbr/> The rectangle is defined inclusive of the
4320specified coordinates.<wbr/></p>
4321<p>The coordinate system is based on the active pixel array,<wbr/>
4322with (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]4323(<a href="#static_android.sensor.info.activeArraySize">android.<wbr/>sensor.<wbr/>info.<wbr/>active<wbr/>Array<wbr/>Size</a>.<wbr/>width - 1,<wbr/>
4324<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]4325bottom-right pixel in the active pixel array.<wbr/> The weight
4326should be nonnegative.<wbr/></p>
4327<p>If all regions have 0 weight,<wbr/> then no specific metering area
4328needs to be used by the HAL.<wbr/> If the metering region is
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]4329outside 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]4330should ignore the sections outside the region and output the
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4331used sections in the frame metadata</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4332 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4333 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4334
4335
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4336 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
4337 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4338
4339
4340 <tr class="entry" id="dynamic_android.control.awbState">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4341 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4342 android.<wbr/>control.<wbr/>awb<wbr/>State
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4343 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4344 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4345 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4346
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4347 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4348
4349 <ul class="entry_type_enum">
4350 <li>
4351 <span class="entry_type_enum_name">INACTIVE</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]4352 <span class="entry_type_enum_notes"><p>AWB is not in auto mode.<wbr/> When a camera device is opened,<wbr/> it
4353starts in this state.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4354 </li>
4355 <li>
4356 <span class="entry_type_enum_name">SEARCHING</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]4357 <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]4358values for the current scene.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4359 </li>
4360 <li>
4361 <span class="entry_type_enum_name">CONVERGED</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]4362 <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]4363current scene.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4364 </li>
4365 <li>
4366 <span class="entry_type_enum_name">LOCKED</span>
Zhijun He92e698d2014-01-13 16:24:31 -0800[diff] [blame]4367 <span class="entry_type_enum_notes"><p>AWB has been locked.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4368 </li>
4369 </ul>
4370
4371 </td> <!-- entry_type -->
4372
4373 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4374 <p>Current state of AWB algorithm</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4375 </td>
4376
4377 <td class="entry_units">
4378 </td>
4379
4380 <td class="entry_range">
4381 </td>
4382
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4383 <td class="entry_tags">
4384 </td>
4385
4386 </tr>
4387 <tr class="entries_header">
4388 <th class="th_details" colspan="5">Details</th>
4389 </tr>
4390 <tr class="entry_cont">
4391 <td class="entry_details" colspan="5">
Zhijun He92e698d2014-01-13 16:24:31 -0800[diff] [blame]4392 <p>Switching between or enabling AWB modes (<a href="#controls_android.control.awbMode">android.<wbr/>control.<wbr/>awb<wbr/>Mode</a>) always
4393resets the AWB state to INACTIVE.<wbr/> Similarly,<wbr/> switching between <a href="#controls_android.control.mode">android.<wbr/>control.<wbr/>mode</a>,<wbr/>
4394or <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
4395the algorithm states to INACTIVE.<wbr/></p>
4396<p>The camera device can do several state transitions between two results,<wbr/> if it is
4397allowed by the state transition table.<wbr/> So INACTIVE may never actually be seen in
4398a result.<wbr/></p>
4399<p>The state in the result is the state for this image (in sync with this image): if
4400AWB state becomes CONVERGED,<wbr/> then the image data associated with this result should
4401be good to use.<wbr/></p>
4402<p>Below are state transition tables for different AWB modes.<wbr/></p>
4403<p>When <code><a href="#controls_android.control.awbMode">android.<wbr/>control.<wbr/>awb<wbr/>Mode</a> != AWB_<wbr/>MODE_<wbr/>AUTO</code>:</p>
4404<table>
4405<thead>
4406<tr>
4407<th align="center">State</th>
4408<th align="center">Transition Cause</th>
4409<th align="center">New State</th>
4410<th align="center">Notes</th>
4411</tr>
4412</thead>
4413<tbody>
4414<tr>
4415<td align="center">INACTIVE</td>
4416<td align="center"></td>
4417<td align="center">INACTIVE</td>
4418<td align="center">Camera device auto white balance algorithm is disabled</td>
4419</tr>
4420</tbody>
4421</table>
4422<p>When <a href="#controls_android.control.awbMode">android.<wbr/>control.<wbr/>awb<wbr/>Mode</a> is AWB_<wbr/>MODE_<wbr/>AUTO:</p>
4423<table>
4424<thead>
4425<tr>
4426<th align="center">State</th>
4427<th align="center">Transition Cause</th>
4428<th align="center">New State</th>
4429<th align="center">Notes</th>
4430</tr>
4431</thead>
4432<tbody>
4433<tr>
4434<td align="center">INACTIVE</td>
4435<td align="center">Camera device initiates AWB scan</td>
4436<td align="center">SEARCHING</td>
4437<td align="center">Values changing</td>
4438</tr>
4439<tr>
4440<td align="center">INACTIVE</td>
4441<td align="center"><a href="#controls_android.control.awbLock">android.<wbr/>control.<wbr/>awb<wbr/>Lock</a> is ON</td>
4442<td align="center">LOCKED</td>
4443<td align="center">Values locked</td>
4444</tr>
4445<tr>
4446<td align="center">SEARCHING</td>
4447<td align="center">Camera device finishes AWB scan</td>
4448<td align="center">CONVERGED</td>
4449<td align="center">Good values,<wbr/> not changing</td>
4450</tr>
4451<tr>
4452<td align="center">SEARCHING</td>
4453<td align="center"><a href="#controls_android.control.awbLock">android.<wbr/>control.<wbr/>awb<wbr/>Lock</a> is ON</td>
4454<td align="center">LOCKED</td>
4455<td align="center">Values locked</td>
4456</tr>
4457<tr>
4458<td align="center">CONVERGED</td>
4459<td align="center">Camera device initiates AWB scan</td>
4460<td align="center">SEARCHING</td>
4461<td align="center">Values changing</td>
4462</tr>
4463<tr>
4464<td align="center">CONVERGED</td>
4465<td align="center"><a href="#controls_android.control.awbLock">android.<wbr/>control.<wbr/>awb<wbr/>Lock</a> is ON</td>
4466<td align="center">LOCKED</td>
4467<td align="center">Values locked</td>
4468</tr>
4469<tr>
4470<td align="center">LOCKED</td>
4471<td align="center"><a href="#controls_android.control.awbLock">android.<wbr/>control.<wbr/>awb<wbr/>Lock</a> is OFF</td>
4472<td align="center">SEARCHING</td>
4473<td align="center">Values not good after unlock</td>
4474</tr>
4475<tr>
4476<td align="center">LOCKED</td>
4477<td align="center"><a href="#controls_android.control.awbLock">android.<wbr/>control.<wbr/>awb<wbr/>Lock</a> is OFF</td>
4478<td align="center">CONVERGED</td>
4479<td align="center">Values good after unlock</td>
4480</tr>
4481</tbody>
4482</table>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4483 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4484 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4485
4486
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4487 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
4488 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4489
4490
4491 <tr class="entry" id="dynamic_android.control.mode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4492 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4493 android.<wbr/>control.<wbr/>mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4494 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4495 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4496 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4497
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4498 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4499
4500 <ul class="entry_type_enum">
4501 <li>
4502 <span class="entry_type_enum_name">OFF</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]4503 <span class="entry_type_enum_notes"><p>Full application control of pipeline.<wbr/> All 3A
4504routines are disabled,<wbr/> no other settings in
4505android.<wbr/>control.<wbr/>* have any effect</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4506 </li>
4507 <li>
4508 <span class="entry_type_enum_name">AUTO</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]4509 <span class="entry_type_enum_notes"><p>Use settings for each individual 3A routine.<wbr/>
4510Manual control of capture parameters is disabled.<wbr/> All
4511controls in android.<wbr/>control.<wbr/>* besides sceneMode take
4512effect</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4513 </li>
4514 <li>
4515 <span class="entry_type_enum_name">USE_SCENE_MODE</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]4516 <span class="entry_type_enum_notes"><p>Use specific scene mode.<wbr/> Enabling this disables
4517control.<wbr/>aeMode,<wbr/> control.<wbr/>awbMode and control.<wbr/>afMode
4518controls; the HAL must ignore those settings while
4519USE_<wbr/>SCENE_<wbr/>MODE is active (except for FACE_<wbr/>PRIORITY
4520scene mode).<wbr/> Other control entries are still active.<wbr/>
4521This setting can only be used if availableSceneModes !=
4522UNSUPPORTED</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4523 </li>
4524 </ul>
4525
4526 </td> <!-- entry_type -->
4527
4528 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4529 <p>Overall mode of 3A control
4530routines</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4531 </td>
4532
4533 <td class="entry_units">
4534 </td>
4535
4536 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]4537 <p>all must be supported</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4538 </td>
4539
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4540 <td class="entry_tags">
4541 <ul class="entry_tags">
4542 <li><a href="#tag_BC">BC</a></li>
4543 </ul>
4544 </td>
4545
4546 </tr>
4547 <tr class="entries_header">
4548 <th class="th_details" colspan="5">Details</th>
4549 </tr>
4550 <tr class="entry_cont">
4551 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4552 <p>High-level 3A control.<wbr/> When set to OFF,<wbr/> all 3A control
Zhijun Hef90eeaf2014-01-16 12:13:35 -0800[diff] [blame]4553by the camera device is disabled.<wbr/> The application must set the fields for
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4554capture parameters itself.<wbr/></p>
4555<p>When set to AUTO,<wbr/> the individual algorithm controls in
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]4556android.<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]4557<p>When set to USE_<wbr/>SCENE_<wbr/>MODE,<wbr/> the individual controls in
Zhijun Hef90eeaf2014-01-16 12:13:35 -0800[diff] [blame]4558android.<wbr/>control.<wbr/>* are mostly disabled,<wbr/> and the camera device implements
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4559one of the scene mode settings (such as ACTION,<wbr/> SUNSET,<wbr/> or PARTY)
Zhijun Hef90eeaf2014-01-16 12:13:35 -0800[diff] [blame]4560as it wishes.<wbr/> The camera device scene mode 3A settings are provided by
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]4561<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]4562 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4563 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4564
4565
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4566 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
4567 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4568
4569
4570
4571 <!-- end of kind -->
4572 </tbody>
4573
4574 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4575 <tr><td colspan="6" id="section_demosaic" class="section">demosaic</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4576
4577
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4578 <tr><td colspan="6" class="kind">controls</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4579
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4580 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4581 <tr>
4582 <th class="th_name">Property Name</th>
4583 <th class="th_type">Type</th>
4584 <th class="th_description">Description</th>
4585 <th class="th_units">Units</th>
4586 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4587 <th class="th_tags">Tags</th>
4588 </tr>
4589 </thead>
4590
4591 <tbody>
4592
4593
4594
4595
4596
4597
4598
4599
4600
4601
4602 <tr class="entry" id="controls_android.demosaic.mode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4603 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4604 android.<wbr/>demosaic.<wbr/>mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4605 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4606 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4607 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4608
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4609 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4610
4611 <ul class="entry_type_enum">
4612 <li>
4613 <span class="entry_type_enum_name">FAST</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]4614 <span class="entry_type_enum_notes"><p>Minimal or no slowdown of frame rate compared to
4615Bayer RAW output</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4616 </li>
4617 <li>
4618 <span class="entry_type_enum_name">HIGH_QUALITY</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]4619 <span class="entry_type_enum_notes"><p>High-quality may reduce output frame
4620rate</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4621 </li>
4622 </ul>
4623
4624 </td> <!-- entry_type -->
4625
4626 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4627 <p>Controls the quality of the demosaicing
4628processing</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4629 </td>
4630
4631 <td class="entry_units">
4632 </td>
4633
4634 <td class="entry_range">
4635 </td>
4636
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4637 <td class="entry_tags">
4638 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]4639 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4640 </ul>
4641 </td>
4642
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4643 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4644
4645
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4646 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
4647 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4648
4649
4650
4651 <!-- end of kind -->
4652 </tbody>
4653
4654 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4655 <tr><td colspan="6" id="section_edge" class="section">edge</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4656
4657
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4658 <tr><td colspan="6" class="kind">controls</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4659
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4660 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4661 <tr>
4662 <th class="th_name">Property Name</th>
4663 <th class="th_type">Type</th>
4664 <th class="th_description">Description</th>
4665 <th class="th_units">Units</th>
4666 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4667 <th class="th_tags">Tags</th>
4668 </tr>
4669 </thead>
4670
4671 <tbody>
4672
4673
4674
4675
4676
4677
4678
4679
4680
4681
4682 <tr class="entry" id="controls_android.edge.mode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4683 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4684 android.<wbr/>edge.<wbr/>mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4685 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4686 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4687 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4688
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4689 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4690
4691 <ul class="entry_type_enum">
4692 <li>
4693 <span class="entry_type_enum_name">OFF</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]4694 <span class="entry_type_enum_notes"><p>No edge enhancement is applied</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4695 </li>
4696 <li>
4697 <span class="entry_type_enum_name">FAST</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]4698 <span class="entry_type_enum_notes"><p>Must not slow down frame rate relative to sensor
4699output</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4700 </li>
4701 <li>
4702 <span class="entry_type_enum_name">HIGH_QUALITY</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]4703 <span class="entry_type_enum_notes"><p>Frame rate may be reduced by high
4704quality</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4705 </li>
4706 </ul>
4707
4708 </td> <!-- entry_type -->
4709
4710 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4711 <p>Operation mode for edge
4712enhancement</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4713 </td>
4714
4715 <td class="entry_units">
4716 </td>
4717
4718 <td class="entry_range">
4719 </td>
4720
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4721 <td class="entry_tags">
4722 </td>
4723
4724 </tr>
4725 <tr class="entries_header">
4726 <th class="th_details" colspan="5">Details</th>
4727 </tr>
4728 <tr class="entry_cont">
4729 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4730 <p>Edge/<wbr/>sharpness/<wbr/>detail enhancement.<wbr/> OFF means no
4731enhancement will be applied by the HAL.<wbr/></p>
Zhijun Hef90eeaf2014-01-16 12:13:35 -0800[diff] [blame]4732<p>FAST/<wbr/>HIGH_<wbr/>QUALITY both mean camera device determined enhancement
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4733will be applied.<wbr/> HIGH_<wbr/>QUALITY mode indicates that the
Zhijun Hef90eeaf2014-01-16 12:13:35 -0800[diff] [blame]4734camera device will use the highest-quality enhancement algorithms,<wbr/>
4735even if it slows down capture rate.<wbr/> FAST means the camera device will
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4736not slow down capture rate when applying edge enhancement.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4737 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4738 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4739
4740
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4741 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
4742 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4743
4744
4745 <tr class="entry" id="controls_android.edge.strength">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4746 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4747 android.<wbr/>edge.<wbr/>strength
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4748 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4749 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4750 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4751
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4752 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4753
4754
4755 </td> <!-- entry_type -->
4756
4757 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4758 <p>Control the amount of edge enhancement
4759applied to the images</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4760 </td>
4761
4762 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4763 1-10; 10 is maximum sharpening
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4764 </td>
4765
4766 <td class="entry_range">
4767 </td>
4768
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4769 <td class="entry_tags">
4770 </td>
4771
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4772 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4773
4774
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4775 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
4776 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4777
4778
4779
4780 <!-- end of kind -->
4781 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4782 <tr><td colspan="6" class="kind">dynamic</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4783
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4784 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4785 <tr>
4786 <th class="th_name">Property Name</th>
4787 <th class="th_type">Type</th>
4788 <th class="th_description">Description</th>
4789 <th class="th_units">Units</th>
4790 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4791 <th class="th_tags">Tags</th>
4792 </tr>
4793 </thead>
4794
4795 <tbody>
4796
4797
4798
4799
4800
4801
4802
4803
4804
4805
4806 <tr class="entry" id="dynamic_android.edge.mode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4807 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4808 android.<wbr/>edge.<wbr/>mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4809 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4810 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4811 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4812
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4813 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4814
4815 <ul class="entry_type_enum">
4816 <li>
4817 <span class="entry_type_enum_name">OFF</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]4818 <span class="entry_type_enum_notes"><p>No edge enhancement is applied</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4819 </li>
4820 <li>
4821 <span class="entry_type_enum_name">FAST</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]4822 <span class="entry_type_enum_notes"><p>Must not slow down frame rate relative to sensor
4823output</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4824 </li>
4825 <li>
4826 <span class="entry_type_enum_name">HIGH_QUALITY</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]4827 <span class="entry_type_enum_notes"><p>Frame rate may be reduced by high
4828quality</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4829 </li>
4830 </ul>
4831
4832 </td> <!-- entry_type -->
4833
4834 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4835 <p>Operation mode for edge
4836enhancement</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4837 </td>
4838
4839 <td class="entry_units">
4840 </td>
4841
4842 <td class="entry_range">
4843 </td>
4844
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4845 <td class="entry_tags">
4846 </td>
4847
4848 </tr>
4849 <tr class="entries_header">
4850 <th class="th_details" colspan="5">Details</th>
4851 </tr>
4852 <tr class="entry_cont">
4853 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4854 <p>Edge/<wbr/>sharpness/<wbr/>detail enhancement.<wbr/> OFF means no
4855enhancement will be applied by the HAL.<wbr/></p>
Zhijun Hef90eeaf2014-01-16 12:13:35 -0800[diff] [blame]4856<p>FAST/<wbr/>HIGH_<wbr/>QUALITY both mean camera device determined enhancement
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4857will be applied.<wbr/> HIGH_<wbr/>QUALITY mode indicates that the
Zhijun Hef90eeaf2014-01-16 12:13:35 -0800[diff] [blame]4858camera device will use the highest-quality enhancement algorithms,<wbr/>
4859even if it slows down capture rate.<wbr/> FAST means the camera device will
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4860not slow down capture rate when applying edge enhancement.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4861 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4862 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4863
4864
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4865 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
4866 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4867
4868
4869
4870 <!-- end of kind -->
4871 </tbody>
4872
4873 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4874 <tr><td colspan="6" id="section_flash" class="section">flash</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4875
4876
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4877 <tr><td colspan="6" class="kind">controls</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4878
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4879 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4880 <tr>
4881 <th class="th_name">Property Name</th>
4882 <th class="th_type">Type</th>
4883 <th class="th_description">Description</th>
4884 <th class="th_units">Units</th>
4885 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4886 <th class="th_tags">Tags</th>
4887 </tr>
4888 </thead>
4889
4890 <tbody>
4891
4892
4893
4894
4895
4896
4897
4898
4899
4900
4901 <tr class="entry" id="controls_android.flash.firingPower">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4902 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4903 android.<wbr/>flash.<wbr/>firing<wbr/>Power
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4904 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4905 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4906 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4907
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4908 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4909
4910
4911 </td> <!-- entry_type -->
4912
4913 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4914 <p>Power for flash firing/<wbr/>torch</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4915 </td>
4916
4917 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4918 10 is max power; 0 is no flash.<wbr/> Linear
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4919 </td>
4920
4921 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]4922 <p>0 - 10</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4923 </td>
4924
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4925 <td class="entry_tags">
4926 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]4927 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4928 </ul>
4929 </td>
4930
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4931 </tr>
4932 <tr class="entries_header">
4933 <th class="th_details" colspan="5">Details</th>
4934 </tr>
4935 <tr class="entry_cont">
4936 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4937 <p>Power for snapshot may use a different scale than
4938for torch mode.<wbr/> Only one entry for torch mode will be
4939used</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4940 </td>
4941 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4942
4943
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4944 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
4945 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4946
4947
4948 <tr class="entry" id="controls_android.flash.firingTime">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4949 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4950 android.<wbr/>flash.<wbr/>firing<wbr/>Time
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4951 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4952 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4953 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4954
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4955 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4956
4957
4958 </td> <!-- entry_type -->
4959
4960 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4961 <p>Firing time of flash relative to start of
4962exposure</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4963 </td>
4964
4965 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4966 nanoseconds
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4967 </td>
4968
4969 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]4970 <p>0-(exposure time-flash duration)</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4971 </td>
4972
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4973 <td class="entry_tags">
4974 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]4975 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4976 </ul>
4977 </td>
4978
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4979 </tr>
4980 <tr class="entries_header">
4981 <th class="th_details" colspan="5">Details</th>
4982 </tr>
4983 <tr class="entry_cont">
4984 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4985 <p>Clamped to (0,<wbr/> exposure time - flash
4986duration).<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4987 </td>
4988 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4989
4990
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4991 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
4992 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4993
4994
4995 <tr class="entry" id="controls_android.flash.mode">
Zhijun Heea27bc32014-01-15 13:47:59 -0800[diff] [blame]4996 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4997 android.<wbr/>flash.<wbr/>mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4998 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4999 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5000 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5001
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5002 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5003
5004 <ul class="entry_type_enum">
5005 <li>
5006 <span class="entry_type_enum_name">OFF</span>
Zhijun Heea27bc32014-01-15 13:47:59 -0800[diff] [blame]5007 <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]5008 </li>
5009 <li>
5010 <span class="entry_type_enum_name">SINGLE</span>
Zhijun Heea27bc32014-01-15 13:47:59 -0800[diff] [blame]5011 <span class="entry_type_enum_notes"><p>If the flash is available and charged,<wbr/> fire flash
5012for this capture based on <a href="#controls_android.flash.firingPower">android.<wbr/>flash.<wbr/>firing<wbr/>Power</a> and
5013<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]5014 </li>
5015 <li>
5016 <span class="entry_type_enum_name">TORCH</span>
Zhijun Heea27bc32014-01-15 13:47:59 -0800[diff] [blame]5017 <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]5018 </li>
5019 </ul>
5020
5021 </td> <!-- entry_type -->
5022
5023 <td class="entry_description">
Zhijun Heea27bc32014-01-15 13:47:59 -0800[diff] [blame]5024 <p>The desired mode for for the camera device's flash control.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5025 </td>
5026
5027 <td class="entry_units">
5028 </td>
5029
5030 <td class="entry_range">
5031 </td>
5032
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5033 <td class="entry_tags">
5034 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5035 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5036 </ul>
5037 </td>
5038
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5039 </tr>
Zhijun Heea27bc32014-01-15 13:47:59 -0800[diff] [blame]5040 <tr class="entries_header">
5041 <th class="th_details" colspan="5">Details</th>
5042 </tr>
5043 <tr class="entry_cont">
5044 <td class="entry_details" colspan="5">
5045 <p>This control is only effective when flash unit is available
5046(<code><a href="#static_android.flash.info.available">android.<wbr/>flash.<wbr/>info.<wbr/>available</a> != 0</code>).<wbr/></p>
5047<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/>
5048Otherwise,<wbr/> the camera device auto-exposure related flash control (ON_<wbr/>AUTO_<wbr/>FLASH,<wbr/>
5049ON_<wbr/>ALWAYS_<wbr/>FLASH,<wbr/> or ON_<wbr/>AUTO_<wbr/>FLASH_<wbr/>REDEYE) will override this control.<wbr/></p>
5050<p>When set to OFF,<wbr/> the camera device will not fire flash for this capture.<wbr/></p>
5051<p>When set to SINGLE,<wbr/> the camera device will fire flash regardless of the camera
5052device's auto-exposure routine's result.<wbr/> When used in still capture case,<wbr/> this
5053control should be used along with AE precapture metering sequence
5054(<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>
5055<p>When set to TORCH,<wbr/> the flash will be on continuously.<wbr/> This mode can be used
5056for use cases such as preview,<wbr/> auto-focus assist,<wbr/> still capture,<wbr/> or video recording.<wbr/></p>
5057 </td>
5058 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5059
5060
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5061 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5062 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5063
5064
5065
5066 <!-- end of kind -->
5067 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5068 <tr><td colspan="6" class="kind">static</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5069
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5070 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5071 <tr>
5072 <th class="th_name">Property Name</th>
5073 <th class="th_type">Type</th>
5074 <th class="th_description">Description</th>
5075 <th class="th_units">Units</th>
5076 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5077 <th class="th_tags">Tags</th>
5078 </tr>
5079 </thead>
5080
5081 <tbody>
5082
5083
5084
5085
5086
5087
5088
5089
5090
5091
5092
5093
5094 <tr class="entry" id="static_android.flash.info.available">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5095 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5096 android.<wbr/>flash.<wbr/>info.<wbr/>available
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5097 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5098 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5099 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5100
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5101 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5102
5103
5104 </td> <!-- entry_type -->
5105
5106 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5107 <p>Whether this camera has a
5108flash</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5109 </td>
5110
5111 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5112 boolean (0 = false,<wbr/> otherwise true)
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5113 </td>
5114
5115 <td class="entry_range">
5116 </td>
5117
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5118 <td class="entry_tags">
5119 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5120 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5121 </ul>
5122 </td>
5123
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5124 </tr>
5125 <tr class="entries_header">
5126 <th class="th_details" colspan="5">Details</th>
5127 </tr>
5128 <tr class="entry_cont">
5129 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5130 <p>If no flash,<wbr/> none of the flash controls do
5131anything.<wbr/> All other metadata should return 0</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5132 </td>
5133 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5134
5135
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5136 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5137 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5138
5139
5140 <tr class="entry" id="static_android.flash.info.chargeDuration">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5141 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5142 android.<wbr/>flash.<wbr/>info.<wbr/>charge<wbr/>Duration
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5143 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5144 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5145 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5146
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5147 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5148
5149
5150 </td> <!-- entry_type -->
5151
5152 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5153 <p>Time taken before flash can fire
5154again</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5155 </td>
5156
5157 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5158 nanoseconds
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5159 </td>
5160
5161 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]5162 <p>0-1e9</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5163 </td>
5164
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5165 <td class="entry_tags">
5166 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5167 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5168 </ul>
5169 </td>
5170
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5171 </tr>
5172 <tr class="entries_header">
5173 <th class="th_details" colspan="5">Details</th>
5174 </tr>
5175 <tr class="entry_cont">
5176 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5177 <p>1 second too long/<wbr/>too short for recharge? Should
5178this be power-dependent?</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5179 </td>
5180 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5181
5182
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5183 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5184 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5185
5186
5187
5188
5189
5190 <tr class="entry" id="static_android.flash.colorTemperature">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5191 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5192 android.<wbr/>flash.<wbr/>color<wbr/>Temperature
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5193 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5194 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5195 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5196
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5197 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5198
5199
5200 </td> <!-- entry_type -->
5201
5202 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5203 <p>The x,<wbr/>y whitepoint of the
5204flash</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5205 </td>
5206
5207 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5208 pair of floats
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5209 </td>
5210
5211 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]5212 <p>0-1 for both</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5213 </td>
5214
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5215 <td class="entry_tags">
5216 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5217 <li><a href="#tag_ADV">ADV</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5218 </ul>
5219 </td>
5220
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5221 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5222
5223
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5224 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5225 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5226
5227
5228 <tr class="entry" id="static_android.flash.maxEnergy">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5229 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5230 android.<wbr/>flash.<wbr/>max<wbr/>Energy
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5231 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5232 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5233 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5234
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5235 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5236
5237
5238 </td> <!-- entry_type -->
5239
5240 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5241 <p>Max energy output of the flash for a full
5242power single flash</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5243 </td>
5244
5245 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5246 lumen-seconds
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5247 </td>
5248
5249 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame]5250 <p>&gt;= 0</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5251 </td>
5252
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5253 <td class="entry_tags">
5254 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5255 <li><a href="#tag_ADV">ADV</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5256 </ul>
5257 </td>
5258
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5259 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5260
5261
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5262 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5263 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5264
5265
5266
5267 <!-- end of kind -->
5268 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5269 <tr><td colspan="6" class="kind">dynamic</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5270
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5271 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5272 <tr>
5273 <th class="th_name">Property Name</th>
5274 <th class="th_type">Type</th>
5275 <th class="th_description">Description</th>
5276 <th class="th_units">Units</th>
5277 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5278 <th class="th_tags">Tags</th>
5279 </tr>
5280 </thead>
5281
5282 <tbody>
5283
5284
5285
5286
5287
5288
5289
5290
5291
5292
5293 <tr class="entry" id="dynamic_android.flash.firingPower">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5294 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5295 android.<wbr/>flash.<wbr/>firing<wbr/>Power
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5296 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5297 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5298 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5299
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5300 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5301
5302
5303 </td> <!-- entry_type -->
5304
5305 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5306 <p>Power for flash firing/<wbr/>torch</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5307 </td>
5308
5309 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5310 10 is max power; 0 is no flash.<wbr/> Linear
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5311 </td>
5312
5313 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]5314 <p>0 - 10</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5315 </td>
5316
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5317 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5318 <ul class="entry_tags">
5319 <li><a href="#tag_V1">V1</a></li>
5320 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5321 </td>
5322
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5323 </tr>
5324 <tr class="entries_header">
5325 <th class="th_details" colspan="5">Details</th>
5326 </tr>
5327 <tr class="entry_cont">
5328 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5329 <p>Power for snapshot may use a different scale than
5330for torch mode.<wbr/> Only one entry for torch mode will be
5331used</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5332 </td>
5333 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5334
5335
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5336 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5337 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5338
5339
5340 <tr class="entry" id="dynamic_android.flash.firingTime">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5341 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5342 android.<wbr/>flash.<wbr/>firing<wbr/>Time
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5343 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5344 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5345 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5346
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5347 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5348
5349
5350 </td> <!-- entry_type -->
5351
5352 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5353 <p>Firing time of flash relative to start of
5354exposure</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5355 </td>
5356
5357 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5358 nanoseconds
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5359 </td>
5360
5361 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]5362 <p>0-(exposure time-flash duration)</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5363 </td>
5364
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5365 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5366 <ul class="entry_tags">
5367 <li><a href="#tag_V1">V1</a></li>
5368 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5369 </td>
5370
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5371 </tr>
5372 <tr class="entries_header">
5373 <th class="th_details" colspan="5">Details</th>
5374 </tr>
5375 <tr class="entry_cont">
5376 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5377 <p>Clamped to (0,<wbr/> exposure time - flash
5378duration).<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5379 </td>
5380 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5381
5382
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5383 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5384 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5385
5386
5387 <tr class="entry" id="dynamic_android.flash.mode">
Zhijun Heea27bc32014-01-15 13:47:59 -0800[diff] [blame]5388 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5389 android.<wbr/>flash.<wbr/>mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5390 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5391 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5392 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5393
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5394 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5395
5396 <ul class="entry_type_enum">
5397 <li>
5398 <span class="entry_type_enum_name">OFF</span>
Zhijun Heea27bc32014-01-15 13:47:59 -0800[diff] [blame]5399 <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]5400 </li>
5401 <li>
5402 <span class="entry_type_enum_name">SINGLE</span>
Zhijun Heea27bc32014-01-15 13:47:59 -0800[diff] [blame]5403 <span class="entry_type_enum_notes"><p>If the flash is available and charged,<wbr/> fire flash
5404for this capture based on <a href="#controls_android.flash.firingPower">android.<wbr/>flash.<wbr/>firing<wbr/>Power</a> and
5405<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]5406 </li>
5407 <li>
5408 <span class="entry_type_enum_name">TORCH</span>
Zhijun Heea27bc32014-01-15 13:47:59 -0800[diff] [blame]5409 <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]5410 </li>
5411 </ul>
5412
5413 </td> <!-- entry_type -->
5414
5415 <td class="entry_description">
Zhijun Heea27bc32014-01-15 13:47:59 -0800[diff] [blame]5416 <p>The desired mode for for the camera device's flash control.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5417 </td>
5418
5419 <td class="entry_units">
5420 </td>
5421
5422 <td class="entry_range">
5423 </td>
5424
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5425 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5426 <ul class="entry_tags">
5427 <li><a href="#tag_BC">BC</a></li>
5428 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5429 </td>
5430
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5431 </tr>
Zhijun Heea27bc32014-01-15 13:47:59 -0800[diff] [blame]5432 <tr class="entries_header">
5433 <th class="th_details" colspan="5">Details</th>
5434 </tr>
5435 <tr class="entry_cont">
5436 <td class="entry_details" colspan="5">
5437 <p>This control is only effective when flash unit is available
5438(<code><a href="#static_android.flash.info.available">android.<wbr/>flash.<wbr/>info.<wbr/>available</a> != 0</code>).<wbr/></p>
5439<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/>
5440Otherwise,<wbr/> the camera device auto-exposure related flash control (ON_<wbr/>AUTO_<wbr/>FLASH,<wbr/>
5441ON_<wbr/>ALWAYS_<wbr/>FLASH,<wbr/> or ON_<wbr/>AUTO_<wbr/>FLASH_<wbr/>REDEYE) will override this control.<wbr/></p>
5442<p>When set to OFF,<wbr/> the camera device will not fire flash for this capture.<wbr/></p>
5443<p>When set to SINGLE,<wbr/> the camera device will fire flash regardless of the camera
5444device's auto-exposure routine's result.<wbr/> When used in still capture case,<wbr/> this
5445control should be used along with AE precapture metering sequence
5446(<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>
5447<p>When set to TORCH,<wbr/> the flash will be on continuously.<wbr/> This mode can be used
5448for use cases such as preview,<wbr/> auto-focus assist,<wbr/> still capture,<wbr/> or video recording.<wbr/></p>
5449 </td>
5450 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5451
5452
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5453 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5454 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5455
5456
5457 <tr class="entry" id="dynamic_android.flash.state">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5458 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5459 android.<wbr/>flash.<wbr/>state
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5460 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5461 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5462 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5463
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5464 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5465
5466 <ul class="entry_type_enum">
5467 <li>
5468 <span class="entry_type_enum_name">UNAVAILABLE</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]5469 <span class="entry_type_enum_notes"><p>No flash on camera</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5470 </li>
5471 <li>
5472 <span class="entry_type_enum_name">CHARGING</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]5473 <span class="entry_type_enum_notes"><p>if android.<wbr/>flash.<wbr/>available is true Flash is
5474charging and cannot be fired</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5475 </li>
5476 <li>
5477 <span class="entry_type_enum_name">READY</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]5478 <span class="entry_type_enum_notes"><p>if android.<wbr/>flash.<wbr/>available is true Flash is
5479ready to fire</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5480 </li>
5481 <li>
5482 <span class="entry_type_enum_name">FIRED</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]5483 <span class="entry_type_enum_notes"><p>if android.<wbr/>flash.<wbr/>available is true Flash fired
5484for this capture</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5485 </li>
5486 </ul>
5487
5488 </td> <!-- entry_type -->
5489
5490 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5491 <p>Current state of the flash
5492unit</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5493 </td>
5494
5495 <td class="entry_units">
5496 </td>
5497
5498 <td class="entry_range">
5499 </td>
5500
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5501 <td class="entry_tags">
5502 </td>
5503
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5504 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5505
5506
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5507 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5508 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5509
5510
5511
5512 <!-- end of kind -->
5513 </tbody>
5514
5515 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5516 <tr><td colspan="6" id="section_geometric" class="section">geometric</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5517
5518
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5519 <tr><td colspan="6" class="kind">controls</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5520
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5521 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5522 <tr>
5523 <th class="th_name">Property Name</th>
5524 <th class="th_type">Type</th>
5525 <th class="th_description">Description</th>
5526 <th class="th_units">Units</th>
5527 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5528 <th class="th_tags">Tags</th>
5529 </tr>
5530 </thead>
5531
5532 <tbody>
5533
5534
5535
5536
5537
5538
5539
5540
5541
5542
5543 <tr class="entry" id="controls_android.geometric.mode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5544 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5545 android.<wbr/>geometric.<wbr/>mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5546 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5547 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5548 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5549
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5550 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5551
5552 <ul class="entry_type_enum">
5553 <li>
5554 <span class="entry_type_enum_name">OFF</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]5555 <span class="entry_type_enum_notes"><p>No geometric correction is
5556applied</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5557 </li>
5558 <li>
5559 <span class="entry_type_enum_name">FAST</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]5560 <span class="entry_type_enum_notes"><p>Must not slow down frame rate relative to raw
5561bayer output</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5562 </li>
5563 <li>
5564 <span class="entry_type_enum_name">HIGH_QUALITY</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]5565 <span class="entry_type_enum_notes"><p>Frame rate may be reduced by high
5566quality</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5567 </li>
5568 </ul>
5569
5570 </td> <!-- entry_type -->
5571
5572 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5573 <p>Operating mode of geometric
5574correction</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5575 </td>
5576
5577 <td class="entry_units">
5578 </td>
5579
5580 <td class="entry_range">
5581 </td>
5582
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5583 <td class="entry_tags">
5584 </td>
5585
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5586 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5587
5588
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5589 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5590 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5591
5592
5593 <tr class="entry" id="controls_android.geometric.strength">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5594 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5595 android.<wbr/>geometric.<wbr/>strength
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5596 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5597 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5598 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5599
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5600 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5601
5602
5603 </td> <!-- entry_type -->
5604
5605 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5606 <p>Control the amount of shading correction
5607applied to the images</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5608 </td>
5609
5610 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5611 unitless: 1-10; 10 is full shading
5612 compensation
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5613 </td>
5614
5615 <td class="entry_range">
5616 </td>
5617
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5618 <td class="entry_tags">
5619 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5620 <li><a href="#tag_ADV">ADV</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5621 </ul>
5622 </td>
5623
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5624 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5625
5626
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5627 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5628 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5629
5630
5631
5632 <!-- end of kind -->
5633 </tbody>
5634
5635 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5636 <tr><td colspan="6" id="section_hotPixel" class="section">hotPixel</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5637
5638
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5639 <tr><td colspan="6" class="kind">controls</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5640
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5641 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5642 <tr>
5643 <th class="th_name">Property Name</th>
5644 <th class="th_type">Type</th>
5645 <th class="th_description">Description</th>
5646 <th class="th_units">Units</th>
5647 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5648 <th class="th_tags">Tags</th>
5649 </tr>
5650 </thead>
5651
5652 <tbody>
5653
5654
5655
5656
5657
5658
5659
5660
5661
5662
5663 <tr class="entry" id="controls_android.hotPixel.mode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5664 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5665 android.<wbr/>hot<wbr/>Pixel.<wbr/>mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5666 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5667 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5668 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5669
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5670 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5671
5672 <ul class="entry_type_enum">
5673 <li>
5674 <span class="entry_type_enum_name">OFF</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]5675 <span class="entry_type_enum_notes"><p>No hot pixel correction can be
5676applied</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5677 </li>
5678 <li>
5679 <span class="entry_type_enum_name">FAST</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]5680 <span class="entry_type_enum_notes"><p>Frame rate must not be reduced compared to raw
5681Bayer output</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5682 </li>
5683 <li>
5684 <span class="entry_type_enum_name">HIGH_QUALITY</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]5685 <span class="entry_type_enum_notes"><p>Frame rate may be reduced by high
5686quality</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5687 </li>
5688 </ul>
5689
5690 </td> <!-- entry_type -->
5691
5692 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5693 <p>Set operational mode for hot pixel
5694correction</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5695 </td>
5696
5697 <td class="entry_units">
5698 </td>
5699
5700 <td class="entry_range">
5701 </td>
5702
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5703 <td class="entry_tags">
5704 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5705 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5706 </ul>
5707 </td>
5708
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5709 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5710
5711
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5712 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5713 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5714
5715
5716
5717 <!-- end of kind -->
5718 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5719 <tr><td colspan="6" class="kind">static</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5720
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5721 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5722 <tr>
5723 <th class="th_name">Property Name</th>
5724 <th class="th_type">Type</th>
5725 <th class="th_description">Description</th>
5726 <th class="th_units">Units</th>
5727 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5728 <th class="th_tags">Tags</th>
5729 </tr>
5730 </thead>
5731
5732 <tbody>
5733
5734
5735
5736
5737
5738
5739
5740
5741
5742
5743
5744
5745 <tr class="entry" id="static_android.hotPixel.info.map">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5746 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5747 android.<wbr/>hot<wbr/>Pixel.<wbr/>info.<wbr/>map
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5748 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5749 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5750 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5751 <span class="entry_type_container">x</span>
5752
5753 <span class="entry_type_array">
5754 2 x n
5755 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5756 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5757 <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]5758
5759
5760 </td> <!-- entry_type -->
5761
5762 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5763 <p>Location of hot/<wbr/>defective pixels on
5764sensor</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5765 </td>
5766
5767 <td class="entry_units">
5768 </td>
5769
5770 <td class="entry_range">
5771 </td>
5772
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5773 <td class="entry_tags">
5774 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5775 <li><a href="#tag_ADV">ADV</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5776 </ul>
5777 </td>
5778
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5779 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5780
5781
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5782 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5783 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5784
5785
5786
5787
5788
5789
5790 <!-- end of kind -->
5791 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5792 <tr><td colspan="6" class="kind">dynamic</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5793
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5794 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5795 <tr>
5796 <th class="th_name">Property Name</th>
5797 <th class="th_type">Type</th>
5798 <th class="th_description">Description</th>
5799 <th class="th_units">Units</th>
5800 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5801 <th class="th_tags">Tags</th>
5802 </tr>
5803 </thead>
5804
5805 <tbody>
5806
5807
5808
5809
5810
5811
5812
5813
5814
5815
5816 <tr class="entry" id="dynamic_android.hotPixel.mode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5817 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5818 android.<wbr/>hot<wbr/>Pixel.<wbr/>mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5819 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5820 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5821 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5822
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5823 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5824
5825 <ul class="entry_type_enum">
5826 <li>
5827 <span class="entry_type_enum_name">OFF</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]5828 <span class="entry_type_enum_notes"><p>No hot pixel correction can be
5829applied</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5830 </li>
5831 <li>
5832 <span class="entry_type_enum_name">FAST</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]5833 <span class="entry_type_enum_notes"><p>Frame rate must not be reduced compared to raw
5834Bayer output</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5835 </li>
5836 <li>
5837 <span class="entry_type_enum_name">HIGH_QUALITY</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]5838 <span class="entry_type_enum_notes"><p>Frame rate may be reduced by high
5839quality</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5840 </li>
5841 </ul>
5842
5843 </td> <!-- entry_type -->
5844
5845 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5846 <p>Set operational mode for hot pixel
5847correction</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5848 </td>
5849
5850 <td class="entry_units">
5851 </td>
5852
5853 <td class="entry_range">
5854 </td>
5855
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5856 <td class="entry_tags">
5857 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5858 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5859 </ul>
5860 </td>
5861
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5862 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5863
5864
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5865 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5866 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5867
5868
5869
5870 <!-- end of kind -->
5871 </tbody>
5872
5873 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5874 <tr><td colspan="6" id="section_jpeg" class="section">jpeg</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5875
5876
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5877 <tr><td colspan="6" class="kind">controls</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5878
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5879 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5880 <tr>
5881 <th class="th_name">Property Name</th>
5882 <th class="th_type">Type</th>
5883 <th class="th_description">Description</th>
5884 <th class="th_units">Units</th>
5885 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5886 <th class="th_tags">Tags</th>
5887 </tr>
5888 </thead>
5889
5890 <tbody>
5891
5892
5893
5894
5895
5896
5897
5898
5899
5900
5901 <tr class="entry" id="controls_android.jpeg.gpsCoordinates">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5902 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5903 android.<wbr/>jpeg.<wbr/>gps<wbr/>Coordinates
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5904 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5905 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5906 <span class="entry_type_name">double</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5907 <span class="entry_type_container">x</span>
5908
5909 <span class="entry_type_array">
5910 3
5911 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5912 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5913 <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]5914
5915
5916 </td> <!-- entry_type -->
5917
5918 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5919 <p>GPS coordinates to include in output JPEG
5920EXIF</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5921 </td>
5922
5923 <td class="entry_units">
5924 </td>
5925
5926 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]5927 <p>(-180 - 180],<wbr/> [-90,<wbr/>90],<wbr/> [-inf,<wbr/> inf]</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5928 </td>
5929
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5930 <td class="entry_tags">
5931 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5932 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5933 </ul>
5934 </td>
5935
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5936 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5937
5938
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5939 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5940 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5941
5942
5943 <tr class="entry" id="controls_android.jpeg.gpsProcessingMethod">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5944 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5945 android.<wbr/>jpeg.<wbr/>gps<wbr/>Processing<wbr/>Method
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5946 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5947 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5948 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5949
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]5950 <span class="entry_type_visibility"> [public as string]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5951
5952
5953 </td> <!-- entry_type -->
5954
5955 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5956 <p>32 characters describing GPS algorithm to
5957include in EXIF</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5958 </td>
5959
5960 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5961 UTF-8 null-terminated string
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5962 </td>
5963
5964 <td class="entry_range">
5965 </td>
5966
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5967 <td class="entry_tags">
5968 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5969 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5970 </ul>
5971 </td>
5972
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5973 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5974
5975
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5976 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5977 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5978
5979
5980 <tr class="entry" id="controls_android.jpeg.gpsTimestamp">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5981 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5982 android.<wbr/>jpeg.<wbr/>gps<wbr/>Timestamp
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5983 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5984 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5985 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5986
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5987 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5988
5989
5990 </td> <!-- entry_type -->
5991
5992 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5993 <p>Time GPS fix was made to include in
5994EXIF</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5995 </td>
5996
5997 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5998 UTC in seconds since January 1,<wbr/> 1970
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5999 </td>
6000
6001 <td class="entry_range">
6002 </td>
6003
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6004 <td class="entry_tags">
6005 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6006 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6007 </ul>
6008 </td>
6009
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6010 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6011
6012
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6013 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6014 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6015
6016
6017 <tr class="entry" id="controls_android.jpeg.orientation">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6018 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6019 android.<wbr/>jpeg.<wbr/>orientation
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6020 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6021 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6022 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6023
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6024 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6025
6026
6027 </td> <!-- entry_type -->
6028
6029 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6030 <p>Orientation of JPEG image to
6031write</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6032 </td>
6033
6034 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6035 Degrees in multiples of 90
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6036 </td>
6037
6038 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]6039 <p>0,<wbr/> 90,<wbr/> 180,<wbr/> 270</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6040 </td>
6041
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6042 <td class="entry_tags">
6043 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6044 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6045 </ul>
6046 </td>
6047
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6048 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6049
6050
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6051 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6052 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6053
6054
6055 <tr class="entry" id="controls_android.jpeg.quality">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6056 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6057 android.<wbr/>jpeg.<wbr/>quality
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6058 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6059 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6060 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6061
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6062 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6063
6064
6065 </td> <!-- entry_type -->
6066
6067 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6068 <p>Compression quality of the final JPEG
6069image</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6070 </td>
6071
6072 <td class="entry_units">
6073 </td>
6074
6075 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]6076 <p>1-100; larger is higher quality</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6077 </td>
6078
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6079 <td class="entry_tags">
6080 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6081 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6082 </ul>
6083 </td>
6084
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6085 </tr>
6086 <tr class="entries_header">
6087 <th class="th_details" colspan="5">Details</th>
6088 </tr>
6089 <tr class="entry_cont">
6090 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6091 <p>85-95 is typical usage range</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6092 </td>
6093 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6094
6095
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6096 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6097 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6098
6099
6100 <tr class="entry" id="controls_android.jpeg.thumbnailQuality">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6101 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6102 android.<wbr/>jpeg.<wbr/>thumbnail<wbr/>Quality
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6103 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6104 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6105 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6106
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6107 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6108
6109
6110 </td> <!-- entry_type -->
6111
6112 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6113 <p>Compression quality of JPEG
6114thumbnail</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6115 </td>
6116
6117 <td class="entry_units">
6118 </td>
6119
6120 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]6121 <p>1-100; larger is higher quality</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6122 </td>
6123
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6124 <td class="entry_tags">
6125 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6126 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6127 </ul>
6128 </td>
6129
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6130 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6131
6132
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6133 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6134 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6135
6136
6137 <tr class="entry" id="controls_android.jpeg.thumbnailSize">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6138 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6139 android.<wbr/>jpeg.<wbr/>thumbnail<wbr/>Size
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6140 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6141 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6142 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6143 <span class="entry_type_container">x</span>
6144
6145 <span class="entry_type_array">
6146 2
6147 </span>
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]6148 <span class="entry_type_visibility"> [public as size]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6149
6150
6151 </td> <!-- entry_type -->
6152
6153 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6154 <p>Resolution of embedded JPEG thumbnail</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6155 </td>
6156
6157 <td class="entry_units">
6158 </td>
6159
6160 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]6161 <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]6162 </td>
6163
6164 <td class="entry_tags">
6165 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6166 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6167 </ul>
6168 </td>
6169
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6170 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6171 <tr class="entries_header">
6172 <th class="th_details" colspan="5">Details</th>
6173 </tr>
6174 <tr class="entry_cont">
6175 <td class="entry_details" colspan="5">
Zhijun Hef90eeaf2014-01-16 12:13:35 -0800[diff] [blame]6176 <p>When set to (0,<wbr/> 0) value,<wbr/> the JPEG EXIF will not contain thumbnail,<wbr/>
6177but the captured JPEG will still be a valid image.<wbr/></p>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6178<p>When a jpeg image capture is issued,<wbr/> the thumbnail size selected should have
6179the same aspect ratio as the jpeg image.<wbr/></p>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6180 </td>
6181 </tr>
6182
6183
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6184 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6185 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6186
6187
6188
6189 <!-- end of kind -->
6190 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6191 <tr><td colspan="6" class="kind">static</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6192
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6193 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6194 <tr>
6195 <th class="th_name">Property Name</th>
6196 <th class="th_type">Type</th>
6197 <th class="th_description">Description</th>
6198 <th class="th_units">Units</th>
6199 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6200 <th class="th_tags">Tags</th>
6201 </tr>
6202 </thead>
6203
6204 <tbody>
6205
6206
6207
6208
6209
6210
6211
6212
6213
6214
6215 <tr class="entry" id="static_android.jpeg.availableThumbnailSizes">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6216 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6217 android.<wbr/>jpeg.<wbr/>available<wbr/>Thumbnail<wbr/>Sizes
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6218 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6219 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6220 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6221 <span class="entry_type_container">x</span>
6222
6223 <span class="entry_type_array">
6224 2 x n
6225 </span>
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]6226 <span class="entry_type_visibility"> [public as size]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6227
6228
6229 </td> <!-- entry_type -->
6230
6231 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6232 <p>Supported resolutions for the JPEG thumbnail</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6233 </td>
6234
6235 <td class="entry_units">
6236 </td>
6237
6238 <td class="entry_range">
Zhijun Hef90eeaf2014-01-16 12:13:35 -0800[diff] [blame]6239 <p>Will include at least one valid resolution,<wbr/> plus
6240(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]6241 </td>
6242
6243 <td class="entry_tags">
6244 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6245 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6246 </ul>
6247 </td>
6248
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6249 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6250 <tr class="entries_header">
6251 <th class="th_details" colspan="5">Details</th>
6252 </tr>
6253 <tr class="entry_cont">
6254 <td class="entry_details" colspan="5">
Zhijun Hef90eeaf2014-01-16 12:13:35 -0800[diff] [blame]6255 <p>Below condiditions will be satisfied for this size list:</p>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6256<ul>
Zhijun Hef90eeaf2014-01-16 12:13:35 -0800[diff] [blame]6257<li>The sizes will be sorted by increasing pixel area (width x height).<wbr/>
6258If several resolutions have the same area,<wbr/> they will be sorted by increasing width.<wbr/></li>
6259<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]6260aspect 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]6261The largest size is defined as the size that has the largest pixel area
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6262in a given size list.<wbr/></li>
Zhijun Hef90eeaf2014-01-16 12:13:35 -0800[diff] [blame]6263<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]6264one corresponding size that has the same aspect ratio in availableThumbnailSizes,<wbr/>
6265and vice versa.<wbr/></li>
Zhijun Hef90eeaf2014-01-16 12:13:35 -0800[diff] [blame]6266<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]6267</ul>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6268 </td>
6269 </tr>
6270
6271
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6272 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6273 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6274
6275
6276 <tr class="entry" id="static_android.jpeg.maxSize">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6277 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6278 android.<wbr/>jpeg.<wbr/>max<wbr/>Size
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6279 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6280 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6281 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6282
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6283 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6284
6285
6286 </td> <!-- entry_type -->
6287
6288 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6289 <p>Maximum size in bytes for the compressed
6290JPEG buffer</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6291 </td>
6292
6293 <td class="entry_units">
6294 </td>
6295
6296 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]6297 <p>Must be large enough to fit any JPEG produced by
6298the camera</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6299 </td>
6300
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6301 <td class="entry_tags">
6302 </td>
6303
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6304 </tr>
6305 <tr class="entries_header">
6306 <th class="th_details" colspan="5">Details</th>
6307 </tr>
6308 <tr class="entry_cont">
6309 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6310 <p>This is used for sizing the gralloc buffers for
6311JPEG</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6312 </td>
6313 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6314
6315
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6316 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6317 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6318
6319
6320
6321 <!-- end of kind -->
6322 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6323 <tr><td colspan="6" class="kind">dynamic</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6324
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6325 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6326 <tr>
6327 <th class="th_name">Property Name</th>
6328 <th class="th_type">Type</th>
6329 <th class="th_description">Description</th>
6330 <th class="th_units">Units</th>
6331 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6332 <th class="th_tags">Tags</th>
6333 </tr>
6334 </thead>
6335
6336 <tbody>
6337
6338
6339
6340
6341
6342
6343
6344
6345
6346
6347 <tr class="entry" id="dynamic_android.jpeg.gpsCoordinates">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6348 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6349 android.<wbr/>jpeg.<wbr/>gps<wbr/>Coordinates
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6350 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6351 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6352 <span class="entry_type_name">double</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6353 <span class="entry_type_container">x</span>
6354
6355 <span class="entry_type_array">
6356 3
6357 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6358 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6359 <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]6360
6361
6362 </td> <!-- entry_type -->
6363
6364 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6365 <p>GPS coordinates to include in output JPEG
6366EXIF</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6367 </td>
6368
6369 <td class="entry_units">
6370 </td>
6371
6372 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]6373 <p>(-180 - 180],<wbr/> [-90,<wbr/>90],<wbr/> [-inf,<wbr/> inf]</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6374 </td>
6375
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6376 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6377 <ul class="entry_tags">
6378 <li><a href="#tag_BC">BC</a></li>
6379 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6380 </td>
6381
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6382 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6383
6384
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6385 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6386 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6387
6388
6389 <tr class="entry" id="dynamic_android.jpeg.gpsProcessingMethod">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6390 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6391 android.<wbr/>jpeg.<wbr/>gps<wbr/>Processing<wbr/>Method
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6392 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6393 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6394 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6395
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]6396 <span class="entry_type_visibility"> [public as string]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6397
6398
6399 </td> <!-- entry_type -->
6400
6401 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6402 <p>32 characters describing GPS algorithm to
6403include in EXIF</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6404 </td>
6405
6406 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6407 UTF-8 null-terminated string
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6408 </td>
6409
6410 <td class="entry_range">
6411 </td>
6412
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6413 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6414 <ul class="entry_tags">
6415 <li><a href="#tag_BC">BC</a></li>
6416 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6417 </td>
6418
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6419 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6420
6421
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6422 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6423 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6424
6425
6426 <tr class="entry" id="dynamic_android.jpeg.gpsTimestamp">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6427 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6428 android.<wbr/>jpeg.<wbr/>gps<wbr/>Timestamp
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6429 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6430 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6431 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6432
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6433 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6434
6435
6436 </td> <!-- entry_type -->
6437
6438 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6439 <p>Time GPS fix was made to include in
6440EXIF</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6441 </td>
6442
6443 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6444 UTC in seconds since January 1,<wbr/> 1970
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6445 </td>
6446
6447 <td class="entry_range">
6448 </td>
6449
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6450 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6451 <ul class="entry_tags">
6452 <li><a href="#tag_BC">BC</a></li>
6453 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6454 </td>
6455
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6456 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6457
6458
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6459 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6460 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6461
6462
6463 <tr class="entry" id="dynamic_android.jpeg.orientation">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6464 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6465 android.<wbr/>jpeg.<wbr/>orientation
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6466 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6467 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6468 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6469
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6470 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6471
6472
6473 </td> <!-- entry_type -->
6474
6475 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6476 <p>Orientation of JPEG image to
6477write</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6478 </td>
6479
6480 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6481 Degrees in multiples of 90
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6482 </td>
6483
6484 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]6485 <p>0,<wbr/> 90,<wbr/> 180,<wbr/> 270</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6486 </td>
6487
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6488 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6489 <ul class="entry_tags">
6490 <li><a href="#tag_BC">BC</a></li>
6491 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6492 </td>
6493
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6494 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6495
6496
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6497 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6498 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6499
6500
6501 <tr class="entry" id="dynamic_android.jpeg.quality">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6502 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6503 android.<wbr/>jpeg.<wbr/>quality
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6504 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6505 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6506 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6507
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6508 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6509
6510
6511 </td> <!-- entry_type -->
6512
6513 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6514 <p>Compression quality of the final JPEG
6515image</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6516 </td>
6517
6518 <td class="entry_units">
6519 </td>
6520
6521 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]6522 <p>1-100; larger is higher quality</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6523 </td>
6524
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6525 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6526 <ul class="entry_tags">
6527 <li><a href="#tag_BC">BC</a></li>
6528 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6529 </td>
6530
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6531 </tr>
6532 <tr class="entries_header">
6533 <th class="th_details" colspan="5">Details</th>
6534 </tr>
6535 <tr class="entry_cont">
6536 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6537 <p>85-95 is typical usage range</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6538 </td>
6539 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6540
6541
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6542 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6543 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6544
6545
6546 <tr class="entry" id="dynamic_android.jpeg.size">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6547 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6548 android.<wbr/>jpeg.<wbr/>size
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6549 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6550 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6551 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6552
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6553 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6554
6555
6556 </td> <!-- entry_type -->
6557
6558 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6559 <p>The size of the compressed JPEG image,<wbr/> in
6560bytes</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6561 </td>
6562
6563 <td class="entry_units">
6564 </td>
6565
6566 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame]6567 <p>&gt;= 0</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6568 </td>
6569
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6570 <td class="entry_tags">
6571 </td>
6572
6573 </tr>
6574 <tr class="entries_header">
6575 <th class="th_details" colspan="5">Details</th>
6576 </tr>
6577 <tr class="entry_cont">
6578 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6579 <p>If no JPEG output is produced for the request,<wbr/>
6580this must be 0.<wbr/></p>
6581<p>Otherwise,<wbr/> this describes the real size of the compressed
6582JPEG image placed in the output stream.<wbr/> More specifically,<wbr/>
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]6583if <a href="#static_android.jpeg.maxSize">android.<wbr/>jpeg.<wbr/>max<wbr/>Size</a> = 1000000,<wbr/> and a specific capture
6584has <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]6585the JPEG stream will be 1000000 bytes,<wbr/> of which the first
6586500000 make up the real data.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6587 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6588 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6589
6590
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6591 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6592 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6593
6594
6595 <tr class="entry" id="dynamic_android.jpeg.thumbnailQuality">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6596 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6597 android.<wbr/>jpeg.<wbr/>thumbnail<wbr/>Quality
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6598 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6599 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6600 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6601
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6602 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6603
6604
6605 </td> <!-- entry_type -->
6606
6607 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6608 <p>Compression quality of JPEG
6609thumbnail</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6610 </td>
6611
6612 <td class="entry_units">
6613 </td>
6614
6615 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]6616 <p>1-100; larger is higher quality</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6617 </td>
6618
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6619 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6620 <ul class="entry_tags">
6621 <li><a href="#tag_BC">BC</a></li>
6622 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6623 </td>
6624
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6625 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6626
6627
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6628 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6629 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6630
6631
6632 <tr class="entry" id="dynamic_android.jpeg.thumbnailSize">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6633 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6634 android.<wbr/>jpeg.<wbr/>thumbnail<wbr/>Size
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6635 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6636 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6637 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6638 <span class="entry_type_container">x</span>
6639
6640 <span class="entry_type_array">
6641 2
6642 </span>
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]6643 <span class="entry_type_visibility"> [public as size]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6644
6645
6646 </td> <!-- entry_type -->
6647
6648 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6649 <p>Resolution of embedded JPEG thumbnail</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6650 </td>
6651
6652 <td class="entry_units">
6653 </td>
6654
6655 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]6656 <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]6657 </td>
6658
6659 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6660 <ul class="entry_tags">
6661 <li><a href="#tag_BC">BC</a></li>
6662 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6663 </td>
6664
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6665 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6666 <tr class="entries_header">
6667 <th class="th_details" colspan="5">Details</th>
6668 </tr>
6669 <tr class="entry_cont">
6670 <td class="entry_details" colspan="5">
Zhijun Hef90eeaf2014-01-16 12:13:35 -0800[diff] [blame]6671 <p>When set to (0,<wbr/> 0) value,<wbr/> the JPEG EXIF will not contain thumbnail,<wbr/>
6672but the captured JPEG will still be a valid image.<wbr/></p>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6673<p>When a jpeg image capture is issued,<wbr/> the thumbnail size selected should have
6674the same aspect ratio as the jpeg image.<wbr/></p>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6675 </td>
6676 </tr>
6677
6678
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6679 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6680 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6681
6682
6683
6684 <!-- end of kind -->
6685 </tbody>
6686
6687 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6688 <tr><td colspan="6" id="section_lens" class="section">lens</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6689
6690
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6691 <tr><td colspan="6" class="kind">controls</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6692
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6693 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6694 <tr>
6695 <th class="th_name">Property Name</th>
6696 <th class="th_type">Type</th>
6697 <th class="th_description">Description</th>
6698 <th class="th_units">Units</th>
6699 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6700 <th class="th_tags">Tags</th>
6701 </tr>
6702 </thead>
6703
6704 <tbody>
6705
6706
6707
6708
6709
6710
6711
6712
6713
6714
6715 <tr class="entry" id="controls_android.lens.aperture">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6716 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6717 android.<wbr/>lens.<wbr/>aperture
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6718 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6719 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6720 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6721
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6722 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6723
6724
6725 </td> <!-- entry_type -->
6726
6727 <td class="entry_description">
Zhijun He1b58d382014-01-10 10:22:53 -0800[diff] [blame]6728 <p>The ratio of lens focal length to the effective
6729aperture diameter.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6730 </td>
6731
6732 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6733 f-number (f/<wbr/>NNN)
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6734 </td>
6735
6736 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]6737 <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]6738 </td>
6739
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6740 <td class="entry_tags">
6741 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6742 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6743 </ul>
6744 </td>
6745
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6746 </tr>
6747 <tr class="entries_header">
6748 <th class="th_details" colspan="5">Details</th>
6749 </tr>
6750 <tr class="entry_cont">
6751 <td class="entry_details" colspan="5">
Zhijun He1b58d382014-01-10 10:22:53 -0800[diff] [blame]6752 <p>This will only be supported on the camera devices that
6753have variable aperture lens.<wbr/> The aperture value can only be
6754one of the values listed in <a href="#static_android.lens.info.availableApertures">android.<wbr/>lens.<wbr/>info.<wbr/>available<wbr/>Apertures</a>.<wbr/></p>
6755<p>When this is supported and <a href="#controls_android.control.aeMode">android.<wbr/>control.<wbr/>ae<wbr/>Mode</a> is OFF,<wbr/>
6756this can be set along with <a href="#controls_android.sensor.exposureTime">android.<wbr/>sensor.<wbr/>exposure<wbr/>Time</a>,<wbr/>
6757<a href="#controls_android.sensor.sensitivity">android.<wbr/>sensor.<wbr/>sensitivity</a>,<wbr/> and android.<wbr/>sensor.<wbr/>frame<wbr/>Duration
6758to achieve manual exposure control.<wbr/></p>
6759<p>The requested aperture value may take several frames to reach the
6760requested value; the camera device will report the current (intermediate)
6761aperture size in capture result metadata while the aperture is changing.<wbr/></p>
6762<p>When this is supported and <a href="#controls_android.control.aeMode">android.<wbr/>control.<wbr/>ae<wbr/>Mode</a> is one of
6763the ON modes,<wbr/> this will be overridden by the camera device
6764auto-exposure algorithm,<wbr/> the overridden values are then provided
6765back to the user in the corresponding result.<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6766 </td>
6767 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6768
6769
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6770 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6771 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6772
6773
6774 <tr class="entry" id="controls_android.lens.filterDensity">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6775 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6776 android.<wbr/>lens.<wbr/>filter<wbr/>Density
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6777 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6778 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6779 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6780
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6781 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6782
6783
6784 </td> <!-- entry_type -->
6785
6786 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6787 <p>State of lens neutral density
6788filter(s)</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6789 </td>
6790
6791 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6792 number of stops of filtering
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6793 </td>
6794
6795 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]6796 <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]6797 </td>
6798
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6799 <td class="entry_tags">
6800 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6801 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6802 </ul>
6803 </td>
6804
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6805 </tr>
6806 <tr class="entries_header">
6807 <th class="th_details" colspan="5">Details</th>
6808 </tr>
6809 <tr class="entry_cont">
6810 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6811 <p>Will not be supported on most devices.<wbr/> Can only
6812pick from supported list</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6813 </td>
6814 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6815
6816
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6817 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6818 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6819
6820
6821 <tr class="entry" id="controls_android.lens.focalLength">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6822 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6823 android.<wbr/>lens.<wbr/>focal<wbr/>Length
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6824 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6825 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6826 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6827
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6828 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6829
6830
6831 </td> <!-- entry_type -->
6832
6833 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6834 <p>Lens optical zoom setting</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6835 </td>
6836
6837 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6838 focal length in mm
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6839 </td>
6840
6841 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame]6842 <p>&gt; 0</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6843 </td>
6844
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6845 <td class="entry_tags">
6846 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6847 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6848 </ul>
6849 </td>
6850
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6851 </tr>
6852 <tr class="entries_header">
6853 <th class="th_details" colspan="5">Details</th>
6854 </tr>
6855 <tr class="entry_cont">
6856 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6857 <p>Will not be supported on most devices.<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6858 </td>
6859 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6860
6861
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6862 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6863 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6864
6865
6866 <tr class="entry" id="controls_android.lens.focusDistance">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6867 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6868 android.<wbr/>lens.<wbr/>focus<wbr/>Distance
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6869 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6870 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6871 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6872
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6873 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6874
6875
6876 </td> <!-- entry_type -->
6877
6878 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6879 <p>Distance to plane of sharpest focus,<wbr/>
6880measured from frontmost surface of the lens</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6881 </td>
6882
6883 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6884 diopters (1/<wbr/>m)
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6885 </td>
6886
6887 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame]6888 <p>&gt;= 0</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6889 </td>
6890
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6891 <td class="entry_tags">
6892 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6893 <li><a href="#tag_BC">BC</a></li>
6894 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6895 </ul>
6896 </td>
6897
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6898 </tr>
6899 <tr class="entries_header">
6900 <th class="th_details" colspan="5">Details</th>
6901 </tr>
6902 <tr class="entry_cont">
6903 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6904 <p>0 = infinity focus.<wbr/> Used value should be clamped
6905to (0,<wbr/>minimum focus distance)</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6906 </td>
6907 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6908
6909
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6910 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6911 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6912
6913
6914 <tr class="entry" id="controls_android.lens.opticalStabilizationMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6915 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6916 android.<wbr/>lens.<wbr/>optical<wbr/>Stabilization<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6917 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6918 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6919 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6920
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6921 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6922
6923 <ul class="entry_type_enum">
6924 <li>
6925 <span class="entry_type_enum_name">OFF</span>
6926 </li>
6927 <li>
6928 <span class="entry_type_enum_name">ON</span>
6929 <span class="entry_type_enum_optional">optional</span>
6930 </li>
6931 </ul>
6932
6933 </td> <!-- entry_type -->
6934
6935 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6936 <p>Whether optical image stabilization is
6937enabled.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6938 </td>
6939
6940 <td class="entry_units">
6941 </td>
6942
6943 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]6944 <p>android.<wbr/>lens.<wbr/>available<wbr/>Optical<wbr/>Stabilization</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6945 </td>
6946
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6947 <td class="entry_tags">
6948 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6949 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6950 </ul>
6951 </td>
6952
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6953 </tr>
6954 <tr class="entries_header">
6955 <th class="th_details" colspan="5">Details</th>
6956 </tr>
6957 <tr class="entry_cont">
6958 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6959 <p>Will not be supported on most devices.<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6960 </td>
6961 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6962
6963
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6964 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6965 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6966
6967
6968
6969 <!-- end of kind -->
6970 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6971 <tr><td colspan="6" class="kind">static</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6972
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6973 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6974 <tr>
6975 <th class="th_name">Property Name</th>
6976 <th class="th_type">Type</th>
6977 <th class="th_description">Description</th>
6978 <th class="th_units">Units</th>
6979 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6980 <th class="th_tags">Tags</th>
6981 </tr>
6982 </thead>
6983
6984 <tbody>
6985
6986
6987
6988
6989
6990
6991
6992
6993
6994
6995
6996
6997 <tr class="entry" id="static_android.lens.info.availableApertures">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6998 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6999 android.<wbr/>lens.<wbr/>info.<wbr/>available<wbr/>Apertures
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7000 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7001 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7002 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7003 <span class="entry_type_container">x</span>
7004
7005 <span class="entry_type_array">
7006 n
7007 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7008 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7009
7010
7011 </td> <!-- entry_type -->
7012
7013 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7014 <p>List of supported aperture
Zhijun He1b58d382014-01-10 10:22:53 -0800[diff] [blame]7015values.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7016 </td>
7017
7018 <td class="entry_units">
7019 </td>
7020
7021 <td class="entry_range">
Zhijun He1b58d382014-01-10 10:22:53 -0800[diff] [blame]7022 <p>one entry required,<wbr/> &amp;&gt; 0</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7023 </td>
7024
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7025 <td class="entry_tags">
7026 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]7027 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7028 </ul>
7029 </td>
7030
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7031 </tr>
7032 <tr class="entries_header">
7033 <th class="th_details" colspan="5">Details</th>
7034 </tr>
7035 <tr class="entry_cont">
7036 <td class="entry_details" colspan="5">
Zhijun He1b58d382014-01-10 10:22:53 -0800[diff] [blame]7037 <p>If the camera device doesn't support variable apertures,<wbr/>
7038listed value will be the fixed aperture.<wbr/></p>
7039<p>If the camera device supports variable apertures,<wbr/> the aperture value
7040in this list will be sorted in ascending order.<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7041 </td>
7042 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7043
7044
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7045 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7046 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7047
7048
7049 <tr class="entry" id="static_android.lens.info.availableFilterDensities">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7050 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7051 android.<wbr/>lens.<wbr/>info.<wbr/>available<wbr/>Filter<wbr/>Densities
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7052 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7053 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7054 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7055 <span class="entry_type_container">x</span>
7056
7057 <span class="entry_type_array">
7058 n
7059 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7060 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7061
7062
7063 </td> <!-- entry_type -->
7064
7065 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7066 <p>List of supported ND filter
7067values</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7068 </td>
7069
7070 <td class="entry_units">
7071 </td>
7072
7073 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]7074 <p>one entry required,<wbr/> &gt;= 0</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7075 </td>
7076
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7077 <td class="entry_tags">
7078 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]7079 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7080 </ul>
7081 </td>
7082
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7083 </tr>
7084 <tr class="entries_header">
7085 <th class="th_details" colspan="5">Details</th>
7086 </tr>
7087 <tr class="entry_cont">
7088 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7089 <p>If not available,<wbr/> only setting is 0.<wbr/> Otherwise,<wbr/>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7090lists the available exposure index values for dimming
7091(2 would mean the filter is set to reduce incoming
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7092light by two stops)</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7093 </td>
7094 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7095
7096
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7097 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7098 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7099
7100
7101 <tr class="entry" id="static_android.lens.info.availableFocalLengths">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7102 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7103 android.<wbr/>lens.<wbr/>info.<wbr/>available<wbr/>Focal<wbr/>Lengths
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7104 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7105 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7106 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7107 <span class="entry_type_container">x</span>
7108
7109 <span class="entry_type_array">
7110 n
7111 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7112 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7113 <div class="entry_type_notes">the list of available focal lengths</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7114
7115
7116 </td> <!-- entry_type -->
7117
7118 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7119 <p>If fitted with optical zoom,<wbr/> what focal
7120lengths are available.<wbr/> If not,<wbr/> the static focal
7121length</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7122 </td>
7123
7124 <td class="entry_units">
7125 </td>
7126
7127 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame]7128 <p>&gt; 0</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7129 </td>
7130
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7131 <td class="entry_tags">
7132 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]7133 <li><a href="#tag_BC">BC</a></li>
7134 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7135 </ul>
7136 </td>
7137
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7138 </tr>
7139 <tr class="entries_header">
7140 <th class="th_details" colspan="5">Details</th>
7141 </tr>
7142 <tr class="entry_cont">
7143 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7144 <p>If optical zoom not supported,<wbr/> only one value
7145should be reported</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7146 </td>
7147 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7148
7149
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7150 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7151 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7152
7153
7154 <tr class="entry" id="static_android.lens.info.availableOpticalStabilization">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7155 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7156 android.<wbr/>lens.<wbr/>info.<wbr/>available<wbr/>Optical<wbr/>Stabilization
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7157 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7158 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7159 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7160 <span class="entry_type_container">x</span>
7161
7162 <span class="entry_type_array">
7163 n
7164 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7165 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7166 <div class="entry_type_notes">list of enums</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7167
7168
7169 </td> <!-- entry_type -->
7170
7171 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7172 <p>List of supported optical image
7173stabilization modes</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7174 </td>
7175
7176 <td class="entry_units">
7177 </td>
7178
7179 <td class="entry_range">
7180 </td>
7181
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7182 <td class="entry_tags">
7183 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]7184 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7185 </ul>
7186 </td>
7187
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7188 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7189
7190
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7191 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7192 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7193
7194
7195 <tr class="entry" id="static_android.lens.info.geometricCorrectionMap">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7196 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7197 android.<wbr/>lens.<wbr/>info.<wbr/>geometric<wbr/>Correction<wbr/>Map
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7198 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7199 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7200 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7201 <span class="entry_type_container">x</span>
7202
7203 <span class="entry_type_array">
7204 2 x 3 x n x m
7205 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7206 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7207 <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]7208
7209
7210 </td> <!-- entry_type -->
7211
7212 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7213 <p>A low-resolution map for correction of
7214geometric distortions and chromatic aberrations,<wbr/> per
7215color channel</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7216 </td>
7217
7218 <td class="entry_units">
7219 </td>
7220
7221 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]7222 <p>N,<wbr/> M &gt;= 2</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7223 </td>
7224
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7225 <td class="entry_tags">
7226 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]7227 <li><a href="#tag_DNG">DNG</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7228 </ul>
7229 </td>
7230
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7231 </tr>
7232 <tr class="entries_header">
7233 <th class="th_details" colspan="5">Details</th>
7234 </tr>
7235 <tr class="entry_cont">
7236 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7237 <p>[DNG wants a function instead].<wbr/> What's easiest
7238for implementers? With an array size (M,<wbr/> N),<wbr/> entry (i,<wbr/>
7239j) provides the destination for pixel (i/<wbr/>(M-1) * width,<wbr/>
7240j/<wbr/>(N-1) * height).<wbr/> Data is row-major,<wbr/> with each array
7241entry 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]7242 </td>
7243 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7244
7245
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7246 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7247 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7248
7249
7250 <tr class="entry" id="static_android.lens.info.geometricCorrectionMapSize">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7251 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7252 android.<wbr/>lens.<wbr/>info.<wbr/>geometric<wbr/>Correction<wbr/>Map<wbr/>Size
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7253 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7254 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7255 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7256 <span class="entry_type_container">x</span>
7257
7258 <span class="entry_type_array">
7259 2
7260 </span>
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]7261 <span class="entry_type_visibility"> [system as size]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7262 <div class="entry_type_notes">width and height of geometric correction map</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7263
7264
7265 </td> <!-- entry_type -->
7266
7267 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7268 <p>Dimensions of geometric correction
7269map</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7270 </td>
7271
7272 <td class="entry_units">
7273 </td>
7274
7275 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]7276 <p>Both values &gt;= 2</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7277 </td>
7278
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7279 <td class="entry_tags">
7280 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]7281 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7282 </ul>
7283 </td>
7284
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7285 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7286
7287
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7288 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7289 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7290
7291
7292 <tr class="entry" id="static_android.lens.info.hyperfocalDistance">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7293 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7294 android.<wbr/>lens.<wbr/>info.<wbr/>hyperfocal<wbr/>Distance
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7295 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7296 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7297 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7298
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7299 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7300
7301
7302 </td> <!-- entry_type -->
7303
7304 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7305 <p>Hyperfocal distance for this lens; set to
73060 if fixed focus</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7307 </td>
7308
7309 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7310 diopters
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7311 </td>
7312
7313 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame]7314 <p>&gt;= 0</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7315 </td>
7316
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7317 <td class="entry_tags">
7318 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]7319 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7320 </ul>
7321 </td>
7322
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7323 </tr>
7324 <tr class="entries_header">
7325 <th class="th_details" colspan="5">Details</th>
7326 </tr>
7327 <tr class="entry_cont">
7328 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7329 <p>The hyperfocal distance is used for the old
7330API's 'fixed' setting</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7331 </td>
7332 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7333
7334
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7335 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7336 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7337
7338
7339 <tr class="entry" id="static_android.lens.info.minimumFocusDistance">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7340 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7341 android.<wbr/>lens.<wbr/>info.<wbr/>minimum<wbr/>Focus<wbr/>Distance
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7342 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7343 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7344 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7345
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7346 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7347
7348
7349 </td> <!-- entry_type -->
7350
7351 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7352 <p>Shortest distance from frontmost surface
7353of the lens that can be focused correctly</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7354 </td>
7355
7356 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7357 diopters
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7358 </td>
7359
7360 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame]7361 <p>&gt;= 0</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7362 </td>
7363
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7364 <td class="entry_tags">
7365 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]7366 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7367 </ul>
7368 </td>
7369
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7370 </tr>
7371 <tr class="entries_header">
7372 <th class="th_details" colspan="5">Details</th>
7373 </tr>
7374 <tr class="entry_cont">
7375 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7376 <p>If the lens is fixed-focus,<wbr/> this should be
73770</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7378 </td>
7379 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7380
7381
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7382 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7383 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7384
7385
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7386 <tr class="entry" id="static_android.lens.info.shadingMapSize">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7387 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7388 android.<wbr/>lens.<wbr/>info.<wbr/>shading<wbr/>Map<wbr/>Size
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7389 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7390 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7391 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7392 <span class="entry_type_container">x</span>
7393
7394 <span class="entry_type_array">
7395 2
7396 </span>
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]7397 <span class="entry_type_visibility"> [public as size]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7398 <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]7399
7400
7401 </td> <!-- entry_type -->
7402
7403 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7404 <p>Dimensions of lens shading map.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7405 </td>
7406
7407 <td class="entry_units">
7408 </td>
7409
7410 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]7411 <p>Both values &gt;= 1</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7412 </td>
7413
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7414 <td class="entry_tags">
7415 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]7416 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7417 </ul>
7418 </td>
7419
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7420 </tr>
7421 <tr class="entries_header">
7422 <th class="th_details" colspan="5">Details</th>
7423 </tr>
7424 <tr class="entry_cont">
7425 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7426 <p>The map should be on the order of 30-40 rows and columns,<wbr/> and
7427must be smaller than 64x64.<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7428 </td>
7429 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7430
7431
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7432 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7433 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7434
7435
7436
7437
7438
7439 <tr class="entry" id="static_android.lens.facing">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7440 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7441 android.<wbr/>lens.<wbr/>facing
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7442 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7443 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7444 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7445
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7446 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7447
7448 <ul class="entry_type_enum">
7449 <li>
7450 <span class="entry_type_enum_name">FRONT</span>
7451 </li>
7452 <li>
7453 <span class="entry_type_enum_name">BACK</span>
7454 </li>
7455 </ul>
7456
7457 </td> <!-- entry_type -->
7458
7459 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7460 <p>Direction the camera faces relative to
7461device screen</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7462 </td>
7463
7464 <td class="entry_units">
7465 </td>
7466
7467 <td class="entry_range">
7468 </td>
7469
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7470 <td class="entry_tags">
7471 </td>
7472
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7473 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7474
7475
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7476 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7477 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7478
7479
7480 <tr class="entry" id="static_android.lens.opticalAxisAngle">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7481 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7482 android.<wbr/>lens.<wbr/>optical<wbr/>Axis<wbr/>Angle
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7483 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7484 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7485 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7486 <span class="entry_type_container">x</span>
7487
7488 <span class="entry_type_array">
7489 2
7490 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7491 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7492 <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]7493
7494
7495 </td> <!-- entry_type -->
7496
7497 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7498 <p>Relative angle of camera optical axis to the
7499perpendicular axis from the display</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7500 </td>
7501
7502 <td class="entry_units">
7503 </td>
7504
7505 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]7506 <p>[0-90) for first angle,<wbr/> [0-360) for second</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7507 </td>
7508
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7509 <td class="entry_tags">
7510 <ul class="entry_tags">
7511 <li><a href="#tag_ADV">ADV</a></li>
7512 </ul>
7513 </td>
7514
7515 </tr>
7516 <tr class="entries_header">
7517 <th class="th_details" colspan="5">Details</th>
7518 </tr>
7519 <tr class="entry_cont">
7520 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7521 <p>Examples:</p>
7522<p>(0,<wbr/>0) means that the camera optical axis
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]7523is perpendicular to the display surface;</p>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7524<p>(45,<wbr/>0) means that the camera points 45 degrees up when
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]7525device is held upright;</p>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7526<p>(45,<wbr/>90) means the camera points 45 degrees to the right when
7527the device is held upright.<wbr/></p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]7528<p>Use FACING field to determine perpendicular outgoing
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7529direction</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7530 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7531 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7532
7533
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7534 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7535 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7536
7537
7538 <tr class="entry" id="static_android.lens.position">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7539 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7540 android.<wbr/>lens.<wbr/>position
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7541 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7542 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7543 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7544 <span class="entry_type_container">x</span>
7545
7546 <span class="entry_type_array">
7547 3, location in mm, in the sensor coordinate
7548 system
7549 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7550 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7551
7552
7553 </td> <!-- entry_type -->
7554
7555 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7556 <p>Coordinates of camera optical axis on
7557device</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7558 </td>
7559
7560 <td class="entry_units">
7561 </td>
7562
7563 <td class="entry_range">
7564 </td>
7565
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7566 <td class="entry_tags">
7567 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]7568 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7569 </ul>
7570 </td>
7571
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7572 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7573
7574
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7575 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7576 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7577
7578
7579
7580 <!-- end of kind -->
7581 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7582 <tr><td colspan="6" class="kind">dynamic</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7583
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7584 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7585 <tr>
7586 <th class="th_name">Property Name</th>
7587 <th class="th_type">Type</th>
7588 <th class="th_description">Description</th>
7589 <th class="th_units">Units</th>
7590 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7591 <th class="th_tags">Tags</th>
7592 </tr>
7593 </thead>
7594
7595 <tbody>
7596
7597
7598
7599
7600
7601
7602
7603
7604
7605
7606 <tr class="entry" id="dynamic_android.lens.aperture">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7607 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7608 android.<wbr/>lens.<wbr/>aperture
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7609 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7610 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7611 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7612
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7613 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7614
7615
7616 </td> <!-- entry_type -->
7617
7618 <td class="entry_description">
Zhijun He1b58d382014-01-10 10:22:53 -0800[diff] [blame]7619 <p>The ratio of lens focal length to the effective
7620aperture diameter.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7621 </td>
7622
7623 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7624 f-number (f/<wbr/>NNN)
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7625 </td>
7626
7627 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]7628 <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]7629 </td>
7630
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7631 <td class="entry_tags">
7632 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]7633 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7634 </ul>
7635 </td>
7636
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7637 </tr>
7638 <tr class="entries_header">
7639 <th class="th_details" colspan="5">Details</th>
7640 </tr>
7641 <tr class="entry_cont">
7642 <td class="entry_details" colspan="5">
Zhijun He1b58d382014-01-10 10:22:53 -0800[diff] [blame]7643 <p>This will only be supported on the camera devices that
7644have variable aperture lens.<wbr/> The aperture value can only be
7645one of the values listed in <a href="#static_android.lens.info.availableApertures">android.<wbr/>lens.<wbr/>info.<wbr/>available<wbr/>Apertures</a>.<wbr/></p>
7646<p>When this is supported and <a href="#controls_android.control.aeMode">android.<wbr/>control.<wbr/>ae<wbr/>Mode</a> is OFF,<wbr/>
7647this can be set along with <a href="#controls_android.sensor.exposureTime">android.<wbr/>sensor.<wbr/>exposure<wbr/>Time</a>,<wbr/>
7648<a href="#controls_android.sensor.sensitivity">android.<wbr/>sensor.<wbr/>sensitivity</a>,<wbr/> and android.<wbr/>sensor.<wbr/>frame<wbr/>Duration
7649to achieve manual exposure control.<wbr/></p>
7650<p>The requested aperture value may take several frames to reach the
7651requested value; the camera device will report the current (intermediate)
7652aperture size in capture result metadata while the aperture is changing.<wbr/></p>
7653<p>When this is supported and <a href="#controls_android.control.aeMode">android.<wbr/>control.<wbr/>ae<wbr/>Mode</a> is one of
7654the ON modes,<wbr/> this will be overridden by the camera device
7655auto-exposure algorithm,<wbr/> the overridden values are then provided
7656back to the user in the corresponding result.<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7657 </td>
7658 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7659
7660
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7661 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7662 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7663
7664
7665 <tr class="entry" id="dynamic_android.lens.filterDensity">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7666 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7667 android.<wbr/>lens.<wbr/>filter<wbr/>Density
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7668 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7669 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7670 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7671
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7672 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7673
7674
7675 </td> <!-- entry_type -->
7676
7677 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7678 <p>State of lens neutral density
7679filter(s)</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7680 </td>
7681
7682 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7683 number of stops of filtering
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7684 </td>
7685
7686 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]7687 <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]7688 </td>
7689
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7690 <td class="entry_tags">
7691 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]7692 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7693 </ul>
7694 </td>
7695
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7696 </tr>
7697 <tr class="entries_header">
7698 <th class="th_details" colspan="5">Details</th>
7699 </tr>
7700 <tr class="entry_cont">
7701 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7702 <p>Will not be supported on most devices.<wbr/> Can only
7703pick from supported list</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7704 </td>
7705 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7706
7707
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7708 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7709 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7710
7711
7712 <tr class="entry" id="dynamic_android.lens.focalLength">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7713 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7714 android.<wbr/>lens.<wbr/>focal<wbr/>Length
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7715 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7716 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7717 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7718
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7719 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7720
7721
7722 </td> <!-- entry_type -->
7723
7724 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7725 <p>Lens optical zoom setting</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7726 </td>
7727
7728 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7729 focal length in mm
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7730 </td>
7731
7732 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame]7733 <p>&gt; 0</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7734 </td>
7735
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7736 <td class="entry_tags">
7737 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]7738 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7739 </ul>
7740 </td>
7741
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7742 </tr>
7743 <tr class="entries_header">
7744 <th class="th_details" colspan="5">Details</th>
7745 </tr>
7746 <tr class="entry_cont">
7747 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7748 <p>Will not be supported on most devices.<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7749 </td>
7750 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7751
7752
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7753 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7754 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7755
7756
7757 <tr class="entry" id="dynamic_android.lens.focusDistance">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7758 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7759 android.<wbr/>lens.<wbr/>focus<wbr/>Distance
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7760 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7761 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7762 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7763
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7764 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7765
7766
7767 </td> <!-- entry_type -->
7768
7769 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7770 <p>Distance to plane of sharpest focus,<wbr/>
7771measured from frontmost surface of the lens</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7772 </td>
7773
7774 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7775 diopters (1/<wbr/>m)
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7776 </td>
7777
7778 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame]7779 <p>&gt;= 0</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7780 </td>
7781
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7782 <td class="entry_tags">
7783 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]7784 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7785 </ul>
7786 </td>
7787
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7788 </tr>
7789 <tr class="entries_header">
7790 <th class="th_details" colspan="5">Details</th>
7791 </tr>
7792 <tr class="entry_cont">
7793 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7794 <p>Should be zero for fixed-focus cameras</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7795 </td>
7796 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7797
7798
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7799 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7800 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7801
7802
7803 <tr class="entry" id="dynamic_android.lens.focusRange">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7804 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7805 android.<wbr/>lens.<wbr/>focus<wbr/>Range
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7806 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7807 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7808 <span class="entry_type_name">float</span>
Zhijun He50451ad2013-09-26 10:27:47 -0700[diff] [blame]7809 <span class="entry_type_container">x</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7810
Zhijun He50451ad2013-09-26 10:27:47 -0700[diff] [blame]7811 <span class="entry_type_array">
7812 2
7813 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7814 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7815 <div class="entry_type_notes">Range of scene distances that are in focus</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7816
7817
7818 </td> <!-- entry_type -->
7819
7820 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7821 <p>The range of scene distances that are in
7822sharp focus (depth of field)</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7823 </td>
7824
7825 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7826 pair of focus distances in diopters: (near,<wbr/>
7827 far)
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7828 </td>
7829
7830 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame]7831 <p>&gt;=0</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7832 </td>
7833
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7834 <td class="entry_tags">
7835 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]7836 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7837 </ul>
7838 </td>
7839
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7840 </tr>
7841 <tr class="entries_header">
7842 <th class="th_details" colspan="5">Details</th>
7843 </tr>
7844 <tr class="entry_cont">
7845 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7846 <p>If variable focus not supported,<wbr/> can still report
7847fixed depth of field range</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7848 </td>
7849 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7850
7851
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7852 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7853 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7854
7855
7856 <tr class="entry" id="dynamic_android.lens.opticalStabilizationMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7857 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7858 android.<wbr/>lens.<wbr/>optical<wbr/>Stabilization<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7859 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7860 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7861 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7862
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7863 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7864
7865 <ul class="entry_type_enum">
7866 <li>
7867 <span class="entry_type_enum_name">OFF</span>
7868 </li>
7869 <li>
7870 <span class="entry_type_enum_name">ON</span>
7871 <span class="entry_type_enum_optional">optional</span>
7872 </li>
7873 </ul>
7874
7875 </td> <!-- entry_type -->
7876
7877 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7878 <p>Whether optical image stabilization is
7879enabled.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7880 </td>
7881
7882 <td class="entry_units">
7883 </td>
7884
7885 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]7886 <p>android.<wbr/>lens.<wbr/>available<wbr/>Optical<wbr/>Stabilization</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7887 </td>
7888
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7889 <td class="entry_tags">
7890 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]7891 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7892 </ul>
7893 </td>
7894
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7895 </tr>
7896 <tr class="entries_header">
7897 <th class="th_details" colspan="5">Details</th>
7898 </tr>
7899 <tr class="entry_cont">
7900 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7901 <p>Will not be supported on most devices.<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7902 </td>
7903 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7904
7905
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7906 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7907 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7908
7909
7910 <tr class="entry" id="dynamic_android.lens.state">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7911 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7912 android.<wbr/>lens.<wbr/>state
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7913 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7914 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7915 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7916
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7917 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7918
7919 <ul class="entry_type_enum">
7920 <li>
7921 <span class="entry_type_enum_name">STATIONARY</span>
7922 </li>
Igor Murashkin0e323a12013-09-06 11:50:48 -0700[diff] [blame]7923 <li>
7924 <span class="entry_type_enum_name">MOVING</span>
7925 </li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7926 </ul>
7927
7928 </td> <!-- entry_type -->
7929
7930 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7931 <p>Current lens status</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7932 </td>
7933
7934 <td class="entry_units">
7935 </td>
7936
7937 <td class="entry_range">
7938 </td>
7939
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7940 <td class="entry_tags">
7941 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]7942 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7943 </ul>
7944 </td>
7945
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7946 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7947
7948
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7949 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7950 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7951
7952
7953
7954 <!-- end of kind -->
7955 </tbody>
7956
7957 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7958 <tr><td colspan="6" id="section_noiseReduction" class="section">noiseReduction</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7959
7960
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7961 <tr><td colspan="6" class="kind">controls</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7962
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7963 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7964 <tr>
7965 <th class="th_name">Property Name</th>
7966 <th class="th_type">Type</th>
7967 <th class="th_description">Description</th>
7968 <th class="th_units">Units</th>
7969 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7970 <th class="th_tags">Tags</th>
7971 </tr>
7972 </thead>
7973
7974 <tbody>
7975
7976
7977
7978
7979
7980
7981
7982
7983
7984
7985 <tr class="entry" id="controls_android.noiseReduction.mode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7986 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7987 android.<wbr/>noise<wbr/>Reduction.<wbr/>mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7988 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7989 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7990 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7991
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7992 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7993
7994 <ul class="entry_type_enum">
7995 <li>
7996 <span class="entry_type_enum_name">OFF</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]7997 <span class="entry_type_enum_notes"><p>No noise reduction is applied</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7998 </li>
7999 <li>
8000 <span class="entry_type_enum_name">FAST</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]8001 <span class="entry_type_enum_notes"><p>Must not slow down frame rate relative to sensor
8002output</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8003 </li>
8004 <li>
8005 <span class="entry_type_enum_name">HIGH_QUALITY</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]8006 <span class="entry_type_enum_notes"><p>May slow down frame rate to provide highest
8007quality</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8008 </li>
8009 </ul>
8010
8011 </td> <!-- entry_type -->
8012
8013 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8014 <p>Mode of operation for the noise reduction
8015algorithm</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8016 </td>
8017
8018 <td class="entry_units">
8019 </td>
8020
8021 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]8022 <p>android.<wbr/>noise<wbr/>Reduction.<wbr/>available<wbr/>Modes</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8023 </td>
8024
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8025 <td class="entry_tags">
8026 <ul class="entry_tags">
8027 <li><a href="#tag_V1">V1</a></li>
8028 </ul>
8029 </td>
8030
8031 </tr>
8032 <tr class="entries_header">
8033 <th class="th_details" colspan="5">Details</th>
8034 </tr>
8035 <tr class="entry_cont">
8036 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8037 <p>Noise filtering control.<wbr/> OFF means no noise reduction
8038will be applied by the HAL.<wbr/></p>
Zhijun Hef90eeaf2014-01-16 12:13:35 -0800[diff] [blame]8039<p>FAST/<wbr/>HIGH_<wbr/>QUALITY both mean camera device determined noise filtering
8040will be applied.<wbr/> HIGH_<wbr/>QUALITY mode indicates that the camera device
8041will use the highest-quality noise filtering algorithms,<wbr/>
8042even if it slows down capture rate.<wbr/> FAST means the camera device should not
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8043slow down capture rate when applying noise filtering.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8044 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8045 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8046
8047
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8048 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8049 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8050
8051
8052 <tr class="entry" id="controls_android.noiseReduction.strength">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8053 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8054 android.<wbr/>noise<wbr/>Reduction.<wbr/>strength
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8055 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8056 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8057 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8058
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8059 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8060
8061
8062 </td> <!-- entry_type -->
8063
8064 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8065 <p>Control the amount of noise reduction
8066applied to the images</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8067 </td>
8068
8069 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8070 1-10; 10 is max noise reduction
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8071 </td>
8072
8073 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]8074 <p>1 - 10</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8075 </td>
8076
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8077 <td class="entry_tags">
8078 </td>
8079
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8080 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8081
8082
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8083 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8084 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8085
8086
8087
8088 <!-- end of kind -->
8089 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8090 <tr><td colspan="6" class="kind">dynamic</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8091
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8092 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8093 <tr>
8094 <th class="th_name">Property Name</th>
8095 <th class="th_type">Type</th>
8096 <th class="th_description">Description</th>
8097 <th class="th_units">Units</th>
8098 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8099 <th class="th_tags">Tags</th>
8100 </tr>
8101 </thead>
8102
8103 <tbody>
8104
8105
8106
8107
8108
8109
8110
8111
8112
8113
8114 <tr class="entry" id="dynamic_android.noiseReduction.mode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8115 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8116 android.<wbr/>noise<wbr/>Reduction.<wbr/>mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8117 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8118 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8119 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8120
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8121 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8122
8123 <ul class="entry_type_enum">
8124 <li>
8125 <span class="entry_type_enum_name">OFF</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]8126 <span class="entry_type_enum_notes"><p>No noise reduction is applied</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8127 </li>
8128 <li>
8129 <span class="entry_type_enum_name">FAST</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]8130 <span class="entry_type_enum_notes"><p>Must not slow down frame rate relative to sensor
8131output</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8132 </li>
8133 <li>
8134 <span class="entry_type_enum_name">HIGH_QUALITY</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]8135 <span class="entry_type_enum_notes"><p>May slow down frame rate to provide highest
8136quality</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8137 </li>
8138 </ul>
8139
8140 </td> <!-- entry_type -->
8141
8142 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8143 <p>Mode of operation for the noise reduction
8144algorithm</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8145 </td>
8146
8147 <td class="entry_units">
8148 </td>
8149
8150 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]8151 <p>android.<wbr/>noise<wbr/>Reduction.<wbr/>available<wbr/>Modes</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8152 </td>
8153
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8154 <td class="entry_tags">
8155 <ul class="entry_tags">
8156 <li><a href="#tag_V1">V1</a></li>
8157 </ul>
8158 </td>
8159
8160 </tr>
8161 <tr class="entries_header">
8162 <th class="th_details" colspan="5">Details</th>
8163 </tr>
8164 <tr class="entry_cont">
8165 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8166 <p>Noise filtering control.<wbr/> OFF means no noise reduction
8167will be applied by the HAL.<wbr/></p>
Zhijun Hef90eeaf2014-01-16 12:13:35 -0800[diff] [blame]8168<p>FAST/<wbr/>HIGH_<wbr/>QUALITY both mean camera device determined noise filtering
8169will be applied.<wbr/> HIGH_<wbr/>QUALITY mode indicates that the camera device
8170will use the highest-quality noise filtering algorithms,<wbr/>
8171even if it slows down capture rate.<wbr/> FAST means the camera device should not
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8172slow down capture rate when applying noise filtering.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8173 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8174 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8175
8176
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8177 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8178 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8179
8180
8181
8182 <!-- end of kind -->
8183 </tbody>
8184
8185 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8186 <tr><td colspan="6" id="section_quirks" class="section">quirks</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8187
8188
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8189 <tr><td colspan="6" class="kind">static</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8190
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8191 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8192 <tr>
8193 <th class="th_name">Property Name</th>
8194 <th class="th_type">Type</th>
8195 <th class="th_description">Description</th>
8196 <th class="th_units">Units</th>
8197 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8198 <th class="th_tags">Tags</th>
8199 </tr>
8200 </thead>
8201
8202 <tbody>
8203
8204
8205
8206
8207
8208
8209
8210
8211
8212
8213 <tr class="entry" id="static_android.quirks.meteringCropRegion">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8214 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8215 android.<wbr/>quirks.<wbr/>metering<wbr/>Crop<wbr/>Region
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8216 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8217 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8218 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8219
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8220 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8221
8222
8223 </td> <!-- entry_type -->
8224
8225 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8226 <p>If set to 1,<wbr/> the camera service does not
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]8227scale 'normalized' coordinates with respect to the crop
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8228region.<wbr/> This applies to metering input (a{e,<wbr/>f,<wbr/>wb}Region
8229and output (face rectangles).<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8230 </td>
8231
8232 <td class="entry_units">
8233 </td>
8234
8235 <td class="entry_range">
8236 </td>
8237
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8238 <td class="entry_tags">
8239 </td>
8240
8241 </tr>
8242 <tr class="entries_header">
8243 <th class="th_details" colspan="5">Details</th>
8244 </tr>
8245 <tr class="entry_cont">
8246 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8247 <p>Normalized coordinates refer to those in the
8248(-1000,<wbr/>1000) range mentioned in the
8249android.<wbr/>hardware.<wbr/>Camera API.<wbr/></p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]8250<p>HAL implementations should instead always use and emit
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8251sensor array-relative coordinates for all region data.<wbr/> Does
8252not need to be listed in static metadata.<wbr/> Support will be
8253removed in future versions of camera service.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8254 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8255 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8256
8257
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8258 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8259 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8260
8261
8262 <tr class="entry" id="static_android.quirks.triggerAfWithAuto">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8263 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8264 android.<wbr/>quirks.<wbr/>trigger<wbr/>Af<wbr/>With<wbr/>Auto
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8265 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8266 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8267 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8268
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8269 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8270
8271
8272 </td> <!-- entry_type -->
8273
8274 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8275 <p>If set to 1,<wbr/> then the camera service always
8276switches to FOCUS_<wbr/>MODE_<wbr/>AUTO before issuing a AF
8277trigger.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8278 </td>
8279
8280 <td class="entry_units">
8281 </td>
8282
8283 <td class="entry_range">
8284 </td>
8285
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8286 <td class="entry_tags">
8287 </td>
8288
8289 </tr>
8290 <tr class="entries_header">
8291 <th class="th_details" colspan="5">Details</th>
8292 </tr>
8293 <tr class="entry_cont">
8294 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8295 <p>HAL implementations should implement AF trigger
8296modes for AUTO,<wbr/> MACRO,<wbr/> CONTINUOUS_<wbr/>FOCUS,<wbr/> and
8297CONTINUOUS_<wbr/>PICTURE modes instead of using this flag.<wbr/> Does
8298not need to be listed in static metadata.<wbr/> Support will be
8299removed in future versions of camera service</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8300 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8301 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8302
8303
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8304 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8305 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8306
8307
8308 <tr class="entry" id="static_android.quirks.useZslFormat">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8309 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8310 android.<wbr/>quirks.<wbr/>use<wbr/>Zsl<wbr/>Format
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8311 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8312 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8313 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8314
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8315 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8316
8317
8318 </td> <!-- entry_type -->
8319
8320 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8321 <p>If set to 1,<wbr/> the camera service uses
8322CAMERA2_<wbr/>PIXEL_<wbr/>FORMAT_<wbr/>ZSL instead of
8323HAL_<wbr/>PIXEL_<wbr/>FORMAT_<wbr/>IMPLEMENTATION_<wbr/>DEFINED for the zero
8324shutter lag stream</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8325 </td>
8326
8327 <td class="entry_units">
8328 </td>
8329
8330 <td class="entry_range">
8331 </td>
8332
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8333 <td class="entry_tags">
8334 </td>
8335
8336 </tr>
8337 <tr class="entries_header">
8338 <th class="th_details" colspan="5">Details</th>
8339 </tr>
8340 <tr class="entry_cont">
8341 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8342 <p>HAL implementations should use gralloc usage flags
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]8343to determine that a stream will be used for
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8344zero-shutter-lag,<wbr/> instead of relying on an explicit
8345format setting.<wbr/> Does not need to be listed in static
8346metadata.<wbr/> Support will be removed in future versions of
8347camera service.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8348 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8349 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8350
8351
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8352 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8353 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8354
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]8355
8356 <tr class="entry" id="static_android.quirks.usePartialResult">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8357 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8358 android.<wbr/>quirks.<wbr/>use<wbr/>Partial<wbr/>Result
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8359 </td>
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]8360 <td class="entry_type">
8361 <span class="entry_type_name">byte</span>
8362
Eino-Ville Talvala52a64a52013-11-07 14:43:43 -0800[diff] [blame]8363 <span class="entry_type_visibility"> [hidden]</span>
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]8364
8365
8366 </td> <!-- entry_type -->
8367
8368 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8369 <p>If set to 1,<wbr/> the HAL will always split result
8370metadata for a single capture into multiple buffers,<wbr/>
8371returned using multiple process_<wbr/>capture_<wbr/>result calls.<wbr/></p>
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]8372 </td>
8373
8374 <td class="entry_units">
8375 </td>
8376
8377 <td class="entry_range">
8378 </td>
8379
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8380 <td class="entry_tags">
8381 </td>
8382
8383 </tr>
8384 <tr class="entries_header">
8385 <th class="th_details" colspan="5">Details</th>
8386 </tr>
8387 <tr class="entry_cont">
8388 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8389 <p>Does not need to be listed in static
8390metadata.<wbr/> Support for partial results will be reworked in
8391future versions of camera service.<wbr/> This quirk will stop
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]8392working at that point; DO NOT USE without careful
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8393consideration of future support.<wbr/></p>
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]8394 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8395 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8396
8397
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8398 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8399 <!-- end of entry -->
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]8400
8401
8402
8403 <!-- end of kind -->
8404 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8405 <tr><td colspan="6" class="kind">dynamic</td></tr>
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]8406
8407 <thead class="entries_header">
8408 <tr>
8409 <th class="th_name">Property Name</th>
8410 <th class="th_type">Type</th>
8411 <th class="th_description">Description</th>
8412 <th class="th_units">Units</th>
8413 <th class="th_range">Range</th>
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]8414 <th class="th_tags">Tags</th>
8415 </tr>
8416 </thead>
8417
8418 <tbody>
8419
8420
8421
8422
8423
8424
8425
8426
8427
8428
8429 <tr class="entry" id="dynamic_android.quirks.partialResult">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8430 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8431 android.<wbr/>quirks.<wbr/>partial<wbr/>Result
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8432 </td>
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]8433 <td class="entry_type">
8434 <span class="entry_type_name entry_type_name_enum">byte</span>
8435
Eino-Ville Talvala52a64a52013-11-07 14:43:43 -0800[diff] [blame]8436 <span class="entry_type_visibility"> [hidden as boolean]</span>
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]8437
8438 <ul class="entry_type_enum">
8439 <li>
8440 <span class="entry_type_enum_name">FINAL</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]8441 <span class="entry_type_enum_notes"><p>The last or only metadata result buffer
8442for this capture.<wbr/></p></span>
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]8443 </li>
8444 <li>
8445 <span class="entry_type_enum_name">PARTIAL</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]8446 <span class="entry_type_enum_notes"><p>A partial buffer of result metadata for this
8447capture.<wbr/> More result buffers for this capture will be sent
8448by the HAL,<wbr/> the last of which will be marked
8449FINAL.<wbr/></p></span>
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]8450 </li>
8451 </ul>
8452
8453 </td> <!-- entry_type -->
8454
8455 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8456 <p>Whether a result given to the framework is the
8457final one for the capture,<wbr/> or only a partial that contains a
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]8458subset of the full set of dynamic metadata
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8459values.<wbr/></p>
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]8460 </td>
8461
8462 <td class="entry_units">
8463 </td>
8464
8465 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]8466 <p>Optional.<wbr/> Default value is FINAL.<wbr/></p>
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]8467 </td>
8468
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8469 <td class="entry_tags">
8470 </td>
8471
8472 </tr>
8473 <tr class="entries_header">
8474 <th class="th_details" colspan="5">Details</th>
8475 </tr>
8476 <tr class="entry_cont">
8477 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8478 <p>The entries in the result metadata buffers for a
8479single capture may not overlap,<wbr/> except for this entry.<wbr/> The
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]8480FINAL buffers must retain FIFO ordering relative to the
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8481requests that generate them,<wbr/> so the FINAL buffer for frame 3 must
8482always be sent to the framework after the FINAL buffer for frame 2,<wbr/> and
8483before the FINAL buffer for frame 4.<wbr/> PARTIAL buffers may be returned
8484in any order relative to other frames,<wbr/> but all PARTIAL buffers for a given
8485capture must arrive before the FINAL buffer for that capture.<wbr/> This entry may
8486only 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]8487 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8488 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8489
8490
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8491 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8492 <!-- end of entry -->
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]8493
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8494
8495
8496 <!-- end of kind -->
8497 </tbody>
8498
8499 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8500 <tr><td colspan="6" id="section_request" class="section">request</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8501
8502
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8503 <tr><td colspan="6" class="kind">controls</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8504
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8505 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8506 <tr>
8507 <th class="th_name">Property Name</th>
8508 <th class="th_type">Type</th>
8509 <th class="th_description">Description</th>
8510 <th class="th_units">Units</th>
8511 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8512 <th class="th_tags">Tags</th>
8513 </tr>
8514 </thead>
8515
8516 <tbody>
8517
8518
8519
8520
8521
8522
8523
8524
8525
8526
8527 <tr class="entry" id="controls_android.request.frameCount">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8528 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8529 android.<wbr/>request.<wbr/>frame<wbr/>Count
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8530 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8531 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8532 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8533
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8534 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8535
8536
8537 </td> <!-- entry_type -->
8538
8539 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8540 <p>A frame counter set by the framework.<wbr/> Must
8541be maintained unchanged in output frame.<wbr/> This value monotonically
8542increases with every new result (that is,<wbr/> each new result has a unique
8543frameCount value).<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8544 </td>
8545
8546 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8547 incrementing integer
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8548 </td>
8549
8550 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]8551 <p>Any int</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8552 </td>
8553
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8554 <td class="entry_tags">
8555 </td>
8556
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8557 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8558
8559
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8560 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8561 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8562
8563
8564 <tr class="entry" id="controls_android.request.id">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8565 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8566 android.<wbr/>request.<wbr/>id
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8567 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8568 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8569 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8570
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8571 <span class="entry_type_visibility"> [hidden]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8572
8573
8574 </td> <!-- entry_type -->
8575
8576 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8577 <p>An application-specified ID for the current
8578request.<wbr/> Must be maintained unchanged in output
8579frame</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8580 </td>
8581
8582 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8583 arbitrary integer assigned by application
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8584 </td>
8585
8586 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]8587 <p>Any int</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8588 </td>
8589
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8590 <td class="entry_tags">
8591 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]8592 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8593 </ul>
8594 </td>
8595
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8596 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8597
8598
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8599 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8600 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8601
8602
8603 <tr class="entry" id="controls_android.request.inputStreams">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8604 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8605 android.<wbr/>request.<wbr/>input<wbr/>Streams
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8606 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8607 <td class="entry_type">
Zhijun Hee36cdbe2013-09-06 14:28:37 -0700[diff] [blame]8608 <span class="entry_type_name">int32</span>
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]8609 <span class="entry_type_container">x</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8610
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]8611 <span class="entry_type_array">
8612 n
8613 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8614 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8615
8616
8617 </td> <!-- entry_type -->
8618
8619 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8620 <p>List which camera reprocess stream is used
8621for the source of reprocessing data.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8622 </td>
8623
8624 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8625 List of camera reprocess stream IDs
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8626 </td>
8627
8628 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]8629 <p>Typically,<wbr/> only one entry allowed,<wbr/> must be a valid
8630reprocess stream ID.<wbr/></p>
8631<p>If android.<wbr/>jpeg.<wbr/>needs<wbr/>Thumbnail is set,<wbr/> then multiple
8632reprocess streams may be included in a single request; they
8633must be different scaled versions of the same image.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8634 </td>
8635
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8636 <td class="entry_tags">
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]8637 <ul class="entry_tags">
8638 <li><a href="#tag_HAL2">HAL2</a></li>
8639 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8640 </td>
8641
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8642 </tr>
8643 <tr class="entries_header">
8644 <th class="th_details" colspan="5">Details</th>
8645 </tr>
8646 <tr class="entry_cont">
8647 <td class="entry_details" colspan="5">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]8648 <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]8649REPROCESS.<wbr/> Ignored otherwise</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8650 </td>
8651 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8652
8653
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8654 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8655 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8656
8657
8658 <tr class="entry" id="controls_android.request.metadataMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8659 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8660 android.<wbr/>request.<wbr/>metadata<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8661 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8662 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8663 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8664
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8665 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8666
8667 <ul class="entry_type_enum">
8668 <li>
8669 <span class="entry_type_enum_name">NONE</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]8670 <span class="entry_type_enum_notes"><p>No metadata should be produced on output,<wbr/> except
8671for application-bound buffer data.<wbr/> If no
8672application-bound streams exist,<wbr/> no frame should be
8673placed in the output frame queue.<wbr/> If such streams
8674exist,<wbr/> a frame should be placed on the output queue
8675with null metadata but with the necessary output buffer
8676information.<wbr/> Timestamp information should still be
8677included with any output stream buffers</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8678 </li>
8679 <li>
8680 <span class="entry_type_enum_name">FULL</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]8681 <span class="entry_type_enum_notes"><p>All metadata should be produced.<wbr/> Statistics will
8682only be produced if they are separately
8683enabled</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8684 </li>
8685 </ul>
8686
8687 </td> <!-- entry_type -->
8688
8689 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8690 <p>How much metadata to produce on
8691output</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8692 </td>
8693
8694 <td class="entry_units">
8695 </td>
8696
8697 <td class="entry_range">
8698 </td>
8699
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8700 <td class="entry_tags">
8701 </td>
8702
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8703 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8704
8705
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8706 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8707 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8708
8709
8710 <tr class="entry" id="controls_android.request.outputStreams">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8711 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8712 android.<wbr/>request.<wbr/>output<wbr/>Streams
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8713 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8714 <td class="entry_type">
Zhijun Hee36cdbe2013-09-06 14:28:37 -0700[diff] [blame]8715 <span class="entry_type_name">int32</span>
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]8716 <span class="entry_type_container">x</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8717
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]8718 <span class="entry_type_array">
8719 n
8720 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8721 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8722
8723
8724 </td> <!-- entry_type -->
8725
8726 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8727 <p>Lists which camera output streams image data
8728from this capture must be sent to</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8729 </td>
8730
8731 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8732 List of camera stream IDs
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8733 </td>
8734
8735 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]8736 <p>List must only include streams that have been
8737created</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8738 </td>
8739
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8740 <td class="entry_tags">
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]8741 <ul class="entry_tags">
8742 <li><a href="#tag_HAL2">HAL2</a></li>
8743 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8744 </td>
8745
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8746 </tr>
8747 <tr class="entries_header">
8748 <th class="th_details" colspan="5">Details</th>
8749 </tr>
8750 <tr class="entry_cont">
8751 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8752 <p>If no output streams are listed,<wbr/> then the image
8753data should simply be discarded.<wbr/> The image data must
8754still be captured for metadata and statistics production,<wbr/>
8755and the lens and flash must operate as requested.<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8756 </td>
8757 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8758
8759
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8760 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8761 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8762
8763
8764 <tr class="entry" id="controls_android.request.type">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8765 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8766 android.<wbr/>request.<wbr/>type
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8767 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8768 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8769 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8770
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8771 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8772
8773 <ul class="entry_type_enum">
8774 <li>
8775 <span class="entry_type_enum_name">CAPTURE</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]8776 <span class="entry_type_enum_notes"><p>Capture a new image from the imaging hardware,<wbr/>
8777and process it according to the
8778settings</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8779 </li>
8780 <li>
8781 <span class="entry_type_enum_name">REPROCESS</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]8782 <span class="entry_type_enum_notes"><p>Process previously captured data; the
8783android.<wbr/>request.<wbr/>input<wbr/>Stream parameter determines the
8784source reprocessing stream.<wbr/> TODO: Mark dynamic metadata
8785needed for reprocessing with [RP]</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8786 </li>
8787 </ul>
8788
8789 </td> <!-- entry_type -->
8790
8791 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8792 <p>The type of the request; either CAPTURE or
8793REPROCESS.<wbr/> For HAL3,<wbr/> this tag is redundant.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8794 </td>
8795
8796 <td class="entry_units">
8797 </td>
8798
8799 <td class="entry_range">
8800 </td>
8801
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8802 <td class="entry_tags">
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]8803 <ul class="entry_tags">
8804 <li><a href="#tag_HAL2">HAL2</a></li>
8805 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8806 </td>
8807
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8808 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8809
8810
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8811 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8812 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8813
8814
8815
8816 <!-- end of kind -->
8817 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8818 <tr><td colspan="6" class="kind">static</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8819
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8820 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8821 <tr>
8822 <th class="th_name">Property Name</th>
8823 <th class="th_type">Type</th>
8824 <th class="th_description">Description</th>
8825 <th class="th_units">Units</th>
8826 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8827 <th class="th_tags">Tags</th>
8828 </tr>
8829 </thead>
8830
8831 <tbody>
8832
8833
8834
8835
8836
8837
8838
8839
8840
8841
8842 <tr class="entry" id="static_android.request.maxNumOutputStreams">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8843 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8844 android.<wbr/>request.<wbr/>max<wbr/>Num<wbr/>Output<wbr/>Streams
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8845 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8846 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8847 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8848 <span class="entry_type_container">x</span>
8849
8850 <span class="entry_type_array">
8851 3
8852 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8853 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8854
8855
8856 </td> <!-- entry_type -->
8857
8858 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8859 <p>How many output streams can be allocated at
8860the same time for each type of stream</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8861 </td>
8862
8863 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8864 The number of raw sensor streams; the number of
8865 processed,<wbr/> uncompressed streams; and the number of
8866 JPEG-compressed streams
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8867 </td>
8868
8869 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame]8870 <p>&gt;=1 for Raw and JPEG-compressed stream.<wbr/> &gt;= 3
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]8871for processed,<wbr/> uncompressed streams</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8872 </td>
8873
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8874 <td class="entry_tags">
8875 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]8876 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8877 </ul>
8878 </td>
8879
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8880 </tr>
8881 <tr class="entries_header">
8882 <th class="th_details" colspan="5">Details</th>
8883 </tr>
8884 <tr class="entry_cont">
8885 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8886 <p>Video snapshot with preview callbacks requires 3
8887processed streams (preview,<wbr/> record,<wbr/> app callbacks) and
8888one JPEG stream (snapshot)</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8889 </td>
8890 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8891
8892
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8893 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8894 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8895
8896
8897 <tr class="entry" id="static_android.request.maxNumReprocessStreams">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8898 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8899 android.<wbr/>request.<wbr/>max<wbr/>Num<wbr/>Reprocess<wbr/>Streams
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8900 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8901 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8902 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8903 <span class="entry_type_container">x</span>
8904
8905 <span class="entry_type_array">
8906 1
8907 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8908 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8909
8910
8911 </td> <!-- entry_type -->
8912
8913 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8914 <p>How many reprocessing streams of any type
8915can be allocated at the same time</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8916 </td>
8917
8918 <td class="entry_units">
8919 </td>
8920
8921 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame]8922 <p>&gt;= 1</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8923 </td>
8924
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8925 <td class="entry_tags">
8926 </td>
8927
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8928 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8929
8930
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8931 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8932 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8933
8934
8935
8936 <!-- end of kind -->
8937 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8938 <tr><td colspan="6" class="kind">dynamic</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8939
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8940 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8941 <tr>
8942 <th class="th_name">Property Name</th>
8943 <th class="th_type">Type</th>
8944 <th class="th_description">Description</th>
8945 <th class="th_units">Units</th>
8946 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8947 <th class="th_tags">Tags</th>
8948 </tr>
8949 </thead>
8950
8951 <tbody>
8952
8953
8954
8955
8956
8957
8958
8959
8960
8961
8962 <tr class="entry" id="dynamic_android.request.frameCount">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8963 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8964 android.<wbr/>request.<wbr/>frame<wbr/>Count
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8965 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8966 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8967 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8968
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8969 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8970
8971
8972 </td> <!-- entry_type -->
8973
8974 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8975 <p>A frame counter set by the framework.<wbr/> This value monotonically
8976increases with every new result (that is,<wbr/> each new result has a unique
8977frameCount value).<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8978 </td>
8979
8980 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8981 count of frames
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8982 </td>
8983
8984 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame]8985 <p>&gt; 0</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8986 </td>
8987
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8988 <td class="entry_tags">
8989 </td>
8990
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8991 </tr>
8992 <tr class="entries_header">
8993 <th class="th_details" colspan="5">Details</th>
8994 </tr>
8995 <tr class="entry_cont">
8996 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8997 <p>Reset on release()</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8998 </td>
8999 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9000
9001
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9002 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9003 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9004
9005
9006 <tr class="entry" id="dynamic_android.request.id">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9007 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9008 android.<wbr/>request.<wbr/>id
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9009 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9010 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9011 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9012
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9013 <span class="entry_type_visibility"> [hidden]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9014
9015
9016 </td> <!-- entry_type -->
9017
9018 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9019 <p>An application-specified ID for the current
9020request.<wbr/> Must be maintained unchanged in output
9021frame</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9022 </td>
9023
9024 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9025 arbitrary integer assigned by application
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9026 </td>
9027
9028 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]9029 <p>Any int</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9030 </td>
9031
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9032 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9033 <ul class="entry_tags">
9034 <li><a href="#tag_V1">V1</a></li>
9035 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9036 </td>
9037
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9038 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9039
9040
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9041 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9042 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9043
9044
9045 <tr class="entry" id="dynamic_android.request.metadataMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9046 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9047 android.<wbr/>request.<wbr/>metadata<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9048 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9049 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9050 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9051
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9052 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9053
9054 <ul class="entry_type_enum">
9055 <li>
9056 <span class="entry_type_enum_name">NONE</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]9057 <span class="entry_type_enum_notes"><p>No metadata should be produced on output,<wbr/> except
9058for application-bound buffer data.<wbr/> If no
9059application-bound streams exist,<wbr/> no frame should be
9060placed in the output frame queue.<wbr/> If such streams
9061exist,<wbr/> a frame should be placed on the output queue
9062with null metadata but with the necessary output buffer
9063information.<wbr/> Timestamp information should still be
9064included with any output stream buffers</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9065 </li>
9066 <li>
9067 <span class="entry_type_enum_name">FULL</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]9068 <span class="entry_type_enum_notes"><p>All metadata should be produced.<wbr/> Statistics will
9069only be produced if they are separately
9070enabled</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9071 </li>
9072 </ul>
9073
9074 </td> <!-- entry_type -->
9075
9076 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9077 <p>How much metadata to produce on
9078output</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9079 </td>
9080
9081 <td class="entry_units">
9082 </td>
9083
9084 <td class="entry_range">
9085 </td>
9086
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9087 <td class="entry_tags">
9088 </td>
9089
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9090 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9091
9092
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9093 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9094 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9095
9096
9097 <tr class="entry" id="dynamic_android.request.outputStreams">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9098 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9099 android.<wbr/>request.<wbr/>output<wbr/>Streams
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9100 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9101 <td class="entry_type">
Zhijun Hee36cdbe2013-09-06 14:28:37 -0700[diff] [blame]9102 <span class="entry_type_name">int32</span>
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]9103 <span class="entry_type_container">x</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9104
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]9105 <span class="entry_type_array">
9106 n
9107 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9108 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9109
9110
9111 </td> <!-- entry_type -->
9112
9113 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9114 <p>Lists which camera output streams image data
9115from this capture must be sent to</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9116 </td>
9117
9118 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9119 List of camera stream IDs
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9120 </td>
9121
9122 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]9123 <p>List must only include streams that have been
9124created</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9125 </td>
9126
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9127 <td class="entry_tags">
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]9128 <ul class="entry_tags">
9129 <li><a href="#tag_HAL2">HAL2</a></li>
9130 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9131 </td>
9132
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9133 </tr>
9134 <tr class="entries_header">
9135 <th class="th_details" colspan="5">Details</th>
9136 </tr>
9137 <tr class="entry_cont">
9138 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9139 <p>If no output streams are listed,<wbr/> then the image
9140data should simply be discarded.<wbr/> The image data must
9141still be captured for metadata and statistics production,<wbr/>
9142and the lens and flash must operate as requested.<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9143 </td>
9144 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9145
9146
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9147 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9148 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9149
9150
9151
9152 <!-- end of kind -->
9153 </tbody>
9154
9155 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9156 <tr><td colspan="6" id="section_scaler" class="section">scaler</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9157
9158
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9159 <tr><td colspan="6" class="kind">controls</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9160
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9161 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9162 <tr>
9163 <th class="th_name">Property Name</th>
9164 <th class="th_type">Type</th>
9165 <th class="th_description">Description</th>
9166 <th class="th_units">Units</th>
9167 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9168 <th class="th_tags">Tags</th>
9169 </tr>
9170 </thead>
9171
9172 <tbody>
9173
9174
9175
9176
9177
9178
9179
9180
9181
9182
9183 <tr class="entry" id="controls_android.scaler.cropRegion">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9184 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9185 android.<wbr/>scaler.<wbr/>crop<wbr/>Region
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9186 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9187 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9188 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9189 <span class="entry_type_container">x</span>
9190
9191 <span class="entry_type_array">
Eino-Ville Talvalae04ec6e2013-04-16 15:35:18 -0700[diff] [blame]9192 4
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9193 </span>
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]9194 <span class="entry_type_visibility"> [public as rectangle]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9195
9196
9197 </td> <!-- entry_type -->
9198
9199 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9200 <p>(x,<wbr/> y,<wbr/> width,<wbr/> height).<wbr/></p>
9201<p>A rectangle with the top-level corner of (x,<wbr/>y) and size
9202(width,<wbr/> height).<wbr/> The region of the sensor that is used for
9203output.<wbr/> Each stream must use this rectangle to produce its
9204output,<wbr/> cropping to a smaller region if necessary to
9205maintain the stream's aspect ratio.<wbr/></p>
9206<p>HAL2.<wbr/>x uses only (x,<wbr/> y,<wbr/> width)</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9207 </td>
9208
9209 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9210 (x,<wbr/>y) of top-left corner,<wbr/> width and height of region
9211 in pixels; (0,<wbr/>0) is top-left corner of
9212 android.<wbr/>sensor.<wbr/>active<wbr/>Array<wbr/>Size
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9213 </td>
9214
9215 <td class="entry_range">
9216 </td>
9217
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9218 <td class="entry_tags">
9219 <ul class="entry_tags">
9220 <li><a href="#tag_BC">BC</a></li>
9221 </ul>
9222 </td>
9223
9224 </tr>
9225 <tr class="entries_header">
9226 <th class="th_details" colspan="5">Details</th>
9227 </tr>
9228 <tr class="entry_cont">
9229 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9230 <p>Any additional per-stream cropping must be done to
9231maximize the final pixel area of the stream.<wbr/></p>
9232<p>For example,<wbr/> if the crop region is set to a 4:3 aspect
9233ratio,<wbr/> then 4:3 streams should use the exact crop
9234region.<wbr/> 16:9 streams should further crop vertically
9235(letterbox).<wbr/></p>
9236<p>Conversely,<wbr/> if the crop region is set to a 16:9,<wbr/> then 4:3
9237outputs should crop horizontally (pillarbox),<wbr/> and 16:9
9238streams should match exactly.<wbr/> These additional crops must
9239be centered within the crop region.<wbr/></p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]9240<p>The output streams must maintain square pixels at all
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9241times,<wbr/> no matter what the relative aspect ratios of the
9242crop region and the stream are.<wbr/> Negative values for
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]9243corner are allowed for raw output if full pixel array is
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9244larger than active pixel array.<wbr/> Width and height may be
9245rounded to nearest larger supportable width,<wbr/> especially
9246for raw output,<wbr/> where only a few fixed scales may be
9247possible.<wbr/> The width and height of the crop region cannot
9248be set to be smaller than floor( activeArraySize.<wbr/>width /<wbr/>
9249android.<wbr/>scaler.<wbr/>max<wbr/>Digital<wbr/>Zoom ) and floor(
9250activeArraySize.<wbr/>height /<wbr/> android.<wbr/>scaler.<wbr/>max<wbr/>Digital<wbr/>Zoom),<wbr/>
9251respectively.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9252 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9253 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9254
9255
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9256 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9257 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9258
9259
9260
9261 <!-- end of kind -->
9262 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9263 <tr><td colspan="6" class="kind">static</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9264
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9265 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9266 <tr>
9267 <th class="th_name">Property Name</th>
9268 <th class="th_type">Type</th>
9269 <th class="th_description">Description</th>
9270 <th class="th_units">Units</th>
9271 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9272 <th class="th_tags">Tags</th>
9273 </tr>
9274 </thead>
9275
9276 <tbody>
9277
9278
9279
9280
9281
9282
9283
9284
9285
9286
9287 <tr class="entry" id="static_android.scaler.availableFormats">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9288 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9289 android.<wbr/>scaler.<wbr/>available<wbr/>Formats
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9290 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9291 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9292 <span class="entry_type_name entry_type_name_enum">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9293 <span class="entry_type_container">x</span>
9294
9295 <span class="entry_type_array">
9296 n
9297 </span>
Eino-Ville Talvalad4e240a2013-08-08 12:56:37 -0700[diff] [blame]9298 <span class="entry_type_visibility"> [public as imageFormat]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9299 <div class="entry_type_notes">values from HAL_<wbr/>PIXEL_<wbr/>FORMAT_<wbr/>* in /<wbr/>system/<wbr/>core/<wbr/>include/<wbr/>system/<wbr/>graphics.<wbr/>h</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9300
9301 <ul class="entry_type_enum">
9302 <li>
9303 <span class="entry_type_enum_name">RAW_SENSOR</span>
9304 <span class="entry_type_enum_value">0x20</span>
9305 </li>
9306 <li>
9307 <span class="entry_type_enum_name">YV12</span>
9308 <span class="entry_type_enum_value">0x32315659</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]9309 <span class="entry_type_enum_notes"><p>YCrCb 4:2:0 Planar</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9310 </li>
9311 <li>
Zhijun Hec2eebff2013-05-16 17:49:35 -0700[diff] [blame]9312 <span class="entry_type_enum_name">YCrCb_420_SP</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9313 <span class="entry_type_enum_value">0x11</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]9314 <span class="entry_type_enum_notes"><p>NV21</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9315 </li>
9316 <li>
Zhijun Hec2eebff2013-05-16 17:49:35 -0700[diff] [blame]9317 <span class="entry_type_enum_name">IMPLEMENTATION_DEFINED</span>
9318 <span class="entry_type_enum_value">0x22</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]9319 <span class="entry_type_enum_notes"><p>Hal Implementation Defined</p></span>
Zhijun Hec2eebff2013-05-16 17:49:35 -0700[diff] [blame]9320 </li>
9321 <li>
9322 <span class="entry_type_enum_name">YCbCr_420_888</span>
9323 <span class="entry_type_enum_value">0x23</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]9324 <span class="entry_type_enum_notes"><p>Flexible YUV420 Format</p></span>
Zhijun Hec2eebff2013-05-16 17:49:35 -0700[diff] [blame]9325 </li>
9326 <li>
9327 <span class="entry_type_enum_name">BLOB</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9328 <span class="entry_type_enum_value">0x21</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]9329 <span class="entry_type_enum_notes"><p>JPEG</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9330 </li>
9331 </ul>
9332
9333 </td> <!-- entry_type -->
9334
9335 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9336 <p>List of app-visible formats</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9337 </td>
9338
9339 <td class="entry_units">
9340 </td>
9341
9342 <td class="entry_range">
9343 </td>
9344
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9345 <td class="entry_tags">
9346 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9347 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9348 </ul>
9349 </td>
9350
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9351 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9352
9353
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9354 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9355 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9356
9357
9358 <tr class="entry" id="static_android.scaler.availableJpegMinDurations">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9359 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9360 android.<wbr/>scaler.<wbr/>available<wbr/>Jpeg<wbr/>Min<wbr/>Durations
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9361 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9362 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9363 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9364 <span class="entry_type_container">x</span>
9365
9366 <span class="entry_type_array">
9367 n
9368 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9369 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9370
9371
9372 </td> <!-- entry_type -->
9373
9374 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9375 <p>The minimum frame duration that is supported
9376for each resolution in availableJpegSizes.<wbr/> Should
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]9377correspond to the frame duration when only that JPEG
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9378stream is active and captured in a burst,<wbr/> with all
9379processing set to FAST</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9380 </td>
9381
9382 <td class="entry_units">
9383 </td>
9384
9385 <td class="entry_range">
9386 </td>
9387
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9388 <td class="entry_tags">
9389 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9390 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9391 </ul>
9392 </td>
9393
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9394 </tr>
9395 <tr class="entries_header">
9396 <th class="th_details" colspan="5">Details</th>
9397 </tr>
9398 <tr class="entry_cont">
9399 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9400 <p>When multiple streams are configured,<wbr/> the minimum
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9401frame duration will be &gt;= max(individual stream min
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9402durations)</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9403 </td>
9404 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9405
9406
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9407 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9408 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9409
9410
9411 <tr class="entry" id="static_android.scaler.availableJpegSizes">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9412 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9413 android.<wbr/>scaler.<wbr/>available<wbr/>Jpeg<wbr/>Sizes
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9414 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9415 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9416 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9417 <span class="entry_type_container">x</span>
9418
9419 <span class="entry_type_array">
9420 n x 2
9421 </span>
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]9422 <span class="entry_type_visibility"> [public as size]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9423
9424
9425 </td> <!-- entry_type -->
9426
9427 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9428 <p>The resolutions available for output from
9429the JPEG block.<wbr/> Listed as width x height</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9430 </td>
9431
9432 <td class="entry_units">
9433 </td>
9434
9435 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]9436 <p>Must include: - sensor maximum resolution Should
9437include: - half/<wbr/>quarter max resolution</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9438 </td>
9439
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9440 <td class="entry_tags">
9441 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9442 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9443 </ul>
9444 </td>
9445
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9446 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9447
9448
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9449 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9450 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9451
9452
9453 <tr class="entry" id="static_android.scaler.availableMaxDigitalZoom">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9454 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9455 android.<wbr/>scaler.<wbr/>available<wbr/>Max<wbr/>Digital<wbr/>Zoom
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9456 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9457 <td class="entry_type">
Igor Murashkinf11a4df2013-05-07 10:00:46 -0700[diff] [blame]9458 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9459
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9460 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9461
9462
9463 </td> <!-- entry_type -->
9464
9465 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9466 <p>The maximum ratio between active area width
9467and crop region width,<wbr/> or between active area height and
9468crop region height,<wbr/> if the crop region height is larger
9469than width</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9470 </td>
9471
9472 <td class="entry_units">
9473 </td>
9474
9475 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame]9476 <p>&gt;=1</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9477 </td>
9478
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9479 <td class="entry_tags">
Igor Murashkinf11a4df2013-05-07 10:00:46 -0700[diff] [blame]9480 <ul class="entry_tags">
9481 <li><a href="#tag_BC">BC</a></li>
9482 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9483 </td>
9484
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9485 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9486
9487
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9488 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9489 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9490
9491
9492 <tr class="entry" id="static_android.scaler.availableProcessedMinDurations">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9493 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9494 android.<wbr/>scaler.<wbr/>available<wbr/>Processed<wbr/>Min<wbr/>Durations
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9495 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9496 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9497 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9498 <span class="entry_type_container">x</span>
9499
9500 <span class="entry_type_array">
9501 n
9502 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9503 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9504
9505
9506 </td> <!-- entry_type -->
9507
9508 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9509 <p>The minimum frame duration that is supported
9510for each resolution in availableProcessedSizes.<wbr/> Should
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]9511correspond to the frame duration when only that processed
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9512stream is active,<wbr/> with all processing set to
9513FAST</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9514 </td>
9515
9516 <td class="entry_units">
9517 </td>
9518
9519 <td class="entry_range">
9520 </td>
9521
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9522 <td class="entry_tags">
9523 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9524 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9525 </ul>
9526 </td>
9527
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9528 </tr>
9529 <tr class="entries_header">
9530 <th class="th_details" colspan="5">Details</th>
9531 </tr>
9532 <tr class="entry_cont">
9533 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9534 <p>When multiple streams are configured,<wbr/> the minimum
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9535frame duration will be &gt;= max(individual stream min
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9536durations)</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9537 </td>
9538 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9539
9540
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9541 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9542 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9543
9544
9545 <tr class="entry" id="static_android.scaler.availableProcessedSizes">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9546 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9547 android.<wbr/>scaler.<wbr/>available<wbr/>Processed<wbr/>Sizes
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9548 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9549 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9550 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9551 <span class="entry_type_container">x</span>
9552
9553 <span class="entry_type_array">
9554 n x 2
9555 </span>
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]9556 <span class="entry_type_visibility"> [public as size]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9557
9558
9559 </td> <!-- entry_type -->
9560
9561 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9562 <p>The resolutions available for use with
9563processed output streams,<wbr/> such as YV12,<wbr/> NV12,<wbr/> and
9564platform opaque YUV/<wbr/>RGB streams to the GPU or video
9565encoders.<wbr/> Listed as width,<wbr/> height</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9566 </td>
9567
9568 <td class="entry_units">
9569 </td>
9570
9571 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]9572 <p>Must include: - sensor maximum resolution -
9573standard QCIF,<wbr/> 240p,<wbr/> 480p,<wbr/> 720p,<wbr/> and 1080p
9574resolutions</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9575 </td>
9576
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9577 <td class="entry_tags">
9578 <ul class="entry_tags">
9579 <li><a href="#tag_BC">BC</a></li>
9580 </ul>
9581 </td>
9582
9583 </tr>
9584 <tr class="entries_header">
9585 <th class="th_details" colspan="5">Details</th>
9586 </tr>
9587 <tr class="entry_cont">
9588 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9589 <p>The actual supported resolution list may be limited by
9590consumer end points for different use cases.<wbr/> For example,<wbr/> for
9591recording use case,<wbr/> the largest supported resolution may be
9592limited by max supported size from encoder,<wbr/> for preview use
9593case,<wbr/> the largest supported resolution may be limited by max
9594resolution SurfaceTexture/<wbr/>SurfaceView can support.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9595 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9596 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9597
9598
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9599 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9600 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9601
9602
9603 <tr class="entry" id="static_android.scaler.availableRawMinDurations">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9604 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9605 android.<wbr/>scaler.<wbr/>available<wbr/>Raw<wbr/>Min<wbr/>Durations
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9606 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9607 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9608 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9609 <span class="entry_type_container">x</span>
9610
9611 <span class="entry_type_array">
9612 n
9613 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9614 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9615
9616
9617 </td> <!-- entry_type -->
9618
9619 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9620 <p>The minimum frame duration that is supported
9621for each raw resolution in availableRawSizes.<wbr/> Should
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]9622correspond to the frame duration when only the raw stream
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9623is active.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9624 </td>
9625
9626 <td class="entry_units">
9627 </td>
9628
9629 <td class="entry_range">
9630 </td>
9631
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9632 <td class="entry_tags">
9633 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9634 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9635 </ul>
9636 </td>
9637
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9638 </tr>
9639 <tr class="entries_header">
9640 <th class="th_details" colspan="5">Details</th>
9641 </tr>
9642 <tr class="entry_cont">
9643 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9644 <p>When multiple streams are configured,<wbr/> the minimum
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9645frame duration will be &gt;= max(individual stream min
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9646durations)</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9647 </td>
9648 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9649
9650
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9651 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9652 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9653
9654
9655 <tr class="entry" id="static_android.scaler.availableRawSizes">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9656 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9657 android.<wbr/>scaler.<wbr/>available<wbr/>Raw<wbr/>Sizes
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9658 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9659 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9660 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9661 <span class="entry_type_container">x</span>
9662
9663 <span class="entry_type_array">
9664 n x 2
9665 </span>
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]9666 <span class="entry_type_visibility"> [system as size]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9667
9668
9669 </td> <!-- entry_type -->
9670
9671 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9672 <p>The resolutions available for use with raw
9673sensor output streams,<wbr/> listed as width,<wbr/>
9674height</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9675 </td>
9676
9677 <td class="entry_units">
9678 </td>
9679
9680 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]9681 <p>Must include: - sensor maximum resolution</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9682 </td>
9683
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9684 <td class="entry_tags">
9685 </td>
9686
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9687 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9688
9689
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9690 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9691 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9692
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9693
9694
9695 <!-- end of kind -->
9696 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9697 <tr><td colspan="6" class="kind">dynamic</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9698
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9699 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9700 <tr>
9701 <th class="th_name">Property Name</th>
9702 <th class="th_type">Type</th>
9703 <th class="th_description">Description</th>
9704 <th class="th_units">Units</th>
9705 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9706 <th class="th_tags">Tags</th>
9707 </tr>
9708 </thead>
9709
9710 <tbody>
9711
9712
9713
9714
9715
9716
9717
9718
9719
9720
9721 <tr class="entry" id="dynamic_android.scaler.cropRegion">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9722 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9723 android.<wbr/>scaler.<wbr/>crop<wbr/>Region
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9724 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9725 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9726 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9727 <span class="entry_type_container">x</span>
9728
9729 <span class="entry_type_array">
Eino-Ville Talvalae04ec6e2013-04-16 15:35:18 -0700[diff] [blame]9730 4
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9731 </span>
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]9732 <span class="entry_type_visibility"> [public as rectangle]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9733
9734
9735 </td> <!-- entry_type -->
9736
9737 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9738 <p>(x,<wbr/> y,<wbr/> width,<wbr/> height).<wbr/></p>
9739<p>A rectangle with the top-level corner of (x,<wbr/>y) and size
9740(width,<wbr/> height).<wbr/> The region of the sensor that is used for
9741output.<wbr/> Each stream must use this rectangle to produce its
9742output,<wbr/> cropping to a smaller region if necessary to
9743maintain the stream's aspect ratio.<wbr/></p>
9744<p>HAL2.<wbr/>x uses only (x,<wbr/> y,<wbr/> width)</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9745 </td>
9746
9747 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9748 (x,<wbr/>y) of top-left corner,<wbr/> width and height of region
9749 in pixels; (0,<wbr/>0) is top-left corner of
9750 android.<wbr/>sensor.<wbr/>active<wbr/>Array<wbr/>Size
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9751 </td>
9752
9753 <td class="entry_range">
9754 </td>
9755
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9756 <td class="entry_tags">
9757 <ul class="entry_tags">
9758 <li><a href="#tag_BC">BC</a></li>
9759 </ul>
9760 </td>
9761
9762 </tr>
9763 <tr class="entries_header">
9764 <th class="th_details" colspan="5">Details</th>
9765 </tr>
9766 <tr class="entry_cont">
9767 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9768 <p>Any additional per-stream cropping must be done to
9769maximize the final pixel area of the stream.<wbr/></p>
9770<p>For example,<wbr/> if the crop region is set to a 4:3 aspect
9771ratio,<wbr/> then 4:3 streams should use the exact crop
9772region.<wbr/> 16:9 streams should further crop vertically
9773(letterbox).<wbr/></p>
9774<p>Conversely,<wbr/> if the crop region is set to a 16:9,<wbr/> then 4:3
9775outputs should crop horizontally (pillarbox),<wbr/> and 16:9
9776streams should match exactly.<wbr/> These additional crops must
9777be centered within the crop region.<wbr/></p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]9778<p>The output streams must maintain square pixels at all
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9779times,<wbr/> no matter what the relative aspect ratios of the
9780crop region and the stream are.<wbr/> Negative values for
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]9781corner are allowed for raw output if full pixel array is
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9782larger than active pixel array.<wbr/> Width and height may be
9783rounded to nearest larger supportable width,<wbr/> especially
9784for raw output,<wbr/> where only a few fixed scales may be
9785possible.<wbr/> The width and height of the crop region cannot
9786be set to be smaller than floor( activeArraySize.<wbr/>width /<wbr/>
9787android.<wbr/>scaler.<wbr/>max<wbr/>Digital<wbr/>Zoom ) and floor(
9788activeArraySize.<wbr/>height /<wbr/> android.<wbr/>scaler.<wbr/>max<wbr/>Digital<wbr/>Zoom),<wbr/>
9789respectively.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9790 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9791 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9792
9793
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9794 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9795 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9796
9797
9798
9799 <!-- end of kind -->
9800 </tbody>
9801
9802 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9803 <tr><td colspan="6" id="section_sensor" class="section">sensor</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9804
9805
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9806 <tr><td colspan="6" class="kind">controls</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9807
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9808 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9809 <tr>
9810 <th class="th_name">Property Name</th>
9811 <th class="th_type">Type</th>
9812 <th class="th_description">Description</th>
9813 <th class="th_units">Units</th>
9814 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9815 <th class="th_tags">Tags</th>
9816 </tr>
9817 </thead>
9818
9819 <tbody>
9820
9821
9822
9823
9824
9825
9826
9827
9828
9829
9830 <tr class="entry" id="controls_android.sensor.exposureTime">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9831 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9832 android.<wbr/>sensor.<wbr/>exposure<wbr/>Time
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9833 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9834 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9835 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9836
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9837 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9838
9839
9840 </td> <!-- entry_type -->
9841
9842 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9843 <p>Duration each pixel is exposed to
9844light.<wbr/></p>
9845<p>If the sensor can't expose this exact duration,<wbr/> it should shorten the
9846duration exposed to the nearest possible value (rather than expose longer).<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9847 </td>
9848
9849 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9850 nanoseconds
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9851 </td>
9852
9853 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]9854 <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]9855 </td>
9856
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9857 <td class="entry_tags">
9858 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9859 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9860 </ul>
9861 </td>
9862
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9863 </tr>
9864 <tr class="entries_header">
9865 <th class="th_details" colspan="5">Details</th>
9866 </tr>
9867 <tr class="entry_cont">
9868 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9869 <p>1/<wbr/>10000 - 30 sec range.<wbr/> No bulb mode</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9870 </td>
9871 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9872
9873
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9874 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9875 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9876
9877
9878 <tr class="entry" id="controls_android.sensor.frameDuration">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9879 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9880 android.<wbr/>sensor.<wbr/>frame<wbr/>Duration
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9881 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9882 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9883 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9884
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9885 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9886
9887
9888 </td> <!-- entry_type -->
9889
9890 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9891 <p>Duration from start of frame exposure to
9892start of next frame exposure</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9893 </td>
9894
9895 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9896 nanoseconds
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9897 </td>
9898
9899 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]9900 <p>see <a href="#static_android.sensor.info.maxFrameDuration">android.<wbr/>sensor.<wbr/>info.<wbr/>max<wbr/>Frame<wbr/>Duration</a>,<wbr/>
9901android.<wbr/>scaler.<wbr/>info.<wbr/>available<wbr/>Min<wbr/>Frame<wbr/>Durations</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9902 </td>
9903
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9904 <td class="entry_tags">
9905 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9906 <li><a href="#tag_V1">V1</a></li>
9907 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9908 </ul>
9909 </td>
9910
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9911 </tr>
9912 <tr class="entries_header">
9913 <th class="th_details" colspan="5">Details</th>
9914 </tr>
9915 <tr class="entry_cont">
9916 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9917 <p>Exposure time has priority,<wbr/> so duration is set to
9918max(duration,<wbr/> exposure time + overhead)</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9919 </td>
9920 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9921
9922
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9923 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9924 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9925
9926
9927 <tr class="entry" id="controls_android.sensor.sensitivity">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9928 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9929 android.<wbr/>sensor.<wbr/>sensitivity
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9930 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9931 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9932 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9933
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9934 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9935
9936
9937 </td> <!-- entry_type -->
9938
9939 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9940 <p>Gain applied to image data.<wbr/> Must be
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]9941implemented through analog gain only if set to values
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9942below 'maximum analog sensitivity'.<wbr/></p>
9943<p>If the sensor can't apply this exact gain,<wbr/> it should lessen the
9944gain to the nearest possible value (rather than gain more).<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 ISO arithmetic units
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.sensitivityRange">android.<wbr/>sensor.<wbr/>info.<wbr/>sensitivity<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>ISO 12232:2006 REI method</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
9977 <!-- end of kind -->
9978 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9979 <tr><td colspan="6" class="kind">static</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9980
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9981 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9982 <tr>
9983 <th class="th_name">Property Name</th>
9984 <th class="th_type">Type</th>
9985 <th class="th_description">Description</th>
9986 <th class="th_units">Units</th>
9987 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9988 <th class="th_tags">Tags</th>
9989 </tr>
9990 </thead>
9991
9992 <tbody>
9993
9994
9995
9996
9997
9998
9999
10000
10001
10002
10003
10004
10005 <tr class="entry" id="static_android.sensor.info.activeArraySize">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10006 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10007 android.<wbr/>sensor.<wbr/>info.<wbr/>active<wbr/>Array<wbr/>Size
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10008 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10009 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10010 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10011 <span class="entry_type_container">x</span>
10012
10013 <span class="entry_type_array">
10014 4
10015 </span>
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]10016 <span class="entry_type_visibility"> [public as rectangle]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10017 <div class="entry_type_notes">Four ints defining the active pixel rectangle</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10018
10019
10020 </td> <!-- entry_type -->
10021
10022 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10023 <p>Area of raw data which corresponds to only
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]10024active pixels; smaller or equal to
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10025pixelArraySize.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10026 </td>
10027
10028 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10029 xmin,<wbr/> ymin,<wbr/> width,<wbr/> height.<wbr/> Top left of full
10030 pixel array is (0,<wbr/>0)
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10031 </td>
10032
10033 <td class="entry_range">
10034 </td>
10035
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10036 <td class="entry_tags">
10037 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]10038 <li><a href="#tag_DNG">DNG</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10039 </ul>
10040 </td>
10041
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10042 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10043
10044
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10045 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10046 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10047
10048
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]10049 <tr class="entry" id="static_android.sensor.info.sensitivityRange">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10050 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10051 android.<wbr/>sensor.<wbr/>info.<wbr/>sensitivity<wbr/>Range
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10052 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10053 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10054 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10055 <span class="entry_type_container">x</span>
10056
10057 <span class="entry_type_array">
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]10058 2
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10059 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10060 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10061 <div class="entry_type_notes">Range of supported sensitivities</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10062
10063
10064 </td> <!-- entry_type -->
10065
10066 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10067 <p>Range of valid sensitivities</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10068 </td>
10069
10070 <td class="entry_units">
10071 </td>
10072
10073 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]10074 <p>Min &lt;= 100,<wbr/> Max &gt;= 1600</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10075 </td>
10076
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10077 <td class="entry_tags">
10078 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]10079 <li><a href="#tag_BC">BC</a></li>
10080 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10081 </ul>
10082 </td>
10083
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10084 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10085
10086
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10087 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10088 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10089
10090
10091 <tr class="entry" id="static_android.sensor.info.colorFilterArrangement">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10092 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10093 android.<wbr/>sensor.<wbr/>info.<wbr/>color<wbr/>Filter<wbr/>Arrangement
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10094 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10095 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10096 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10097
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10098 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10099
10100 <ul class="entry_type_enum">
10101 <li>
10102 <span class="entry_type_enum_name">RGGB</span>
10103 </li>
10104 <li>
10105 <span class="entry_type_enum_name">GRBG</span>
10106 </li>
10107 <li>
10108 <span class="entry_type_enum_name">GBRG</span>
10109 </li>
10110 <li>
10111 <span class="entry_type_enum_name">BGGR</span>
10112 </li>
10113 <li>
10114 <span class="entry_type_enum_name">RGB</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]10115 <span class="entry_type_enum_notes"><p>Sensor is not Bayer; output has 3 16-bit
10116values for each pixel,<wbr/> instead of just 1 16-bit value
10117per pixel.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10118 </li>
10119 </ul>
10120
10121 </td> <!-- entry_type -->
10122
10123 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10124 <p>Arrangement of color filters on sensor;
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]10125represents the colors in the top-left 2x2 section of
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10126the sensor,<wbr/> in reading order</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10127 </td>
10128
10129 <td class="entry_units">
10130 </td>
10131
10132 <td class="entry_range">
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_DNG">DNG</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>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10142
10143
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10144 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10145 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10146
10147
10148 <tr class="entry" id="static_android.sensor.info.exposureTimeRange">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10149 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10150 android.<wbr/>sensor.<wbr/>info.<wbr/>exposure<wbr/>Time<wbr/>Range
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10151 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10152 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10153 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10154 <span class="entry_type_container">x</span>
10155
10156 <span class="entry_type_array">
10157 2
10158 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10159 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10160 <div class="entry_type_notes">nanoseconds</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10161
10162
10163 </td> <!-- entry_type -->
10164
10165 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10166 <p>Range of valid exposure
10167times</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10168 </td>
10169
10170 <td class="entry_units">
10171 </td>
10172
10173 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]10174 <p>Min &lt;= 100e3 (100 us),<wbr/> Max &gt;= 30e9 (30
10175sec)</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10176 </td>
10177
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10178 <td class="entry_tags">
10179 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]10180 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10181 </ul>
10182 </td>
10183
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10184 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10185
10186
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10187 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10188 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10189
10190
10191 <tr class="entry" id="static_android.sensor.info.maxFrameDuration">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10192 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10193 android.<wbr/>sensor.<wbr/>info.<wbr/>max<wbr/>Frame<wbr/>Duration
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10194 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10195 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10196 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10197
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10198 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10199
10200
10201 </td> <!-- entry_type -->
10202
10203 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10204 <p>Maximum possible frame duration (minimum frame
10205rate)</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 nanoseconds
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10210 </td>
10211
10212 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame]10213 <p>&gt;= 30e9</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]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_BC">BC</a></li>
10219 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10220 </ul>
10221 </td>
10222
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10223 </tr>
10224 <tr class="entries_header">
10225 <th class="th_details" colspan="5">Details</th>
10226 </tr>
10227 <tr class="entry_cont">
10228 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10229 <p>Minimum duration is a function of resolution,<wbr/>
10230processing settings.<wbr/> See
10231android.<wbr/>scaler.<wbr/>available<wbr/>Processed<wbr/>Min<wbr/>Durations
10232android.<wbr/>scaler.<wbr/>available<wbr/>Jpeg<wbr/>Min<wbr/>Durations
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]10233<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]10234 </td>
10235 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10236
10237
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10238 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10239 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10240
10241
10242 <tr class="entry" id="static_android.sensor.info.physicalSize">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10243 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10244 android.<wbr/>sensor.<wbr/>info.<wbr/>physical<wbr/>Size
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10245 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10246 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10247 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10248 <span class="entry_type_container">x</span>
10249
10250 <span class="entry_type_array">
10251 2
10252 </span>
Timothy Knightec817d52013-08-16 16:15:29 -0700[diff] [blame]10253 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10254 <div class="entry_type_notes">width x height in millimeters</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10255
10256
10257 </td> <!-- entry_type -->
10258
10259 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10260 <p>The physical dimensions of the full pixel
10261array</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10262 </td>
10263
10264 <td class="entry_units">
10265 </td>
10266
10267 <td class="entry_range">
10268 </td>
10269
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10270 <td class="entry_tags">
10271 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]10272 <li><a href="#tag_V1">V1</a></li>
10273 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10274 </ul>
10275 </td>
10276
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10277 </tr>
10278 <tr class="entries_header">
10279 <th class="th_details" colspan="5">Details</th>
10280 </tr>
10281 <tr class="entry_cont">
10282 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10283 <p>Needed for FOV calculation for old API</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10284 </td>
10285 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10286
10287
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10288 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10289 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10290
10291
10292 <tr class="entry" id="static_android.sensor.info.pixelArraySize">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10293 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10294 android.<wbr/>sensor.<wbr/>info.<wbr/>pixel<wbr/>Array<wbr/>Size
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10295 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10296 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10297 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10298 <span class="entry_type_container">x</span>
10299
10300 <span class="entry_type_array">
10301 2
10302 </span>
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]10303 <span class="entry_type_visibility"> [system as size]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10304
10305
10306 </td> <!-- entry_type -->
10307
10308 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10309 <p>Dimensions of full pixel array,<wbr/> possibly
10310including black calibration pixels</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10311 </td>
10312
10313 <td class="entry_units">
10314 </td>
10315
10316 <td class="entry_range">
10317 </td>
10318
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10319 <td class="entry_tags">
10320 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]10321 <li><a href="#tag_DNG">DNG</a></li>
10322 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10323 </ul>
10324 </td>
10325
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10326 </tr>
10327 <tr class="entries_header">
10328 <th class="th_details" colspan="5">Details</th>
10329 </tr>
10330 <tr class="entry_cont">
10331 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10332 <p>Maximum output resolution for raw format must
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10333match this in
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10334android.<wbr/>scaler.<wbr/>info.<wbr/>available<wbr/>Sizes<wbr/>Per<wbr/>Format</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10335 </td>
10336 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10337
10338
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10339 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10340 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10341
10342
10343 <tr class="entry" id="static_android.sensor.info.whiteLevel">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10344 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10345 android.<wbr/>sensor.<wbr/>info.<wbr/>white<wbr/>Level
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10346 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10347 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10348 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10349
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10350 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10351
10352
10353 </td> <!-- entry_type -->
10354
10355 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10356 <p>Maximum raw value output by
10357sensor</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10358 </td>
10359
10360 <td class="entry_units">
10361 </td>
10362
10363 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame]10364 <p>&gt; 1024 (10-bit output)</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10365 </td>
10366
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10367 <td class="entry_tags">
10368 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]10369 <li><a href="#tag_DNG">DNG</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10370 </ul>
10371 </td>
10372
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10373 </tr>
10374 <tr class="entries_header">
10375 <th class="th_details" colspan="5">Details</th>
10376 </tr>
10377 <tr class="entry_cont">
10378 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10379 <p>Defines sensor bit depth (10-14 bits is
10380expected)</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10381 </td>
10382 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10383
10384
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10385 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10386 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10387
10388
10389
10390
10391
10392 <tr class="entry" id="static_android.sensor.baseGainFactor">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10393 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10394 android.<wbr/>sensor.<wbr/>base<wbr/>Gain<wbr/>Factor
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10395 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10396 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10397 <span class="entry_type_name">rational</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10398
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10399 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10400
10401
10402 </td> <!-- entry_type -->
10403
10404 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10405 <p>Gain factor from electrons to raw units when
10406ISO=100</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10407 </td>
10408
10409 <td class="entry_units">
10410 </td>
10411
10412 <td class="entry_range">
10413 </td>
10414
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10415 <td class="entry_tags">
10416 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]10417 <li><a href="#tag_V1">V1</a></li>
Alex Rayef40ad62013-10-01 17:52:33 -0700[diff] [blame]10418 <li><a href="#tag_FULL">FULL</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10419 </ul>
10420 </td>
10421
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10422 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10423
10424
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10425 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10426 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10427
10428
10429 <tr class="entry" id="static_android.sensor.blackLevelPattern">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10430 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10431 android.<wbr/>sensor.<wbr/>black<wbr/>Level<wbr/>Pattern
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10432 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10433 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10434 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10435 <span class="entry_type_container">x</span>
10436
10437 <span class="entry_type_array">
10438 4
10439 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10440 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10441 <div class="entry_type_notes">2x2 raw count block</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10442
10443
10444 </td> <!-- entry_type -->
10445
10446 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10447 <p>A fixed black level offset for each of the
10448Bayer mosaic channels</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10449 </td>
10450
10451 <td class="entry_units">
10452 </td>
10453
10454 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame]10455 <p>&gt;= 0 each</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10456 </td>
10457
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10458 <td class="entry_tags">
10459 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]10460 <li><a href="#tag_DNG">DNG</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10461 </ul>
10462 </td>
10463
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10464 </tr>
10465 <tr class="entries_header">
10466 <th class="th_details" colspan="5">Details</th>
10467 </tr>
10468 <tr class="entry_cont">
10469 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10470 <p>As per DNG BlackLevelRepeatDim /<wbr/> BlackLevel
10471tags</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10472 </td>
10473 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10474
10475
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10476 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10477 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10478
10479
10480 <tr class="entry" id="static_android.sensor.calibrationTransform1">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10481 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10482 android.<wbr/>sensor.<wbr/>calibration<wbr/>Transform1
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10483 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10484 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10485 <span class="entry_type_name">rational</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10486 <span class="entry_type_container">x</span>
10487
10488 <span class="entry_type_array">
10489 9
10490 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10491 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10492 <div class="entry_type_notes">3x3 matrix in row-major-order</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10493
10494
10495 </td> <!-- entry_type -->
10496
10497 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10498 <p>Per-device calibration on top of color space
10499transform 1</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10500 </td>
10501
10502 <td class="entry_units">
10503 </td>
10504
10505 <td class="entry_range">
10506 </td>
10507
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10508 <td class="entry_tags">
10509 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]10510 <li><a href="#tag_DNG">DNG</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10511 </ul>
10512 </td>
10513
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10514 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10515
10516
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10517 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10518 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10519
10520
10521 <tr class="entry" id="static_android.sensor.calibrationTransform2">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10522 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10523 android.<wbr/>sensor.<wbr/>calibration<wbr/>Transform2
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10524 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10525 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10526 <span class="entry_type_name">rational</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10527 <span class="entry_type_container">x</span>
10528
10529 <span class="entry_type_array">
10530 9
10531 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10532 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10533 <div class="entry_type_notes">3x3 matrix in row-major-order</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10534
10535
10536 </td> <!-- entry_type -->
10537
10538 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10539 <p>Per-device calibration on top of color space
10540transform 2</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10541 </td>
10542
10543 <td class="entry_units">
10544 </td>
10545
10546 <td class="entry_range">
10547 </td>
10548
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10549 <td class="entry_tags">
10550 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]10551 <li><a href="#tag_DNG">DNG</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10552 </ul>
10553 </td>
10554
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10555 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10556
10557
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10558 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10559 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10560
10561
10562 <tr class="entry" id="static_android.sensor.colorTransform1">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10563 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10564 android.<wbr/>sensor.<wbr/>color<wbr/>Transform1
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10565 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10566 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10567 <span class="entry_type_name">rational</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10568 <span class="entry_type_container">x</span>
10569
10570 <span class="entry_type_array">
10571 9
10572 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10573 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10574 <div class="entry_type_notes">3x3 matrix in row-major-order</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10575
10576
10577 </td> <!-- entry_type -->
10578
10579 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10580 <p>Linear mapping from XYZ (D50) color space to
10581reference linear sensor color,<wbr/> for first reference
10582illuminant</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10583 </td>
10584
10585 <td class="entry_units">
10586 </td>
10587
10588 <td class="entry_range">
10589 </td>
10590
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10591 <td class="entry_tags">
10592 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]10593 <li><a href="#tag_DNG">DNG</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10594 </ul>
10595 </td>
10596
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10597 </tr>
10598 <tr class="entries_header">
10599 <th class="th_details" colspan="5">Details</th>
10600 </tr>
10601 <tr class="entry_cont">
10602 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10603 <p>Use as follows XYZ = inv(transform) * clip( (raw -
10604black level(raw) ) /<wbr/> ( white level - max black level) ).<wbr/>
10605At least in the simple case</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10606 </td>
10607 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10608
10609
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10610 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10611 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10612
10613
10614 <tr class="entry" id="static_android.sensor.colorTransform2">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10615 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10616 android.<wbr/>sensor.<wbr/>color<wbr/>Transform2
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10617 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10618 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10619 <span class="entry_type_name">rational</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10620 <span class="entry_type_container">x</span>
10621
10622 <span class="entry_type_array">
10623 9
10624 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10625 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10626 <div class="entry_type_notes">3x3 matrix in row-major-order</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10627
10628
10629 </td> <!-- entry_type -->
10630
10631 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10632 <p>Linear mapping from XYZ (D50) color space to
10633reference linear sensor color,<wbr/> for second reference
10634illuminant</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10635 </td>
10636
10637 <td class="entry_units">
10638 </td>
10639
10640 <td class="entry_range">
10641 </td>
10642
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10643 <td class="entry_tags">
10644 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]10645 <li><a href="#tag_DNG">DNG</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10646 </ul>
10647 </td>
10648
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10649 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10650
10651
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10652 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10653 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10654
10655
10656 <tr class="entry" id="static_android.sensor.forwardMatrix1">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10657 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10658 android.<wbr/>sensor.<wbr/>forward<wbr/>Matrix1
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10659 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10660 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10661 <span class="entry_type_name">rational</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10662 <span class="entry_type_container">x</span>
10663
10664 <span class="entry_type_array">
10665 9
10666 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10667 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10668 <div class="entry_type_notes">3x3 matrix in row-major-order</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10669
10670
10671 </td> <!-- entry_type -->
10672
10673 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10674 <p>Used by DNG for better WB
10675adaptation</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10676 </td>
10677
10678 <td class="entry_units">
10679 </td>
10680
10681 <td class="entry_range">
10682 </td>
10683
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10684 <td class="entry_tags">
10685 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]10686 <li><a href="#tag_DNG">DNG</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10687 </ul>
10688 </td>
10689
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10690 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10691
10692
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10693 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10694 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10695
10696
10697 <tr class="entry" id="static_android.sensor.forwardMatrix2">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10698 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10699 android.<wbr/>sensor.<wbr/>forward<wbr/>Matrix2
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10700 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10701 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10702 <span class="entry_type_name">rational</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10703 <span class="entry_type_container">x</span>
10704
10705 <span class="entry_type_array">
10706 9
10707 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10708 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10709 <div class="entry_type_notes">3x3 matrix in row-major-order</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10710
10711
10712 </td> <!-- entry_type -->
10713
10714 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10715 <p>Used by DNG for better WB
10716adaptation</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10717 </td>
10718
10719 <td class="entry_units">
10720 </td>
10721
10722 <td class="entry_range">
10723 </td>
10724
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10725 <td class="entry_tags">
10726 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]10727 <li><a href="#tag_DNG">DNG</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10728 </ul>
10729 </td>
10730
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10731 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10732
10733
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10734 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10735 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10736
10737
10738 <tr class="entry" id="static_android.sensor.maxAnalogSensitivity">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10739 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10740 android.<wbr/>sensor.<wbr/>max<wbr/>Analog<wbr/>Sensitivity
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10741 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10742 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10743 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10744
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10745 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10746
10747
10748 </td> <!-- entry_type -->
10749
10750 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10751 <p>Maximum sensitivity that is implemented
10752purely through analog gain</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10753 </td>
10754
10755 <td class="entry_units">
10756 </td>
10757
10758 <td class="entry_range">
10759 </td>
10760
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10761 <td class="entry_tags">
10762 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]10763 <li><a href="#tag_V1">V1</a></li>
Alex Rayef40ad62013-10-01 17:52:33 -0700[diff] [blame]10764 <li><a href="#tag_FULL">FULL</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10765 </ul>
10766 </td>
10767
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10768 </tr>
10769 <tr class="entries_header">
10770 <th class="th_details" colspan="5">Details</th>
10771 </tr>
10772 <tr class="entry_cont">
10773 <td class="entry_details" colspan="5">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]10774 <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]10775equal to this,<wbr/> all applied gain must be analog.<wbr/> For
10776values above this,<wbr/> it can be a mix of analog and
10777digital</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10778 </td>
10779 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10780
10781
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10782 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10783 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10784
10785
10786 <tr class="entry" id="static_android.sensor.noiseModelCoefficients">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10787 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10788 android.<wbr/>sensor.<wbr/>noise<wbr/>Model<wbr/>Coefficients
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10789 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10790 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10791 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10792 <span class="entry_type_container">x</span>
10793
10794 <span class="entry_type_array">
10795 2
10796 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10797 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10798 <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]10799
10800
10801 </td> <!-- entry_type -->
10802
10803 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10804 <p>Estimation of sensor noise
10805characteristics</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10806 </td>
10807
10808 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10809 var(raw pixel value) = electrons * (baseGainFactor
10810 * iso/<wbr/>100)^2 + A * (baseGainFactor * iso/<wbr/>100)^2 +
10811 B
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10812 </td>
10813
10814 <td class="entry_range">
10815 </td>
10816
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10817 <td class="entry_tags">
10818 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]10819 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10820 </ul>
10821 </td>
10822
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10823 </tr>
10824 <tr class="entries_header">
10825 <th class="th_details" colspan="5">Details</th>
10826 </tr>
10827 <tr class="entry_cont">
10828 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10829 <p>A represents sensor read noise before analog
10830amplification; B represents noise from A/<wbr/>D conversion and
10831other circuits after amplification.<wbr/> Both noise sources
10832are assumed to be gaussian,<wbr/> independent,<wbr/> and not to vary
10833across the sensor</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10834 </td>
10835 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10836
10837
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10838 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10839 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10840
10841
10842 <tr class="entry" id="static_android.sensor.orientation">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10843 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10844 android.<wbr/>sensor.<wbr/>orientation
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10845 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10846 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10847 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10848
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10849 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10850
10851
10852 </td> <!-- entry_type -->
10853
10854 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10855 <p>Clockwise angle through which the output
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]10856image needs to be rotated to be upright on the device
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10857screen in its native orientation.<wbr/> Also defines the
10858direction of rolling shutter readout,<wbr/> which is from top
10859to bottom in the sensor's coordinate system</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10860 </td>
10861
10862 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10863 degrees clockwise rotation,<wbr/> only multiples of
10864 90
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10865 </td>
10866
10867 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]10868 <p>0,<wbr/>90,<wbr/>180,<wbr/>270</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10869 </td>
10870
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10871 <td class="entry_tags">
10872 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]10873 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10874 </ul>
10875 </td>
10876
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10877 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10878
10879
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10880 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10881 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10882
10883
10884 <tr class="entry" id="static_android.sensor.referenceIlluminant1">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10885 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10886 android.<wbr/>sensor.<wbr/>reference<wbr/>Illuminant1
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10887 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10888 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10889 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10890
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10891 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10892
10893 <ul class="entry_type_enum">
10894 <li>
10895 <span class="entry_type_enum_name">DAYLIGHT</span>
10896 <span class="entry_type_enum_value">1</span>
10897 </li>
10898 <li>
10899 <span class="entry_type_enum_name">FLUORESCENT</span>
10900 <span class="entry_type_enum_value">2</span>
10901 </li>
10902 <li>
10903 <span class="entry_type_enum_name">TUNGSTEN</span>
10904 <span class="entry_type_enum_value">3</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]10905 <span class="entry_type_enum_notes"><p>Incandescent light</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10906 </li>
10907 <li>
10908 <span class="entry_type_enum_name">FLASH</span>
10909 <span class="entry_type_enum_value">4</span>
10910 </li>
10911 <li>
10912 <span class="entry_type_enum_name">FINE_WEATHER</span>
10913 <span class="entry_type_enum_value">9</span>
10914 </li>
10915 <li>
10916 <span class="entry_type_enum_name">CLOUDY_WEATHER</span>
10917 <span class="entry_type_enum_value">10</span>
10918 </li>
10919 <li>
10920 <span class="entry_type_enum_name">SHADE</span>
10921 <span class="entry_type_enum_value">11</span>
10922 </li>
10923 <li>
10924 <span class="entry_type_enum_name">DAYLIGHT_FLUORESCENT</span>
10925 <span class="entry_type_enum_value">12</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]10926 <span class="entry_type_enum_notes"><p>D 5700 - 7100K</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10927 </li>
10928 <li>
10929 <span class="entry_type_enum_name">DAY_WHITE_FLUORESCENT</span>
10930 <span class="entry_type_enum_value">13</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]10931 <span class="entry_type_enum_notes"><p>N 4600 - 5400K</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10932 </li>
10933 <li>
10934 <span class="entry_type_enum_name">COOL_WHITE_FLUORESCENT</span>
10935 <span class="entry_type_enum_value">14</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]10936 <span class="entry_type_enum_notes"><p>W 3900 - 4500K</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10937 </li>
10938 <li>
10939 <span class="entry_type_enum_name">WHITE_FLUORESCENT</span>
10940 <span class="entry_type_enum_value">15</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]10941 <span class="entry_type_enum_notes"><p>WW 3200 - 3700K</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10942 </li>
10943 <li>
10944 <span class="entry_type_enum_name">STANDARD_A</span>
10945 <span class="entry_type_enum_value">17</span>
10946 </li>
10947 <li>
10948 <span class="entry_type_enum_name">STANDARD_B</span>
10949 <span class="entry_type_enum_value">18</span>
10950 </li>
10951 <li>
10952 <span class="entry_type_enum_name">STANDARD_C</span>
10953 <span class="entry_type_enum_value">19</span>
10954 </li>
10955 <li>
10956 <span class="entry_type_enum_name">D55</span>
10957 <span class="entry_type_enum_value">20</span>
10958 </li>
10959 <li>
10960 <span class="entry_type_enum_name">D65</span>
10961 <span class="entry_type_enum_value">21</span>
10962 </li>
10963 <li>
10964 <span class="entry_type_enum_name">D75</span>
10965 <span class="entry_type_enum_value">22</span>
10966 </li>
10967 <li>
10968 <span class="entry_type_enum_name">D50</span>
10969 <span class="entry_type_enum_value">23</span>
10970 </li>
10971 <li>
10972 <span class="entry_type_enum_name">ISO_STUDIO_TUNGSTEN</span>
10973 <span class="entry_type_enum_value">24</span>
10974 </li>
10975 </ul>
10976
10977 </td> <!-- entry_type -->
10978
10979 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10980 <p>Light source used to define transform
109811</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10982 </td>
10983
10984 <td class="entry_units">
10985 </td>
10986
10987 <td class="entry_range">
10988 </td>
10989
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10990 <td class="entry_tags">
10991 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]10992 <li><a href="#tag_DNG">DNG</a></li>
10993 <li><a href="#tag_EXIF">EXIF</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10994 </ul>
10995 </td>
10996
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10997 </tr>
10998 <tr class="entries_header">
10999 <th class="th_details" colspan="5">Details</th>
11000 </tr>
11001 <tr class="entry_cont">
11002 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11003 <p>[EXIF LightSource tag] Must all these be
11004supported? Need CCT for each!</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11005 </td>
11006 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11007
11008
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11009 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11010 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11011
11012
11013 <tr class="entry" id="static_android.sensor.referenceIlluminant2">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11014 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11015 android.<wbr/>sensor.<wbr/>reference<wbr/>Illuminant2
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11016 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11017 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]11018 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11019
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]11020 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11021
11022
11023 </td> <!-- entry_type -->
11024
11025 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11026 <p>Light source used to define transform
110272</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11028 </td>
11029
11030 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11031 Same as illuminant 1
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11032 </td>
11033
11034 <td class="entry_range">
11035 </td>
11036
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11037 <td class="entry_tags">
11038 </td>
11039
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11040 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11041
11042
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11043 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11044 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11045
11046
11047
11048 <!-- end of kind -->
11049 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11050 <tr><td colspan="6" class="kind">dynamic</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11051
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]11052 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11053 <tr>
11054 <th class="th_name">Property Name</th>
11055 <th class="th_type">Type</th>
11056 <th class="th_description">Description</th>
11057 <th class="th_units">Units</th>
11058 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11059 <th class="th_tags">Tags</th>
11060 </tr>
11061 </thead>
11062
11063 <tbody>
11064
11065
11066
11067
11068
11069
11070
11071
11072
11073
11074 <tr class="entry" id="dynamic_android.sensor.exposureTime">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11075 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11076 android.<wbr/>sensor.<wbr/>exposure<wbr/>Time
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11077 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11078 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]11079 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11080
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]11081 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11082
11083
11084 </td> <!-- entry_type -->
11085
11086 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11087 <p>Duration each pixel is exposed to
11088light.<wbr/></p>
11089<p>If the sensor can't expose this exact duration,<wbr/> it should shorten the
11090duration exposed to the nearest possible value (rather than expose longer).<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11091 </td>
11092
11093 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11094 nanoseconds
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11095 </td>
11096
11097 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]11098 <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]11099 </td>
11100
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11101 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]11102 <ul class="entry_tags">
11103 <li><a href="#tag_V1">V1</a></li>
11104 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11105 </td>
11106
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11107 </tr>
11108 <tr class="entries_header">
11109 <th class="th_details" colspan="5">Details</th>
11110 </tr>
11111 <tr class="entry_cont">
11112 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11113 <p>1/<wbr/>10000 - 30 sec range.<wbr/> No bulb mode</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11114 </td>
11115 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11116
11117
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11118 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11119 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11120
11121
11122 <tr class="entry" id="dynamic_android.sensor.frameDuration">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11123 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11124 android.<wbr/>sensor.<wbr/>frame<wbr/>Duration
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11125 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11126 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]11127 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11128
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]11129 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11130
11131
11132 </td> <!-- entry_type -->
11133
11134 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11135 <p>Duration from start of frame exposure to
11136start of next frame exposure</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11137 </td>
11138
11139 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11140 nanoseconds
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11141 </td>
11142
11143 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]11144 <p>see <a href="#static_android.sensor.info.maxFrameDuration">android.<wbr/>sensor.<wbr/>info.<wbr/>max<wbr/>Frame<wbr/>Duration</a>,<wbr/>
11145android.<wbr/>scaler.<wbr/>info.<wbr/>available<wbr/>Min<wbr/>Frame<wbr/>Durations</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11146 </td>
11147
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11148 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]11149 <ul class="entry_tags">
11150 <li><a href="#tag_V1">V1</a></li>
11151 <li><a href="#tag_BC">BC</a></li>
11152 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11153 </td>
11154
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11155 </tr>
11156 <tr class="entries_header">
11157 <th class="th_details" colspan="5">Details</th>
11158 </tr>
11159 <tr class="entry_cont">
11160 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11161 <p>Exposure time has priority,<wbr/> so duration is set to
11162max(duration,<wbr/> exposure time + overhead)</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11163 </td>
11164 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11165
11166
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11167 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11168 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11169
11170
11171 <tr class="entry" id="dynamic_android.sensor.sensitivity">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11172 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11173 android.<wbr/>sensor.<wbr/>sensitivity
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11174 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11175 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]11176 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11177
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]11178 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11179
11180
11181 </td> <!-- entry_type -->
11182
11183 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11184 <p>Gain applied to image data.<wbr/> Must be
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]11185implemented through analog gain only if set to values
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11186below 'maximum analog sensitivity'.<wbr/></p>
11187<p>If the sensor can't apply this exact gain,<wbr/> it should lessen the
11188gain to the nearest possible value (rather than gain more).<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11189 </td>
11190
11191 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11192 ISO arithmetic units
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11193 </td>
11194
11195 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]11196 <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]11197 </td>
11198
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11199 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]11200 <ul class="entry_tags">
11201 <li><a href="#tag_V1">V1</a></li>
11202 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11203 </td>
11204
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11205 </tr>
11206 <tr class="entries_header">
11207 <th class="th_details" colspan="5">Details</th>
11208 </tr>
11209 <tr class="entry_cont">
11210 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11211 <p>ISO 12232:2006 REI method</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11212 </td>
11213 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11214
11215
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11216 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11217 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11218
11219
11220 <tr class="entry" id="dynamic_android.sensor.timestamp">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11221 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11222 android.<wbr/>sensor.<wbr/>timestamp
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11223 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11224 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]11225 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11226
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]11227 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11228
11229
11230 </td> <!-- entry_type -->
11231
11232 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11233 <p>Time at start of exposure of first
11234row</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11235 </td>
11236
11237 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11238 nanoseconds
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11239 </td>
11240
11241 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame]11242 <p>&gt; 0</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11243 </td>
11244
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11245 <td class="entry_tags">
11246 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]11247 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11248 </ul>
11249 </td>
11250
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11251 </tr>
11252 <tr class="entries_header">
11253 <th class="th_details" colspan="5">Details</th>
11254 </tr>
11255 <tr class="entry_cont">
11256 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11257 <p>Monotonic,<wbr/> should be synced to other timestamps in
11258system</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11259 </td>
11260 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11261
11262
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11263 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11264 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11265
Igor Murashkin656aa5a2013-08-13 14:23:39 -0700[diff] [blame]11266
11267 <tr class="entry" id="dynamic_android.sensor.temperature">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11268 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11269 android.<wbr/>sensor.<wbr/>temperature
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11270 </td>
Igor Murashkin656aa5a2013-08-13 14:23:39 -0700[diff] [blame]11271 <td class="entry_type">
11272 <span class="entry_type_name">float</span>
11273
11274 <span class="entry_type_visibility"> [public]</span>
11275
11276
11277 </td> <!-- entry_type -->
11278
11279 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11280 <p>The temperature of the sensor,<wbr/> sampled at the time
11281exposure began for this frame.<wbr/></p>
11282<p>The thermal diode being queried should be inside the sensor PCB,<wbr/> or
11283somewhere close to it.<wbr/></p>
Igor Murashkin656aa5a2013-08-13 14:23:39 -0700[diff] [blame]11284 </td>
11285
11286 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11287 celsius
Igor Murashkin656aa5a2013-08-13 14:23:39 -0700[diff] [blame]11288 </td>
11289
11290 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]11291 <p>Optional.<wbr/> This value is missing if no temperature is available.<wbr/></p>
Igor Murashkin656aa5a2013-08-13 14:23:39 -0700[diff] [blame]11292 </td>
11293
Igor Murashkin656aa5a2013-08-13 14:23:39 -0700[diff] [blame]11294 <td class="entry_tags">
Alex Rayef40ad62013-10-01 17:52:33 -0700[diff] [blame]11295 <ul class="entry_tags">
11296 <li><a href="#tag_FULL">FULL</a></li>
11297 </ul>
Igor Murashkin656aa5a2013-08-13 14:23:39 -0700[diff] [blame]11298 </td>
11299
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11300 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11301
11302
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11303 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11304 <!-- end of entry -->
Igor Murashkin656aa5a2013-08-13 14:23:39 -0700[diff] [blame]11305
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11306
11307
11308 <!-- end of kind -->
11309 </tbody>
11310
11311 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11312 <tr><td colspan="6" id="section_shading" class="section">shading</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11313
11314
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11315 <tr><td colspan="6" class="kind">controls</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11316
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]11317 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11318 <tr>
11319 <th class="th_name">Property Name</th>
11320 <th class="th_type">Type</th>
11321 <th class="th_description">Description</th>
11322 <th class="th_units">Units</th>
11323 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11324 <th class="th_tags">Tags</th>
11325 </tr>
11326 </thead>
11327
11328 <tbody>
11329
11330
11331
11332
11333
11334
11335
11336
11337
11338
11339 <tr class="entry" id="controls_android.shading.mode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11340 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11341 android.<wbr/>shading.<wbr/>mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11342 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11343 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]11344 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11345
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]11346 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11347
11348 <ul class="entry_type_enum">
11349 <li>
11350 <span class="entry_type_enum_name">OFF</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]11351 <span class="entry_type_enum_notes"><p>No shading correction is applied</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11352 </li>
11353 <li>
11354 <span class="entry_type_enum_name">FAST</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]11355 <span class="entry_type_enum_notes"><p>Must not slow down frame rate relative to raw
11356bayer output</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11357 </li>
11358 <li>
11359 <span class="entry_type_enum_name">HIGH_QUALITY</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]11360 <span class="entry_type_enum_notes"><p>Frame rate may be reduced by high
11361quality</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11362 </li>
11363 </ul>
11364
11365 </td> <!-- entry_type -->
11366
11367 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11368 <p>Quality of lens shading correction applied
11369to the image data</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11370 </td>
11371
11372 <td class="entry_units">
11373 </td>
11374
11375 <td class="entry_range">
11376 </td>
11377
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11378 <td class="entry_tags">
11379 </td>
11380
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11381 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11382
11383
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11384 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11385 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11386
11387
11388 <tr class="entry" id="controls_android.shading.strength">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11389 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11390 android.<wbr/>shading.<wbr/>strength
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11391 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11392 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]11393 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11394
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]11395 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11396
11397
11398 </td> <!-- entry_type -->
11399
11400 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11401 <p>Control the amount of shading correction
11402applied to the images</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11403 </td>
11404
11405 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11406 unitless: 1-10; 10 is full shading
11407 compensation
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11408 </td>
11409
11410 <td class="entry_range">
11411 </td>
11412
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11413 <td class="entry_tags">
11414 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]11415 <li><a href="#tag_ADV">ADV</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11416 </ul>
11417 </td>
11418
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11419 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11420
11421
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11422 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11423 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11424
11425
11426
11427 <!-- end of kind -->
11428 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11429 <tr><td colspan="6" class="kind">dynamic</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11430
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]11431 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11432 <tr>
11433 <th class="th_name">Property Name</th>
11434 <th class="th_type">Type</th>
11435 <th class="th_description">Description</th>
11436 <th class="th_units">Units</th>
11437 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11438 <th class="th_tags">Tags</th>
11439 </tr>
11440 </thead>
11441
11442 <tbody>
11443
11444
11445
11446
11447
11448
11449
11450
11451
11452
11453 <tr class="entry" id="dynamic_android.shading.mode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11454 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11455 android.<wbr/>shading.<wbr/>mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11456 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11457 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]11458 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11459
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]11460 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11461
11462 <ul class="entry_type_enum">
11463 <li>
11464 <span class="entry_type_enum_name">OFF</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]11465 <span class="entry_type_enum_notes"><p>No shading correction is applied</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11466 </li>
11467 <li>
11468 <span class="entry_type_enum_name">FAST</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]11469 <span class="entry_type_enum_notes"><p>Must not slow down frame rate relative to raw
11470bayer output</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11471 </li>
11472 <li>
11473 <span class="entry_type_enum_name">HIGH_QUALITY</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]11474 <span class="entry_type_enum_notes"><p>Frame rate may be reduced by high
11475quality</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11476 </li>
11477 </ul>
11478
11479 </td> <!-- entry_type -->
11480
11481 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11482 <p>Quality of lens shading correction applied
11483to the image data</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11484 </td>
11485
11486 <td class="entry_units">
11487 </td>
11488
11489 <td class="entry_range">
11490 </td>
11491
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11492 <td class="entry_tags">
11493 </td>
11494
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11495 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11496
11497
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11498 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11499 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11500
11501
11502
11503 <!-- end of kind -->
11504 </tbody>
11505
11506 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11507 <tr><td colspan="6" id="section_statistics" class="section">statistics</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11508
11509
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11510 <tr><td colspan="6" class="kind">controls</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11511
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]11512 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11513 <tr>
11514 <th class="th_name">Property Name</th>
11515 <th class="th_type">Type</th>
11516 <th class="th_description">Description</th>
11517 <th class="th_units">Units</th>
11518 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11519 <th class="th_tags">Tags</th>
11520 </tr>
11521 </thead>
11522
11523 <tbody>
11524
11525
11526
11527
11528
11529
11530
11531
11532
11533
11534 <tr class="entry" id="controls_android.statistics.faceDetectMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11535 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11536 android.<wbr/>statistics.<wbr/>face<wbr/>Detect<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11537 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11538 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]11539 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11540
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]11541 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11542
11543 <ul class="entry_type_enum">
11544 <li>
11545 <span class="entry_type_enum_name">OFF</span>
11546 </li>
11547 <li>
11548 <span class="entry_type_enum_name">SIMPLE</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]11549 <span class="entry_type_enum_notes"><p>Optional Return rectangle and confidence
11550only</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11551 </li>
11552 <li>
11553 <span class="entry_type_enum_name">FULL</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]11554 <span class="entry_type_enum_notes"><p>Optional Return all face
11555metadata</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11556 </li>
11557 </ul>
11558
11559 </td> <!-- entry_type -->
11560
11561 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11562 <p>State of the face detector
11563unit</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11564 </td>
11565
11566 <td class="entry_units">
11567 </td>
11568
11569 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]11570 <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]11571 </td>
11572
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11573 <td class="entry_tags">
11574 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]11575 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11576 </ul>
11577 </td>
11578
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11579 </tr>
11580 <tr class="entries_header">
11581 <th class="th_details" colspan="5">Details</th>
11582 </tr>
11583 <tr class="entry_cont">
11584 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11585 <p>Whether face detection is enabled,<wbr/> and whether it
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11586should output just the basic fields or the full set of
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11587fields.<wbr/> Value must be one of the
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]11588<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]11589 </td>
11590 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11591
11592
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11593 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11594 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11595
11596
11597 <tr class="entry" id="controls_android.statistics.histogramMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11598 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11599 android.<wbr/>statistics.<wbr/>histogram<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11600 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11601 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]11602 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11603
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]11604 <span class="entry_type_visibility"> [system as boolean]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11605
11606 <ul class="entry_type_enum">
11607 <li>
11608 <span class="entry_type_enum_name">OFF</span>
11609 </li>
11610 <li>
11611 <span class="entry_type_enum_name">ON</span>
11612 </li>
11613 </ul>
11614
11615 </td> <!-- entry_type -->
11616
11617 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11618 <p>Operating mode for histogram
11619generation</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11620 </td>
11621
11622 <td class="entry_units">
11623 </td>
11624
11625 <td class="entry_range">
11626 </td>
11627
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11628 <td class="entry_tags">
11629 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]11630 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11631 </ul>
11632 </td>
11633
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11634 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11635
11636
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11637 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11638 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11639
11640
11641 <tr class="entry" id="controls_android.statistics.sharpnessMapMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11642 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11643 android.<wbr/>statistics.<wbr/>sharpness<wbr/>Map<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11644 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11645 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]11646 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11647
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]11648 <span class="entry_type_visibility"> [system as boolean]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11649
11650 <ul class="entry_type_enum">
11651 <li>
11652 <span class="entry_type_enum_name">OFF</span>
11653 </li>
11654 <li>
11655 <span class="entry_type_enum_name">ON</span>
11656 </li>
11657 </ul>
11658
11659 </td> <!-- entry_type -->
11660
11661 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11662 <p>Operating mode for sharpness map
11663generation</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11664 </td>
11665
11666 <td class="entry_units">
11667 </td>
11668
11669 <td class="entry_range">
11670 </td>
11671
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11672 <td class="entry_tags">
11673 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]11674 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11675 </ul>
11676 </td>
11677
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11678 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11679
11680
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11681 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11682 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11683
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]11684
11685 <tr class="entry" id="controls_android.statistics.lensShadingMapMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11686 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11687 android.<wbr/>statistics.<wbr/>lens<wbr/>Shading<wbr/>Map<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11688 </td>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]11689 <td class="entry_type">
11690 <span class="entry_type_name entry_type_name_enum">byte</span>
11691
11692 <span class="entry_type_visibility"> [public]</span>
11693
11694 <ul class="entry_type_enum">
11695 <li>
11696 <span class="entry_type_enum_name">OFF</span>
11697 </li>
11698 <li>
11699 <span class="entry_type_enum_name">ON</span>
11700 </li>
11701 </ul>
11702
11703 </td> <!-- entry_type -->
11704
11705 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11706 <p>Whether the HAL needs to output the lens
11707shading map in output result metadata</p>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]11708 </td>
11709
11710 <td class="entry_units">
11711 </td>
11712
11713 <td class="entry_range">
11714 </td>
11715
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11716 <td class="entry_tags">
11717 </td>
11718
11719 </tr>
11720 <tr class="entries_header">
11721 <th class="th_details" colspan="5">Details</th>
11722 </tr>
11723 <tr class="entry_cont">
11724 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11725 <p>When set to ON,<wbr/>
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]11726<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]11727the output result metadata.<wbr/></p>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]11728 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11729 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11730
11731
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11732 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11733 <!-- end of entry -->
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]11734
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11735
11736
11737 <!-- end of kind -->
11738 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11739 <tr><td colspan="6" class="kind">static</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11740
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]11741 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11742 <tr>
11743 <th class="th_name">Property Name</th>
11744 <th class="th_type">Type</th>
11745 <th class="th_description">Description</th>
11746 <th class="th_units">Units</th>
11747 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11748 <th class="th_tags">Tags</th>
11749 </tr>
11750 </thead>
11751
11752 <tbody>
11753
11754
11755
11756
11757
11758
11759
11760
11761
11762
11763
11764
11765 <tr class="entry" id="static_android.statistics.info.availableFaceDetectModes">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11766 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11767 android.<wbr/>statistics.<wbr/>info.<wbr/>available<wbr/>Face<wbr/>Detect<wbr/>Modes
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11768 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11769 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]11770 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11771 <span class="entry_type_container">x</span>
11772
11773 <span class="entry_type_array">
11774 n
11775 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]11776 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11777 <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]11778
11779
11780 </td> <!-- entry_type -->
11781
11782 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11783 <p>Which face detection modes are available,<wbr/>
11784if any</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11785 </td>
11786
11787 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11788 List of enum:
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]11789 OFF
11790 SIMPLE
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11791 FULL
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11792 </td>
11793
11794 <td class="entry_range">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11795 </td>
11796
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11797 <td class="entry_tags">
11798 </td>
11799
11800 </tr>
11801 <tr class="entries_header">
11802 <th class="th_details" colspan="5">Details</th>
11803 </tr>
11804 <tr class="entry_cont">
11805 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11806 <p>OFF means face detection is disabled,<wbr/> it must
11807be included in the list.<wbr/></p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]11808<p>SIMPLE means the device supports the
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]11809<a href="#dynamic_android.statistics.faceRectangles">android.<wbr/>statistics.<wbr/>face<wbr/>Rectangles</a> and
11810<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]11811<p>FULL means the device additionally supports the
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]11812<a href="#dynamic_android.statistics.faceIds">android.<wbr/>statistics.<wbr/>face<wbr/>Ids</a> and
11813<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]11814 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11815 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11816
11817
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11818 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11819 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11820
11821
11822 <tr class="entry" id="static_android.statistics.info.histogramBucketCount">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11823 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11824 android.<wbr/>statistics.<wbr/>info.<wbr/>histogram<wbr/>Bucket<wbr/>Count
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11825 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11826 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]11827 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11828
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]11829 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11830
11831
11832 </td> <!-- entry_type -->
11833
11834 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11835 <p>Number of histogram buckets
11836supported</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11837 </td>
11838
11839 <td class="entry_units">
11840 </td>
11841
11842 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame]11843 <p>&gt;= 64</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11844 </td>
11845
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11846 <td class="entry_tags">
11847 </td>
11848
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11849 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11850
11851
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11852 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11853 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11854
11855
11856 <tr class="entry" id="static_android.statistics.info.maxFaceCount">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11857 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11858 android.<wbr/>statistics.<wbr/>info.<wbr/>max<wbr/>Face<wbr/>Count
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11859 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11860 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]11861 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11862
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]11863 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11864
11865
11866 </td> <!-- entry_type -->
11867
11868 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11869 <p>Maximum number of simultaneously detectable
11870faces</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11871 </td>
11872
11873 <td class="entry_units">
11874 </td>
11875
11876 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame]11877 <p>&gt;= 4 if availableFaceDetectionModes lists
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]11878modes besides OFF,<wbr/> otherwise 0</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11879 </td>
11880
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11881 <td class="entry_tags">
11882 </td>
11883
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11884 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11885
11886
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11887 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11888 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11889
11890
11891 <tr class="entry" id="static_android.statistics.info.maxHistogramCount">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11892 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11893 android.<wbr/>statistics.<wbr/>info.<wbr/>max<wbr/>Histogram<wbr/>Count
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11894 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11895 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]11896 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11897
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]11898 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11899
11900
11901 </td> <!-- entry_type -->
11902
11903 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11904 <p>Maximum value possible for a histogram
11905bucket</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11906 </td>
11907
11908 <td class="entry_units">
11909 </td>
11910
11911 <td class="entry_range">
11912 </td>
11913
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11914 <td class="entry_tags">
11915 </td>
11916
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11917 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11918
11919
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11920 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11921 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11922
11923
11924 <tr class="entry" id="static_android.statistics.info.maxSharpnessMapValue">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11925 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11926 android.<wbr/>statistics.<wbr/>info.<wbr/>max<wbr/>Sharpness<wbr/>Map<wbr/>Value
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11927 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11928 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]11929 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11930
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]11931 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11932
11933
11934 </td> <!-- entry_type -->
11935
11936 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11937 <p>Maximum value possible for a sharpness map
11938region.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11939 </td>
11940
11941 <td class="entry_units">
11942 </td>
11943
11944 <td class="entry_range">
11945 </td>
11946
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11947 <td class="entry_tags">
11948 </td>
11949
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11950 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11951
11952
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11953 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11954 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11955
11956
11957 <tr class="entry" id="static_android.statistics.info.sharpnessMapSize">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11958 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11959 android.<wbr/>statistics.<wbr/>info.<wbr/>sharpness<wbr/>Map<wbr/>Size
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11960 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11961 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]11962 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11963 <span class="entry_type_container">x</span>
11964
11965 <span class="entry_type_array">
11966 2
11967 </span>
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]11968 <span class="entry_type_visibility"> [system as size]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11969 <div class="entry_type_notes">width x height</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11970
11971
11972 </td> <!-- entry_type -->
11973
11974 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11975 <p>Dimensions of the sharpness
11976map</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11977 </td>
11978
11979 <td class="entry_units">
11980 </td>
11981
11982 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]11983 <p>Must be at least 32 x 32</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11984 </td>
11985
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11986 <td class="entry_tags">
11987 </td>
11988
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11989 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11990
11991
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11992 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11993 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11994
11995
11996
11997
11998
11999
12000 <!-- end of kind -->
12001 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12002 <tr><td colspan="6" class="kind">dynamic</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12003
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]12004 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12005 <tr>
12006 <th class="th_name">Property Name</th>
12007 <th class="th_type">Type</th>
12008 <th class="th_description">Description</th>
12009 <th class="th_units">Units</th>
12010 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12011 <th class="th_tags">Tags</th>
12012 </tr>
12013 </thead>
12014
12015 <tbody>
12016
12017
12018
12019
12020
12021
12022
12023
12024
12025
12026 <tr class="entry" id="dynamic_android.statistics.faceDetectMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12027 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12028 android.<wbr/>statistics.<wbr/>face<wbr/>Detect<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12029 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12030 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]12031 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12032
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]12033 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12034
12035 <ul class="entry_type_enum">
12036 <li>
12037 <span class="entry_type_enum_name">OFF</span>
12038 </li>
12039 <li>
12040 <span class="entry_type_enum_name">SIMPLE</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]12041 <span class="entry_type_enum_notes"><p>Optional Return rectangle and confidence
12042only</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12043 </li>
12044 <li>
12045 <span class="entry_type_enum_name">FULL</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]12046 <span class="entry_type_enum_notes"><p>Optional Return all face
12047metadata</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12048 </li>
12049 </ul>
12050
12051 </td> <!-- entry_type -->
12052
12053 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12054 <p>State of the face detector
12055unit</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12056 </td>
12057
12058 <td class="entry_units">
12059 </td>
12060
12061 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]12062 <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]12063 </td>
12064
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12065 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]12066 <ul class="entry_tags">
12067 <li><a href="#tag_BC">BC</a></li>
12068 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12069 </td>
12070
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12071 </tr>
12072 <tr class="entries_header">
12073 <th class="th_details" colspan="5">Details</th>
12074 </tr>
12075 <tr class="entry_cont">
12076 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12077 <p>Whether face detection is enabled,<wbr/> and whether it
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12078should output just the basic fields or the full set of
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12079fields.<wbr/> Value must be one of the
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]12080<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]12081 </td>
12082 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12083
12084
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12085 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
12086 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12087
12088
12089 <tr class="entry" id="dynamic_android.statistics.faceIds">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12090 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12091 android.<wbr/>statistics.<wbr/>face<wbr/>Ids
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12092 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12093 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]12094 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12095 <span class="entry_type_container">x</span>
12096
12097 <span class="entry_type_array">
12098 n
12099 </span>
Zhijun He3b4c2062013-10-07 11:23:30 -0700[diff] [blame]12100 <span class="entry_type_visibility"> [hidden]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12101
12102
12103 </td> <!-- entry_type -->
12104
12105 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12106 <p>List of unique IDs for detected
12107faces</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12108 </td>
12109
12110 <td class="entry_units">
12111 </td>
12112
12113 <td class="entry_range">
12114 </td>
12115
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12116 <td class="entry_tags">
12117 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]12118 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12119 </ul>
12120 </td>
12121
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12122 </tr>
12123 <tr class="entries_header">
12124 <th class="th_details" colspan="5">Details</th>
12125 </tr>
12126 <tr class="entry_cont">
12127 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12128 <p>Only available if faceDetectMode == FULL</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12129 </td>
12130 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12131
12132
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12133 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
12134 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12135
12136
12137 <tr class="entry" id="dynamic_android.statistics.faceLandmarks">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12138 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12139 android.<wbr/>statistics.<wbr/>face<wbr/>Landmarks
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12140 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12141 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]12142 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12143 <span class="entry_type_container">x</span>
12144
12145 <span class="entry_type_array">
12146 n x 6
12147 </span>
Zhijun He3b4c2062013-10-07 11:23:30 -0700[diff] [blame]12148 <span class="entry_type_visibility"> [hidden]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12149 <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]12150
12151
12152 </td> <!-- entry_type -->
12153
12154 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12155 <p>List of landmarks for detected
12156faces</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12157 </td>
12158
12159 <td class="entry_units">
12160 </td>
12161
12162 <td class="entry_range">
12163 </td>
12164
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12165 <td class="entry_tags">
12166 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]12167 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12168 </ul>
12169 </td>
12170
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12171 </tr>
12172 <tr class="entries_header">
12173 <th class="th_details" colspan="5">Details</th>
12174 </tr>
12175 <tr class="entry_cont">
12176 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12177 <p>Only available if faceDetectMode == FULL</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12178 </td>
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="dynamic_android.statistics.faceRectangles">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12187 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12188 android.<wbr/>statistics.<wbr/>face<wbr/>Rectangles
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 <span class="entry_type_container">x</span>
12193
12194 <span class="entry_type_array">
12195 n x 4
12196 </span>
Zhijun He3b4c2062013-10-07 11:23:30 -0700[diff] [blame]12197 <span class="entry_type_visibility"> [hidden as rectangle]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12198 <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]12199
12200
12201 </td> <!-- entry_type -->
12202
12203 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12204 <p>List of the bounding rectangles for detected
12205faces</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12206 </td>
12207
12208 <td class="entry_units">
12209 </td>
12210
12211 <td class="entry_range">
12212 </td>
12213
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12214 <td class="entry_tags">
12215 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]12216 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12217 </ul>
12218 </td>
12219
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12220 </tr>
12221 <tr class="entries_header">
12222 <th class="th_details" colspan="5">Details</th>
12223 </tr>
12224 <tr class="entry_cont">
12225 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12226 <p>Only available if faceDetectMode != OFF</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12227 </td>
12228 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12229
12230
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12231 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
12232 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12233
12234
12235 <tr class="entry" id="dynamic_android.statistics.faceScores">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12236 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12237 android.<wbr/>statistics.<wbr/>face<wbr/>Scores
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12238 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12239 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]12240 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12241 <span class="entry_type_container">x</span>
12242
12243 <span class="entry_type_array">
12244 n
12245 </span>
Zhijun He3b4c2062013-10-07 11:23:30 -0700[diff] [blame]12246 <span class="entry_type_visibility"> [hidden]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12247
12248
12249 </td> <!-- entry_type -->
12250
12251 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12252 <p>List of the face confidence scores for
12253detected faces</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12254 </td>
12255
12256 <td class="entry_units">
12257 </td>
12258
12259 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]12260 <p>1-100</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12261 </td>
12262
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12263 <td class="entry_tags">
12264 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]12265 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12266 </ul>
12267 </td>
12268
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12269 </tr>
12270 <tr class="entries_header">
12271 <th class="th_details" colspan="5">Details</th>
12272 </tr>
12273 <tr class="entry_cont">
12274 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12275 <p>Only available if faceDetectMode != OFF.<wbr/> The value should be
12276meaningful (for example,<wbr/> setting 100 at all times is illegal).<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12277 </td>
12278 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12279
12280
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12281 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
12282 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12283
12284
12285 <tr class="entry" id="dynamic_android.statistics.histogram">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12286 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12287 android.<wbr/>statistics.<wbr/>histogram
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12288 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12289 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]12290 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12291 <span class="entry_type_container">x</span>
12292
12293 <span class="entry_type_array">
12294 n x 3
12295 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]12296 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12297 <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]12298
12299
12300 </td> <!-- entry_type -->
12301
12302 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12303 <p>A 3-channel histogram based on the raw
12304sensor data</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12305 </td>
12306
12307 <td class="entry_units">
12308 </td>
12309
12310 <td class="entry_range">
12311 </td>
12312
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12313 <td class="entry_tags">
12314 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]12315 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12316 </ul>
12317 </td>
12318
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12319 </tr>
12320 <tr class="entries_header">
12321 <th class="th_details" colspan="5">Details</th>
12322 </tr>
12323 <tr class="entry_cont">
12324 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12325 <p>The k'th bucket (0-based) covers the input range
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]12326(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]12327(k + 1) * w /<wbr/> N ).<wbr/> If only a monochrome sharpness map is
12328supported,<wbr/> all channels should have the same data</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12329 </td>
12330 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12331
12332
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12333 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
12334 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12335
12336
12337 <tr class="entry" id="dynamic_android.statistics.histogramMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12338 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12339 android.<wbr/>statistics.<wbr/>histogram<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12340 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12341 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]12342 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12343
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]12344 <span class="entry_type_visibility"> [system as boolean]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12345
12346 <ul class="entry_type_enum">
12347 <li>
12348 <span class="entry_type_enum_name">OFF</span>
12349 </li>
12350 <li>
12351 <span class="entry_type_enum_name">ON</span>
12352 </li>
12353 </ul>
12354
12355 </td> <!-- entry_type -->
12356
12357 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12358 <p>Operating mode for histogram
12359generation</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12360 </td>
12361
12362 <td class="entry_units">
12363 </td>
12364
12365 <td class="entry_range">
12366 </td>
12367
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12368 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]12369 <ul class="entry_tags">
12370 <li><a href="#tag_V1">V1</a></li>
12371 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12372 </td>
12373
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12374 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12375
12376
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12377 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
12378 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12379
12380
12381 <tr class="entry" id="dynamic_android.statistics.sharpnessMap">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12382 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12383 android.<wbr/>statistics.<wbr/>sharpness<wbr/>Map
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12384 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12385 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]12386 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12387 <span class="entry_type_container">x</span>
12388
12389 <span class="entry_type_array">
12390 n x m x 3
12391 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]12392 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12393 <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]12394
12395
12396 </td> <!-- entry_type -->
12397
12398 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12399 <p>A 3-channel sharpness map,<wbr/> based on the raw
12400sensor data</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12401 </td>
12402
12403 <td class="entry_units">
12404 </td>
12405
12406 <td class="entry_range">
12407 </td>
12408
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12409 <td class="entry_tags">
12410 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]12411 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12412 </ul>
12413 </td>
12414
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12415 </tr>
12416 <tr class="entries_header">
12417 <th class="th_details" colspan="5">Details</th>
12418 </tr>
12419 <tr class="entry_cont">
12420 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12421 <p>If only a monochrome sharpness map is supported,<wbr/>
12422all channels should have the same data</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12423 </td>
12424 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12425
12426
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12427 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
12428 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12429
12430
12431 <tr class="entry" id="dynamic_android.statistics.sharpnessMapMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12432 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12433 android.<wbr/>statistics.<wbr/>sharpness<wbr/>Map<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12434 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12435 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]12436 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12437
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]12438 <span class="entry_type_visibility"> [system as boolean]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12439
12440 <ul class="entry_type_enum">
12441 <li>
12442 <span class="entry_type_enum_name">OFF</span>
12443 </li>
12444 <li>
12445 <span class="entry_type_enum_name">ON</span>
12446 </li>
12447 </ul>
12448
12449 </td> <!-- entry_type -->
12450
12451 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12452 <p>Operating mode for sharpness map
12453generation</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12454 </td>
12455
12456 <td class="entry_units">
12457 </td>
12458
12459 <td class="entry_range">
12460 </td>
12461
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12462 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]12463 <ul class="entry_tags">
12464 <li><a href="#tag_V1">V1</a></li>
12465 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12466 </td>
12467
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12468 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12469
12470
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12471 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
12472 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12473
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]12474
12475 <tr class="entry" id="dynamic_android.statistics.lensShadingMap">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12476 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12477 android.<wbr/>statistics.<wbr/>lens<wbr/>Shading<wbr/>Map
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12478 </td>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]12479 <td class="entry_type">
12480 <span class="entry_type_name">float</span>
12481 <span class="entry_type_container">x</span>
12482
12483 <span class="entry_type_array">
12484 4 x n x m
12485 </span>
12486 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12487 <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]12488
12489
12490 </td> <!-- entry_type -->
12491
12492 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12493 <p>The shading map is a low-resolution floating-point map
12494that lists the coefficients used to correct for vignetting,<wbr/> for each
12495Bayer color channel.<wbr/></p>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]12496 </td>
12497
12498 <td class="entry_units">
12499 </td>
12500
12501 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]12502 <p>Each gain factor is &gt;= 1</p>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]12503 </td>
12504
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12505 <td class="entry_tags">
12506 </td>
12507
12508 </tr>
12509 <tr class="entries_header">
12510 <th class="th_details" colspan="5">Details</th>
12511 </tr>
12512 <tr class="entry_cont">
12513 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12514 <p>The least shaded section of the image should have a gain factor
12515of 1; all other sections should have gains above 1.<wbr/></p>
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]12516<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]12517must take into account the colorCorrection settings.<wbr/></p>
12518<p>The shading map is for the entire active pixel array,<wbr/> and is not
12519affected by the crop region specified in the request.<wbr/> Each shading map
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]12520entry is the value of the shading compensation map over a specific
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12521pixel on the sensor.<wbr/> Specifically,<wbr/> with a (N x M) resolution shading
12522map,<wbr/> and an active pixel array size (W x H),<wbr/> shading map entry
12523(x,<wbr/>y) ϵ (0 ...<wbr/> N-1,<wbr/> 0 ...<wbr/> M-1) is the value of the shading map at
12524pixel ( ((W-1)/<wbr/>(N-1)) * x,<wbr/> ((H-1)/<wbr/>(M-1)) * y) for the four color channels.<wbr/>
12525The map is assumed to be bilinearly interpolated between the sample points.<wbr/></p>
12526<p>The channel order is [R,<wbr/> Geven,<wbr/> Godd,<wbr/> B],<wbr/> where Geven is the green
12527channel for the even rows of a Bayer pattern,<wbr/> and Godd is the odd rows.<wbr/>
12528The shading map is stored in a fully interleaved format,<wbr/> and its size
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]12529is 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]12530<p>The shading map should have on the order of 30-40 rows and columns,<wbr/>
12531and must be smaller than 64x64.<wbr/></p>
12532<p>As an example,<wbr/> given a very small map defined as:</p>
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]12533<pre><code><a href="#static_android.lens.info.shadingMapSize">android.<wbr/>lens.<wbr/>info.<wbr/>shading<wbr/>Map<wbr/>Size</a> = [ 4,<wbr/> 3 ]
12534<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]12535[ 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/>
12536 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/>
12537 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/>
12538 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/>
12539 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/>
12540 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]12541</code></pre>
12542<p>The low-resolution scaling map images for each channel are
12543(displayed using nearest-neighbor interpolation):</p>
12544<p><img alt="Red lens shading map" src="images/camera2/metadata/android.statistics.lensShadingMap/red_shading.png"/>
12545<img alt="Green (even rows) lens shading map" src="images/camera2/metadata/android.statistics.lensShadingMap/green_e_shading.png"/>
12546<img alt="Green (odd rows) lens shading map" src="images/camera2/metadata/android.statistics.lensShadingMap/green_o_shading.png"/>
12547<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]12548<p>As a visualization only,<wbr/> inverting the full-color map to recover an
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]12549image 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]12550<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]12551 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12552 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12553
12554
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12555 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
12556 <!-- end of entry -->
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]12557
12558
12559 <tr class="entry" id="dynamic_android.statistics.predictedColorGains">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12560 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12561 android.<wbr/>statistics.<wbr/>predicted<wbr/>Color<wbr/>Gains
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12562 </td>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]12563 <td class="entry_type">
12564 <span class="entry_type_name">float</span>
12565 <span class="entry_type_container">x</span>
12566
12567 <span class="entry_type_array">
12568 4
12569 </span>
Igor Murashkin0fe2f132014-01-13 16:59:47 -0800[diff] [blame]12570 <span class="entry_type_visibility"> [hidden]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12571 <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]12572
12573
12574 </td> <!-- entry_type -->
12575
12576 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12577 <p>The best-fit color channel gains calculated
12578by the HAL's statistics units for the current output frame</p>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]12579 </td>
12580
12581 <td class="entry_units">
12582 </td>
12583
12584 <td class="entry_range">
Igor Murashkin0fe2f132014-01-13 16:59:47 -0800[diff] [blame]12585 <p><strong>Deprecated</strong>.<wbr/> Do not use.<wbr/></p>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]12586 </td>
12587
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12588 <td class="entry_tags">
12589 </td>
12590
12591 </tr>
12592 <tr class="entries_header">
12593 <th class="th_details" colspan="5">Details</th>
12594 </tr>
12595 <tr class="entry_cont">
12596 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12597 <p>This may be different than the gains used for this frame,<wbr/>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]12598since statistics processing on data from a new frame
12599typically completes after the transform has already been
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12600applied to that frame.<wbr/></p>
12601<p>The 4 channel gains are defined in Bayer domain,<wbr/>
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]12602see <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]12603<p>This value should always be calculated by the AWB block,<wbr/>
12604regardless of the android.<wbr/>control.<wbr/>* current values.<wbr/></p>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]12605 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12606 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12607
12608
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12609 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
12610 <!-- end of entry -->
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]12611
12612
12613 <tr class="entry" id="dynamic_android.statistics.predictedColorTransform">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12614 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12615 android.<wbr/>statistics.<wbr/>predicted<wbr/>Color<wbr/>Transform
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12616 </td>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]12617 <td class="entry_type">
12618 <span class="entry_type_name">rational</span>
12619 <span class="entry_type_container">x</span>
12620
12621 <span class="entry_type_array">
12622 3 x 3
12623 </span>
Igor Murashkin0fe2f132014-01-13 16:59:47 -0800[diff] [blame]12624 <span class="entry_type_visibility"> [hidden]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12625 <div class="entry_type_notes">3x3 rational matrix in row-major order</div>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]12626
12627
12628 </td> <!-- entry_type -->
12629
12630 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12631 <p>The best-fit color transform matrix estimate
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]12632calculated by the HAL's statistics units for the current
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12633output frame</p>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]12634 </td>
12635
12636 <td class="entry_units">
12637 </td>
12638
12639 <td class="entry_range">
Igor Murashkin0fe2f132014-01-13 16:59:47 -0800[diff] [blame]12640 <p><strong>Deprecated</strong>.<wbr/> Do not use.<wbr/></p>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]12641 </td>
12642
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12643 <td class="entry_tags">
12644 </td>
12645
12646 </tr>
12647 <tr class="entries_header">
12648 <th class="th_details" colspan="5">Details</th>
12649 </tr>
12650 <tr class="entry_cont">
12651 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12652 <p>The HAL must provide the estimate from its
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]12653statistics unit on the white balance transforms to use
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12654for the next frame.<wbr/> These are the values the HAL believes
12655are the best fit for the current output frame.<wbr/> This may
12656be different than the transform used for this frame,<wbr/> since
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]12657statistics processing on data from a new frame typically
12658completes after the transform has already been applied to
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12659that frame.<wbr/></p>
12660<p>These estimates must be provided for all frames,<wbr/> even if
12661capture settings and color transforms are set by the application.<wbr/></p>
12662<p>This value should always be calculated by the AWB block,<wbr/>
12663regardless of the android.<wbr/>control.<wbr/>* current values.<wbr/></p>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]12664 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12665 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12666
12667
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12668 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
12669 <!-- end of entry -->
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]12670
12671
12672 <tr class="entry" id="dynamic_android.statistics.sceneFlicker">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12673 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12674 android.<wbr/>statistics.<wbr/>scene<wbr/>Flicker
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12675 </td>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]12676 <td class="entry_type">
12677 <span class="entry_type_name entry_type_name_enum">byte</span>
12678
12679 <span class="entry_type_visibility"> [public]</span>
12680
12681 <ul class="entry_type_enum">
12682 <li>
12683 <span class="entry_type_enum_name">NONE</span>
12684 </li>
12685 <li>
12686 <span class="entry_type_enum_name">50HZ</span>
12687 </li>
12688 <li>
12689 <span class="entry_type_enum_name">60HZ</span>
12690 </li>
12691 </ul>
12692
12693 </td> <!-- entry_type -->
12694
12695 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12696 <p>The HAL estimated scene illumination lighting
12697frequency</p>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]12698 </td>
12699
12700 <td class="entry_units">
12701 </td>
12702
12703 <td class="entry_range">
12704 </td>
12705
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]12706 <td class="entry_tags">
12707 </td>
12708
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12709 </tr>
12710 <tr class="entries_header">
12711 <th class="th_details" colspan="5">Details</th>
12712 </tr>
12713 <tr class="entry_cont">
12714 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12715 <p>Report NONE if there doesn't appear to be flickering
12716illumination</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12717 </td>
12718 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12719
12720
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12721 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
12722 <!-- end of entry -->
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]12723
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12724
12725
12726 <!-- end of kind -->
12727 </tbody>
12728
12729 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12730 <tr><td colspan="6" id="section_tonemap" class="section">tonemap</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12731
12732
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12733 <tr><td colspan="6" class="kind">controls</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12734
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]12735 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12736 <tr>
12737 <th class="th_name">Property Name</th>
12738 <th class="th_type">Type</th>
12739 <th class="th_description">Description</th>
12740 <th class="th_units">Units</th>
12741 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12742 <th class="th_tags">Tags</th>
12743 </tr>
12744 </thead>
12745
12746 <tbody>
12747
12748
12749
12750
12751
12752
12753
12754
12755
12756
12757 <tr class="entry" id="controls_android.tonemap.curveBlue">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12758 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12759 android.<wbr/>tonemap.<wbr/>curve<wbr/>Blue
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12760 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12761 <td class="entry_type">
Eino-Ville Talvala76548fe2013-01-11 13:57:19 -0800[diff] [blame]12762 <span class="entry_type_name">float</span>
Zhijun He704d1282013-08-19 15:26:33 -0700[diff] [blame]12763 <span class="entry_type_container">x</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12764
Zhijun He704d1282013-08-19 15:26:33 -0700[diff] [blame]12765 <span class="entry_type_array">
12766 n x 2
12767 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]12768 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12769 <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]12770
12771
12772 </td> <!-- entry_type -->
12773
12774 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12775 <p>Table mapping blue input values to output
12776values</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12777 </td>
12778
12779 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12780 same as android.<wbr/>tonemap.<wbr/>curve<wbr/>Red
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12781 </td>
12782
12783 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]12784 <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]12785 </td>
12786
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12787 <td class="entry_tags">
12788 </td>
12789
12790 </tr>
12791 <tr class="entries_header">
12792 <th class="th_details" colspan="5">Details</th>
12793 </tr>
12794 <tr class="entry_cont">
12795 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12796 <p>Tonemapping /<wbr/> contrast /<wbr/> gamma curve for the blue
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]12797channel,<wbr/> to use when <a href="#controls_android.tonemap.mode">android.<wbr/>tonemap.<wbr/>mode</a> is CONTRAST_<wbr/>CURVE.<wbr/></p>
12798<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]12799 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12800 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12801
12802
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12803 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
12804 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12805
12806
12807 <tr class="entry" id="controls_android.tonemap.curveGreen">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12808 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12809 android.<wbr/>tonemap.<wbr/>curve<wbr/>Green
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12810 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12811 <td class="entry_type">
Eino-Ville Talvala76548fe2013-01-11 13:57:19 -0800[diff] [blame]12812 <span class="entry_type_name">float</span>
Zhijun He704d1282013-08-19 15:26:33 -0700[diff] [blame]12813 <span class="entry_type_container">x</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12814
Zhijun He704d1282013-08-19 15:26:33 -0700[diff] [blame]12815 <span class="entry_type_array">
12816 n x 2
12817 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]12818 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12819 <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]12820
12821
12822 </td> <!-- entry_type -->
12823
12824 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12825 <p>Table mapping green input values to output
12826values</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12827 </td>
12828
12829 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12830 same as android.<wbr/>tonemap.<wbr/>curve<wbr/>Red
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12831 </td>
12832
12833 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]12834 <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]12835 </td>
12836
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12837 <td class="entry_tags">
12838 </td>
12839
12840 </tr>
12841 <tr class="entries_header">
12842 <th class="th_details" colspan="5">Details</th>
12843 </tr>
12844 <tr class="entry_cont">
12845 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12846 <p>Tonemapping /<wbr/> contrast /<wbr/> gamma curve for the green
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]12847channel,<wbr/> to use when <a href="#controls_android.tonemap.mode">android.<wbr/>tonemap.<wbr/>mode</a> is CONTRAST_<wbr/>CURVE.<wbr/></p>
12848<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]12849 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12850 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12851
12852
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12853 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
12854 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12855
12856
12857 <tr class="entry" id="controls_android.tonemap.curveRed">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12858 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12859 android.<wbr/>tonemap.<wbr/>curve<wbr/>Red
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12860 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12861 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]12862 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12863 <span class="entry_type_container">x</span>
12864
12865 <span class="entry_type_array">
12866 n x 2
12867 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]12868 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12869 <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]12870
12871
12872 </td> <!-- entry_type -->
12873
12874 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12875 <p>Table mapping red input values to output
12876values</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12877 </td>
12878
12879 <td class="entry_units">
12880 </td>
12881
12882 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]12883 <p>0-1 on input and output coordinates.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12884 </td>
12885
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12886 <td class="entry_tags">
12887 <ul class="entry_tags">
12888 <li><a href="#tag_DNG">DNG</a></li>
12889 </ul>
12890 </td>
12891
12892 </tr>
12893 <tr class="entries_header">
12894 <th class="th_details" colspan="5">Details</th>
12895 </tr>
12896 <tr class="entry_cont">
12897 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12898 <p>Tonemapping /<wbr/> contrast /<wbr/> gamma curve for the red
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]12899channel,<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]12900<p>Since the input and output ranges may vary depending on
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12901the camera pipeline,<wbr/> the input and output pixel values
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]12902are represented by normalized floating-point values
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12903between 0 and 1,<wbr/> with 0 == black and 1 == white.<wbr/></p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]12904<p>The curve should be linearly interpolated between the
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12905defined points.<wbr/> The points will be listed in increasing
12906order of P_<wbr/>IN.<wbr/> For example,<wbr/> if the array is: [0.<wbr/>0,<wbr/> 0.<wbr/>0,<wbr/>
129070.<wbr/>3,<wbr/> 0.<wbr/>5,<wbr/> 1.<wbr/>0,<wbr/> 1.<wbr/>0],<wbr/> then the input-&gt;output mapping
12908for a few sample points would be: 0 -&gt; 0,<wbr/> 0.<wbr/>15 -&gt;
129090.<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]12910 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12911 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12912
12913
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12914 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
12915 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12916
12917
12918 <tr class="entry" id="controls_android.tonemap.mode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12919 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12920 android.<wbr/>tonemap.<wbr/>mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12921 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12922 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]12923 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12924
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]12925 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12926
12927 <ul class="entry_type_enum">
12928 <li>
12929 <span class="entry_type_enum_name">CONTRAST_CURVE</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]12930 <span class="entry_type_enum_notes"><p>Use the tone mapping curve specified in
12931android.<wbr/>tonemap.<wbr/>curve</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12932 </li>
12933 <li>
12934 <span class="entry_type_enum_name">FAST</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]12935 <span class="entry_type_enum_notes"><p>Must not slow down frame rate relative to raw
12936bayer output</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12937 </li>
12938 <li>
12939 <span class="entry_type_enum_name">HIGH_QUALITY</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]12940 <span class="entry_type_enum_notes"><p>Frame rate may be reduced by high
12941quality</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12942 </li>
12943 </ul>
12944
12945 </td> <!-- entry_type -->
12946
12947 <td class="entry_description">
12948 </td>
12949
12950 <td class="entry_units">
12951 </td>
12952
12953 <td class="entry_range">
12954 </td>
12955
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12956 <td class="entry_tags">
12957 </td>
12958
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12959 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12960
12961
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12962 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
12963 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12964
12965
12966
12967 <!-- end of kind -->
12968 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12969 <tr><td colspan="6" class="kind">static</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12970
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]12971 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12972 <tr>
12973 <th class="th_name">Property Name</th>
12974 <th class="th_type">Type</th>
12975 <th class="th_description">Description</th>
12976 <th class="th_units">Units</th>
12977 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12978 <th class="th_tags">Tags</th>
12979 </tr>
12980 </thead>
12981
12982 <tbody>
12983
12984
12985
12986
12987
12988
12989
12990
12991
12992
12993 <tr class="entry" id="static_android.tonemap.maxCurvePoints">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12994 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12995 android.<wbr/>tonemap.<wbr/>max<wbr/>Curve<wbr/>Points
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12996 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12997 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]12998 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12999
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]13000 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13001
13002
13003 </td> <!-- entry_type -->
13004
13005 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13006 <p>Maximum number of supported points in the
13007tonemap curve</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13008 </td>
13009
13010 <td class="entry_units">
13011 </td>
13012
13013 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame]13014 <p>&gt;= 128</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13015 </td>
13016
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13017 <td class="entry_tags">
13018 </td>
13019
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13020 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]13021
13022
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13023 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
13024 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13025
13026
13027
13028 <!-- end of kind -->
13029 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13030 <tr><td colspan="6" class="kind">dynamic</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13031
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]13032 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13033 <tr>
13034 <th class="th_name">Property Name</th>
13035 <th class="th_type">Type</th>
13036 <th class="th_description">Description</th>
13037 <th class="th_units">Units</th>
13038 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13039 <th class="th_tags">Tags</th>
13040 </tr>
13041 </thead>
13042
13043 <tbody>
13044
13045
13046
13047
13048
13049
13050
13051
13052
13053
13054 <tr class="entry" id="dynamic_android.tonemap.curveBlue">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]13055 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13056 android.<wbr/>tonemap.<wbr/>curve<wbr/>Blue
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]13057 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13058 <td class="entry_type">
Eino-Ville Talvala76548fe2013-01-11 13:57:19 -0800[diff] [blame]13059 <span class="entry_type_name">float</span>
Zhijun He704d1282013-08-19 15:26:33 -0700[diff] [blame]13060 <span class="entry_type_container">x</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13061
Zhijun He704d1282013-08-19 15:26:33 -0700[diff] [blame]13062 <span class="entry_type_array">
13063 n x 2
13064 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]13065 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13066 <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]13067
13068
13069 </td> <!-- entry_type -->
13070
13071 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13072 <p>Table mapping blue input values to output
13073values</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13074 </td>
13075
13076 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13077 same as android.<wbr/>tonemap.<wbr/>curve<wbr/>Red
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13078 </td>
13079
13080 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]13081 <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]13082 </td>
13083
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13084 <td class="entry_tags">
13085 </td>
13086
13087 </tr>
13088 <tr class="entries_header">
13089 <th class="th_details" colspan="5">Details</th>
13090 </tr>
13091 <tr class="entry_cont">
13092 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13093 <p>Tonemapping /<wbr/> contrast /<wbr/> gamma curve for the blue
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]13094channel,<wbr/> to use when <a href="#controls_android.tonemap.mode">android.<wbr/>tonemap.<wbr/>mode</a> is CONTRAST_<wbr/>CURVE.<wbr/></p>
13095<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]13096 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13097 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]13098
13099
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13100 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
13101 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13102
13103
13104 <tr class="entry" id="dynamic_android.tonemap.curveGreen">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]13105 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13106 android.<wbr/>tonemap.<wbr/>curve<wbr/>Green
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]13107 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13108 <td class="entry_type">
Eino-Ville Talvala76548fe2013-01-11 13:57:19 -0800[diff] [blame]13109 <span class="entry_type_name">float</span>
Zhijun He704d1282013-08-19 15:26:33 -0700[diff] [blame]13110 <span class="entry_type_container">x</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13111
Zhijun He704d1282013-08-19 15:26:33 -0700[diff] [blame]13112 <span class="entry_type_array">
13113 n x 2
13114 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]13115 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13116 <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]13117
13118
13119 </td> <!-- entry_type -->
13120
13121 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13122 <p>Table mapping green input values to output
13123values</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13124 </td>
13125
13126 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13127 same as android.<wbr/>tonemap.<wbr/>curve<wbr/>Red
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13128 </td>
13129
13130 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]13131 <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]13132 </td>
13133
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13134 <td class="entry_tags">
13135 </td>
13136
13137 </tr>
13138 <tr class="entries_header">
13139 <th class="th_details" colspan="5">Details</th>
13140 </tr>
13141 <tr class="entry_cont">
13142 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13143 <p>Tonemapping /<wbr/> contrast /<wbr/> gamma curve for the green
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]13144channel,<wbr/> to use when <a href="#controls_android.tonemap.mode">android.<wbr/>tonemap.<wbr/>mode</a> is CONTRAST_<wbr/>CURVE.<wbr/></p>
13145<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]13146 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13147 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]13148
13149
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13150 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
13151 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13152
13153
13154 <tr class="entry" id="dynamic_android.tonemap.curveRed">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]13155 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13156 android.<wbr/>tonemap.<wbr/>curve<wbr/>Red
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]13157 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13158 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]13159 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13160 <span class="entry_type_container">x</span>
13161
13162 <span class="entry_type_array">
13163 n x 2
13164 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]13165 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13166 <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]13167
13168
13169 </td> <!-- entry_type -->
13170
13171 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13172 <p>Table mapping red input values to output
13173values</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13174 </td>
13175
13176 <td class="entry_units">
13177 </td>
13178
13179 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]13180 <p>0-1 on input and output coordinates.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13181 </td>
13182
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13183 <td class="entry_tags">
13184 <ul class="entry_tags">
13185 <li><a href="#tag_DNG">DNG</a></li>
13186 </ul>
13187 </td>
13188
13189 </tr>
13190 <tr class="entries_header">
13191 <th class="th_details" colspan="5">Details</th>
13192 </tr>
13193 <tr class="entry_cont">
13194 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13195 <p>Tonemapping /<wbr/> contrast /<wbr/> gamma curve for the red
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]13196channel,<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]13197<p>Since the input and output ranges may vary depending on
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13198the camera pipeline,<wbr/> the input and output pixel values
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]13199are represented by normalized floating-point values
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13200between 0 and 1,<wbr/> with 0 == black and 1 == white.<wbr/></p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]13201<p>The curve should be linearly interpolated between the
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13202defined points.<wbr/> The points will be listed in increasing
13203order of P_<wbr/>IN.<wbr/> For example,<wbr/> if the array is: [0.<wbr/>0,<wbr/> 0.<wbr/>0,<wbr/>
132040.<wbr/>3,<wbr/> 0.<wbr/>5,<wbr/> 1.<wbr/>0,<wbr/> 1.<wbr/>0],<wbr/> then the input-&gt;output mapping
13205for a few sample points would be: 0 -&gt; 0,<wbr/> 0.<wbr/>15 -&gt;
132060.<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]13207 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13208 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]13209
13210
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13211 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
13212 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13213
13214
13215 <tr class="entry" id="dynamic_android.tonemap.mode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]13216 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13217 android.<wbr/>tonemap.<wbr/>mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]13218 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13219 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]13220 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13221
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]13222 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13223
13224 <ul class="entry_type_enum">
13225 <li>
13226 <span class="entry_type_enum_name">CONTRAST_CURVE</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]13227 <span class="entry_type_enum_notes"><p>Use the tone mapping curve specified in
13228android.<wbr/>tonemap.<wbr/>curve</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13229 </li>
13230 <li>
13231 <span class="entry_type_enum_name">FAST</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]13232 <span class="entry_type_enum_notes"><p>Must not slow down frame rate relative to raw
13233bayer output</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13234 </li>
13235 <li>
13236 <span class="entry_type_enum_name">HIGH_QUALITY</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]13237 <span class="entry_type_enum_notes"><p>Frame rate may be reduced by high
13238quality</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13239 </li>
13240 </ul>
13241
13242 </td> <!-- entry_type -->
13243
13244 <td class="entry_description">
13245 </td>
13246
13247 <td class="entry_units">
13248 </td>
13249
13250 <td class="entry_range">
13251 </td>
13252
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13253 <td class="entry_tags">
13254 </td>
13255
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13256 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]13257
13258
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13259 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
13260 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13261
13262
13263
13264 <!-- end of kind -->
13265 </tbody>
13266
13267 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13268 <tr><td colspan="6" id="section_led" class="section">led</td></tr>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]13269
13270
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13271 <tr><td colspan="6" class="kind">controls</td></tr>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]13272
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]13273 <thead class="entries_header">
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]13274 <tr>
13275 <th class="th_name">Property Name</th>
13276 <th class="th_type">Type</th>
13277 <th class="th_description">Description</th>
13278 <th class="th_units">Units</th>
13279 <th class="th_range">Range</th>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]13280 <th class="th_tags">Tags</th>
13281 </tr>
13282 </thead>
13283
13284 <tbody>
13285
13286
13287
13288
13289
13290
13291
13292
13293
13294
13295 <tr class="entry" id="controls_android.led.transmit">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]13296 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13297 android.<wbr/>led.<wbr/>transmit
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]13298 </td>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]13299 <td class="entry_type">
13300 <span class="entry_type_name entry_type_name_enum">byte</span>
13301
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]13302 <span class="entry_type_visibility"> [hidden as boolean]</span>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]13303
13304 <ul class="entry_type_enum">
13305 <li>
13306 <span class="entry_type_enum_name">OFF</span>
13307 </li>
13308 <li>
13309 <span class="entry_type_enum_name">ON</span>
13310 </li>
13311 </ul>
13312
13313 </td> <!-- entry_type -->
13314
13315 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13316 <p>This LED is nominally used to indicate to the user
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]13317that the camera is powered on and may be streaming images back to the
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13318Application Processor.<wbr/> In certain rare circumstances,<wbr/> the OS may
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]13319disable this when video is processed locally and not transmitted to
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13320any untrusted applications.<wbr/></p>
13321<p>In particular,<wbr/> the LED <em>must</em> always be on when the data could be
13322transmitted off the device.<wbr/> The LED <em>should</em> always be on whenever
13323data is stored locally on the device.<wbr/></p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]13324<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]13325doesn't violate the above rules.<wbr/></p>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]13326 </td>
13327
13328 <td class="entry_units">
13329 </td>
13330
13331 <td class="entry_range">
13332 </td>
13333
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]13334 <td class="entry_tags">
13335 </td>
13336
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13337 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]13338
13339
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13340 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
13341 <!-- end of entry -->
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]13342
13343
13344
13345 <!-- end of kind -->
13346 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13347 <tr><td colspan="6" class="kind">dynamic</td></tr>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]13348
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]13349 <thead class="entries_header">
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]13350 <tr>
13351 <th class="th_name">Property Name</th>
13352 <th class="th_type">Type</th>
13353 <th class="th_description">Description</th>
13354 <th class="th_units">Units</th>
13355 <th class="th_range">Range</th>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]13356 <th class="th_tags">Tags</th>
13357 </tr>
13358 </thead>
13359
13360 <tbody>
13361
13362
13363
13364
13365
13366
13367
13368
13369
13370
13371 <tr class="entry" id="dynamic_android.led.transmit">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]13372 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13373 android.<wbr/>led.<wbr/>transmit
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]13374 </td>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]13375 <td class="entry_type">
13376 <span class="entry_type_name entry_type_name_enum">byte</span>
13377
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]13378 <span class="entry_type_visibility"> [hidden as boolean]</span>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]13379
13380 <ul class="entry_type_enum">
13381 <li>
13382 <span class="entry_type_enum_name">OFF</span>
13383 </li>
13384 <li>
13385 <span class="entry_type_enum_name">ON</span>
13386 </li>
13387 </ul>
13388
13389 </td> <!-- entry_type -->
13390
13391 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13392 <p>This LED is nominally used to indicate to the user
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]13393that the camera is powered on and may be streaming images back to the
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13394Application Processor.<wbr/> In certain rare circumstances,<wbr/> the OS may
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]13395disable this when video is processed locally and not transmitted to
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13396any untrusted applications.<wbr/></p>
13397<p>In particular,<wbr/> the LED <em>must</em> always be on when the data could be
13398transmitted off the device.<wbr/> The LED <em>should</em> always be on whenever
13399data is stored locally on the device.<wbr/></p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]13400<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]13401doesn't violate the above rules.<wbr/></p>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]13402 </td>
13403
13404 <td class="entry_units">
13405 </td>
13406
13407 <td class="entry_range">
13408 </td>
13409
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]13410 <td class="entry_tags">
13411 </td>
13412
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13413 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]13414
13415
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13416 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
13417 <!-- end of entry -->
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]13418
13419
13420
13421 <!-- end of kind -->
13422 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13423 <tr><td colspan="6" class="kind">static</td></tr>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]13424
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]13425 <thead class="entries_header">
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]13426 <tr>
13427 <th class="th_name">Property Name</th>
13428 <th class="th_type">Type</th>
13429 <th class="th_description">Description</th>
13430 <th class="th_units">Units</th>
13431 <th class="th_range">Range</th>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]13432 <th class="th_tags">Tags</th>
13433 </tr>
13434 </thead>
13435
13436 <tbody>
13437
13438
13439
13440
13441
13442
13443
13444
13445
13446
13447 <tr class="entry" id="static_android.led.availableLeds">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]13448 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13449 android.<wbr/>led.<wbr/>available<wbr/>Leds
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]13450 </td>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]13451 <td class="entry_type">
13452 <span class="entry_type_name entry_type_name_enum">byte</span>
13453 <span class="entry_type_container">x</span>
13454
13455 <span class="entry_type_array">
13456 n
13457 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]13458 <span class="entry_type_visibility"> [hidden]</span>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]13459
13460 <ul class="entry_type_enum">
13461 <li>
13462 <span class="entry_type_enum_name">TRANSMIT</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]13463 <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]13464 </li>
13465 </ul>
13466
13467 </td> <!-- entry_type -->
13468
13469 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13470 <p>A list of camera LEDs that are available on this system.<wbr/></p>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]13471 </td>
13472
13473 <td class="entry_units">
13474 </td>
13475
13476 <td class="entry_range">
13477 </td>
13478
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]13479 <td class="entry_tags">
13480 </td>
13481
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13482 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]13483
13484
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13485 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
13486 <!-- end of entry -->
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]13487
13488
13489
13490 <!-- end of kind -->
13491 </tbody>
13492
13493 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13494 <tr><td colspan="6" id="section_info" class="section">info</td></tr>
Igor Murashkin38b8cae2013-05-23 16:38:59 -0700[diff] [blame]13495
13496
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13497 <tr><td colspan="6" class="kind">static</td></tr>
Igor Murashkin38b8cae2013-05-23 16:38:59 -0700[diff] [blame]13498
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]13499 <thead class="entries_header">
Igor Murashkin38b8cae2013-05-23 16:38:59 -0700[diff] [blame]13500 <tr>
13501 <th class="th_name">Property Name</th>
13502 <th class="th_type">Type</th>
13503 <th class="th_description">Description</th>
13504 <th class="th_units">Units</th>
13505 <th class="th_range">Range</th>
Igor Murashkin38b8cae2013-05-23 16:38:59 -0700[diff] [blame]13506 <th class="th_tags">Tags</th>
13507 </tr>
13508 </thead>
13509
13510 <tbody>
13511
13512
13513
13514
13515
13516
13517
13518
13519
13520
13521 <tr class="entry" id="static_android.info.supportedHardwareLevel">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]13522 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13523 android.<wbr/>info.<wbr/>supported<wbr/>Hardware<wbr/>Level
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]13524 </td>
Igor Murashkin38b8cae2013-05-23 16:38:59 -0700[diff] [blame]13525 <td class="entry_type">
13526 <span class="entry_type_name entry_type_name_enum">byte</span>
13527
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]13528 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin38b8cae2013-05-23 16:38:59 -0700[diff] [blame]13529
13530 <ul class="entry_type_enum">
13531 <li>
13532 <span class="entry_type_enum_name">LIMITED</span>
13533 </li>
13534 <li>
13535 <span class="entry_type_enum_name">FULL</span>
13536 </li>
13537 </ul>
13538
13539 </td> <!-- entry_type -->
13540
13541 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13542 <p>The camera 3 HAL device can implement one of two possible
13543operational modes; limited and full.<wbr/> Full support is
13544expected from new higher-end devices.<wbr/> Limited mode has
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]13545hardware requirements roughly in line with those for a
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13546camera HAL device v1 implementation,<wbr/> and is expected from
13547older or inexpensive devices.<wbr/> Full is a strict superset of
13548limited,<wbr/> and they share the same essential operational flow.<wbr/></p>
13549<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]13550 </td>
13551
13552 <td class="entry_units">
13553 </td>
13554
13555 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]13556 <p>Optional.<wbr/> Default value is LIMITED.<wbr/></p>
Igor Murashkin38b8cae2013-05-23 16:38:59 -0700[diff] [blame]13557 </td>
13558
Igor Murashkin38b8cae2013-05-23 16:38:59 -0700[diff] [blame]13559 <td class="entry_tags">
13560 </td>
13561
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13562 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]13563
13564
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13565 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
13566 <!-- end of entry -->
Igor Murashkin38b8cae2013-05-23 16:38:59 -0700[diff] [blame]13567
13568
13569
13570 <!-- end of kind -->
13571 </tbody>
13572
13573 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13574 <tr><td colspan="6" id="section_blackLevel" class="section">blackLevel</td></tr>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]13575
13576
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13577 <tr><td colspan="6" class="kind">controls</td></tr>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]13578
13579 <thead class="entries_header">
13580 <tr>
13581 <th class="th_name">Property Name</th>
13582 <th class="th_type">Type</th>
13583 <th class="th_description">Description</th>
13584 <th class="th_units">Units</th>
13585 <th class="th_range">Range</th>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]13586 <th class="th_tags">Tags</th>
13587 </tr>
13588 </thead>
13589
13590 <tbody>
13591
13592
13593
13594
13595
13596
13597
13598
13599
13600
13601 <tr class="entry" id="controls_android.blackLevel.lock">
Eino-Ville Talvala7796cfe2013-12-26 13:16:54 -0800[diff] [blame]13602 <td class="entry_name" rowspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13603 android.<wbr/>black<wbr/>Level.<wbr/>lock
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]13604 </td>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]13605 <td class="entry_type">
13606 <span class="entry_type_name entry_type_name_enum">byte</span>
13607
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]13608 <span class="entry_type_visibility"> [public as boolean]</span>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]13609
13610 <ul class="entry_type_enum">
13611 <li>
13612 <span class="entry_type_enum_name">OFF</span>
13613 </li>
13614 <li>
13615 <span class="entry_type_enum_name">ON</span>
13616 </li>
13617 </ul>
13618
13619 </td> <!-- entry_type -->
13620
13621 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13622 <p>Whether black-level compensation is locked
13623to its current values,<wbr/> or is free to vary.<wbr/></p>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]13624 </td>
13625
13626 <td class="entry_units">
13627 </td>
13628
13629 <td class="entry_range">
13630 </td>
13631
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13632 <td class="entry_tags">
13633 <ul class="entry_tags">
13634 <li><a href="#tag_HAL2">HAL2</a></li>
13635 </ul>
13636 </td>
13637
13638 </tr>
13639 <tr class="entries_header">
13640 <th class="th_details" colspan="5">Details</th>
13641 </tr>
13642 <tr class="entry_cont">
13643 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13644 <p>When set to ON,<wbr/> the values used for black-level
Eino-Ville Talvala7796cfe2013-12-26 13:16:54 -0800[diff] [blame]13645compensation will not change until the lock is set to
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13646OFF.<wbr/></p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]13647<p>Since changes to certain capture parameters (such as
13648exposure time) may require resetting of black level
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13649compensation,<wbr/> the camera device must report whether setting
Eino-Ville Talvala7796cfe2013-12-26 13:16:54 -0800[diff] [blame]13650the black level lock was successful in the output result
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13651metadata.<wbr/></p>
13652<p>For example,<wbr/> if a sequence of requests is as follows:</p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]13653<ul>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13654<li>Request 1: Exposure = 10ms,<wbr/> Black level lock = OFF</li>
13655<li>Request 2: Exposure = 10ms,<wbr/> Black level lock = ON</li>
13656<li>Request 3: Exposure = 10ms,<wbr/> Black level lock = ON</li>
13657<li>Request 4: Exposure = 20ms,<wbr/> Black level lock = ON</li>
13658<li>Request 5: Exposure = 20ms,<wbr/> Black level lock = ON</li>
13659<li>Request 6: Exposure = 20ms,<wbr/> Black level lock = ON</li>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]13660</ul>
Eino-Ville Talvala7796cfe2013-12-26 13:16:54 -0800[diff] [blame]13661<p>And the exposure change in Request 4 requires the camera
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13662device to reset the black level offsets,<wbr/> then the output
Eino-Ville Talvala7796cfe2013-12-26 13:16:54 -0800[diff] [blame]13663result metadata is expected to be:</p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]13664<ul>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13665<li>Result 1: Exposure = 10ms,<wbr/> Black level lock = OFF</li>
13666<li>Result 2: Exposure = 10ms,<wbr/> Black level lock = ON</li>
13667<li>Result 3: Exposure = 10ms,<wbr/> Black level lock = ON</li>
13668<li>Result 4: Exposure = 20ms,<wbr/> Black level lock = OFF</li>
13669<li>Result 5: Exposure = 20ms,<wbr/> Black level lock = ON</li>
13670<li>Result 6: Exposure = 20ms,<wbr/> Black level lock = ON</li>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]13671</ul>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13672<p>This indicates to the application that on frame 4,<wbr/> black
13673levels were reset due to exposure value changes,<wbr/> and pixel
13674values may not be consistent across captures.<wbr/></p>
Eino-Ville Talvala7796cfe2013-12-26 13:16:54 -0800[diff] [blame]13675<p>The camera device will maintain the lock to the extent
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13676possible,<wbr/> only overriding the lock to OFF when changes to
Eino-Ville Talvala7796cfe2013-12-26 13:16:54 -0800[diff] [blame]13677other request parameters require a black level recalculation
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13678or reset.<wbr/></p>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]13679 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13680 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]13681
Eino-Ville Talvala7796cfe2013-12-26 13:16:54 -0800[diff] [blame]13682 <tr class="entries_header">
13683 <th class="th_details" colspan="5">HAL Implementation Details</th>
13684 </tr>
13685 <tr class="entry_cont">
13686 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13687 <p>If for some reason black level locking is no longer possible
13688(for example,<wbr/> the analog gain has changed,<wbr/> which forces
13689black level offsets to be recalculated),<wbr/> then the HAL must
Eino-Ville Talvala7796cfe2013-12-26 13:16:54 -0800[diff] [blame]13690override this request (and it must report 'OFF' when this
13691does happen) until the next capture for which locking is
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13692possible again.<wbr/></p>
Eino-Ville Talvala7796cfe2013-12-26 13:16:54 -0800[diff] [blame]13693 </td>
13694 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]13695
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13696 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
13697 <!-- end of entry -->
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]13698
13699
13700
13701 <!-- end of kind -->
13702 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13703 <tr><td colspan="6" class="kind">dynamic</td></tr>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]13704
13705 <thead class="entries_header">
13706 <tr>
13707 <th class="th_name">Property Name</th>
13708 <th class="th_type">Type</th>
13709 <th class="th_description">Description</th>
13710 <th class="th_units">Units</th>
13711 <th class="th_range">Range</th>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]13712 <th class="th_tags">Tags</th>
13713 </tr>
13714 </thead>
13715
13716 <tbody>
13717
13718
13719
13720
13721
13722
13723
13724
13725
13726
13727 <tr class="entry" id="dynamic_android.blackLevel.lock">
Eino-Ville Talvala7796cfe2013-12-26 13:16:54 -0800[diff] [blame]13728 <td class="entry_name" rowspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13729 android.<wbr/>black<wbr/>Level.<wbr/>lock
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]13730 </td>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]13731 <td class="entry_type">
13732 <span class="entry_type_name entry_type_name_enum">byte</span>
13733
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]13734 <span class="entry_type_visibility"> [public as boolean]</span>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]13735
13736 <ul class="entry_type_enum">
13737 <li>
13738 <span class="entry_type_enum_name">OFF</span>
13739 </li>
13740 <li>
13741 <span class="entry_type_enum_name">ON</span>
13742 </li>
13743 </ul>
13744
13745 </td> <!-- entry_type -->
13746
13747 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13748 <p>Whether black-level compensation is locked
13749to its current values,<wbr/> or is free to vary.<wbr/></p>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]13750 </td>
13751
13752 <td class="entry_units">
13753 </td>
13754
13755 <td class="entry_range">
13756 </td>
13757
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]13758 <td class="entry_tags">
13759 <ul class="entry_tags">
13760 <li><a href="#tag_HAL2">HAL2</a></li>
13761 </ul>
13762 </td>
13763
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13764 </tr>
13765 <tr class="entries_header">
13766 <th class="th_details" colspan="5">Details</th>
13767 </tr>
13768 <tr class="entry_cont">
13769 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13770 <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]13771ON 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]13772a change in other capture settings forced the camera device to
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13773perform a black level reset.<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13774 </td>
13775 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]13776
Eino-Ville Talvala7796cfe2013-12-26 13:16:54 -0800[diff] [blame]13777 <tr class="entries_header">
13778 <th class="th_details" colspan="5">HAL Implementation Details</th>
13779 </tr>
13780 <tr class="entry_cont">
13781 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13782 <p>If for some reason black level locking is no longer possible
13783(for example,<wbr/> the analog gain has changed,<wbr/> which forces
13784black level offsets to be recalculated),<wbr/> then the HAL must
Eino-Ville Talvala7796cfe2013-12-26 13:16:54 -0800[diff] [blame]13785override this request (and it must report 'OFF' when this
13786does happen) until the next capture for which locking is
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13787possible again.<wbr/></p>
Eino-Ville Talvala7796cfe2013-12-26 13:16:54 -0800[diff] [blame]13788 </td>
13789 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]13790
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13791 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
13792 <!-- end of entry -->
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]13793
13794
13795
13796 <!-- end of kind -->
13797 </tbody>
13798
13799 <!-- end of section -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13800<!-- </namespace> -->
13801 </table>
13802
13803 <div class="tags" id="tag_index">
13804 <h2>Tags</h2>
13805 <ul>
13806 <li id="tag_AWB">AWB -
13807 Needed for auto white balance
13808
13809 <ul class="tags_entries">
13810 <li><a href="#controls_android.control.awbMode">android.control.awbMode</a> (controls)</li>
13811 </ul>
13812 </li> <!-- tag_AWB -->
13813 <li id="tag_BC">BC -
13814 Needed for backwards compatibility with old Java API
13815
13816 <ul class="tags_entries">
Eino-Ville Talvala19ce2c12013-12-30 12:03:45 -0800[diff] [blame]13817 <li><a href="#controls_android.control.aeAntibandingMode">android.control.aeAntibandingMode</a> (controls)</li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13818 <li><a href="#controls_android.control.aeExposureCompensation">android.control.aeExposureCompensation</a> (controls)</li>
13819 <li><a href="#controls_android.control.aeLock">android.control.aeLock</a> (controls)</li>
13820 <li><a href="#controls_android.control.aeMode">android.control.aeMode</a> (controls)</li>
13821 <li><a href="#controls_android.control.aeRegions">android.control.aeRegions</a> (controls)</li>
13822 <li><a href="#controls_android.control.aeTargetFpsRange">android.control.aeTargetFpsRange</a> (controls)</li>
Eino-Ville Talvala3b4383a2013-03-18 09:42:48 -0700[diff] [blame]13823 <li><a href="#controls_android.control.aePrecaptureTrigger">android.control.aePrecaptureTrigger</a> (controls)</li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13824 <li><a href="#controls_android.control.afMode">android.control.afMode</a> (controls)</li>
13825 <li><a href="#controls_android.control.afRegions">android.control.afRegions</a> (controls)</li>
Eino-Ville Talvala3b4383a2013-03-18 09:42:48 -0700[diff] [blame]13826 <li><a href="#controls_android.control.afTrigger">android.control.afTrigger</a> (controls)</li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13827 <li><a href="#controls_android.control.awbLock">android.control.awbLock</a> (controls)</li>
13828 <li><a href="#controls_android.control.awbMode">android.control.awbMode</a> (controls)</li>
13829 <li><a href="#controls_android.control.awbRegions">android.control.awbRegions</a> (controls)</li>
13830 <li><a href="#controls_android.control.captureIntent">android.control.captureIntent</a> (controls)</li>
13831 <li><a href="#controls_android.control.effectMode">android.control.effectMode</a> (controls)</li>
13832 <li><a href="#controls_android.control.mode">android.control.mode</a> (controls)</li>
13833 <li><a href="#controls_android.control.sceneMode">android.control.sceneMode</a> (controls)</li>
13834 <li><a href="#controls_android.control.videoStabilizationMode">android.control.videoStabilizationMode</a> (controls)</li>
Eino-Ville Talvala9fa0d902014-01-08 16:16:53 -0800[diff] [blame]13835 <li><a href="#static_android.control.aeAvailableModes">android.control.aeAvailableModes</a> (static)</li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13836 <li><a href="#static_android.control.aeCompensationRange">android.control.aeCompensationRange</a> (static)</li>
13837 <li><a href="#static_android.control.aeCompensationStep">android.control.aeCompensationStep</a> (static)</li>
13838 <li><a href="#static_android.control.afAvailableModes">android.control.afAvailableModes</a> (static)</li>
13839 <li><a href="#static_android.control.availableEffects">android.control.availableEffects</a> (static)</li>
13840 <li><a href="#static_android.control.availableSceneModes">android.control.availableSceneModes</a> (static)</li>
13841 <li><a href="#static_android.control.availableVideoStabilizationModes">android.control.availableVideoStabilizationModes</a> (static)</li>
13842 <li><a href="#static_android.control.awbAvailableModes">android.control.awbAvailableModes</a> (static)</li>
13843 <li><a href="#static_android.control.maxRegions">android.control.maxRegions</a> (static)</li>
13844 <li><a href="#static_android.control.sceneModeOverrides">android.control.sceneModeOverrides</a> (static)</li>
13845 <li><a href="#controls_android.flash.mode">android.flash.mode</a> (controls)</li>
13846 <li><a href="#static_android.flash.info.available">android.flash.info.available</a> (static)</li>
13847 <li><a href="#controls_android.jpeg.gpsCoordinates">android.jpeg.gpsCoordinates</a> (controls)</li>
13848 <li><a href="#controls_android.jpeg.gpsProcessingMethod">android.jpeg.gpsProcessingMethod</a> (controls)</li>
13849 <li><a href="#controls_android.jpeg.gpsTimestamp">android.jpeg.gpsTimestamp</a> (controls)</li>
13850 <li><a href="#controls_android.jpeg.orientation">android.jpeg.orientation</a> (controls)</li>
13851 <li><a href="#controls_android.jpeg.quality">android.jpeg.quality</a> (controls)</li>
13852 <li><a href="#controls_android.jpeg.thumbnailQuality">android.jpeg.thumbnailQuality</a> (controls)</li>
13853 <li><a href="#controls_android.jpeg.thumbnailSize">android.jpeg.thumbnailSize</a> (controls)</li>
13854 <li><a href="#static_android.jpeg.availableThumbnailSizes">android.jpeg.availableThumbnailSizes</a> (static)</li>
13855 <li><a href="#controls_android.lens.focusDistance">android.lens.focusDistance</a> (controls)</li>
13856 <li><a href="#static_android.lens.info.availableFocalLengths">android.lens.info.availableFocalLengths</a> (static)</li>
13857 <li><a href="#static_android.lens.info.hyperfocalDistance">android.lens.info.hyperfocalDistance</a> (static)</li>
13858 <li><a href="#dynamic_android.lens.focusRange">android.lens.focusRange</a> (dynamic)</li>
13859 <li><a href="#static_android.request.maxNumOutputStreams">android.request.maxNumOutputStreams</a> (static)</li>
13860 <li><a href="#controls_android.scaler.cropRegion">android.scaler.cropRegion</a> (controls)</li>
13861 <li><a href="#static_android.scaler.availableFormats">android.scaler.availableFormats</a> (static)</li>
13862 <li><a href="#static_android.scaler.availableJpegMinDurations">android.scaler.availableJpegMinDurations</a> (static)</li>
13863 <li><a href="#static_android.scaler.availableJpegSizes">android.scaler.availableJpegSizes</a> (static)</li>
Igor Murashkinf11a4df2013-05-07 10:00:46 -0700[diff] [blame]13864 <li><a href="#static_android.scaler.availableMaxDigitalZoom">android.scaler.availableMaxDigitalZoom</a> (static)</li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13865 <li><a href="#static_android.scaler.availableProcessedMinDurations">android.scaler.availableProcessedMinDurations</a> (static)</li>
13866 <li><a href="#static_android.scaler.availableProcessedSizes">android.scaler.availableProcessedSizes</a> (static)</li>
13867 <li><a href="#static_android.scaler.availableRawMinDurations">android.scaler.availableRawMinDurations</a> (static)</li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13868 <li><a href="#controls_android.sensor.frameDuration">android.sensor.frameDuration</a> (controls)</li>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]13869 <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]13870 <li><a href="#static_android.sensor.info.maxFrameDuration">android.sensor.info.maxFrameDuration</a> (static)</li>
13871 <li><a href="#static_android.sensor.info.physicalSize">android.sensor.info.physicalSize</a> (static)</li>
13872 <li><a href="#static_android.sensor.info.pixelArraySize">android.sensor.info.pixelArraySize</a> (static)</li>
13873 <li><a href="#static_android.sensor.orientation">android.sensor.orientation</a> (static)</li>
13874 <li><a href="#dynamic_android.sensor.timestamp">android.sensor.timestamp</a> (dynamic)</li>
13875 <li><a href="#controls_android.statistics.faceDetectMode">android.statistics.faceDetectMode</a> (controls)</li>
13876 <li><a href="#dynamic_android.statistics.faceIds">android.statistics.faceIds</a> (dynamic)</li>
13877 <li><a href="#dynamic_android.statistics.faceLandmarks">android.statistics.faceLandmarks</a> (dynamic)</li>
13878 <li><a href="#dynamic_android.statistics.faceRectangles">android.statistics.faceRectangles</a> (dynamic)</li>
13879 <li><a href="#dynamic_android.statistics.faceScores">android.statistics.faceScores</a> (dynamic)</li>
13880 <li><a href="#dynamic_android.lens.focalLength">android.lens.focalLength</a> (dynamic)</li>
13881 <li><a href="#dynamic_android.lens.focusDistance">android.lens.focusDistance</a> (dynamic)</li>
13882 </ul>
13883 </li> <!-- tag_BC -->
13884 <li id="tag_V1">V1 -
13885 New features for first camera 2 release (API1)
13886
13887 <ul class="tags_entries">
13888 <li><a href="#controls_android.demosaic.mode">android.demosaic.mode</a> (controls)</li>
13889 <li><a href="#controls_android.flash.firingPower">android.flash.firingPower</a> (controls)</li>
13890 <li><a href="#controls_android.flash.firingTime">android.flash.firingTime</a> (controls)</li>
13891 <li><a href="#static_android.flash.info.chargeDuration">android.flash.info.chargeDuration</a> (static)</li>
13892 <li><a href="#controls_android.hotPixel.mode">android.hotPixel.mode</a> (controls)</li>
13893 <li><a href="#controls_android.lens.aperture">android.lens.aperture</a> (controls)</li>
13894 <li><a href="#controls_android.lens.filterDensity">android.lens.filterDensity</a> (controls)</li>
13895 <li><a href="#controls_android.lens.focalLength">android.lens.focalLength</a> (controls)</li>
13896 <li><a href="#controls_android.lens.focusDistance">android.lens.focusDistance</a> (controls)</li>
13897 <li><a href="#controls_android.lens.opticalStabilizationMode">android.lens.opticalStabilizationMode</a> (controls)</li>
13898 <li><a href="#static_android.lens.info.availableApertures">android.lens.info.availableApertures</a> (static)</li>
13899 <li><a href="#static_android.lens.info.availableFilterDensities">android.lens.info.availableFilterDensities</a> (static)</li>
13900 <li><a href="#static_android.lens.info.availableFocalLengths">android.lens.info.availableFocalLengths</a> (static)</li>
13901 <li><a href="#static_android.lens.info.availableOpticalStabilization">android.lens.info.availableOpticalStabilization</a> (static)</li>
13902 <li><a href="#static_android.lens.info.geometricCorrectionMapSize">android.lens.info.geometricCorrectionMapSize</a> (static)</li>
13903 <li><a href="#static_android.lens.info.minimumFocusDistance">android.lens.info.minimumFocusDistance</a> (static)</li>
13904 <li><a href="#static_android.lens.info.shadingMapSize">android.lens.info.shadingMapSize</a> (static)</li>
13905 <li><a href="#static_android.lens.position">android.lens.position</a> (static)</li>
13906 <li><a href="#dynamic_android.lens.state">android.lens.state</a> (dynamic)</li>
13907 <li><a href="#controls_android.noiseReduction.mode">android.noiseReduction.mode</a> (controls)</li>
13908 <li><a href="#controls_android.request.id">android.request.id</a> (controls)</li>
13909 <li><a href="#controls_android.sensor.exposureTime">android.sensor.exposureTime</a> (controls)</li>
13910 <li><a href="#controls_android.sensor.frameDuration">android.sensor.frameDuration</a> (controls)</li>
13911 <li><a href="#controls_android.sensor.sensitivity">android.sensor.sensitivity</a> (controls)</li>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]13912 <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]13913 <li><a href="#static_android.sensor.info.exposureTimeRange">android.sensor.info.exposureTimeRange</a> (static)</li>
13914 <li><a href="#static_android.sensor.info.maxFrameDuration">android.sensor.info.maxFrameDuration</a> (static)</li>
13915 <li><a href="#static_android.sensor.info.physicalSize">android.sensor.info.physicalSize</a> (static)</li>
13916 <li><a href="#static_android.sensor.baseGainFactor">android.sensor.baseGainFactor</a> (static)</li>
13917 <li><a href="#static_android.sensor.maxAnalogSensitivity">android.sensor.maxAnalogSensitivity</a> (static)</li>
13918 <li><a href="#static_android.sensor.noiseModelCoefficients">android.sensor.noiseModelCoefficients</a> (static)</li>
13919 <li><a href="#controls_android.statistics.histogramMode">android.statistics.histogramMode</a> (controls)</li>
13920 <li><a href="#controls_android.statistics.sharpnessMapMode">android.statistics.sharpnessMapMode</a> (controls)</li>
13921 <li><a href="#dynamic_android.statistics.histogram">android.statistics.histogram</a> (dynamic)</li>
13922 <li><a href="#dynamic_android.statistics.sharpnessMap">android.statistics.sharpnessMap</a> (dynamic)</li>
13923 <li><a href="#dynamic_android.hotPixel.mode">android.hotPixel.mode</a> (dynamic)</li>
13924 <li><a href="#dynamic_android.lens.aperture">android.lens.aperture</a> (dynamic)</li>
13925 <li><a href="#dynamic_android.lens.filterDensity">android.lens.filterDensity</a> (dynamic)</li>
13926 <li><a href="#dynamic_android.lens.opticalStabilizationMode">android.lens.opticalStabilizationMode</a> (dynamic)</li>
13927 </ul>
13928 </li> <!-- tag_V1 -->
13929 <li id="tag_ADV">ADV - None
13930 <ul class="tags_entries">
13931 <li><a href="#static_android.flash.colorTemperature">android.flash.colorTemperature</a> (static)</li>
13932 <li><a href="#static_android.flash.maxEnergy">android.flash.maxEnergy</a> (static)</li>
13933 <li><a href="#controls_android.geometric.strength">android.geometric.strength</a> (controls)</li>
13934 <li><a href="#static_android.hotPixel.info.map">android.hotPixel.info.map</a> (static)</li>
13935 <li><a href="#static_android.lens.opticalAxisAngle">android.lens.opticalAxisAngle</a> (static)</li>
13936 <li><a href="#controls_android.shading.strength">android.shading.strength</a> (controls)</li>
13937 </ul>
13938 </li> <!-- tag_ADV -->
13939 <li id="tag_DNG">DNG -
13940 Needed for DNG file support
13941
13942 <ul class="tags_entries">
13943 <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]13944 <li><a href="#static_android.sensor.info.activeArraySize">android.sensor.info.activeArraySize</a> (static)</li>
13945 <li><a href="#static_android.sensor.info.colorFilterArrangement">android.sensor.info.colorFilterArrangement</a> (static)</li>
13946 <li><a href="#static_android.sensor.info.pixelArraySize">android.sensor.info.pixelArraySize</a> (static)</li>
13947 <li><a href="#static_android.sensor.info.whiteLevel">android.sensor.info.whiteLevel</a> (static)</li>
13948 <li><a href="#static_android.sensor.blackLevelPattern">android.sensor.blackLevelPattern</a> (static)</li>
13949 <li><a href="#static_android.sensor.calibrationTransform1">android.sensor.calibrationTransform1</a> (static)</li>
13950 <li><a href="#static_android.sensor.calibrationTransform2">android.sensor.calibrationTransform2</a> (static)</li>
13951 <li><a href="#static_android.sensor.colorTransform1">android.sensor.colorTransform1</a> (static)</li>
13952 <li><a href="#static_android.sensor.colorTransform2">android.sensor.colorTransform2</a> (static)</li>
13953 <li><a href="#static_android.sensor.forwardMatrix1">android.sensor.forwardMatrix1</a> (static)</li>
13954 <li><a href="#static_android.sensor.forwardMatrix2">android.sensor.forwardMatrix2</a> (static)</li>
13955 <li><a href="#static_android.sensor.referenceIlluminant1">android.sensor.referenceIlluminant1</a> (static)</li>
13956 <li><a href="#controls_android.tonemap.curveRed">android.tonemap.curveRed</a> (controls)</li>
13957 </ul>
13958 </li> <!-- tag_DNG -->
13959 <li id="tag_EXIF">EXIF - None
13960 <ul class="tags_entries">
13961 <li><a href="#static_android.sensor.referenceIlluminant1">android.sensor.referenceIlluminant1</a> (static)</li>
13962 </ul>
13963 </li> <!-- tag_EXIF -->
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]13964 <li id="tag_HAL2">HAL2 -
Alex Rayef40ad62013-10-01 17:52:33 -0700[diff] [blame]13965 Entry is only used by camera device HAL 2.x
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]13966
13967 <ul class="tags_entries">
13968 <li><a href="#controls_android.request.inputStreams">android.request.inputStreams</a> (controls)</li>
13969 <li><a href="#controls_android.request.outputStreams">android.request.outputStreams</a> (controls)</li>
13970 <li><a href="#controls_android.request.type">android.request.type</a> (controls)</li>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]13971 <li><a href="#controls_android.blackLevel.lock">android.blackLevel.lock</a> (controls)</li>
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]13972 </ul>
13973 </li> <!-- tag_HAL2 -->
Alex Rayef40ad62013-10-01 17:52:33 -0700[diff] [blame]13974 <li id="tag_FULL">FULL -
13975 Entry is required for full hardware level devices, and optional for other hardware levels
13976
13977 <ul class="tags_entries">
13978 <li><a href="#static_android.sensor.baseGainFactor">android.sensor.baseGainFactor</a> (static)</li>
13979 <li><a href="#static_android.sensor.maxAnalogSensitivity">android.sensor.maxAnalogSensitivity</a> (static)</li>
13980 <li><a href="#dynamic_android.sensor.temperature">android.sensor.temperature</a> (dynamic)</li>
13981 </ul>
13982 </li> <!-- tag_FULL -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13983 </ul>
13984 </div>
13985
13986 [ <a href="#">top</a> ]
13987
13988</body>
13989</html>