Gitiles
Code Review Sign In
gerrit-public.fairphone.software / platform / system / media / f90eeaffa2fc7de7c4f14f62e9ffc59cbb005839 / . / camera / docs / docs.html
blob: 7c56850c64b3a686594d63b098ee2ee3c3b0a402 [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>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]1502 <span class="entry_type_enum_notes"><p>The precapture metering sequence
1503must be started.<wbr/> The exact effect of the precapture
1504trigger depends on the current AE mode and
1505state.<wbr/></p></span>
Eino-Ville Talvala3b4383a2013-03-18 09:42:48 -0700[diff] [blame]1506 </li>
1507 </ul>
1508
1509 </td> <!-- entry_type -->
1510
1511 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1512 <p>Whether the HAL must trigger precapture
1513metering.<wbr/></p>
Eino-Ville Talvala3b4383a2013-03-18 09:42:48 -0700[diff] [blame]1514 </td>
1515
1516 <td class="entry_units">
1517 </td>
1518
1519 <td class="entry_range">
1520 </td>
1521
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1522 <td class="entry_tags">
1523 <ul class="entry_tags">
1524 <li><a href="#tag_BC">BC</a></li>
1525 </ul>
1526 </td>
1527
1528 </tr>
1529 <tr class="entries_header">
1530 <th class="th_details" colspan="5">Details</th>
1531 </tr>
1532 <tr class="entry_cont">
1533 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1534 <p>This entry is normally set to IDLE,<wbr/> or is not
1535included at all in the request settings.<wbr/> When included and
1536set to START,<wbr/> the HAL must trigger the autoexposure
1537precapture metering sequence.<wbr/></p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]1538<p>The effect of AE precapture trigger depends on the current
1539AE mode and state; see the camera HAL device v3 header for
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1540details.<wbr/></p>
Eino-Ville Talvala3b4383a2013-03-18 09:42:48 -0700[diff] [blame]1541 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1542 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1543
1544
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1545 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
1546 <!-- end of entry -->
Eino-Ville Talvala3b4383a2013-03-18 09:42:48 -0700[diff] [blame]1547
1548
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1549 <tr class="entry" id="controls_android.control.afMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1550 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1551 android.<wbr/>control.<wbr/>af<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1552 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1553 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]1554 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1555
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]1556 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1557
1558 <ul class="entry_type_enum">
1559 <li>
1560 <span class="entry_type_enum_name">OFF</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]1561 <span class="entry_type_enum_notes"><p>The auto-focus routine does not control the lens;
1562<a href="#controls_android.lens.focusDistance">android.<wbr/>lens.<wbr/>focus<wbr/>Distance</a> is controlled by the
1563application</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1564 </li>
1565 <li>
1566 <span class="entry_type_enum_name">AUTO</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]1567 <span class="entry_type_enum_notes"><p>If lens is not fixed focus.<wbr/></p>
1568<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
1569is fixed-focus.<wbr/> In this mode,<wbr/> the lens does not move unless
1570the autofocus trigger action is called.<wbr/> When that trigger
1571is activated,<wbr/> AF must transition to ACTIVE_<wbr/>SCAN,<wbr/> then to
1572the outcome of the scan (FOCUSED or NOT_<wbr/>FOCUSED).<wbr/></p>
1573<p>Triggering AF_<wbr/>CANCEL resets the lens position to default,<wbr/>
1574and sets the AF state to INACTIVE.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1575 </li>
1576 <li>
1577 <span class="entry_type_enum_name">MACRO</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]1578 <span class="entry_type_enum_notes"><p>In this mode,<wbr/> the lens does not move unless the
1579autofocus trigger action is called.<wbr/></p>
1580<p>When that trigger is activated,<wbr/> AF must transition to
1581ACTIVE_<wbr/>SCAN,<wbr/> then to the outcome of the scan (FOCUSED or
1582NOT_<wbr/>FOCUSED).<wbr/> Triggering cancel AF resets the lens
1583position to default,<wbr/> and sets the AF state to
1584INACTIVE.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1585 </li>
1586 <li>
1587 <span class="entry_type_enum_name">CONTINUOUS_VIDEO</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]1588 <span class="entry_type_enum_notes"><p>In this mode,<wbr/> the AF algorithm modifies the lens
1589position continually to attempt to provide a
1590constantly-in-focus image stream.<wbr/></p>
1591<p>The focusing behavior should be suitable for good quality
1592video recording; typically this means slower focus
1593movement and no overshoots.<wbr/> When the AF trigger is not
1594involved,<wbr/> the AF algorithm should start in INACTIVE state,<wbr/>
1595and then transition into PASSIVE_<wbr/>SCAN and PASSIVE_<wbr/>FOCUSED
1596states as appropriate.<wbr/> When the AF trigger is activated,<wbr/>
1597the algorithm should immediately transition into
1598AF_<wbr/>FOCUSED or AF_<wbr/>NOT_<wbr/>FOCUSED as appropriate,<wbr/> and lock the
1599lens position until a cancel AF trigger is received.<wbr/></p>
1600<p>Once cancel is received,<wbr/> the algorithm should transition
1601back to INACTIVE and resume passive scan.<wbr/> Note that this
1602behavior is not identical to CONTINUOUS_<wbr/>PICTURE,<wbr/> since an
1603ongoing PASSIVE_<wbr/>SCAN must immediately be
1604canceled.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1605 </li>
1606 <li>
1607 <span class="entry_type_enum_name">CONTINUOUS_PICTURE</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]1608 <span class="entry_type_enum_notes"><p>In this mode,<wbr/> the AF algorithm modifies the lens
1609position continually to attempt to provide a
1610constantly-in-focus image stream.<wbr/></p>
1611<p>The focusing behavior should be suitable for still image
1612capture; typically this means focusing as fast as
1613possible.<wbr/> When the AF trigger is not involved,<wbr/> the AF
1614algorithm should start in INACTIVE state,<wbr/> and then
1615transition into PASSIVE_<wbr/>SCAN and PASSIVE_<wbr/>FOCUSED states as
1616appropriate as it attempts to maintain focus.<wbr/> When the AF
1617trigger is activated,<wbr/> the algorithm should finish its
1618PASSIVE_<wbr/>SCAN if active,<wbr/> and then transition into
1619AF_<wbr/>FOCUSED or AF_<wbr/>NOT_<wbr/>FOCUSED as appropriate,<wbr/> and lock the
1620lens position until a cancel AF trigger is received.<wbr/></p>
1621<p>When the AF cancel trigger is activated,<wbr/> the algorithm
1622should transition back to INACTIVE and then act as if it
1623has just been started.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1624 </li>
1625 <li>
1626 <span class="entry_type_enum_name">EDOF</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]1627 <span class="entry_type_enum_notes"><p>Extended depth of field (digital focus).<wbr/> AF
1628trigger is ignored,<wbr/> AF state should always be
1629INACTIVE.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1630 </li>
1631 </ul>
1632
1633 </td> <!-- entry_type -->
1634
1635 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1636 <p>Whether AF is currently enabled,<wbr/> and what
1637mode it is set to</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1638 </td>
1639
1640 <td class="entry_units">
1641 </td>
1642
1643 <td class="entry_range">
Zhijun He7787f7f2014-01-14 16:30:31 -0800[diff] [blame]1644 <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]1645 </td>
1646
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1647 <td class="entry_tags">
1648 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]1649 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1650 </ul>
1651 </td>
1652
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1653 </tr>
1654 <tr class="entries_header">
1655 <th class="th_details" colspan="5">Details</th>
1656 </tr>
1657 <tr class="entry_cont">
1658 <td class="entry_details" colspan="5">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]1659 <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]1660<p>If the lens is controlled by the camera device auto-focus algorithm,<wbr/>
1661the camera device will report the current AF status in android.<wbr/>control.<wbr/>af<wbr/>State
1662in result metadata.<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1663 </td>
1664 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1665
1666
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1667 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
1668 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1669
1670
1671 <tr class="entry" id="controls_android.control.afRegions">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1672 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1673 android.<wbr/>control.<wbr/>af<wbr/>Regions
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1674 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1675 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]1676 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1677 <span class="entry_type_container">x</span>
1678
1679 <span class="entry_type_array">
1680 5 x area_count
1681 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]1682 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1683
1684
1685 </td> <!-- entry_type -->
1686
1687 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1688 <p>List of areas to use for focus
1689estimation</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1690 </td>
1691
1692 <td class="entry_units">
1693 </td>
1694
1695 <td class="entry_range">
1696 </td>
1697
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1698 <td class="entry_tags">
1699 <ul class="entry_tags">
1700 <li><a href="#tag_BC">BC</a></li>
1701 </ul>
1702 </td>
1703
1704 </tr>
1705 <tr class="entries_header">
1706 <th class="th_details" colspan="5">Details</th>
1707 </tr>
1708 <tr class="entry_cont">
1709 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1710 <p>Each area is a rectangle plus weight: xmin,<wbr/> ymin,<wbr/>
1711xmax,<wbr/> ymax,<wbr/> weight.<wbr/> The rectangle is defined inclusive of the
1712specified coordinates.<wbr/></p>
1713<p>The coordinate system is based on the active pixel array,<wbr/>
1714with (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]1715(<a href="#static_android.sensor.info.activeArraySize">android.<wbr/>sensor.<wbr/>info.<wbr/>active<wbr/>Array<wbr/>Size</a>.<wbr/>width - 1,<wbr/>
1716<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]1717bottom-right pixel in the active pixel array.<wbr/> The weight
1718should be nonnegative.<wbr/></p>
1719<p>If all regions have 0 weight,<wbr/> then no specific focus area
1720needs to be used by the HAL.<wbr/> If the focusing region is
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]1721outside 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]1722should ignore the sections outside the region and output the
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1723used sections in the frame metadata</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1724 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1725 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1726
1727
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1728 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
1729 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1730
1731
Eino-Ville Talvala3b4383a2013-03-18 09:42:48 -0700[diff] [blame]1732 <tr class="entry" id="controls_android.control.afTrigger">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1733 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1734 android.<wbr/>control.<wbr/>af<wbr/>Trigger
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1735 </td>
Eino-Ville Talvala3b4383a2013-03-18 09:42:48 -0700[diff] [blame]1736 <td class="entry_type">
1737 <span class="entry_type_name entry_type_name_enum">byte</span>
1738
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]1739 <span class="entry_type_visibility"> [public]</span>
Eino-Ville Talvala3b4383a2013-03-18 09:42:48 -0700[diff] [blame]1740
1741 <ul class="entry_type_enum">
1742 <li>
1743 <span class="entry_type_enum_name">IDLE</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]1744 <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]1745 </li>
1746 <li>
1747 <span class="entry_type_enum_name">START</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]1748 <span class="entry_type_enum_notes"><p>Autofocus must trigger now.<wbr/></p></span>
Eino-Ville Talvala3b4383a2013-03-18 09:42:48 -0700[diff] [blame]1749 </li>
1750 <li>
1751 <span class="entry_type_enum_name">CANCEL</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]1752 <span class="entry_type_enum_notes"><p>Autofocus must return to initial
1753state,<wbr/> and cancel any active trigger.<wbr/></p></span>
Eino-Ville Talvala3b4383a2013-03-18 09:42:48 -0700[diff] [blame]1754 </li>
1755 </ul>
1756
1757 </td> <!-- entry_type -->
1758
1759 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1760 <p>Whether the HAL must trigger autofocus.<wbr/></p>
Eino-Ville Talvala3b4383a2013-03-18 09:42:48 -0700[diff] [blame]1761 </td>
1762
1763 <td class="entry_units">
1764 </td>
1765
1766 <td class="entry_range">
1767 </td>
1768
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1769 <td class="entry_tags">
1770 <ul class="entry_tags">
1771 <li><a href="#tag_BC">BC</a></li>
1772 </ul>
1773 </td>
1774
1775 </tr>
1776 <tr class="entries_header">
1777 <th class="th_details" colspan="5">Details</th>
1778 </tr>
1779 <tr class="entry_cont">
1780 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1781 <p>This entry is normally set to IDLE,<wbr/> or is not
1782included at all in the request settings.<wbr/></p>
1783<p>When included and set to START,<wbr/> the HAL must trigger the
1784autofocus algorithm.<wbr/> The effect of AF trigger depends on the
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]1785current AF mode and state; see the camera HAL device v3
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1786header for details.<wbr/> When set to CANCEL,<wbr/> the HAL must cancel
1787any active trigger,<wbr/> and return to initial AF state.<wbr/></p>
Eino-Ville Talvala3b4383a2013-03-18 09:42:48 -0700[diff] [blame]1788 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1789 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1790
1791
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1792 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
1793 <!-- end of entry -->
Eino-Ville Talvala3b4383a2013-03-18 09:42:48 -0700[diff] [blame]1794
1795
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1796 <tr class="entry" id="controls_android.control.awbLock">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1797 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1798 android.<wbr/>control.<wbr/>awb<wbr/>Lock
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1799 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1800 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]1801 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1802
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]1803 <span class="entry_type_visibility"> [public as boolean]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1804
1805 <ul class="entry_type_enum">
1806 <li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1807 <span class="entry_type_enum_name">OFF</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]1808 <span class="entry_type_enum_notes"><p>Auto-whitebalance lock is disabled; the AWB
1809algorithm is free to update its parameters if in AUTO
1810mode.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1811 </li>
Eino-Ville Talvala76548fe2013-01-11 13:57:19 -0800[diff] [blame]1812 <li>
1813 <span class="entry_type_enum_name">ON</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]1814 <span class="entry_type_enum_notes"><p>Auto-whitebalance lock is enabled; the AWB
1815algorithm must not update the exposure and sensitivity
1816parameters while the lock is active</p></span>
Eino-Ville Talvala76548fe2013-01-11 13:57:19 -0800[diff] [blame]1817 </li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1818 </ul>
1819
1820 </td> <!-- entry_type -->
1821
1822 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1823 <p>Whether AWB is currently locked to its
1824latest calculated values</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1825 </td>
1826
1827 <td class="entry_units">
1828 </td>
1829
1830 <td class="entry_range">
1831 </td>
1832
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1833 <td class="entry_tags">
1834 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]1835 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1836 </ul>
1837 </td>
1838
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1839 </tr>
1840 <tr class="entries_header">
1841 <th class="th_details" colspan="5">Details</th>
1842 </tr>
1843 <tr class="entry_cont">
1844 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1845 <p>Note that AWB lock is only meaningful for AUTO
1846mode; in other modes,<wbr/> AWB is already fixed to a specific
1847setting</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1848 </td>
1849 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1850
1851
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1852 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
1853 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1854
1855
1856 <tr class="entry" id="controls_android.control.awbMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1857 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1858 android.<wbr/>control.<wbr/>awb<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1859 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1860 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]1861 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1862
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]1863 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1864
1865 <ul class="entry_type_enum">
1866 <li>
1867 <span class="entry_type_enum_name">OFF</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]1868 <span class="entry_type_enum_notes"><p>The camera device's auto white balance routine is disabled;
1869the application-selected color transform matrix
1870(<a href="#controls_android.colorCorrection.transform">android.<wbr/>color<wbr/>Correction.<wbr/>transform</a>) and gains
1871(<a href="#controls_android.colorCorrection.gains">android.<wbr/>color<wbr/>Correction.<wbr/>gains</a>) are used by the camera
1872device for manual white balance control.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1873 </li>
1874 <li>
1875 <span class="entry_type_enum_name">AUTO</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]1876 <span class="entry_type_enum_notes"><p>The camera device's auto white balance routine is active;
1877the application's values for android.<wbr/>color<wbr/>Correction.<wbr/>transform
1878and <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]1879 </li>
1880 <li>
1881 <span class="entry_type_enum_name">INCANDESCENT</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]1882 <span class="entry_type_enum_notes"><p>The camera device's auto white balance routine is disabled;
1883the camera device uses incandescent light as the assumed scene
1884illumination for white balance.<wbr/> While the exact white balance
1885transforms are up to the camera device,<wbr/> they will approximately
1886match the CIE standard illuminant A.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1887 </li>
1888 <li>
1889 <span class="entry_type_enum_name">FLUORESCENT</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]1890 <span class="entry_type_enum_notes"><p>The camera device's auto white balance routine is disabled;
1891the camera device uses fluorescent light as the assumed scene
1892illumination for white balance.<wbr/> While the exact white balance
1893transforms are up to the camera device,<wbr/> they will approximately
1894match the CIE standard illuminant F2.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1895 </li>
1896 <li>
1897 <span class="entry_type_enum_name">WARM_FLUORESCENT</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]1898 <span class="entry_type_enum_notes"><p>The camera device's auto white balance routine is disabled;
1899the camera device uses warm fluorescent light as the assumed scene
1900illumination for white balance.<wbr/> While the exact white balance
1901transforms are up to the camera device,<wbr/> they will approximately
1902match the CIE standard illuminant F4.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1903 </li>
1904 <li>
1905 <span class="entry_type_enum_name">DAYLIGHT</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]1906 <span class="entry_type_enum_notes"><p>The camera device's auto white balance routine is disabled;
1907the camera device uses daylight light as the assumed scene
1908illumination for white balance.<wbr/> While the exact white balance
1909transforms are up to the camera device,<wbr/> they will approximately
1910match the CIE standard illuminant D65.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1911 </li>
1912 <li>
1913 <span class="entry_type_enum_name">CLOUDY_DAYLIGHT</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]1914 <span class="entry_type_enum_notes"><p>The camera device's auto white balance routine is disabled;
1915the camera device uses cloudy daylight light as the assumed scene
1916illumination for white balance.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1917 </li>
1918 <li>
1919 <span class="entry_type_enum_name">TWILIGHT</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]1920 <span class="entry_type_enum_notes"><p>The camera device's auto white balance routine is disabled;
1921the camera device uses twilight light as the assumed scene
1922illumination for white balance.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1923 </li>
1924 <li>
1925 <span class="entry_type_enum_name">SHADE</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]1926 <span class="entry_type_enum_notes"><p>The camera device's auto white balance routine is disabled;
1927the camera device uses shade light as the assumed scene
1928illumination for white balance.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1929 </li>
1930 </ul>
1931
1932 </td> <!-- entry_type -->
1933
1934 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1935 <p>Whether AWB is currently setting the color
1936transform fields,<wbr/> and what its illumination target
1937is</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1938 </td>
1939
1940 <td class="entry_units">
1941 </td>
1942
1943 <td class="entry_range">
Zhijun He7787f7f2014-01-14 16:30:31 -0800[diff] [blame]1944 <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]1945 </td>
1946
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1947 <td class="entry_tags">
1948 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]1949 <li><a href="#tag_BC">BC</a></li>
1950 <li><a href="#tag_AWB">AWB</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1951 </ul>
1952 </td>
1953
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1954 </tr>
1955 <tr class="entries_header">
1956 <th class="th_details" colspan="5">Details</th>
1957 </tr>
1958 <tr class="entry_cont">
1959 <td class="entry_details" colspan="5">
Zhijun He7787f7f2014-01-14 16:30:31 -0800[diff] [blame]1960 <p>This control is only effective if <a href="#controls_android.control.mode">android.<wbr/>control.<wbr/>mode</a> is AUTO.<wbr/></p>
1961<p>When set to the ON mode,<wbr/> the camera device's auto white balance
1962routine is enabled,<wbr/> overriding the application's selected
1963<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
1964<a href="#controls_android.colorCorrection.mode">android.<wbr/>color<wbr/>Correction.<wbr/>mode</a>.<wbr/></p>
1965<p>When set to the OFF mode,<wbr/> the camera device's auto white balance
1966routine is disabled.<wbr/> The applicantion manually controls the white
1967balance by <a href="#controls_android.colorCorrection.transform">android.<wbr/>color<wbr/>Correction.<wbr/>transform</a>,<wbr/> android.<wbr/>color<wbr/>Correction.<wbr/>gains
1968and <a href="#controls_android.colorCorrection.mode">android.<wbr/>color<wbr/>Correction.<wbr/>mode</a>.<wbr/></p>
1969<p>When set to any other modes,<wbr/> the camera device's auto white balance
1970routine is disabled.<wbr/> The camera device uses each particular illumination
1971target for white balance adjustment.<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1972 </td>
1973 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1974
1975
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1976 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
1977 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1978
1979
1980 <tr class="entry" id="controls_android.control.awbRegions">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1981 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1982 android.<wbr/>control.<wbr/>awb<wbr/>Regions
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1983 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1984 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]1985 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1986 <span class="entry_type_container">x</span>
1987
1988 <span class="entry_type_array">
1989 5 x area_count
1990 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]1991 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1992
1993
1994 </td> <!-- entry_type -->
1995
1996 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1997 <p>List of areas to use for illuminant
1998estimation</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1999 </td>
2000
2001 <td class="entry_units">
2002 </td>
2003
2004 <td class="entry_range">
2005 </td>
2006
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2007 <td class="entry_tags">
2008 <ul class="entry_tags">
2009 <li><a href="#tag_BC">BC</a></li>
2010 </ul>
2011 </td>
2012
2013 </tr>
2014 <tr class="entries_header">
2015 <th class="th_details" colspan="5">Details</th>
2016 </tr>
2017 <tr class="entry_cont">
2018 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2019 <p>Only used in AUTO mode.<wbr/></p>
2020<p>Each area is a rectangle plus weight: xmin,<wbr/> ymin,<wbr/>
2021xmax,<wbr/> ymax,<wbr/> weight.<wbr/> The rectangle is defined inclusive of the
2022specified coordinates.<wbr/></p>
2023<p>The coordinate system is based on the active pixel array,<wbr/>
2024with (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]2025(<a href="#static_android.sensor.info.activeArraySize">android.<wbr/>sensor.<wbr/>info.<wbr/>active<wbr/>Array<wbr/>Size</a>.<wbr/>width - 1,<wbr/>
2026<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]2027bottom-right pixel in the active pixel array.<wbr/> The weight
2028should be nonnegative.<wbr/></p>
2029<p>If all regions have 0 weight,<wbr/> then no specific metering area
2030needs to be used by the HAL.<wbr/> If the metering region is
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]2031outside 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]2032should ignore the sections outside the region and output the
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2033used sections in the frame metadata</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2034 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2035 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2036
2037
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2038 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
2039 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2040
2041
2042 <tr class="entry" id="controls_android.control.captureIntent">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2043 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2044 android.<wbr/>control.<wbr/>capture<wbr/>Intent
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2045 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2046 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]2047 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2048
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2049 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2050
2051 <ul class="entry_type_enum">
2052 <li>
2053 <span class="entry_type_enum_name">CUSTOM</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]2054 <span class="entry_type_enum_notes"><p>This request doesn't fall into the other
2055categories.<wbr/> Default to preview-like
2056behavior.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2057 </li>
2058 <li>
2059 <span class="entry_type_enum_name">PREVIEW</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]2060 <span class="entry_type_enum_notes"><p>This request is for a preview-like usecase.<wbr/> The
2061precapture trigger may be used to start off a metering
2062w/<wbr/>flash sequence</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2063 </li>
2064 <li>
2065 <span class="entry_type_enum_name">STILL_CAPTURE</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]2066 <span class="entry_type_enum_notes"><p>This request is for a still capture-type
2067usecase.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2068 </li>
2069 <li>
2070 <span class="entry_type_enum_name">VIDEO_RECORD</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]2071 <span class="entry_type_enum_notes"><p>This request is for a video recording
2072usecase.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2073 </li>
2074 <li>
2075 <span class="entry_type_enum_name">VIDEO_SNAPSHOT</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]2076 <span class="entry_type_enum_notes"><p>This request is for a video snapshot (still
2077image while recording video) usecase</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2078 </li>
2079 <li>
2080 <span class="entry_type_enum_name">ZERO_SHUTTER_LAG</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]2081 <span class="entry_type_enum_notes"><p>This request is for a ZSL usecase; the
2082application will stream full-resolution images and
2083reprocess one or several later for a final
2084capture</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2085 </li>
2086 </ul>
2087
2088 </td> <!-- entry_type -->
2089
2090 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2091 <p>Information to 3A routines about the purpose
2092of this capture,<wbr/> to help decide optimal 3A
2093strategy</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">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -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">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]2115 <p>Only used if <a href="#controls_android.control.mode">android.<wbr/>control.<wbr/>mode</a> != OFF.<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2116 </td>
2117 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2118
2119
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2120 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
2121 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2122
2123
2124 <tr class="entry" id="controls_android.control.effectMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2125 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2126 android.<wbr/>control.<wbr/>effect<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2127 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2128 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]2129 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2130
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2131 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2132
2133 <ul class="entry_type_enum">
2134 <li>
2135 <span class="entry_type_enum_name">OFF</span>
2136 </li>
2137 <li>
2138 <span class="entry_type_enum_name">MONO</span>
2139 <span class="entry_type_enum_optional">optional</span>
2140 </li>
2141 <li>
2142 <span class="entry_type_enum_name">NEGATIVE</span>
2143 <span class="entry_type_enum_optional">optional</span>
2144 </li>
2145 <li>
2146 <span class="entry_type_enum_name">SOLARIZE</span>
2147 <span class="entry_type_enum_optional">optional</span>
2148 </li>
2149 <li>
2150 <span class="entry_type_enum_name">SEPIA</span>
2151 <span class="entry_type_enum_optional">optional</span>
2152 </li>
2153 <li>
2154 <span class="entry_type_enum_name">POSTERIZE</span>
2155 <span class="entry_type_enum_optional">optional</span>
2156 </li>
2157 <li>
2158 <span class="entry_type_enum_name">WHITEBOARD</span>
2159 <span class="entry_type_enum_optional">optional</span>
2160 </li>
2161 <li>
2162 <span class="entry_type_enum_name">BLACKBOARD</span>
2163 <span class="entry_type_enum_optional">optional</span>
2164 </li>
2165 <li>
2166 <span class="entry_type_enum_name">AQUA</span>
2167 <span class="entry_type_enum_optional">optional</span>
2168 </li>
2169 </ul>
2170
2171 </td> <!-- entry_type -->
2172
2173 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2174 <p>Whether any special color effect is in use.<wbr/>
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]2175Only 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]2176 </td>
2177
2178 <td class="entry_units">
2179 </td>
2180
2181 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]2182 <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]2183 </td>
2184
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2185 <td class="entry_tags">
2186 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]2187 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2188 </ul>
2189 </td>
2190
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2191 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2192
2193
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2194 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
2195 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2196
2197
2198 <tr class="entry" id="controls_android.control.mode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2199 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2200 android.<wbr/>control.<wbr/>mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2201 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2202 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]2203 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2204
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2205 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2206
2207 <ul class="entry_type_enum">
2208 <li>
2209 <span class="entry_type_enum_name">OFF</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]2210 <span class="entry_type_enum_notes"><p>Full application control of pipeline.<wbr/> All 3A
2211routines are disabled,<wbr/> no other settings in
2212android.<wbr/>control.<wbr/>* have any effect</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2213 </li>
2214 <li>
2215 <span class="entry_type_enum_name">AUTO</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]2216 <span class="entry_type_enum_notes"><p>Use settings for each individual 3A routine.<wbr/>
2217Manual control of capture parameters is disabled.<wbr/> All
2218controls in android.<wbr/>control.<wbr/>* besides sceneMode take
2219effect</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2220 </li>
2221 <li>
2222 <span class="entry_type_enum_name">USE_SCENE_MODE</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]2223 <span class="entry_type_enum_notes"><p>Use specific scene mode.<wbr/> Enabling this disables
2224control.<wbr/>aeMode,<wbr/> control.<wbr/>awbMode and control.<wbr/>afMode
2225controls; the HAL must ignore those settings while
2226USE_<wbr/>SCENE_<wbr/>MODE is active (except for FACE_<wbr/>PRIORITY
2227scene mode).<wbr/> Other control entries are still active.<wbr/>
2228This setting can only be used if availableSceneModes !=
2229UNSUPPORTED</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2230 </li>
2231 </ul>
2232
2233 </td> <!-- entry_type -->
2234
2235 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2236 <p>Overall mode of 3A control
2237routines</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2238 </td>
2239
2240 <td class="entry_units">
2241 </td>
2242
2243 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]2244 <p>all must be supported</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2245 </td>
2246
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2247 <td class="entry_tags">
2248 <ul class="entry_tags">
2249 <li><a href="#tag_BC">BC</a></li>
2250 </ul>
2251 </td>
2252
2253 </tr>
2254 <tr class="entries_header">
2255 <th class="th_details" colspan="5">Details</th>
2256 </tr>
2257 <tr class="entry_cont">
2258 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2259 <p>High-level 3A control.<wbr/> When set to OFF,<wbr/> all 3A control
Zhijun Hef90eeaf2014-01-16 12:13:35 -0800[diff] [blame^]2260by the camera device is disabled.<wbr/> The application must set the fields for
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2261capture parameters itself.<wbr/></p>
2262<p>When set to AUTO,<wbr/> the individual algorithm controls in
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]2263android.<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]2264<p>When set to USE_<wbr/>SCENE_<wbr/>MODE,<wbr/> the individual controls in
Zhijun Hef90eeaf2014-01-16 12:13:35 -0800[diff] [blame^]2265android.<wbr/>control.<wbr/>* are mostly disabled,<wbr/> and the camera device implements
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2266one of the scene mode settings (such as ACTION,<wbr/> SUNSET,<wbr/> or PARTY)
Zhijun Hef90eeaf2014-01-16 12:13:35 -0800[diff] [blame^]2267as it wishes.<wbr/> The camera device scene mode 3A settings are provided by
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]2268<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]2269 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2270 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2271
2272
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2273 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
2274 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2275
2276
2277 <tr class="entry" id="controls_android.control.sceneMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2278 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2279 android.<wbr/>control.<wbr/>scene<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2280 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2281 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]2282 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2283
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2284 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2285
2286 <ul class="entry_type_enum">
2287 <li>
2288 <span class="entry_type_enum_name">UNSUPPORTED</span>
2289 <span class="entry_type_enum_value">0</span>
2290 </li>
2291 <li>
2292 <span class="entry_type_enum_name">FACE_PRIORITY</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]2293 <span class="entry_type_enum_notes"><p>if face detection support exists Use face
2294detection data to drive 3A routines.<wbr/> If face detection
2295statistics are disabled,<wbr/> should still operate correctly
2296(but not return face detection statistics to the
2297framework).<wbr/></p>
2298<p>Unlike the other scene modes,<wbr/> aeMode,<wbr/> awbMode,<wbr/> and afMode
2299remain active when FACE_<wbr/>PRIORITY is set.<wbr/> This is due to
2300compatibility concerns with the old camera
2301API</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2302 </li>
2303 <li>
2304 <span class="entry_type_enum_name">ACTION</span>
2305 <span class="entry_type_enum_optional">optional</span>
2306 </li>
2307 <li>
2308 <span class="entry_type_enum_name">PORTRAIT</span>
2309 <span class="entry_type_enum_optional">optional</span>
2310 </li>
2311 <li>
2312 <span class="entry_type_enum_name">LANDSCAPE</span>
2313 <span class="entry_type_enum_optional">optional</span>
2314 </li>
2315 <li>
2316 <span class="entry_type_enum_name">NIGHT</span>
2317 <span class="entry_type_enum_optional">optional</span>
2318 </li>
2319 <li>
2320 <span class="entry_type_enum_name">NIGHT_PORTRAIT</span>
2321 <span class="entry_type_enum_optional">optional</span>
2322 </li>
2323 <li>
2324 <span class="entry_type_enum_name">THEATRE</span>
2325 <span class="entry_type_enum_optional">optional</span>
2326 </li>
2327 <li>
2328 <span class="entry_type_enum_name">BEACH</span>
2329 <span class="entry_type_enum_optional">optional</span>
2330 </li>
2331 <li>
2332 <span class="entry_type_enum_name">SNOW</span>
2333 <span class="entry_type_enum_optional">optional</span>
2334 </li>
2335 <li>
2336 <span class="entry_type_enum_name">SUNSET</span>
2337 <span class="entry_type_enum_optional">optional</span>
2338 </li>
2339 <li>
2340 <span class="entry_type_enum_name">STEADYPHOTO</span>
2341 <span class="entry_type_enum_optional">optional</span>
2342 </li>
2343 <li>
2344 <span class="entry_type_enum_name">FIREWORKS</span>
2345 <span class="entry_type_enum_optional">optional</span>
2346 </li>
2347 <li>
2348 <span class="entry_type_enum_name">SPORTS</span>
2349 <span class="entry_type_enum_optional">optional</span>
2350 </li>
2351 <li>
2352 <span class="entry_type_enum_name">PARTY</span>
2353 <span class="entry_type_enum_optional">optional</span>
2354 </li>
2355 <li>
2356 <span class="entry_type_enum_name">CANDLELIGHT</span>
2357 <span class="entry_type_enum_optional">optional</span>
2358 </li>
2359 <li>
2360 <span class="entry_type_enum_name">BARCODE</span>
2361 <span class="entry_type_enum_optional">optional</span>
2362 </li>
2363 </ul>
2364
2365 </td> <!-- entry_type -->
2366
2367 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2368 <p>Which scene mode is active when
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]2369<a href="#controls_android.control.mode">android.<wbr/>control.<wbr/>mode</a> = SCENE_<wbr/>MODE</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2370 </td>
2371
2372 <td class="entry_units">
2373 </td>
2374
2375 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]2376 <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]2377 </td>
2378
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2379 <td class="entry_tags">
2380 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]2381 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2382 </ul>
2383 </td>
2384
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2385 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2386
2387
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2388 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
2389 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2390
2391
2392 <tr class="entry" id="controls_android.control.videoStabilizationMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2393 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2394 android.<wbr/>control.<wbr/>video<wbr/>Stabilization<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2395 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2396 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]2397 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2398
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]2399 <span class="entry_type_visibility"> [public as boolean]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2400
2401 <ul class="entry_type_enum">
2402 <li>
2403 <span class="entry_type_enum_name">OFF</span>
2404 </li>
2405 <li>
2406 <span class="entry_type_enum_name">ON</span>
2407 </li>
2408 </ul>
2409
2410 </td> <!-- entry_type -->
2411
2412 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2413 <p>Whether video stabilization is
2414active</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2415 </td>
2416
2417 <td class="entry_units">
2418 </td>
2419
2420 <td class="entry_range">
2421 </td>
2422
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2423 <td class="entry_tags">
2424 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]2425 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2426 </ul>
2427 </td>
2428
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2429 </tr>
2430 <tr class="entries_header">
2431 <th class="th_details" colspan="5">Details</th>
2432 </tr>
2433 <tr class="entry_cont">
2434 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2435 <p>If enabled,<wbr/> video stabilization can modify the
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]2436<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]2437stabilized</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2438 </td>
2439 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2440
2441
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2442 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
2443 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2444
2445
2446
2447 <!-- end of kind -->
2448 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2449 <tr><td colspan="6" class="kind">static</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2450
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2451 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2452 <tr>
2453 <th class="th_name">Property Name</th>
2454 <th class="th_type">Type</th>
2455 <th class="th_description">Description</th>
2456 <th class="th_units">Units</th>
2457 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2458 <th class="th_tags">Tags</th>
2459 </tr>
2460 </thead>
2461
2462 <tbody>
2463
2464
2465
2466
2467
2468
2469
2470
2471
2472
2473 <tr class="entry" id="static_android.control.aeAvailableAntibandingModes">
Eino-Ville Talvala19ce2c12013-12-30 12:03:45 -0800[diff] [blame]2474 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2475 android.<wbr/>control.<wbr/>ae<wbr/>Available<wbr/>Antibanding<wbr/>Modes
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2476 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2477 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]2478 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2479 <span class="entry_type_container">x</span>
2480
2481 <span class="entry_type_array">
2482 n
2483 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2484 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2485 <div class="entry_type_notes">list of enums</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2486
2487
2488 </td> <!-- entry_type -->
2489
2490 <td class="entry_description">
Eino-Ville Talvala19ce2c12013-12-30 12:03:45 -0800[diff] [blame]2491 <p>The set of auto-exposure antibanding modes that are
2492supported by this camera device.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2493 </td>
2494
2495 <td class="entry_units">
2496 </td>
2497
2498 <td class="entry_range">
2499 </td>
2500
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2501 <td class="entry_tags">
2502 </td>
2503
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2504 </tr>
Eino-Ville Talvala19ce2c12013-12-30 12:03:45 -0800[diff] [blame]2505 <tr class="entries_header">
2506 <th class="th_details" colspan="5">Details</th>
2507 </tr>
2508 <tr class="entry_cont">
2509 <td class="entry_details" colspan="5">
2510 <p>Not all of the auto-exposure anti-banding modes may be
2511supported by a given camera device.<wbr/> This field lists the
2512valid anti-banding modes that the application may request
2513for this camera device; they must include AUTO.<wbr/></p>
2514 </td>
2515 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2516
2517
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2518 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
2519 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2520
2521
2522 <tr class="entry" id="static_android.control.aeAvailableModes">
Eino-Ville Talvala9fa0d902014-01-08 16:16:53 -0800[diff] [blame]2523 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2524 android.<wbr/>control.<wbr/>ae<wbr/>Available<wbr/>Modes
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2525 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2526 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]2527 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2528 <span class="entry_type_container">x</span>
2529
2530 <span class="entry_type_array">
2531 n
2532 </span>
Eino-Ville Talvala9fa0d902014-01-08 16:16:53 -0800[diff] [blame]2533 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2534 <div class="entry_type_notes">list of enums</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2535
2536
2537 </td> <!-- entry_type -->
2538
2539 <td class="entry_description">
Eino-Ville Talvala9fa0d902014-01-08 16:16:53 -0800[diff] [blame]2540 <p>The set of auto-exposure modes that are supported by this
2541camera device.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2542 </td>
2543
2544 <td class="entry_units">
2545 </td>
2546
2547 <td class="entry_range">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2548 </td>
2549
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2550 <td class="entry_tags">
Eino-Ville Talvala9fa0d902014-01-08 16:16:53 -0800[diff] [blame]2551 <ul class="entry_tags">
2552 <li><a href="#tag_BC">BC</a></li>
2553 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2554 </td>
2555
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2556 </tr>
Eino-Ville Talvala9fa0d902014-01-08 16:16:53 -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 the auto-exposure modes may be supported by a
2563given camera device,<wbr/> especially if no flash unit is
2564available.<wbr/> This entry lists the valid modes for
2565<a href="#controls_android.control.aeMode">android.<wbr/>control.<wbr/>ae<wbr/>Mode</a> for this camera device.<wbr/></p>
2566<p>All camera devices support ON,<wbr/> and all camera devices with
2567flash units support ON_<wbr/>AUTO_<wbr/>FLASH and
2568ON_<wbr/>ALWAYS_<wbr/>FLASH.<wbr/></p>
2569<p>Full-capability camera devices always support OFF mode,<wbr/>
2570which enables application control of camera exposure time,<wbr/>
2571sensitivity,<wbr/> and frame duration.<wbr/></p>
2572 </td>
2573 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2574
2575
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2576 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
2577 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2578
2579
2580 <tr class="entry" id="static_android.control.aeAvailableTargetFpsRanges">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2581 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2582 android.<wbr/>control.<wbr/>ae<wbr/>Available<wbr/>Target<wbr/>Fps<wbr/>Ranges
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2583 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2584 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]2585 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2586 <span class="entry_type_container">x</span>
2587
2588 <span class="entry_type_array">
2589 2 x n
2590 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2591 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2592 <div class="entry_type_notes">list of pairs of frame rates</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2593
2594
2595 </td> <!-- entry_type -->
2596
2597 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2598 <p>List of frame rate ranges supported by the
2599AE algorithm/<wbr/>hardware</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2600 </td>
2601
2602 <td class="entry_units">
2603 </td>
2604
2605 <td class="entry_range">
2606 </td>
2607
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2608 <td class="entry_tags">
2609 </td>
2610
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2611 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2612
2613
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2614 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
2615 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2616
2617
2618 <tr class="entry" id="static_android.control.aeCompensationRange">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2619 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2620 android.<wbr/>control.<wbr/>ae<wbr/>Compensation<wbr/>Range
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2621 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2622 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]2623 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2624 <span class="entry_type_container">x</span>
2625
2626 <span class="entry_type_array">
2627 2
2628 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2629 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2630
2631
2632 </td> <!-- entry_type -->
2633
2634 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2635 <p>Maximum and minimum exposure compensation
2636setting,<wbr/> in counts of
2637android.<wbr/>control.<wbr/>ae<wbr/>Compensation<wbr/>Step<wbr/>Size</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2638 </td>
2639
2640 <td class="entry_units">
2641 </td>
2642
2643 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]2644 <p>At least (-2,<wbr/>2)/<wbr/>(exp compensation step
2645size)</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2646 </td>
2647
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2648 <td class="entry_tags">
2649 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]2650 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2651 </ul>
2652 </td>
2653
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2654 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2655
2656
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2657 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
2658 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2659
2660
2661 <tr class="entry" id="static_android.control.aeCompensationStep">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2662 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2663 android.<wbr/>control.<wbr/>ae<wbr/>Compensation<wbr/>Step
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2664 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2665 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]2666 <span class="entry_type_name">rational</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2667
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2668 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2669
2670
2671 </td> <!-- entry_type -->
2672
2673 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2674 <p>Smallest step by which exposure compensation
2675can be changed</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2676 </td>
2677
2678 <td class="entry_units">
2679 </td>
2680
2681 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]2682 <p>&lt;= 1/<wbr/>2</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2683 </td>
2684
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2685 <td class="entry_tags">
2686 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]2687 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2688 </ul>
2689 </td>
2690
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2691 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2692
2693
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2694 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
2695 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2696
2697
2698 <tr class="entry" id="static_android.control.afAvailableModes">
Zhijun Hef163fa92014-01-14 09:59:04 -0800[diff] [blame]2699 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2700 android.<wbr/>control.<wbr/>af<wbr/>Available<wbr/>Modes
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2701 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2702 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]2703 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2704 <span class="entry_type_container">x</span>
2705
2706 <span class="entry_type_array">
2707 n
2708 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2709 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2710 <div class="entry_type_notes">List of enums</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2711
2712
2713 </td> <!-- entry_type -->
2714
2715 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2716 <p>List of AF modes that can be
Zhijun Hef163fa92014-01-14 09:59:04 -0800[diff] [blame]2717selected 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]2718 </td>
2719
2720 <td class="entry_units">
2721 </td>
2722
2723 <td class="entry_range">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2724 </td>
2725
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2726 <td class="entry_tags">
2727 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]2728 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2729 </ul>
2730 </td>
2731
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2732 </tr>
Zhijun Hef163fa92014-01-14 09:59:04 -0800[diff] [blame]2733 <tr class="entries_header">
2734 <th class="th_details" colspan="5">Details</th>
2735 </tr>
2736 <tr class="entry_cont">
2737 <td class="entry_details" colspan="5">
2738 <p>Not all the auto-focus modes may be supported by a
2739given camera device.<wbr/> This entry lists the valid modes for
2740<a href="#controls_android.control.afMode">android.<wbr/>control.<wbr/>af<wbr/>Mode</a> for this camera device.<wbr/></p>
2741<p>All camera devices will support OFF mode,<wbr/> and all camera devices with
2742adjustable 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>)
2743will support AUTO mode.<wbr/></p>
2744 </td>
2745 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2746
2747
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2748 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
2749 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2750
2751
2752 <tr class="entry" id="static_android.control.availableEffects">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2753 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2754 android.<wbr/>control.<wbr/>available<wbr/>Effects
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2755 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2756 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]2757 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2758 <span class="entry_type_container">x</span>
2759
2760 <span class="entry_type_array">
2761 n
2762 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2763 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2764 <div class="entry_type_notes">list of enums</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2765
2766
2767 </td> <!-- entry_type -->
2768
2769 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2770 <p>what subset of the full color effect enum
2771list is supported</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2772 </td>
2773
2774 <td class="entry_units">
2775 </td>
2776
2777 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]2778 <p>OFF must be listed</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2779 </td>
2780
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2781 <td class="entry_tags">
2782 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]2783 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2784 </ul>
2785 </td>
2786
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2787 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2788
2789
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2790 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
2791 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2792
2793
2794 <tr class="entry" id="static_android.control.availableSceneModes">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2795 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2796 android.<wbr/>control.<wbr/>available<wbr/>Scene<wbr/>Modes
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2797 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2798 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]2799 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2800 <span class="entry_type_container">x</span>
2801
2802 <span class="entry_type_array">
2803 n
2804 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2805 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2806 <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]2807
2808
2809 </td> <!-- entry_type -->
2810
2811 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2812 <p>what subset of the scene mode enum list is
2813supported.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2814 </td>
2815
2816 <td class="entry_units">
2817 </td>
2818
2819 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]2820 <p>SCENE_<wbr/>MODE_<wbr/>FACE_<wbr/>PRIORITY must be supported if face
2821detection is supported</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2822 </td>
2823
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2824 <td class="entry_tags">
2825 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]2826 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2827 </ul>
2828 </td>
2829
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2830 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2831
2832
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2833 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
2834 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2835
2836
2837 <tr class="entry" id="static_android.control.availableVideoStabilizationModes">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2838 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2839 android.<wbr/>control.<wbr/>available<wbr/>Video<wbr/>Stabilization<wbr/>Modes
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2840 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2841 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]2842 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2843 <span class="entry_type_container">x</span>
2844
2845 <span class="entry_type_array">
2846 n
2847 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2848 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2849 <div class="entry_type_notes">List of enums.<wbr/></div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2850
2851
2852 </td> <!-- entry_type -->
2853
2854 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2855 <p>List of video stabilization modes that can
2856be supported</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2857 </td>
2858
2859 <td class="entry_units">
2860 </td>
2861
2862 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]2863 <p>OFF must be included</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2864 </td>
2865
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2866 <td class="entry_tags">
2867 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]2868 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2869 </ul>
2870 </td>
2871
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2872 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2873
2874
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2875 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
2876 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2877
2878
2879 <tr class="entry" id="static_android.control.awbAvailableModes">
Zhijun He7787f7f2014-01-14 16:30:31 -0800[diff] [blame]2880 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2881 android.<wbr/>control.<wbr/>awb<wbr/>Available<wbr/>Modes
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2882 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2883 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]2884 <span class="entry_type_name">byte</span>
Alex Raya4251d92013-04-30 16:43:44 -0700[diff] [blame]2885 <span class="entry_type_container">x</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2886
Alex Raya4251d92013-04-30 16:43:44 -0700[diff] [blame]2887 <span class="entry_type_array">
2888 n
2889 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2890 <span class="entry_type_visibility"> [public]</span>
Zhijun He7787f7f2014-01-14 16:30:31 -0800[diff] [blame]2891 <div class="entry_type_notes">List of enums</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2892
2893
2894 </td> <!-- entry_type -->
2895
2896 <td class="entry_description">
Zhijun He7787f7f2014-01-14 16:30:31 -0800[diff] [blame]2897 <p>The set of auto-white-balance modes (<a href="#controls_android.control.awbMode">android.<wbr/>control.<wbr/>awb<wbr/>Mode</a>)
2898that are supported by this camera device.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2899 </td>
2900
2901 <td class="entry_units">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2902 </td>
2903
2904 <td class="entry_range">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2905 </td>
2906
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2907 <td class="entry_tags">
2908 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]2909 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2910 </ul>
2911 </td>
2912
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2913 </tr>
Zhijun He7787f7f2014-01-14 16:30:31 -0800[diff] [blame]2914 <tr class="entries_header">
2915 <th class="th_details" colspan="5">Details</th>
2916 </tr>
2917 <tr class="entry_cont">
2918 <td class="entry_details" colspan="5">
2919 <p>Not all the auto-white-balance modes may be supported by a
2920given camera device.<wbr/> This entry lists the valid modes for
2921<a href="#controls_android.control.awbMode">android.<wbr/>control.<wbr/>awb<wbr/>Mode</a> for this camera device.<wbr/></p>
2922<p>All camera devices will support ON mode.<wbr/></p>
2923<p>Full-capability camera devices will always support OFF mode,<wbr/>
2924which enables application control of white balance,<wbr/> by using
2925<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>
2926 </td>
2927 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2928
2929
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2930 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
2931 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2932
2933
2934 <tr class="entry" id="static_android.control.maxRegions">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2935 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2936 android.<wbr/>control.<wbr/>max<wbr/>Regions
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2937 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2938 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]2939 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2940
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2941 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2942
2943
2944 </td> <!-- entry_type -->
2945
2946 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2947 <p>For AE,<wbr/> AWB,<wbr/> and AF,<wbr/> how many individual
2948regions can be listed for metering?</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2949 </td>
2950
2951 <td class="entry_units">
2952 </td>
2953
2954 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame]2955 <p>&gt;= 1</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2956 </td>
2957
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2958 <td class="entry_tags">
2959 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]2960 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2961 </ul>
2962 </td>
2963
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2964 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2965
2966
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2967 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
2968 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2969
2970
2971 <tr class="entry" id="static_android.control.sceneModeOverrides">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2972 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2973 android.<wbr/>control.<wbr/>scene<wbr/>Mode<wbr/>Overrides
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2974 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2975 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]2976 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2977 <span class="entry_type_container">x</span>
2978
2979 <span class="entry_type_array">
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2980 3 x length(availableSceneModes)
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2981 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2982 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2983
2984
2985 </td> <!-- entry_type -->
2986
2987 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2988 <p>List of AE,<wbr/> AWB,<wbr/> and AF modes to use for
2989each available scene mode</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2990 </td>
2991
2992 <td class="entry_units">
2993 </td>
2994
2995 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]2996 <p>For each listed scene mode,<wbr/> lists the aeMode,<wbr/>
2997awbMode,<wbr/> and afMode that the HAL wants to use for that
2998scene mode.<wbr/></p>
2999<p>For each entry,<wbr/> the order is {aeMode,<wbr/> awbMode,<wbr/> afMode} in
3000order of increasing index</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3001 </td>
3002
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3003 <td class="entry_tags">
3004 <ul class="entry_tags">
3005 <li><a href="#tag_BC">BC</a></li>
3006 </ul>
3007 </td>
3008
3009 </tr>
3010 <tr class="entries_header">
3011 <th class="th_details" colspan="5">Details</th>
3012 </tr>
3013 <tr class="entry_cont">
3014 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3015 <p>When a scene mode is enabled,<wbr/> the HAL is expected
3016to override aeMode,<wbr/> awbMode,<wbr/> and afMode with its
3017preferred settings for that scene mode.<wbr/></p>
3018<p>To simplify communication with old camera API applications,<wbr/>
3019the service wants this override list in the static metadata.<wbr/>
3020The order of this list matches that of availableSceneModes,<wbr/>
3021with 3 entires for each scene mode.<wbr/> The overrides listed
3022for SCENE_<wbr/>MODE_<wbr/>FACE_<wbr/>PRIORITY are ignored,<wbr/> since for that
3023mode,<wbr/> the application-set aeMode,<wbr/> awbMode,<wbr/> and afMode are
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]3024used 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]3025AUTO.<wbr/></p>
3026<p>It is recommended that for FACE_<wbr/>PRIORITY,<wbr/> the overrides
3027should be set to 0.<wbr/> As an example,<wbr/> if availableSceneModes is
3028{ FACE_<wbr/>PRIORITY,<wbr/> ACTION,<wbr/> NIGHT },<wbr/> then the service expects
3029this field to have 9 entries; for example { 0 ,<wbr/> 0,<wbr/> 0,<wbr/>
3030ON_<wbr/>AUTO_<wbr/>FLASH,<wbr/> AUTO,<wbr/> CONTINUOUS_<wbr/>PICTURE,<wbr/> ON_<wbr/>AUTO_<wbr/>FLASH,<wbr/>
3031INCANDESCENT,<wbr/> AUTO }</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3032 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3033 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3034
3035
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3036 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
3037 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3038
3039
3040
3041 <!-- end of kind -->
3042 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3043 <tr><td colspan="6" class="kind">dynamic</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3044
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3045 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3046 <tr>
3047 <th class="th_name">Property Name</th>
3048 <th class="th_type">Type</th>
3049 <th class="th_description">Description</th>
3050 <th class="th_units">Units</th>
3051 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3052 <th class="th_tags">Tags</th>
3053 </tr>
3054 </thead>
3055
3056 <tbody>
3057
3058
3059
3060
3061
3062
3063
3064
3065
3066
3067 <tr class="entry" id="dynamic_android.control.aePrecaptureId">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3068 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3069 android.<wbr/>control.<wbr/>ae<wbr/>Precapture<wbr/>Id
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3070 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3071 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]3072 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3073
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3074 <span class="entry_type_visibility"> [hidden]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3075
3076
3077 </td> <!-- entry_type -->
3078
3079 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3080 <p>The ID sent with the latest
3081CAMERA2_<wbr/>TRIGGER_<wbr/>PRECAPTURE_<wbr/>METERING call</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3082 </td>
3083
3084 <td class="entry_units">
3085 </td>
3086
3087 <td class="entry_range">
3088 </td>
3089
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3090 <td class="entry_tags">
3091 </td>
3092
3093 </tr>
3094 <tr class="entries_header">
3095 <th class="th_details" colspan="5">Details</th>
3096 </tr>
3097 <tr class="entry_cont">
3098 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3099 <p>Must be 0 if no
3100CAMERA2_<wbr/>TRIGGER_<wbr/>PRECAPTURE_<wbr/>METERING trigger received yet
3101by HAL.<wbr/> Always updated even if AE algorithm ignores the
3102trigger</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3103 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3104 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3105
3106
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3107 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
3108 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3109
3110
Eino-Ville Talvala9fa0d902014-01-08 16:16:53 -0800[diff] [blame]3111 <tr class="entry" id="dynamic_android.control.aeMode">
3112 <td class="entry_name" rowspan="3">
3113 android.<wbr/>control.<wbr/>ae<wbr/>Mode
3114 </td>
3115 <td class="entry_type">
3116 <span class="entry_type_name entry_type_name_enum">byte</span>
3117
3118 <span class="entry_type_visibility"> [public]</span>
3119
3120 <ul class="entry_type_enum">
3121 <li>
3122 <span class="entry_type_enum_name">OFF</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]3123 <span class="entry_type_enum_notes"><p>The camera device's autoexposure routine is disabled;
3124the application-selected <a href="#controls_android.sensor.exposureTime">android.<wbr/>sensor.<wbr/>exposure<wbr/>Time</a>,<wbr/>
3125<a href="#controls_android.sensor.sensitivity">android.<wbr/>sensor.<wbr/>sensitivity</a> and
3126<a href="#controls_android.sensor.frameDuration">android.<wbr/>sensor.<wbr/>frame<wbr/>Duration</a> are used by the camera
3127device,<wbr/> along with android.<wbr/>flash.<wbr/>* fields,<wbr/> if there's
3128a flash unit for this camera device.<wbr/></p></span>
Eino-Ville Talvala9fa0d902014-01-08 16:16:53 -0800[diff] [blame]3129 </li>
3130 <li>
3131 <span class="entry_type_enum_name">ON</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]3132 <span class="entry_type_enum_notes"><p>The camera device's autoexposure routine is active,<wbr/>
3133with no flash control.<wbr/> The application's values for
3134<a href="#controls_android.sensor.exposureTime">android.<wbr/>sensor.<wbr/>exposure<wbr/>Time</a>,<wbr/>
3135<a href="#controls_android.sensor.sensitivity">android.<wbr/>sensor.<wbr/>sensitivity</a>,<wbr/> and
3136<a href="#controls_android.sensor.frameDuration">android.<wbr/>sensor.<wbr/>frame<wbr/>Duration</a> are ignored.<wbr/> The
3137application has control over the various
3138android.<wbr/>flash.<wbr/>* fields.<wbr/></p></span>
Eino-Ville Talvala9fa0d902014-01-08 16:16:53 -0800[diff] [blame]3139 </li>
3140 <li>
3141 <span class="entry_type_enum_name">ON_AUTO_FLASH</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]3142 <span class="entry_type_enum_notes"><p>Like ON,<wbr/> except that the camera device also controls
3143the camera's flash unit,<wbr/> firing it in low-light
3144conditions.<wbr/> The flash may be fired during a
3145precapture sequence (triggered by
3146<a href="#controls_android.control.aePrecaptureTrigger">android.<wbr/>control.<wbr/>ae<wbr/>Precapture<wbr/>Trigger</a>) and may be fired
3147for captures for which the
3148<a href="#controls_android.control.captureIntent">android.<wbr/>control.<wbr/>capture<wbr/>Intent</a> field is set to
3149STILL_<wbr/>CAPTURE</p></span>
Eino-Ville Talvala9fa0d902014-01-08 16:16:53 -0800[diff] [blame]3150 </li>
3151 <li>
3152 <span class="entry_type_enum_name">ON_ALWAYS_FLASH</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]3153 <span class="entry_type_enum_notes"><p>Like ON,<wbr/> except that the camera device also controls
3154the camera's flash unit,<wbr/> always firing it for still
3155captures.<wbr/> The flash may be fired during a precapture
3156sequence (triggered by
3157<a href="#controls_android.control.aePrecaptureTrigger">android.<wbr/>control.<wbr/>ae<wbr/>Precapture<wbr/>Trigger</a>) and will always
3158be fired for captures for which the
3159<a href="#controls_android.control.captureIntent">android.<wbr/>control.<wbr/>capture<wbr/>Intent</a> field is set to
3160STILL_<wbr/>CAPTURE</p></span>
Eino-Ville Talvala9fa0d902014-01-08 16:16:53 -0800[diff] [blame]3161 </li>
3162 <li>
3163 <span class="entry_type_enum_name">ON_AUTO_FLASH_REDEYE</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]3164 <span class="entry_type_enum_notes"><p>Like ON_<wbr/>AUTO_<wbr/>FLASH,<wbr/> but with automatic red eye
3165reduction.<wbr/> If deemed necessary by the camera device,<wbr/>
3166a red eye reduction flash will fire during the
3167precapture sequence.<wbr/></p></span>
Eino-Ville Talvala9fa0d902014-01-08 16:16:53 -0800[diff] [blame]3168 </li>
3169 </ul>
3170
3171 </td> <!-- entry_type -->
3172
3173 <td class="entry_description">
3174 <p>The desired mode for the camera device's
3175auto-exposure routine.<wbr/></p>
3176 </td>
3177
3178 <td class="entry_units">
3179 </td>
3180
3181 <td class="entry_range">
3182 <p><a href="#static_android.control.aeAvailableModes">android.<wbr/>control.<wbr/>ae<wbr/>Available<wbr/>Modes</a></p>
3183 </td>
3184
3185 <td class="entry_tags">
3186 <ul class="entry_tags">
3187 <li><a href="#tag_BC">BC</a></li>
3188 </ul>
3189 </td>
3190
3191 </tr>
3192 <tr class="entries_header">
3193 <th class="th_details" colspan="5">Details</th>
3194 </tr>
3195 <tr class="entry_cont">
3196 <td class="entry_details" colspan="5">
3197 <p>This control is only effective if <a href="#controls_android.control.mode">android.<wbr/>control.<wbr/>mode</a> is
3198AUTO.<wbr/></p>
3199<p>When set to any of the ON modes,<wbr/> the camera device's
3200auto-exposure routine is enabled,<wbr/> overriding the
3201application's selected exposure time,<wbr/> sensor sensitivity,<wbr/>
3202and frame duration (<a href="#controls_android.sensor.exposureTime">android.<wbr/>sensor.<wbr/>exposure<wbr/>Time</a>,<wbr/>
3203<a href="#controls_android.sensor.sensitivity">android.<wbr/>sensor.<wbr/>sensitivity</a>,<wbr/> and
3204<a href="#controls_android.sensor.frameDuration">android.<wbr/>sensor.<wbr/>frame<wbr/>Duration</a>).<wbr/> If one of the FLASH modes
3205is selected,<wbr/> the camera device's flash unit controls are
3206also overridden.<wbr/></p>
3207<p>The FLASH modes are only available if the camera device
3208has a flash unit (<a href="#static_android.flash.info.available">android.<wbr/>flash.<wbr/>info.<wbr/>available</a> is <code>true</code>).<wbr/></p>
3209<p>If flash TORCH mode is desired,<wbr/> this field must be set to
3210ON or OFF,<wbr/> and <a href="#controls_android.flash.mode">android.<wbr/>flash.<wbr/>mode</a> set to TORCH.<wbr/></p>
3211<p>When set to any of the ON modes,<wbr/> the values chosen by the
3212camera device auto-exposure routine for the overridden
3213fields for a given capture will be available in its
3214CaptureResult.<wbr/></p>
3215 </td>
3216 </tr>
3217
3218
3219 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
3220 <!-- end of entry -->
3221
3222
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3223 <tr class="entry" id="dynamic_android.control.aeRegions">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3224 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3225 android.<wbr/>control.<wbr/>ae<wbr/>Regions
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3226 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3227 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]3228 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3229 <span class="entry_type_container">x</span>
3230
3231 <span class="entry_type_array">
3232 5 x area_count
3233 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3234 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3235
3236
3237 </td> <!-- entry_type -->
3238
3239 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3240 <p>List of areas to use for
3241metering</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3242 </td>
3243
3244 <td class="entry_units">
3245 </td>
3246
3247 <td class="entry_range">
3248 </td>
3249
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3250 <td class="entry_tags">
3251 <ul class="entry_tags">
3252 <li><a href="#tag_BC">BC</a></li>
3253 </ul>
3254 </td>
3255
3256 </tr>
3257 <tr class="entries_header">
3258 <th class="th_details" colspan="5">Details</th>
3259 </tr>
3260 <tr class="entry_cont">
3261 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3262 <p>Each area is a rectangle plus weight: xmin,<wbr/> ymin,<wbr/>
3263xmax,<wbr/> ymax,<wbr/> weight.<wbr/> The rectangle is defined inclusive of the
3264specified coordinates.<wbr/></p>
3265<p>The coordinate system is based on the active pixel array,<wbr/>
3266with (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]3267(<a href="#static_android.sensor.info.activeArraySize">android.<wbr/>sensor.<wbr/>info.<wbr/>active<wbr/>Array<wbr/>Size</a>.<wbr/>width - 1,<wbr/>
3268<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]3269bottom-right pixel in the active pixel array.<wbr/> The weight
3270should be nonnegative.<wbr/></p>
3271<p>If all regions have 0 weight,<wbr/> then no specific metering area
3272needs to be used by the HAL.<wbr/> If the metering region is
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]3273outside 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]3274should ignore the sections outside the region and output the
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3275used sections in the frame metadata</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3276 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3277 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3278
3279
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3280 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
3281 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3282
3283
3284 <tr class="entry" id="dynamic_android.control.aeState">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3285 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3286 android.<wbr/>control.<wbr/>ae<wbr/>State
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3287 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3288 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]3289 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3290
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3291 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3292
3293 <ul class="entry_type_enum">
3294 <li>
3295 <span class="entry_type_enum_name">INACTIVE</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]3296 <span class="entry_type_enum_notes"><p>AE is off.<wbr/> When a camera device is opened,<wbr/> it starts in
3297this state.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3298 </li>
3299 <li>
3300 <span class="entry_type_enum_name">SEARCHING</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]3301 <span class="entry_type_enum_notes"><p>AE doesn't yet have a good set of control values
3302for the current scene</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3303 </li>
3304 <li>
3305 <span class="entry_type_enum_name">CONVERGED</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]3306 <span class="entry_type_enum_notes"><p>AE has a good set of control values for the
3307current scene</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3308 </li>
3309 <li>
3310 <span class="entry_type_enum_name">LOCKED</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]3311 <span class="entry_type_enum_notes"><p>AE has been locked (aeMode =
3312LOCKED)</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3313 </li>
3314 <li>
3315 <span class="entry_type_enum_name">FLASH_REQUIRED</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]3316 <span class="entry_type_enum_notes"><p>AE has a good set of control values,<wbr/> but flash
3317needs to be fired for good quality still
3318capture</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3319 </li>
3320 <li>
3321 <span class="entry_type_enum_name">PRECAPTURE</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]3322 <span class="entry_type_enum_notes"><p>AE has been asked to do a precapture sequence
3323(through the
3324trigger_<wbr/>action(CAMERA2_<wbr/>TRIGGER_<wbr/>PRECAPTURE_<wbr/>METERING)
3325call),<wbr/> and is currently executing it.<wbr/> Once PRECAPTURE
3326completes,<wbr/> AE will transition to CONVERGED or
3327FLASH_<wbr/>REQUIRED as appropriate</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3328 </li>
3329 </ul>
3330
3331 </td> <!-- entry_type -->
3332
3333 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3334 <p>Current state of AE algorithm</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3335 </td>
3336
3337 <td class="entry_units">
3338 </td>
3339
3340 <td class="entry_range">
3341 </td>
3342
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3343 <td class="entry_tags">
3344 </td>
3345
3346 </tr>
3347 <tr class="entries_header">
3348 <th class="th_details" colspan="5">Details</th>
3349 </tr>
3350 <tr class="entry_cont">
3351 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3352 <p>Whenever the AE algorithm state changes,<wbr/> a
3353MSG_<wbr/>AUTOEXPOSURE notification must be send if a
3354notification callback is registered.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3355 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3356 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3357
3358
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3359 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
3360 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3361
3362
3363 <tr class="entry" id="dynamic_android.control.afMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3364 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3365 android.<wbr/>control.<wbr/>af<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3366 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3367 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]3368 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3369
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3370 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3371
3372 <ul class="entry_type_enum">
3373 <li>
3374 <span class="entry_type_enum_name">OFF</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]3375 <span class="entry_type_enum_notes"><p>The auto-focus routine does not control the lens;
3376<a href="#controls_android.lens.focusDistance">android.<wbr/>lens.<wbr/>focus<wbr/>Distance</a> is controlled by the
3377application</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3378 </li>
3379 <li>
3380 <span class="entry_type_enum_name">AUTO</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]3381 <span class="entry_type_enum_notes"><p>If lens is not fixed focus.<wbr/></p>
3382<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
3383is fixed-focus.<wbr/> In this mode,<wbr/> the lens does not move unless
3384the autofocus trigger action is called.<wbr/> When that trigger
3385is activated,<wbr/> AF must transition to ACTIVE_<wbr/>SCAN,<wbr/> then to
3386the outcome of the scan (FOCUSED or NOT_<wbr/>FOCUSED).<wbr/></p>
3387<p>Triggering AF_<wbr/>CANCEL resets the lens position to default,<wbr/>
3388and sets the AF state to INACTIVE.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3389 </li>
3390 <li>
3391 <span class="entry_type_enum_name">MACRO</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]3392 <span class="entry_type_enum_notes"><p>In this mode,<wbr/> the lens does not move unless the
3393autofocus trigger action is called.<wbr/></p>
3394<p>When that trigger is activated,<wbr/> AF must transition to
3395ACTIVE_<wbr/>SCAN,<wbr/> then to the outcome of the scan (FOCUSED or
3396NOT_<wbr/>FOCUSED).<wbr/> Triggering cancel AF resets the lens
3397position to default,<wbr/> and sets the AF state to
3398INACTIVE.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3399 </li>
3400 <li>
3401 <span class="entry_type_enum_name">CONTINUOUS_VIDEO</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]3402 <span class="entry_type_enum_notes"><p>In this mode,<wbr/> the AF algorithm modifies the lens
3403position continually to attempt to provide a
3404constantly-in-focus image stream.<wbr/></p>
3405<p>The focusing behavior should be suitable for good quality
3406video recording; typically this means slower focus
3407movement and no overshoots.<wbr/> When the AF trigger is not
3408involved,<wbr/> the AF algorithm should start in INACTIVE state,<wbr/>
3409and then transition into PASSIVE_<wbr/>SCAN and PASSIVE_<wbr/>FOCUSED
3410states as appropriate.<wbr/> When the AF trigger is activated,<wbr/>
3411the algorithm should immediately transition into
3412AF_<wbr/>FOCUSED or AF_<wbr/>NOT_<wbr/>FOCUSED as appropriate,<wbr/> and lock the
3413lens position until a cancel AF trigger is received.<wbr/></p>
3414<p>Once cancel is received,<wbr/> the algorithm should transition
3415back to INACTIVE and resume passive scan.<wbr/> Note that this
3416behavior is not identical to CONTINUOUS_<wbr/>PICTURE,<wbr/> since an
3417ongoing PASSIVE_<wbr/>SCAN must immediately be
3418canceled.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3419 </li>
3420 <li>
3421 <span class="entry_type_enum_name">CONTINUOUS_PICTURE</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]3422 <span class="entry_type_enum_notes"><p>In this mode,<wbr/> the AF algorithm modifies the lens
3423position continually to attempt to provide a
3424constantly-in-focus image stream.<wbr/></p>
3425<p>The focusing behavior should be suitable for still image
3426capture; typically this means focusing as fast as
3427possible.<wbr/> When the AF trigger is not involved,<wbr/> the AF
3428algorithm should start in INACTIVE state,<wbr/> and then
3429transition into PASSIVE_<wbr/>SCAN and PASSIVE_<wbr/>FOCUSED states as
3430appropriate as it attempts to maintain focus.<wbr/> When the AF
3431trigger is activated,<wbr/> the algorithm should finish its
3432PASSIVE_<wbr/>SCAN if active,<wbr/> and then transition into
3433AF_<wbr/>FOCUSED or AF_<wbr/>NOT_<wbr/>FOCUSED as appropriate,<wbr/> and lock the
3434lens position until a cancel AF trigger is received.<wbr/></p>
3435<p>When the AF cancel trigger is activated,<wbr/> the algorithm
3436should transition back to INACTIVE and then act as if it
3437has just been started.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3438 </li>
3439 <li>
3440 <span class="entry_type_enum_name">EDOF</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]3441 <span class="entry_type_enum_notes"><p>Extended depth of field (digital focus).<wbr/> AF
3442trigger is ignored,<wbr/> AF state should always be
3443INACTIVE.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3444 </li>
3445 </ul>
3446
3447 </td> <!-- entry_type -->
3448
3449 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3450 <p>Whether AF is currently enabled,<wbr/> and what
3451mode it is set to</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3452 </td>
3453
3454 <td class="entry_units">
3455 </td>
3456
3457 <td class="entry_range">
Zhijun He7787f7f2014-01-14 16:30:31 -0800[diff] [blame]3458 <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]3459 </td>
3460
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3461 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]3462 <ul class="entry_tags">
3463 <li><a href="#tag_BC">BC</a></li>
3464 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3465 </td>
3466
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3467 </tr>
3468 <tr class="entries_header">
3469 <th class="th_details" colspan="5">Details</th>
3470 </tr>
3471 <tr class="entry_cont">
3472 <td class="entry_details" colspan="5">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]3473 <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]3474<p>If the lens is controlled by the camera device auto-focus algorithm,<wbr/>
3475the camera device will report the current AF status in android.<wbr/>control.<wbr/>af<wbr/>State
3476in result metadata.<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3477 </td>
3478 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3479
3480
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3481 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
3482 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3483
3484
3485 <tr class="entry" id="dynamic_android.control.afRegions">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3486 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3487 android.<wbr/>control.<wbr/>af<wbr/>Regions
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3488 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3489 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]3490 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3491 <span class="entry_type_container">x</span>
3492
3493 <span class="entry_type_array">
3494 5 x area_count
3495 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3496 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3497
3498
3499 </td> <!-- entry_type -->
3500
3501 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3502 <p>List of areas to use for focus
3503estimation</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3504 </td>
3505
3506 <td class="entry_units">
3507 </td>
3508
3509 <td class="entry_range">
3510 </td>
3511
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3512 <td class="entry_tags">
3513 <ul class="entry_tags">
3514 <li><a href="#tag_BC">BC</a></li>
3515 </ul>
3516 </td>
3517
3518 </tr>
3519 <tr class="entries_header">
3520 <th class="th_details" colspan="5">Details</th>
3521 </tr>
3522 <tr class="entry_cont">
3523 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3524 <p>Each area is a rectangle plus weight: xmin,<wbr/> ymin,<wbr/>
3525xmax,<wbr/> ymax,<wbr/> weight.<wbr/> The rectangle is defined inclusive of the
3526specified coordinates.<wbr/></p>
3527<p>The coordinate system is based on the active pixel array,<wbr/>
3528with (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]3529(<a href="#static_android.sensor.info.activeArraySize">android.<wbr/>sensor.<wbr/>info.<wbr/>active<wbr/>Array<wbr/>Size</a>.<wbr/>width - 1,<wbr/>
3530<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]3531bottom-right pixel in the active pixel array.<wbr/> The weight
3532should be nonnegative.<wbr/></p>
3533<p>If all regions have 0 weight,<wbr/> then no specific focus area
3534needs to be used by the HAL.<wbr/> If the focusing region is
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]3535outside 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]3536should ignore the sections outside the region and output the
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3537used sections in the frame metadata</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3538 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3539 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3540
3541
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3542 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
3543 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3544
3545
3546 <tr class="entry" id="dynamic_android.control.afState">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3547 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3548 android.<wbr/>control.<wbr/>af<wbr/>State
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3549 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3550 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]3551 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3552
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3553 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3554
3555 <ul class="entry_type_enum">
3556 <li>
3557 <span class="entry_type_enum_name">INACTIVE</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]3558 <span class="entry_type_enum_notes"><p>AF off or has not yet tried to scan/<wbr/>been asked
3559to scan.<wbr/> When a camera device is opened,<wbr/> it starts in
3560this state.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3561 </li>
3562 <li>
3563 <span class="entry_type_enum_name">PASSIVE_SCAN</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]3564 <span class="entry_type_enum_notes"><p>if CONTINUOUS_<wbr/>* modes are supported.<wbr/> AF is
3565currently doing an AF scan initiated by a continuous
3566autofocus mode</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3567 </li>
3568 <li>
3569 <span class="entry_type_enum_name">PASSIVE_FOCUSED</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]3570 <span class="entry_type_enum_notes"><p>if CONTINUOUS_<wbr/>* modes are supported.<wbr/> AF currently
3571believes it is in focus,<wbr/> but may restart scanning at
3572any time.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3573 </li>
3574 <li>
3575 <span class="entry_type_enum_name">ACTIVE_SCAN</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]3576 <span class="entry_type_enum_notes"><p>if AUTO or MACRO modes are supported.<wbr/> AF is doing
3577an AF scan because it was triggered by AF
3578trigger</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3579 </li>
3580 <li>
3581 <span class="entry_type_enum_name">FOCUSED_LOCKED</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]3582 <span class="entry_type_enum_notes"><p>if any AF mode besides OFF is supported.<wbr/> AF
3583believes it is focused correctly and is
3584locked</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3585 </li>
3586 <li>
3587 <span class="entry_type_enum_name">NOT_FOCUSED_LOCKED</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]3588 <span class="entry_type_enum_notes"><p>if any AF mode besides OFF is supported.<wbr/> AF has
3589failed to focus successfully and is
3590locked</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3591 </li>
Eino-Ville Talvala492ba7c2013-09-20 17:24:00 -0700[diff] [blame]3592 <li>
3593 <span class="entry_type_enum_name">PASSIVE_UNFOCUSED</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]3594 <span class="entry_type_enum_notes"><p>if CONTINUOUS_<wbr/>* modes are supported.<wbr/> AF finished a
3595passive scan without finding focus,<wbr/> and may restart
3596scanning at any time.<wbr/></p></span>
Eino-Ville Talvala492ba7c2013-09-20 17:24:00 -0700[diff] [blame]3597 </li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3598 </ul>
3599
3600 </td> <!-- entry_type -->
3601
3602 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3603 <p>Current state of AF algorithm</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3604 </td>
3605
3606 <td class="entry_units">
3607 </td>
3608
3609 <td class="entry_range">
3610 </td>
3611
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3612 <td class="entry_tags">
3613 </td>
3614
3615 </tr>
3616 <tr class="entries_header">
3617 <th class="th_details" colspan="5">Details</th>
3618 </tr>
3619 <tr class="entry_cont">
3620 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3621 <p>Whenever the AF algorithm state changes,<wbr/> a
3622MSG_<wbr/>AUTOFOCUS notification must be send if a notification
3623callback is registered.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3624 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3625 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3626
3627
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3628 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
3629 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3630
3631
3632 <tr class="entry" id="dynamic_android.control.afTriggerId">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3633 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3634 android.<wbr/>control.<wbr/>af<wbr/>Trigger<wbr/>Id
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3635 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3636 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]3637 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3638
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3639 <span class="entry_type_visibility"> [hidden]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3640
3641
3642 </td> <!-- entry_type -->
3643
3644 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3645 <p>The ID sent with the latest
3646CAMERA2_<wbr/>TRIGGER_<wbr/>AUTOFOCUS call</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3647 </td>
3648
3649 <td class="entry_units">
3650 </td>
3651
3652 <td class="entry_range">
3653 </td>
3654
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3655 <td class="entry_tags">
3656 </td>
3657
3658 </tr>
3659 <tr class="entries_header">
3660 <th class="th_details" colspan="5">Details</th>
3661 </tr>
3662 <tr class="entry_cont">
3663 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3664 <p>Must be 0 if no CAMERA2_<wbr/>TRIGGER_<wbr/>AUTOFOCUS trigger
3665received yet by HAL.<wbr/> Always updated even if AF algorithm
3666ignores the trigger</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3667 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3668 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3669
3670
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3671 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
3672 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3673
3674
3675 <tr class="entry" id="dynamic_android.control.awbMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3676 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3677 android.<wbr/>control.<wbr/>awb<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3678 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3679 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]3680 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3681
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3682 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3683
3684 <ul class="entry_type_enum">
3685 <li>
3686 <span class="entry_type_enum_name">OFF</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]3687 <span class="entry_type_enum_notes"><p>The camera device's auto white balance routine is disabled;
3688the application-selected color transform matrix
3689(<a href="#controls_android.colorCorrection.transform">android.<wbr/>color<wbr/>Correction.<wbr/>transform</a>) and gains
3690(<a href="#controls_android.colorCorrection.gains">android.<wbr/>color<wbr/>Correction.<wbr/>gains</a>) are used by the camera
3691device for manual white balance control.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3692 </li>
3693 <li>
3694 <span class="entry_type_enum_name">AUTO</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]3695 <span class="entry_type_enum_notes"><p>The camera device's auto white balance routine is active;
3696the application's values for android.<wbr/>color<wbr/>Correction.<wbr/>transform
3697and <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]3698 </li>
3699 <li>
3700 <span class="entry_type_enum_name">INCANDESCENT</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]3701 <span class="entry_type_enum_notes"><p>The camera device's auto white balance routine is disabled;
3702the camera device uses incandescent light as the assumed scene
3703illumination for white balance.<wbr/> While the exact white balance
3704transforms are up to the camera device,<wbr/> they will approximately
3705match the CIE standard illuminant A.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3706 </li>
3707 <li>
3708 <span class="entry_type_enum_name">FLUORESCENT</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]3709 <span class="entry_type_enum_notes"><p>The camera device's auto white balance routine is disabled;
3710the camera device uses fluorescent light as the assumed scene
3711illumination for white balance.<wbr/> While the exact white balance
3712transforms are up to the camera device,<wbr/> they will approximately
3713match the CIE standard illuminant F2.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3714 </li>
3715 <li>
3716 <span class="entry_type_enum_name">WARM_FLUORESCENT</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]3717 <span class="entry_type_enum_notes"><p>The camera device's auto white balance routine is disabled;
3718the camera device uses warm fluorescent light as the assumed scene
3719illumination for white balance.<wbr/> While the exact white balance
3720transforms are up to the camera device,<wbr/> they will approximately
3721match the CIE standard illuminant F4.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3722 </li>
3723 <li>
3724 <span class="entry_type_enum_name">DAYLIGHT</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]3725 <span class="entry_type_enum_notes"><p>The camera device's auto white balance routine is disabled;
3726the camera device uses daylight light as the assumed scene
3727illumination for white balance.<wbr/> While the exact white balance
3728transforms are up to the camera device,<wbr/> they will approximately
3729match the CIE standard illuminant D65.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3730 </li>
3731 <li>
3732 <span class="entry_type_enum_name">CLOUDY_DAYLIGHT</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]3733 <span class="entry_type_enum_notes"><p>The camera device's auto white balance routine is disabled;
3734the camera device uses cloudy daylight light as the assumed scene
3735illumination for white balance.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3736 </li>
3737 <li>
3738 <span class="entry_type_enum_name">TWILIGHT</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]3739 <span class="entry_type_enum_notes"><p>The camera device's auto white balance routine is disabled;
3740the camera device uses twilight light as the assumed scene
3741illumination for white balance.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3742 </li>
3743 <li>
3744 <span class="entry_type_enum_name">SHADE</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]3745 <span class="entry_type_enum_notes"><p>The camera device's auto white balance routine is disabled;
3746the camera device uses shade light as the assumed scene
3747illumination for white balance.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3748 </li>
3749 </ul>
3750
3751 </td> <!-- entry_type -->
3752
3753 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3754 <p>Whether AWB is currently setting the color
3755transform fields,<wbr/> and what its illumination target
3756is</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3757 </td>
3758
3759 <td class="entry_units">
3760 </td>
3761
3762 <td class="entry_range">
Zhijun He7787f7f2014-01-14 16:30:31 -0800[diff] [blame]3763 <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]3764 </td>
3765
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3766 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]3767 <ul class="entry_tags">
3768 <li><a href="#tag_BC">BC</a></li>
3769 <li><a href="#tag_AWB">AWB</a></li>
3770 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3771 </td>
3772
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3773 </tr>
3774 <tr class="entries_header">
3775 <th class="th_details" colspan="5">Details</th>
3776 </tr>
3777 <tr class="entry_cont">
3778 <td class="entry_details" colspan="5">
Zhijun He7787f7f2014-01-14 16:30:31 -0800[diff] [blame]3779 <p>This control is only effective if <a href="#controls_android.control.mode">android.<wbr/>control.<wbr/>mode</a> is AUTO.<wbr/></p>
3780<p>When set to the ON mode,<wbr/> the camera device's auto white balance
3781routine is enabled,<wbr/> overriding the application's selected
3782<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
3783<a href="#controls_android.colorCorrection.mode">android.<wbr/>color<wbr/>Correction.<wbr/>mode</a>.<wbr/></p>
3784<p>When set to the OFF mode,<wbr/> the camera device's auto white balance
3785routine is disabled.<wbr/> The applicantion manually controls the white
3786balance by <a href="#controls_android.colorCorrection.transform">android.<wbr/>color<wbr/>Correction.<wbr/>transform</a>,<wbr/> android.<wbr/>color<wbr/>Correction.<wbr/>gains
3787and <a href="#controls_android.colorCorrection.mode">android.<wbr/>color<wbr/>Correction.<wbr/>mode</a>.<wbr/></p>
3788<p>When set to any other modes,<wbr/> the camera device's auto white balance
3789routine is disabled.<wbr/> The camera device uses each particular illumination
3790target for white balance adjustment.<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3791 </td>
3792 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3793
3794
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3795 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
3796 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3797
3798
3799 <tr class="entry" id="dynamic_android.control.awbRegions">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3800 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3801 android.<wbr/>control.<wbr/>awb<wbr/>Regions
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3802 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3803 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]3804 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3805 <span class="entry_type_container">x</span>
3806
3807 <span class="entry_type_array">
3808 5 x area_count
3809 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3810 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3811
3812
3813 </td> <!-- entry_type -->
3814
3815 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3816 <p>List of areas to use for illuminant
3817estimation</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3818 </td>
3819
3820 <td class="entry_units">
3821 </td>
3822
3823 <td class="entry_range">
3824 </td>
3825
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3826 <td class="entry_tags">
3827 <ul class="entry_tags">
3828 <li><a href="#tag_BC">BC</a></li>
3829 </ul>
3830 </td>
3831
3832 </tr>
3833 <tr class="entries_header">
3834 <th class="th_details" colspan="5">Details</th>
3835 </tr>
3836 <tr class="entry_cont">
3837 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3838 <p>Only used in AUTO mode.<wbr/></p>
3839<p>Each area is a rectangle plus weight: xmin,<wbr/> ymin,<wbr/>
3840xmax,<wbr/> ymax,<wbr/> weight.<wbr/> The rectangle is defined inclusive of the
3841specified coordinates.<wbr/></p>
3842<p>The coordinate system is based on the active pixel array,<wbr/>
3843with (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]3844(<a href="#static_android.sensor.info.activeArraySize">android.<wbr/>sensor.<wbr/>info.<wbr/>active<wbr/>Array<wbr/>Size</a>.<wbr/>width - 1,<wbr/>
3845<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]3846bottom-right pixel in the active pixel array.<wbr/> The weight
3847should be nonnegative.<wbr/></p>
3848<p>If all regions have 0 weight,<wbr/> then no specific metering area
3849needs to be used by the HAL.<wbr/> If the metering region is
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]3850outside 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]3851should ignore the sections outside the region and output the
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3852used sections in the frame metadata</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3853 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3854 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3855
3856
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3857 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
3858 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3859
3860
3861 <tr class="entry" id="dynamic_android.control.awbState">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3862 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3863 android.<wbr/>control.<wbr/>awb<wbr/>State
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3864 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3865 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]3866 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3867
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3868 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3869
3870 <ul class="entry_type_enum">
3871 <li>
3872 <span class="entry_type_enum_name">INACTIVE</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]3873 <span class="entry_type_enum_notes"><p>AWB is not in auto mode.<wbr/> When a camera device is opened,<wbr/> it
3874starts in this state.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3875 </li>
3876 <li>
3877 <span class="entry_type_enum_name">SEARCHING</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]3878 <span class="entry_type_enum_notes"><p>AWB doesn't yet have a good set of control
3879values for the current scene</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3880 </li>
3881 <li>
3882 <span class="entry_type_enum_name">CONVERGED</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]3883 <span class="entry_type_enum_notes"><p>AWB has a good set of control values for the
3884current scene</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3885 </li>
3886 <li>
3887 <span class="entry_type_enum_name">LOCKED</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]3888 <span class="entry_type_enum_notes"><p>AE has been locked (aeMode =
3889LOCKED)</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3890 </li>
3891 </ul>
3892
3893 </td> <!-- entry_type -->
3894
3895 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3896 <p>Current state of AWB algorithm</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3897 </td>
3898
3899 <td class="entry_units">
3900 </td>
3901
3902 <td class="entry_range">
3903 </td>
3904
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3905 <td class="entry_tags">
3906 </td>
3907
3908 </tr>
3909 <tr class="entries_header">
3910 <th class="th_details" colspan="5">Details</th>
3911 </tr>
3912 <tr class="entry_cont">
3913 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3914 <p>Whenever the AWB algorithm state changes,<wbr/> a
3915MSG_<wbr/>AUTOWHITEBALANCE notification must be send if a
3916notification callback is registered.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3917 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3918 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3919
3920
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3921 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
3922 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3923
3924
3925 <tr class="entry" id="dynamic_android.control.mode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3926 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3927 android.<wbr/>control.<wbr/>mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3928 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3929 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]3930 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3931
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3932 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3933
3934 <ul class="entry_type_enum">
3935 <li>
3936 <span class="entry_type_enum_name">OFF</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]3937 <span class="entry_type_enum_notes"><p>Full application control of pipeline.<wbr/> All 3A
3938routines are disabled,<wbr/> no other settings in
3939android.<wbr/>control.<wbr/>* have any effect</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3940 </li>
3941 <li>
3942 <span class="entry_type_enum_name">AUTO</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]3943 <span class="entry_type_enum_notes"><p>Use settings for each individual 3A routine.<wbr/>
3944Manual control of capture parameters is disabled.<wbr/> All
3945controls in android.<wbr/>control.<wbr/>* besides sceneMode take
3946effect</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3947 </li>
3948 <li>
3949 <span class="entry_type_enum_name">USE_SCENE_MODE</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]3950 <span class="entry_type_enum_notes"><p>Use specific scene mode.<wbr/> Enabling this disables
3951control.<wbr/>aeMode,<wbr/> control.<wbr/>awbMode and control.<wbr/>afMode
3952controls; the HAL must ignore those settings while
3953USE_<wbr/>SCENE_<wbr/>MODE is active (except for FACE_<wbr/>PRIORITY
3954scene mode).<wbr/> Other control entries are still active.<wbr/>
3955This setting can only be used if availableSceneModes !=
3956UNSUPPORTED</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3957 </li>
3958 </ul>
3959
3960 </td> <!-- entry_type -->
3961
3962 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3963 <p>Overall mode of 3A control
3964routines</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3965 </td>
3966
3967 <td class="entry_units">
3968 </td>
3969
3970 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]3971 <p>all must be supported</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3972 </td>
3973
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3974 <td class="entry_tags">
3975 <ul class="entry_tags">
3976 <li><a href="#tag_BC">BC</a></li>
3977 </ul>
3978 </td>
3979
3980 </tr>
3981 <tr class="entries_header">
3982 <th class="th_details" colspan="5">Details</th>
3983 </tr>
3984 <tr class="entry_cont">
3985 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3986 <p>High-level 3A control.<wbr/> When set to OFF,<wbr/> all 3A control
Zhijun Hef90eeaf2014-01-16 12:13:35 -0800[diff] [blame^]3987by the camera device is disabled.<wbr/> The application must set the fields for
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3988capture parameters itself.<wbr/></p>
3989<p>When set to AUTO,<wbr/> the individual algorithm controls in
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]3990android.<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]3991<p>When set to USE_<wbr/>SCENE_<wbr/>MODE,<wbr/> the individual controls in
Zhijun Hef90eeaf2014-01-16 12:13:35 -0800[diff] [blame^]3992android.<wbr/>control.<wbr/>* are mostly disabled,<wbr/> and the camera device implements
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3993one of the scene mode settings (such as ACTION,<wbr/> SUNSET,<wbr/> or PARTY)
Zhijun Hef90eeaf2014-01-16 12:13:35 -0800[diff] [blame^]3994as it wishes.<wbr/> The camera device scene mode 3A settings are provided by
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]3995<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]3996 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3997 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3998
3999
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4000 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
4001 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4002
4003
4004
4005 <!-- end of kind -->
4006 </tbody>
4007
4008 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4009 <tr><td colspan="6" id="section_demosaic" class="section">demosaic</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4010
4011
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4012 <tr><td colspan="6" class="kind">controls</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4013
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4014 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4015 <tr>
4016 <th class="th_name">Property Name</th>
4017 <th class="th_type">Type</th>
4018 <th class="th_description">Description</th>
4019 <th class="th_units">Units</th>
4020 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4021 <th class="th_tags">Tags</th>
4022 </tr>
4023 </thead>
4024
4025 <tbody>
4026
4027
4028
4029
4030
4031
4032
4033
4034
4035
4036 <tr class="entry" id="controls_android.demosaic.mode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4037 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4038 android.<wbr/>demosaic.<wbr/>mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4039 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4040 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4041 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4042
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4043 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4044
4045 <ul class="entry_type_enum">
4046 <li>
4047 <span class="entry_type_enum_name">FAST</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]4048 <span class="entry_type_enum_notes"><p>Minimal or no slowdown of frame rate compared to
4049Bayer RAW output</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4050 </li>
4051 <li>
4052 <span class="entry_type_enum_name">HIGH_QUALITY</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]4053 <span class="entry_type_enum_notes"><p>High-quality may reduce output frame
4054rate</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4055 </li>
4056 </ul>
4057
4058 </td> <!-- entry_type -->
4059
4060 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4061 <p>Controls the quality of the demosaicing
4062processing</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4063 </td>
4064
4065 <td class="entry_units">
4066 </td>
4067
4068 <td class="entry_range">
4069 </td>
4070
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4071 <td class="entry_tags">
4072 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]4073 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4074 </ul>
4075 </td>
4076
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4077 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4078
4079
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4080 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
4081 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4082
4083
4084
4085 <!-- end of kind -->
4086 </tbody>
4087
4088 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4089 <tr><td colspan="6" id="section_edge" class="section">edge</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4090
4091
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4092 <tr><td colspan="6" class="kind">controls</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4093
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4094 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4095 <tr>
4096 <th class="th_name">Property Name</th>
4097 <th class="th_type">Type</th>
4098 <th class="th_description">Description</th>
4099 <th class="th_units">Units</th>
4100 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4101 <th class="th_tags">Tags</th>
4102 </tr>
4103 </thead>
4104
4105 <tbody>
4106
4107
4108
4109
4110
4111
4112
4113
4114
4115
4116 <tr class="entry" id="controls_android.edge.mode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4117 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4118 android.<wbr/>edge.<wbr/>mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4119 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4120 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4121 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4122
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4123 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4124
4125 <ul class="entry_type_enum">
4126 <li>
4127 <span class="entry_type_enum_name">OFF</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]4128 <span class="entry_type_enum_notes"><p>No edge enhancement is applied</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4129 </li>
4130 <li>
4131 <span class="entry_type_enum_name">FAST</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]4132 <span class="entry_type_enum_notes"><p>Must not slow down frame rate relative to sensor
4133output</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4134 </li>
4135 <li>
4136 <span class="entry_type_enum_name">HIGH_QUALITY</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]4137 <span class="entry_type_enum_notes"><p>Frame rate may be reduced by high
4138quality</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4139 </li>
4140 </ul>
4141
4142 </td> <!-- entry_type -->
4143
4144 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4145 <p>Operation mode for edge
4146enhancement</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4147 </td>
4148
4149 <td class="entry_units">
4150 </td>
4151
4152 <td class="entry_range">
4153 </td>
4154
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4155 <td class="entry_tags">
4156 </td>
4157
4158 </tr>
4159 <tr class="entries_header">
4160 <th class="th_details" colspan="5">Details</th>
4161 </tr>
4162 <tr class="entry_cont">
4163 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4164 <p>Edge/<wbr/>sharpness/<wbr/>detail enhancement.<wbr/> OFF means no
4165enhancement will be applied by the HAL.<wbr/></p>
Zhijun Hef90eeaf2014-01-16 12:13:35 -0800[diff] [blame^]4166<p>FAST/<wbr/>HIGH_<wbr/>QUALITY both mean camera device determined enhancement
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4167will be applied.<wbr/> HIGH_<wbr/>QUALITY mode indicates that the
Zhijun Hef90eeaf2014-01-16 12:13:35 -0800[diff] [blame^]4168camera device will use the highest-quality enhancement algorithms,<wbr/>
4169even if it slows down capture rate.<wbr/> FAST means the camera device will
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4170not slow down capture rate when applying edge enhancement.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4171 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4172 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4173
4174
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4175 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
4176 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4177
4178
4179 <tr class="entry" id="controls_android.edge.strength">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4180 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4181 android.<wbr/>edge.<wbr/>strength
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4182 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4183 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4184 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4185
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4186 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4187
4188
4189 </td> <!-- entry_type -->
4190
4191 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4192 <p>Control the amount of edge enhancement
4193applied to the images</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4194 </td>
4195
4196 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4197 1-10; 10 is maximum sharpening
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4198 </td>
4199
4200 <td class="entry_range">
4201 </td>
4202
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4203 <td class="entry_tags">
4204 </td>
4205
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4206 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4207
4208
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4209 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
4210 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4211
4212
4213
4214 <!-- end of kind -->
4215 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4216 <tr><td colspan="6" class="kind">dynamic</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4217
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4218 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4219 <tr>
4220 <th class="th_name">Property Name</th>
4221 <th class="th_type">Type</th>
4222 <th class="th_description">Description</th>
4223 <th class="th_units">Units</th>
4224 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4225 <th class="th_tags">Tags</th>
4226 </tr>
4227 </thead>
4228
4229 <tbody>
4230
4231
4232
4233
4234
4235
4236
4237
4238
4239
4240 <tr class="entry" id="dynamic_android.edge.mode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4241 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4242 android.<wbr/>edge.<wbr/>mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4243 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4244 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4245 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4246
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4247 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4248
4249 <ul class="entry_type_enum">
4250 <li>
4251 <span class="entry_type_enum_name">OFF</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]4252 <span class="entry_type_enum_notes"><p>No edge enhancement is applied</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4253 </li>
4254 <li>
4255 <span class="entry_type_enum_name">FAST</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]4256 <span class="entry_type_enum_notes"><p>Must not slow down frame rate relative to sensor
4257output</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4258 </li>
4259 <li>
4260 <span class="entry_type_enum_name">HIGH_QUALITY</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]4261 <span class="entry_type_enum_notes"><p>Frame rate may be reduced by high
4262quality</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4263 </li>
4264 </ul>
4265
4266 </td> <!-- entry_type -->
4267
4268 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4269 <p>Operation mode for edge
4270enhancement</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4271 </td>
4272
4273 <td class="entry_units">
4274 </td>
4275
4276 <td class="entry_range">
4277 </td>
4278
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4279 <td class="entry_tags">
4280 </td>
4281
4282 </tr>
4283 <tr class="entries_header">
4284 <th class="th_details" colspan="5">Details</th>
4285 </tr>
4286 <tr class="entry_cont">
4287 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4288 <p>Edge/<wbr/>sharpness/<wbr/>detail enhancement.<wbr/> OFF means no
4289enhancement will be applied by the HAL.<wbr/></p>
Zhijun Hef90eeaf2014-01-16 12:13:35 -0800[diff] [blame^]4290<p>FAST/<wbr/>HIGH_<wbr/>QUALITY both mean camera device determined enhancement
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4291will be applied.<wbr/> HIGH_<wbr/>QUALITY mode indicates that the
Zhijun Hef90eeaf2014-01-16 12:13:35 -0800[diff] [blame^]4292camera device will use the highest-quality enhancement algorithms,<wbr/>
4293even if it slows down capture rate.<wbr/> FAST means the camera device will
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4294not slow down capture rate when applying edge enhancement.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4295 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4296 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4297
4298
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4299 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
4300 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4301
4302
4303
4304 <!-- end of kind -->
4305 </tbody>
4306
4307 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4308 <tr><td colspan="6" id="section_flash" class="section">flash</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4309
4310
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4311 <tr><td colspan="6" class="kind">controls</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4312
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4313 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4314 <tr>
4315 <th class="th_name">Property Name</th>
4316 <th class="th_type">Type</th>
4317 <th class="th_description">Description</th>
4318 <th class="th_units">Units</th>
4319 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4320 <th class="th_tags">Tags</th>
4321 </tr>
4322 </thead>
4323
4324 <tbody>
4325
4326
4327
4328
4329
4330
4331
4332
4333
4334
4335 <tr class="entry" id="controls_android.flash.firingPower">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4336 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4337 android.<wbr/>flash.<wbr/>firing<wbr/>Power
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4338 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4339 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4340 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4341
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4342 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4343
4344
4345 </td> <!-- entry_type -->
4346
4347 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4348 <p>Power for flash firing/<wbr/>torch</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4349 </td>
4350
4351 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4352 10 is max power; 0 is no flash.<wbr/> Linear
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4353 </td>
4354
4355 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]4356 <p>0 - 10</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4357 </td>
4358
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4359 <td class="entry_tags">
4360 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]4361 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4362 </ul>
4363 </td>
4364
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4365 </tr>
4366 <tr class="entries_header">
4367 <th class="th_details" colspan="5">Details</th>
4368 </tr>
4369 <tr class="entry_cont">
4370 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4371 <p>Power for snapshot may use a different scale than
4372for torch mode.<wbr/> Only one entry for torch mode will be
4373used</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4374 </td>
4375 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4376
4377
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4378 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
4379 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4380
4381
4382 <tr class="entry" id="controls_android.flash.firingTime">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4383 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4384 android.<wbr/>flash.<wbr/>firing<wbr/>Time
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4385 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4386 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4387 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4388
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4389 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4390
4391
4392 </td> <!-- entry_type -->
4393
4394 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4395 <p>Firing time of flash relative to start of
4396exposure</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4397 </td>
4398
4399 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4400 nanoseconds
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4401 </td>
4402
4403 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]4404 <p>0-(exposure time-flash duration)</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4405 </td>
4406
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4407 <td class="entry_tags">
4408 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]4409 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4410 </ul>
4411 </td>
4412
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4413 </tr>
4414 <tr class="entries_header">
4415 <th class="th_details" colspan="5">Details</th>
4416 </tr>
4417 <tr class="entry_cont">
4418 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4419 <p>Clamped to (0,<wbr/> exposure time - flash
4420duration).<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4421 </td>
4422 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4423
4424
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4425 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
4426 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4427
4428
4429 <tr class="entry" id="controls_android.flash.mode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4430 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4431 android.<wbr/>flash.<wbr/>mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4432 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4433 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4434 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4435
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4436 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4437
4438 <ul class="entry_type_enum">
4439 <li>
4440 <span class="entry_type_enum_name">OFF</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]4441 <span class="entry_type_enum_notes"><p>Do not fire the flash for this
4442capture</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4443 </li>
4444 <li>
4445 <span class="entry_type_enum_name">SINGLE</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]4446 <span class="entry_type_enum_notes"><p>if android.<wbr/>flash.<wbr/>available is true Fire flash
4447for this capture based on firingPower,<wbr/>
4448firingTime.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4449 </li>
4450 <li>
4451 <span class="entry_type_enum_name">TORCH</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]4452 <span class="entry_type_enum_notes"><p>if android.<wbr/>flash.<wbr/>available is true Flash
4453continuously on,<wbr/> power set by
4454firingPower</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4455 </li>
4456 </ul>
4457
4458 </td> <!-- entry_type -->
4459
4460 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4461 <p>Select flash operation mode</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4462 </td>
4463
4464 <td class="entry_units">
4465 </td>
4466
4467 <td class="entry_range">
4468 </td>
4469
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4470 <td class="entry_tags">
4471 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]4472 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4473 </ul>
4474 </td>
4475
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4476 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4477
4478
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4479 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
4480 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4481
4482
4483
4484 <!-- end of kind -->
4485 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4486 <tr><td colspan="6" class="kind">static</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4487
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4488 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4489 <tr>
4490 <th class="th_name">Property Name</th>
4491 <th class="th_type">Type</th>
4492 <th class="th_description">Description</th>
4493 <th class="th_units">Units</th>
4494 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4495 <th class="th_tags">Tags</th>
4496 </tr>
4497 </thead>
4498
4499 <tbody>
4500
4501
4502
4503
4504
4505
4506
4507
4508
4509
4510
4511
4512 <tr class="entry" id="static_android.flash.info.available">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4513 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4514 android.<wbr/>flash.<wbr/>info.<wbr/>available
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4515 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4516 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4517 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4518
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4519 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4520
4521
4522 </td> <!-- entry_type -->
4523
4524 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4525 <p>Whether this camera has a
4526flash</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4527 </td>
4528
4529 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4530 boolean (0 = false,<wbr/> otherwise true)
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4531 </td>
4532
4533 <td class="entry_range">
4534 </td>
4535
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4536 <td class="entry_tags">
4537 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]4538 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4539 </ul>
4540 </td>
4541
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4542 </tr>
4543 <tr class="entries_header">
4544 <th class="th_details" colspan="5">Details</th>
4545 </tr>
4546 <tr class="entry_cont">
4547 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4548 <p>If no flash,<wbr/> none of the flash controls do
4549anything.<wbr/> All other metadata should return 0</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4550 </td>
4551 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4552
4553
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4554 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
4555 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4556
4557
4558 <tr class="entry" id="static_android.flash.info.chargeDuration">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4559 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4560 android.<wbr/>flash.<wbr/>info.<wbr/>charge<wbr/>Duration
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4561 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4562 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4563 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4564
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4565 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4566
4567
4568 </td> <!-- entry_type -->
4569
4570 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4571 <p>Time taken before flash can fire
4572again</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4573 </td>
4574
4575 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4576 nanoseconds
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4577 </td>
4578
4579 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]4580 <p>0-1e9</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4581 </td>
4582
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4583 <td class="entry_tags">
4584 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]4585 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4586 </ul>
4587 </td>
4588
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4589 </tr>
4590 <tr class="entries_header">
4591 <th class="th_details" colspan="5">Details</th>
4592 </tr>
4593 <tr class="entry_cont">
4594 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4595 <p>1 second too long/<wbr/>too short for recharge? Should
4596this be power-dependent?</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4597 </td>
4598 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4599
4600
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4601 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
4602 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4603
4604
4605
4606
4607
4608 <tr class="entry" id="static_android.flash.colorTemperature">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4609 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4610 android.<wbr/>flash.<wbr/>color<wbr/>Temperature
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4611 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4612 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4613 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4614
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4615 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4616
4617
4618 </td> <!-- entry_type -->
4619
4620 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4621 <p>The x,<wbr/>y whitepoint of the
4622flash</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4623 </td>
4624
4625 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4626 pair of floats
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4627 </td>
4628
4629 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]4630 <p>0-1 for both</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4631 </td>
4632
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4633 <td class="entry_tags">
4634 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]4635 <li><a href="#tag_ADV">ADV</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4636 </ul>
4637 </td>
4638
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4639 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4640
4641
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4642 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
4643 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4644
4645
4646 <tr class="entry" id="static_android.flash.maxEnergy">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4647 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4648 android.<wbr/>flash.<wbr/>max<wbr/>Energy
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4649 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4650 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4651 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4652
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4653 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4654
4655
4656 </td> <!-- entry_type -->
4657
4658 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4659 <p>Max energy output of the flash for a full
4660power single flash</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4661 </td>
4662
4663 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4664 lumen-seconds
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4665 </td>
4666
4667 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame]4668 <p>&gt;= 0</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4669 </td>
4670
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4671 <td class="entry_tags">
4672 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]4673 <li><a href="#tag_ADV">ADV</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4674 </ul>
4675 </td>
4676
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4677 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4678
4679
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4680 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
4681 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4682
4683
4684
4685 <!-- end of kind -->
4686 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4687 <tr><td colspan="6" class="kind">dynamic</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4688
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4689 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4690 <tr>
4691 <th class="th_name">Property Name</th>
4692 <th class="th_type">Type</th>
4693 <th class="th_description">Description</th>
4694 <th class="th_units">Units</th>
4695 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4696 <th class="th_tags">Tags</th>
4697 </tr>
4698 </thead>
4699
4700 <tbody>
4701
4702
4703
4704
4705
4706
4707
4708
4709
4710
4711 <tr class="entry" id="dynamic_android.flash.firingPower">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4712 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4713 android.<wbr/>flash.<wbr/>firing<wbr/>Power
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4714 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4715 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4716 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4717
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4718 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4719
4720
4721 </td> <!-- entry_type -->
4722
4723 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4724 <p>Power for flash firing/<wbr/>torch</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4725 </td>
4726
4727 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4728 10 is max power; 0 is no flash.<wbr/> Linear
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4729 </td>
4730
4731 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]4732 <p>0 - 10</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4733 </td>
4734
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4735 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]4736 <ul class="entry_tags">
4737 <li><a href="#tag_V1">V1</a></li>
4738 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4739 </td>
4740
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4741 </tr>
4742 <tr class="entries_header">
4743 <th class="th_details" colspan="5">Details</th>
4744 </tr>
4745 <tr class="entry_cont">
4746 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4747 <p>Power for snapshot may use a different scale than
4748for torch mode.<wbr/> Only one entry for torch mode will be
4749used</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4750 </td>
4751 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4752
4753
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4754 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
4755 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4756
4757
4758 <tr class="entry" id="dynamic_android.flash.firingTime">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4759 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4760 android.<wbr/>flash.<wbr/>firing<wbr/>Time
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4761 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4762 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4763 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4764
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4765 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4766
4767
4768 </td> <!-- entry_type -->
4769
4770 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4771 <p>Firing time of flash relative to start of
4772exposure</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4773 </td>
4774
4775 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4776 nanoseconds
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4777 </td>
4778
4779 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]4780 <p>0-(exposure time-flash duration)</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4781 </td>
4782
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4783 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]4784 <ul class="entry_tags">
4785 <li><a href="#tag_V1">V1</a></li>
4786 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4787 </td>
4788
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4789 </tr>
4790 <tr class="entries_header">
4791 <th class="th_details" colspan="5">Details</th>
4792 </tr>
4793 <tr class="entry_cont">
4794 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4795 <p>Clamped to (0,<wbr/> exposure time - flash
4796duration).<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4797 </td>
4798 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4799
4800
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4801 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
4802 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4803
4804
4805 <tr class="entry" id="dynamic_android.flash.mode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4806 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4807 android.<wbr/>flash.<wbr/>mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4808 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4809 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4810 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4811
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4812 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4813
4814 <ul class="entry_type_enum">
4815 <li>
4816 <span class="entry_type_enum_name">OFF</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]4817 <span class="entry_type_enum_notes"><p>Do not fire the flash for this
4818capture</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4819 </li>
4820 <li>
4821 <span class="entry_type_enum_name">SINGLE</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]4822 <span class="entry_type_enum_notes"><p>if android.<wbr/>flash.<wbr/>available is true Fire flash
4823for this capture based on firingPower,<wbr/>
4824firingTime.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4825 </li>
4826 <li>
4827 <span class="entry_type_enum_name">TORCH</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]4828 <span class="entry_type_enum_notes"><p>if android.<wbr/>flash.<wbr/>available is true Flash
4829continuously on,<wbr/> power set by
4830firingPower</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4831 </li>
4832 </ul>
4833
4834 </td> <!-- entry_type -->
4835
4836 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4837 <p>Select flash operation mode</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4838 </td>
4839
4840 <td class="entry_units">
4841 </td>
4842
4843 <td class="entry_range">
4844 </td>
4845
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4846 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]4847 <ul class="entry_tags">
4848 <li><a href="#tag_BC">BC</a></li>
4849 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4850 </td>
4851
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4852 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4853
4854
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4855 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
4856 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4857
4858
4859 <tr class="entry" id="dynamic_android.flash.state">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4860 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4861 android.<wbr/>flash.<wbr/>state
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4862 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4863 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4864 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4865
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4866 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4867
4868 <ul class="entry_type_enum">
4869 <li>
4870 <span class="entry_type_enum_name">UNAVAILABLE</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]4871 <span class="entry_type_enum_notes"><p>No flash on camera</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4872 </li>
4873 <li>
4874 <span class="entry_type_enum_name">CHARGING</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]4875 <span class="entry_type_enum_notes"><p>if android.<wbr/>flash.<wbr/>available is true Flash is
4876charging and cannot be fired</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4877 </li>
4878 <li>
4879 <span class="entry_type_enum_name">READY</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]4880 <span class="entry_type_enum_notes"><p>if android.<wbr/>flash.<wbr/>available is true Flash is
4881ready to fire</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4882 </li>
4883 <li>
4884 <span class="entry_type_enum_name">FIRED</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]4885 <span class="entry_type_enum_notes"><p>if android.<wbr/>flash.<wbr/>available is true Flash fired
4886for this capture</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4887 </li>
4888 </ul>
4889
4890 </td> <!-- entry_type -->
4891
4892 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4893 <p>Current state of the flash
4894unit</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4895 </td>
4896
4897 <td class="entry_units">
4898 </td>
4899
4900 <td class="entry_range">
4901 </td>
4902
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4903 <td class="entry_tags">
4904 </td>
4905
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4906 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4907
4908
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4909 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
4910 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4911
4912
4913
4914 <!-- end of kind -->
4915 </tbody>
4916
4917 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4918 <tr><td colspan="6" id="section_geometric" class="section">geometric</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4919
4920
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4921 <tr><td colspan="6" class="kind">controls</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4922
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4923 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4924 <tr>
4925 <th class="th_name">Property Name</th>
4926 <th class="th_type">Type</th>
4927 <th class="th_description">Description</th>
4928 <th class="th_units">Units</th>
4929 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4930 <th class="th_tags">Tags</th>
4931 </tr>
4932 </thead>
4933
4934 <tbody>
4935
4936
4937
4938
4939
4940
4941
4942
4943
4944
4945 <tr class="entry" id="controls_android.geometric.mode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4946 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4947 android.<wbr/>geometric.<wbr/>mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4948 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4949 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4950 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4951
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4952 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4953
4954 <ul class="entry_type_enum">
4955 <li>
4956 <span class="entry_type_enum_name">OFF</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]4957 <span class="entry_type_enum_notes"><p>No geometric correction is
4958applied</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4959 </li>
4960 <li>
4961 <span class="entry_type_enum_name">FAST</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]4962 <span class="entry_type_enum_notes"><p>Must not slow down frame rate relative to raw
4963bayer output</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4964 </li>
4965 <li>
4966 <span class="entry_type_enum_name">HIGH_QUALITY</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]4967 <span class="entry_type_enum_notes"><p>Frame rate may be reduced by high
4968quality</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4969 </li>
4970 </ul>
4971
4972 </td> <!-- entry_type -->
4973
4974 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4975 <p>Operating mode of geometric
4976correction</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4977 </td>
4978
4979 <td class="entry_units">
4980 </td>
4981
4982 <td class="entry_range">
4983 </td>
4984
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4985 <td class="entry_tags">
4986 </td>
4987
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]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.geometric.strength">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4996 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4997 android.<wbr/>geometric.<wbr/>strength
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">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"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5003
5004
5005 </td> <!-- entry_type -->
5006
5007 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5008 <p>Control the amount of shading correction
5009applied to the images</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5010 </td>
5011
5012 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5013 unitless: 1-10; 10 is full shading
5014 compensation
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5015 </td>
5016
5017 <td class="entry_range">
5018 </td>
5019
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5020 <td class="entry_tags">
5021 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5022 <li><a href="#tag_ADV">ADV</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5023 </ul>
5024 </td>
5025
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5026 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5027
5028
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5029 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5030 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5031
5032
5033
5034 <!-- end of kind -->
5035 </tbody>
5036
5037 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5038 <tr><td colspan="6" id="section_hotPixel" class="section">hotPixel</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5039
5040
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5041 <tr><td colspan="6" class="kind">controls</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5042
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5043 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5044 <tr>
5045 <th class="th_name">Property Name</th>
5046 <th class="th_type">Type</th>
5047 <th class="th_description">Description</th>
5048 <th class="th_units">Units</th>
5049 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5050 <th class="th_tags">Tags</th>
5051 </tr>
5052 </thead>
5053
5054 <tbody>
5055
5056
5057
5058
5059
5060
5061
5062
5063
5064
5065 <tr class="entry" id="controls_android.hotPixel.mode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5066 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5067 android.<wbr/>hot<wbr/>Pixel.<wbr/>mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5068 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5069 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5070 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5071
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5072 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5073
5074 <ul class="entry_type_enum">
5075 <li>
5076 <span class="entry_type_enum_name">OFF</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]5077 <span class="entry_type_enum_notes"><p>No hot pixel correction can be
5078applied</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5079 </li>
5080 <li>
5081 <span class="entry_type_enum_name">FAST</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]5082 <span class="entry_type_enum_notes"><p>Frame rate must not be reduced compared to raw
5083Bayer output</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5084 </li>
5085 <li>
5086 <span class="entry_type_enum_name">HIGH_QUALITY</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]5087 <span class="entry_type_enum_notes"><p>Frame rate may be reduced by high
5088quality</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5089 </li>
5090 </ul>
5091
5092 </td> <!-- entry_type -->
5093
5094 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5095 <p>Set operational mode for hot pixel
5096correction</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5097 </td>
5098
5099 <td class="entry_units">
5100 </td>
5101
5102 <td class="entry_range">
5103 </td>
5104
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5105 <td class="entry_tags">
5106 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5107 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5108 </ul>
5109 </td>
5110
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5111 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5112
5113
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5114 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5115 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5116
5117
5118
5119 <!-- end of kind -->
5120 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5121 <tr><td colspan="6" class="kind">static</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5122
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5123 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5124 <tr>
5125 <th class="th_name">Property Name</th>
5126 <th class="th_type">Type</th>
5127 <th class="th_description">Description</th>
5128 <th class="th_units">Units</th>
5129 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5130 <th class="th_tags">Tags</th>
5131 </tr>
5132 </thead>
5133
5134 <tbody>
5135
5136
5137
5138
5139
5140
5141
5142
5143
5144
5145
5146
5147 <tr class="entry" id="static_android.hotPixel.info.map">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5148 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5149 android.<wbr/>hot<wbr/>Pixel.<wbr/>info.<wbr/>map
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5150 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5151 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5152 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5153 <span class="entry_type_container">x</span>
5154
5155 <span class="entry_type_array">
5156 2 x n
5157 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5158 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5159 <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]5160
5161
5162 </td> <!-- entry_type -->
5163
5164 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5165 <p>Location of hot/<wbr/>defective pixels on
5166sensor</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5167 </td>
5168
5169 <td class="entry_units">
5170 </td>
5171
5172 <td class="entry_range">
5173 </td>
5174
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5175 <td class="entry_tags">
5176 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5177 <li><a href="#tag_ADV">ADV</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5178 </ul>
5179 </td>
5180
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5181 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5182
5183
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5184 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5185 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5186
5187
5188
5189
5190
5191
5192 <!-- end of kind -->
5193 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5194 <tr><td colspan="6" class="kind">dynamic</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5195
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5196 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5197 <tr>
5198 <th class="th_name">Property Name</th>
5199 <th class="th_type">Type</th>
5200 <th class="th_description">Description</th>
5201 <th class="th_units">Units</th>
5202 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5203 <th class="th_tags">Tags</th>
5204 </tr>
5205 </thead>
5206
5207 <tbody>
5208
5209
5210
5211
5212
5213
5214
5215
5216
5217
5218 <tr class="entry" id="dynamic_android.hotPixel.mode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5219 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5220 android.<wbr/>hot<wbr/>Pixel.<wbr/>mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5221 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5222 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5223 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5224
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5225 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5226
5227 <ul class="entry_type_enum">
5228 <li>
5229 <span class="entry_type_enum_name">OFF</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]5230 <span class="entry_type_enum_notes"><p>No hot pixel correction can be
5231applied</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5232 </li>
5233 <li>
5234 <span class="entry_type_enum_name">FAST</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]5235 <span class="entry_type_enum_notes"><p>Frame rate must not be reduced compared to raw
5236Bayer output</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5237 </li>
5238 <li>
5239 <span class="entry_type_enum_name">HIGH_QUALITY</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]5240 <span class="entry_type_enum_notes"><p>Frame rate may be reduced by high
5241quality</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5242 </li>
5243 </ul>
5244
5245 </td> <!-- entry_type -->
5246
5247 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5248 <p>Set operational mode for hot pixel
5249correction</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5250 </td>
5251
5252 <td class="entry_units">
5253 </td>
5254
5255 <td class="entry_range">
5256 </td>
5257
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5258 <td class="entry_tags">
5259 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5260 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5261 </ul>
5262 </td>
5263
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5264 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5265
5266
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5267 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5268 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5269
5270
5271
5272 <!-- end of kind -->
5273 </tbody>
5274
5275 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5276 <tr><td colspan="6" id="section_jpeg" class="section">jpeg</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5277
5278
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5279 <tr><td colspan="6" class="kind">controls</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5280
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5281 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5282 <tr>
5283 <th class="th_name">Property Name</th>
5284 <th class="th_type">Type</th>
5285 <th class="th_description">Description</th>
5286 <th class="th_units">Units</th>
5287 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5288 <th class="th_tags">Tags</th>
5289 </tr>
5290 </thead>
5291
5292 <tbody>
5293
5294
5295
5296
5297
5298
5299
5300
5301
5302
5303 <tr class="entry" id="controls_android.jpeg.gpsCoordinates">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5304 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5305 android.<wbr/>jpeg.<wbr/>gps<wbr/>Coordinates
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5306 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5307 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5308 <span class="entry_type_name">double</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5309 <span class="entry_type_container">x</span>
5310
5311 <span class="entry_type_array">
5312 3
5313 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5314 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5315 <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]5316
5317
5318 </td> <!-- entry_type -->
5319
5320 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5321 <p>GPS coordinates to include in output JPEG
5322EXIF</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5323 </td>
5324
5325 <td class="entry_units">
5326 </td>
5327
5328 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]5329 <p>(-180 - 180],<wbr/> [-90,<wbr/>90],<wbr/> [-inf,<wbr/> inf]</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5330 </td>
5331
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5332 <td class="entry_tags">
5333 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5334 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5335 </ul>
5336 </td>
5337
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5338 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5339
5340
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5341 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5342 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5343
5344
5345 <tr class="entry" id="controls_android.jpeg.gpsProcessingMethod">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5346 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5347 android.<wbr/>jpeg.<wbr/>gps<wbr/>Processing<wbr/>Method
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5348 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5349 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5350 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5351
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]5352 <span class="entry_type_visibility"> [public as string]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5353
5354
5355 </td> <!-- entry_type -->
5356
5357 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5358 <p>32 characters describing GPS algorithm to
5359include in EXIF</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5360 </td>
5361
5362 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5363 UTF-8 null-terminated string
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5364 </td>
5365
5366 <td class="entry_range">
5367 </td>
5368
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5369 <td class="entry_tags">
5370 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5371 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5372 </ul>
5373 </td>
5374
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5375 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5376
5377
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5378 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5379 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5380
5381
5382 <tr class="entry" id="controls_android.jpeg.gpsTimestamp">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5383 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5384 android.<wbr/>jpeg.<wbr/>gps<wbr/>Timestamp
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5385 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5386 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5387 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5388
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5389 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5390
5391
5392 </td> <!-- entry_type -->
5393
5394 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5395 <p>Time GPS fix was made to include in
5396EXIF</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5397 </td>
5398
5399 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5400 UTC in seconds since January 1,<wbr/> 1970
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5401 </td>
5402
5403 <td class="entry_range">
5404 </td>
5405
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5406 <td class="entry_tags">
5407 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5408 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5409 </ul>
5410 </td>
5411
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5412 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5413
5414
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5415 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5416 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5417
5418
5419 <tr class="entry" id="controls_android.jpeg.orientation">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5420 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5421 android.<wbr/>jpeg.<wbr/>orientation
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5422 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5423 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5424 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5425
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5426 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5427
5428
5429 </td> <!-- entry_type -->
5430
5431 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5432 <p>Orientation of JPEG image to
5433write</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5434 </td>
5435
5436 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5437 Degrees in multiples of 90
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5438 </td>
5439
5440 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]5441 <p>0,<wbr/> 90,<wbr/> 180,<wbr/> 270</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5442 </td>
5443
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5444 <td class="entry_tags">
5445 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5446 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5447 </ul>
5448 </td>
5449
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]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="controls_android.jpeg.quality">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5458 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5459 android.<wbr/>jpeg.<wbr/>quality
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">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
5467 </td> <!-- entry_type -->
5468
5469 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5470 <p>Compression quality of the final JPEG
5471image</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5472 </td>
5473
5474 <td class="entry_units">
5475 </td>
5476
5477 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]5478 <p>1-100; larger is higher quality</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5479 </td>
5480
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5481 <td class="entry_tags">
5482 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5483 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5484 </ul>
5485 </td>
5486
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5487 </tr>
5488 <tr class="entries_header">
5489 <th class="th_details" colspan="5">Details</th>
5490 </tr>
5491 <tr class="entry_cont">
5492 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5493 <p>85-95 is typical usage range</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5494 </td>
5495 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5496
5497
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5498 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5499 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5500
5501
5502 <tr class="entry" id="controls_android.jpeg.thumbnailQuality">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5503 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5504 android.<wbr/>jpeg.<wbr/>thumbnail<wbr/>Quality
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5505 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5506 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5507 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5508
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5509 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5510
5511
5512 </td> <!-- entry_type -->
5513
5514 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5515 <p>Compression quality of JPEG
5516thumbnail</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5517 </td>
5518
5519 <td class="entry_units">
5520 </td>
5521
5522 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]5523 <p>1-100; larger is higher quality</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5524 </td>
5525
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5526 <td class="entry_tags">
5527 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5528 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5529 </ul>
5530 </td>
5531
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5532 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5533
5534
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5535 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5536 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5537
5538
5539 <tr class="entry" id="controls_android.jpeg.thumbnailSize">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5540 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5541 android.<wbr/>jpeg.<wbr/>thumbnail<wbr/>Size
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5542 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5543 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5544 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5545 <span class="entry_type_container">x</span>
5546
5547 <span class="entry_type_array">
5548 2
5549 </span>
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]5550 <span class="entry_type_visibility"> [public as size]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5551
5552
5553 </td> <!-- entry_type -->
5554
5555 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5556 <p>Resolution of embedded JPEG thumbnail</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5557 </td>
5558
5559 <td class="entry_units">
5560 </td>
5561
5562 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]5563 <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]5564 </td>
5565
5566 <td class="entry_tags">
5567 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5568 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5569 </ul>
5570 </td>
5571
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5572 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5573 <tr class="entries_header">
5574 <th class="th_details" colspan="5">Details</th>
5575 </tr>
5576 <tr class="entry_cont">
5577 <td class="entry_details" colspan="5">
Zhijun Hef90eeaf2014-01-16 12:13:35 -0800[diff] [blame^]5578 <p>When set to (0,<wbr/> 0) value,<wbr/> the JPEG EXIF will not contain thumbnail,<wbr/>
5579but the captured JPEG will still be a valid image.<wbr/></p>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5580<p>When a jpeg image capture is issued,<wbr/> the thumbnail size selected should have
5581the same aspect ratio as the jpeg image.<wbr/></p>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5582 </td>
5583 </tr>
5584
5585
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5586 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5587 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5588
5589
5590
5591 <!-- end of kind -->
5592 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5593 <tr><td colspan="6" class="kind">static</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5594
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5595 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5596 <tr>
5597 <th class="th_name">Property Name</th>
5598 <th class="th_type">Type</th>
5599 <th class="th_description">Description</th>
5600 <th class="th_units">Units</th>
5601 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5602 <th class="th_tags">Tags</th>
5603 </tr>
5604 </thead>
5605
5606 <tbody>
5607
5608
5609
5610
5611
5612
5613
5614
5615
5616
5617 <tr class="entry" id="static_android.jpeg.availableThumbnailSizes">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5618 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5619 android.<wbr/>jpeg.<wbr/>available<wbr/>Thumbnail<wbr/>Sizes
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5620 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5621 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5622 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5623 <span class="entry_type_container">x</span>
5624
5625 <span class="entry_type_array">
5626 2 x n
5627 </span>
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]5628 <span class="entry_type_visibility"> [public as size]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5629
5630
5631 </td> <!-- entry_type -->
5632
5633 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5634 <p>Supported resolutions for the JPEG thumbnail</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5635 </td>
5636
5637 <td class="entry_units">
5638 </td>
5639
5640 <td class="entry_range">
Zhijun Hef90eeaf2014-01-16 12:13:35 -0800[diff] [blame^]5641 <p>Will include at least one valid resolution,<wbr/> plus
5642(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]5643 </td>
5644
5645 <td class="entry_tags">
5646 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5647 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5648 </ul>
5649 </td>
5650
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5651 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5652 <tr class="entries_header">
5653 <th class="th_details" colspan="5">Details</th>
5654 </tr>
5655 <tr class="entry_cont">
5656 <td class="entry_details" colspan="5">
Zhijun Hef90eeaf2014-01-16 12:13:35 -0800[diff] [blame^]5657 <p>Below condiditions will be satisfied for this size list:</p>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5658<ul>
Zhijun Hef90eeaf2014-01-16 12:13:35 -0800[diff] [blame^]5659<li>The sizes will be sorted by increasing pixel area (width x height).<wbr/>
5660If several resolutions have the same area,<wbr/> they will be sorted by increasing width.<wbr/></li>
5661<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]5662aspect 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]5663The largest size is defined as the size that has the largest pixel area
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5664in a given size list.<wbr/></li>
Zhijun Hef90eeaf2014-01-16 12:13:35 -0800[diff] [blame^]5665<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]5666one corresponding size that has the same aspect ratio in availableThumbnailSizes,<wbr/>
5667and vice versa.<wbr/></li>
Zhijun Hef90eeaf2014-01-16 12:13:35 -0800[diff] [blame^]5668<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]5669</ul>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5670 </td>
5671 </tr>
5672
5673
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5674 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5675 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5676
5677
5678 <tr class="entry" id="static_android.jpeg.maxSize">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5679 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5680 android.<wbr/>jpeg.<wbr/>max<wbr/>Size
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5681 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5682 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5683 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5684
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5685 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5686
5687
5688 </td> <!-- entry_type -->
5689
5690 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5691 <p>Maximum size in bytes for the compressed
5692JPEG buffer</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5693 </td>
5694
5695 <td class="entry_units">
5696 </td>
5697
5698 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]5699 <p>Must be large enough to fit any JPEG produced by
5700the camera</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5701 </td>
5702
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5703 <td class="entry_tags">
5704 </td>
5705
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5706 </tr>
5707 <tr class="entries_header">
5708 <th class="th_details" colspan="5">Details</th>
5709 </tr>
5710 <tr class="entry_cont">
5711 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5712 <p>This is used for sizing the gralloc buffers for
5713JPEG</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5714 </td>
5715 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5716
5717
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5718 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5719 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5720
5721
5722
5723 <!-- end of kind -->
5724 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5725 <tr><td colspan="6" class="kind">dynamic</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5726
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5727 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5728 <tr>
5729 <th class="th_name">Property Name</th>
5730 <th class="th_type">Type</th>
5731 <th class="th_description">Description</th>
5732 <th class="th_units">Units</th>
5733 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5734 <th class="th_tags">Tags</th>
5735 </tr>
5736 </thead>
5737
5738 <tbody>
5739
5740
5741
5742
5743
5744
5745
5746
5747
5748
5749 <tr class="entry" id="dynamic_android.jpeg.gpsCoordinates">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5750 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5751 android.<wbr/>jpeg.<wbr/>gps<wbr/>Coordinates
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5752 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5753 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5754 <span class="entry_type_name">double</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5755 <span class="entry_type_container">x</span>
5756
5757 <span class="entry_type_array">
5758 3
5759 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5760 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5761 <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]5762
5763
5764 </td> <!-- entry_type -->
5765
5766 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5767 <p>GPS coordinates to include in output JPEG
5768EXIF</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5769 </td>
5770
5771 <td class="entry_units">
5772 </td>
5773
5774 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]5775 <p>(-180 - 180],<wbr/> [-90,<wbr/>90],<wbr/> [-inf,<wbr/> inf]</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5776 </td>
5777
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5778 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5779 <ul class="entry_tags">
5780 <li><a href="#tag_BC">BC</a></li>
5781 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5782 </td>
5783
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5784 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5785
5786
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5787 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5788 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5789
5790
5791 <tr class="entry" id="dynamic_android.jpeg.gpsProcessingMethod">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5792 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5793 android.<wbr/>jpeg.<wbr/>gps<wbr/>Processing<wbr/>Method
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5794 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5795 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5796 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5797
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]5798 <span class="entry_type_visibility"> [public as string]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5799
5800
5801 </td> <!-- entry_type -->
5802
5803 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5804 <p>32 characters describing GPS algorithm to
5805include in EXIF</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5806 </td>
5807
5808 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5809 UTF-8 null-terminated string
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5810 </td>
5811
5812 <td class="entry_range">
5813 </td>
5814
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5815 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5816 <ul class="entry_tags">
5817 <li><a href="#tag_BC">BC</a></li>
5818 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5819 </td>
5820
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5821 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5822
5823
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5824 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5825 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5826
5827
5828 <tr class="entry" id="dynamic_android.jpeg.gpsTimestamp">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5829 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5830 android.<wbr/>jpeg.<wbr/>gps<wbr/>Timestamp
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5831 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5832 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5833 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5834
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5835 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5836
5837
5838 </td> <!-- entry_type -->
5839
5840 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5841 <p>Time GPS fix was made to include in
5842EXIF</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5843 </td>
5844
5845 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5846 UTC in seconds since January 1,<wbr/> 1970
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5847 </td>
5848
5849 <td class="entry_range">
5850 </td>
5851
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5852 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5853 <ul class="entry_tags">
5854 <li><a href="#tag_BC">BC</a></li>
5855 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5856 </td>
5857
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5858 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5859
5860
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5861 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5862 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5863
5864
5865 <tr class="entry" id="dynamic_android.jpeg.orientation">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5866 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5867 android.<wbr/>jpeg.<wbr/>orientation
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5868 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5869 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5870 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5871
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5872 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5873
5874
5875 </td> <!-- entry_type -->
5876
5877 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5878 <p>Orientation of JPEG image to
5879write</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5880 </td>
5881
5882 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5883 Degrees in multiples of 90
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5884 </td>
5885
5886 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]5887 <p>0,<wbr/> 90,<wbr/> 180,<wbr/> 270</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5888 </td>
5889
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5890 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5891 <ul class="entry_tags">
5892 <li><a href="#tag_BC">BC</a></li>
5893 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5894 </td>
5895
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5896 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5897
5898
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5899 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5900 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5901
5902
5903 <tr class="entry" id="dynamic_android.jpeg.quality">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5904 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5905 android.<wbr/>jpeg.<wbr/>quality
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5906 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5907 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5908 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5909
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5910 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5911
5912
5913 </td> <!-- entry_type -->
5914
5915 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5916 <p>Compression quality of the final JPEG
5917image</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5918 </td>
5919
5920 <td class="entry_units">
5921 </td>
5922
5923 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]5924 <p>1-100; larger is higher quality</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5925 </td>
5926
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5927 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5928 <ul class="entry_tags">
5929 <li><a href="#tag_BC">BC</a></li>
5930 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5931 </td>
5932
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5933 </tr>
5934 <tr class="entries_header">
5935 <th class="th_details" colspan="5">Details</th>
5936 </tr>
5937 <tr class="entry_cont">
5938 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5939 <p>85-95 is typical usage range</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5940 </td>
5941 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5942
5943
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5944 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5945 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5946
5947
5948 <tr class="entry" id="dynamic_android.jpeg.size">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5949 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5950 android.<wbr/>jpeg.<wbr/>size
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5951 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5952 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5953 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5954
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5955 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5956
5957
5958 </td> <!-- entry_type -->
5959
5960 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5961 <p>The size of the compressed JPEG image,<wbr/> in
5962bytes</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5963 </td>
5964
5965 <td class="entry_units">
5966 </td>
5967
5968 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame]5969 <p>&gt;= 0</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5970 </td>
5971
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5972 <td class="entry_tags">
5973 </td>
5974
5975 </tr>
5976 <tr class="entries_header">
5977 <th class="th_details" colspan="5">Details</th>
5978 </tr>
5979 <tr class="entry_cont">
5980 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5981 <p>If no JPEG output is produced for the request,<wbr/>
5982this must be 0.<wbr/></p>
5983<p>Otherwise,<wbr/> this describes the real size of the compressed
5984JPEG image placed in the output stream.<wbr/> More specifically,<wbr/>
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]5985if <a href="#static_android.jpeg.maxSize">android.<wbr/>jpeg.<wbr/>max<wbr/>Size</a> = 1000000,<wbr/> and a specific capture
5986has <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]5987the JPEG stream will be 1000000 bytes,<wbr/> of which the first
5988500000 make up the real data.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5989 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5990 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5991
5992
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5993 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5994 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5995
5996
5997 <tr class="entry" id="dynamic_android.jpeg.thumbnailQuality">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5998 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5999 android.<wbr/>jpeg.<wbr/>thumbnail<wbr/>Quality
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6000 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6001 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6002 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6003
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6004 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6005
6006
6007 </td> <!-- entry_type -->
6008
6009 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6010 <p>Compression quality of JPEG
6011thumbnail</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6012 </td>
6013
6014 <td class="entry_units">
6015 </td>
6016
6017 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]6018 <p>1-100; larger is higher quality</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6019 </td>
6020
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6021 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6022 <ul class="entry_tags">
6023 <li><a href="#tag_BC">BC</a></li>
6024 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6025 </td>
6026
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6027 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6028
6029
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6030 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6031 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6032
6033
6034 <tr class="entry" id="dynamic_android.jpeg.thumbnailSize">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6035 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6036 android.<wbr/>jpeg.<wbr/>thumbnail<wbr/>Size
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6037 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6038 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6039 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6040 <span class="entry_type_container">x</span>
6041
6042 <span class="entry_type_array">
6043 2
6044 </span>
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]6045 <span class="entry_type_visibility"> [public as size]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6046
6047
6048 </td> <!-- entry_type -->
6049
6050 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6051 <p>Resolution of embedded JPEG thumbnail</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6052 </td>
6053
6054 <td class="entry_units">
6055 </td>
6056
6057 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]6058 <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]6059 </td>
6060
6061 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6062 <ul class="entry_tags">
6063 <li><a href="#tag_BC">BC</a></li>
6064 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6065 </td>
6066
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6067 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6068 <tr class="entries_header">
6069 <th class="th_details" colspan="5">Details</th>
6070 </tr>
6071 <tr class="entry_cont">
6072 <td class="entry_details" colspan="5">
Zhijun Hef90eeaf2014-01-16 12:13:35 -0800[diff] [blame^]6073 <p>When set to (0,<wbr/> 0) value,<wbr/> the JPEG EXIF will not contain thumbnail,<wbr/>
6074but the captured JPEG will still be a valid image.<wbr/></p>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6075<p>When a jpeg image capture is issued,<wbr/> the thumbnail size selected should have
6076the same aspect ratio as the jpeg image.<wbr/></p>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6077 </td>
6078 </tr>
6079
6080
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6081 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6082 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6083
6084
6085
6086 <!-- end of kind -->
6087 </tbody>
6088
6089 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6090 <tr><td colspan="6" id="section_lens" class="section">lens</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6091
6092
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6093 <tr><td colspan="6" class="kind">controls</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6094
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6095 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6096 <tr>
6097 <th class="th_name">Property Name</th>
6098 <th class="th_type">Type</th>
6099 <th class="th_description">Description</th>
6100 <th class="th_units">Units</th>
6101 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6102 <th class="th_tags">Tags</th>
6103 </tr>
6104 </thead>
6105
6106 <tbody>
6107
6108
6109
6110
6111
6112
6113
6114
6115
6116
6117 <tr class="entry" id="controls_android.lens.aperture">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6118 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6119 android.<wbr/>lens.<wbr/>aperture
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6120 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6121 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6122 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6123
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6124 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6125
6126
6127 </td> <!-- entry_type -->
6128
6129 <td class="entry_description">
Zhijun He1b58d382014-01-10 10:22:53 -0800[diff] [blame]6130 <p>The ratio of lens focal length to the effective
6131aperture diameter.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6132 </td>
6133
6134 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6135 f-number (f/<wbr/>NNN)
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6136 </td>
6137
6138 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]6139 <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]6140 </td>
6141
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6142 <td class="entry_tags">
6143 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6144 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6145 </ul>
6146 </td>
6147
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6148 </tr>
6149 <tr class="entries_header">
6150 <th class="th_details" colspan="5">Details</th>
6151 </tr>
6152 <tr class="entry_cont">
6153 <td class="entry_details" colspan="5">
Zhijun He1b58d382014-01-10 10:22:53 -0800[diff] [blame]6154 <p>This will only be supported on the camera devices that
6155have variable aperture lens.<wbr/> The aperture value can only be
6156one of the values listed in <a href="#static_android.lens.info.availableApertures">android.<wbr/>lens.<wbr/>info.<wbr/>available<wbr/>Apertures</a>.<wbr/></p>
6157<p>When this is supported and <a href="#controls_android.control.aeMode">android.<wbr/>control.<wbr/>ae<wbr/>Mode</a> is OFF,<wbr/>
6158this can be set along with <a href="#controls_android.sensor.exposureTime">android.<wbr/>sensor.<wbr/>exposure<wbr/>Time</a>,<wbr/>
6159<a href="#controls_android.sensor.sensitivity">android.<wbr/>sensor.<wbr/>sensitivity</a>,<wbr/> and android.<wbr/>sensor.<wbr/>frame<wbr/>Duration
6160to achieve manual exposure control.<wbr/></p>
6161<p>The requested aperture value may take several frames to reach the
6162requested value; the camera device will report the current (intermediate)
6163aperture size in capture result metadata while the aperture is changing.<wbr/></p>
6164<p>When this is supported and <a href="#controls_android.control.aeMode">android.<wbr/>control.<wbr/>ae<wbr/>Mode</a> is one of
6165the ON modes,<wbr/> this will be overridden by the camera device
6166auto-exposure algorithm,<wbr/> the overridden values are then provided
6167back to the user in the corresponding result.<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6168 </td>
6169 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6170
6171
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6172 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6173 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6174
6175
6176 <tr class="entry" id="controls_android.lens.filterDensity">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6177 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6178 android.<wbr/>lens.<wbr/>filter<wbr/>Density
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6179 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6180 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6181 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6182
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6183 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6184
6185
6186 </td> <!-- entry_type -->
6187
6188 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6189 <p>State of lens neutral density
6190filter(s)</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6191 </td>
6192
6193 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6194 number of stops of filtering
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6195 </td>
6196
6197 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]6198 <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]6199 </td>
6200
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6201 <td class="entry_tags">
6202 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6203 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6204 </ul>
6205 </td>
6206
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6207 </tr>
6208 <tr class="entries_header">
6209 <th class="th_details" colspan="5">Details</th>
6210 </tr>
6211 <tr class="entry_cont">
6212 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6213 <p>Will not be supported on most devices.<wbr/> Can only
6214pick from supported list</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6215 </td>
6216 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6217
6218
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6219 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6220 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6221
6222
6223 <tr class="entry" id="controls_android.lens.focalLength">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6224 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6225 android.<wbr/>lens.<wbr/>focal<wbr/>Length
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6226 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6227 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6228 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6229
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6230 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6231
6232
6233 </td> <!-- entry_type -->
6234
6235 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6236 <p>Lens optical zoom setting</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6237 </td>
6238
6239 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6240 focal length in mm
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6241 </td>
6242
6243 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame]6244 <p>&gt; 0</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6245 </td>
6246
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6247 <td class="entry_tags">
6248 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6249 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6250 </ul>
6251 </td>
6252
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6253 </tr>
6254 <tr class="entries_header">
6255 <th class="th_details" colspan="5">Details</th>
6256 </tr>
6257 <tr class="entry_cont">
6258 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6259 <p>Will not be supported on most devices.<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6260 </td>
6261 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6262
6263
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6264 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6265 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6266
6267
6268 <tr class="entry" id="controls_android.lens.focusDistance">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6269 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6270 android.<wbr/>lens.<wbr/>focus<wbr/>Distance
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6271 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6272 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6273 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6274
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6275 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6276
6277
6278 </td> <!-- entry_type -->
6279
6280 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6281 <p>Distance to plane of sharpest focus,<wbr/>
6282measured from frontmost surface of the lens</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6283 </td>
6284
6285 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6286 diopters (1/<wbr/>m)
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6287 </td>
6288
6289 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame]6290 <p>&gt;= 0</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6291 </td>
6292
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6293 <td class="entry_tags">
6294 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6295 <li><a href="#tag_BC">BC</a></li>
6296 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6297 </ul>
6298 </td>
6299
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6300 </tr>
6301 <tr class="entries_header">
6302 <th class="th_details" colspan="5">Details</th>
6303 </tr>
6304 <tr class="entry_cont">
6305 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6306 <p>0 = infinity focus.<wbr/> Used value should be clamped
6307to (0,<wbr/>minimum focus distance)</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6308 </td>
6309 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6310
6311
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6312 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6313 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6314
6315
6316 <tr class="entry" id="controls_android.lens.opticalStabilizationMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6317 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6318 android.<wbr/>lens.<wbr/>optical<wbr/>Stabilization<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6319 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6320 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6321 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6322
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6323 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6324
6325 <ul class="entry_type_enum">
6326 <li>
6327 <span class="entry_type_enum_name">OFF</span>
6328 </li>
6329 <li>
6330 <span class="entry_type_enum_name">ON</span>
6331 <span class="entry_type_enum_optional">optional</span>
6332 </li>
6333 </ul>
6334
6335 </td> <!-- entry_type -->
6336
6337 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6338 <p>Whether optical image stabilization is
6339enabled.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6340 </td>
6341
6342 <td class="entry_units">
6343 </td>
6344
6345 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]6346 <p>android.<wbr/>lens.<wbr/>available<wbr/>Optical<wbr/>Stabilization</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6347 </td>
6348
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6349 <td class="entry_tags">
6350 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6351 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6352 </ul>
6353 </td>
6354
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6355 </tr>
6356 <tr class="entries_header">
6357 <th class="th_details" colspan="5">Details</th>
6358 </tr>
6359 <tr class="entry_cont">
6360 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6361 <p>Will not be supported on most devices.<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6362 </td>
6363 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6364
6365
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6366 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6367 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6368
6369
6370
6371 <!-- end of kind -->
6372 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6373 <tr><td colspan="6" class="kind">static</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6374
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6375 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6376 <tr>
6377 <th class="th_name">Property Name</th>
6378 <th class="th_type">Type</th>
6379 <th class="th_description">Description</th>
6380 <th class="th_units">Units</th>
6381 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6382 <th class="th_tags">Tags</th>
6383 </tr>
6384 </thead>
6385
6386 <tbody>
6387
6388
6389
6390
6391
6392
6393
6394
6395
6396
6397
6398
6399 <tr class="entry" id="static_android.lens.info.availableApertures">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6400 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6401 android.<wbr/>lens.<wbr/>info.<wbr/>available<wbr/>Apertures
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6402 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6403 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6404 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6405 <span class="entry_type_container">x</span>
6406
6407 <span class="entry_type_array">
6408 n
6409 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6410 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6411
6412
6413 </td> <!-- entry_type -->
6414
6415 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6416 <p>List of supported aperture
Zhijun He1b58d382014-01-10 10:22:53 -0800[diff] [blame]6417values.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6418 </td>
6419
6420 <td class="entry_units">
6421 </td>
6422
6423 <td class="entry_range">
Zhijun He1b58d382014-01-10 10:22:53 -0800[diff] [blame]6424 <p>one entry required,<wbr/> &amp;&gt; 0</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6425 </td>
6426
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6427 <td class="entry_tags">
6428 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6429 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6430 </ul>
6431 </td>
6432
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6433 </tr>
6434 <tr class="entries_header">
6435 <th class="th_details" colspan="5">Details</th>
6436 </tr>
6437 <tr class="entry_cont">
6438 <td class="entry_details" colspan="5">
Zhijun He1b58d382014-01-10 10:22:53 -0800[diff] [blame]6439 <p>If the camera device doesn't support variable apertures,<wbr/>
6440listed value will be the fixed aperture.<wbr/></p>
6441<p>If the camera device supports variable apertures,<wbr/> the aperture value
6442in this list will be sorted in ascending order.<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6443 </td>
6444 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6445
6446
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6447 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6448 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6449
6450
6451 <tr class="entry" id="static_android.lens.info.availableFilterDensities">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6452 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6453 android.<wbr/>lens.<wbr/>info.<wbr/>available<wbr/>Filter<wbr/>Densities
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6454 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6455 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6456 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6457 <span class="entry_type_container">x</span>
6458
6459 <span class="entry_type_array">
6460 n
6461 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6462 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6463
6464
6465 </td> <!-- entry_type -->
6466
6467 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6468 <p>List of supported ND filter
6469values</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6470 </td>
6471
6472 <td class="entry_units">
6473 </td>
6474
6475 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]6476 <p>one entry required,<wbr/> &gt;= 0</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6477 </td>
6478
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6479 <td class="entry_tags">
6480 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6481 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6482 </ul>
6483 </td>
6484
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6485 </tr>
6486 <tr class="entries_header">
6487 <th class="th_details" colspan="5">Details</th>
6488 </tr>
6489 <tr class="entry_cont">
6490 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6491 <p>If not available,<wbr/> only setting is 0.<wbr/> Otherwise,<wbr/>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6492lists the available exposure index values for dimming
6493(2 would mean the filter is set to reduce incoming
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6494light by two stops)</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6495 </td>
6496 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6497
6498
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6499 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6500 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6501
6502
6503 <tr class="entry" id="static_android.lens.info.availableFocalLengths">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6504 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6505 android.<wbr/>lens.<wbr/>info.<wbr/>available<wbr/>Focal<wbr/>Lengths
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6506 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6507 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6508 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6509 <span class="entry_type_container">x</span>
6510
6511 <span class="entry_type_array">
6512 n
6513 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6514 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6515 <div class="entry_type_notes">the list of available focal lengths</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6516
6517
6518 </td> <!-- entry_type -->
6519
6520 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6521 <p>If fitted with optical zoom,<wbr/> what focal
6522lengths are available.<wbr/> If not,<wbr/> the static focal
6523length</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6524 </td>
6525
6526 <td class="entry_units">
6527 </td>
6528
6529 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame]6530 <p>&gt; 0</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6531 </td>
6532
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6533 <td class="entry_tags">
6534 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6535 <li><a href="#tag_BC">BC</a></li>
6536 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6537 </ul>
6538 </td>
6539
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6540 </tr>
6541 <tr class="entries_header">
6542 <th class="th_details" colspan="5">Details</th>
6543 </tr>
6544 <tr class="entry_cont">
6545 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6546 <p>If optical zoom not supported,<wbr/> only one value
6547should be reported</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6548 </td>
6549 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6550
6551
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6552 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6553 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6554
6555
6556 <tr class="entry" id="static_android.lens.info.availableOpticalStabilization">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6557 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6558 android.<wbr/>lens.<wbr/>info.<wbr/>available<wbr/>Optical<wbr/>Stabilization
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6559 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6560 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6561 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6562 <span class="entry_type_container">x</span>
6563
6564 <span class="entry_type_array">
6565 n
6566 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6567 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6568 <div class="entry_type_notes">list of enums</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6569
6570
6571 </td> <!-- entry_type -->
6572
6573 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6574 <p>List of supported optical image
6575stabilization modes</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6576 </td>
6577
6578 <td class="entry_units">
6579 </td>
6580
6581 <td class="entry_range">
6582 </td>
6583
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6584 <td class="entry_tags">
6585 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6586 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6587 </ul>
6588 </td>
6589
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6590 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6591
6592
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6593 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6594 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6595
6596
6597 <tr class="entry" id="static_android.lens.info.geometricCorrectionMap">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6598 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6599 android.<wbr/>lens.<wbr/>info.<wbr/>geometric<wbr/>Correction<wbr/>Map
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6600 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6601 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6602 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6603 <span class="entry_type_container">x</span>
6604
6605 <span class="entry_type_array">
6606 2 x 3 x n x m
6607 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6608 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6609 <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]6610
6611
6612 </td> <!-- entry_type -->
6613
6614 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6615 <p>A low-resolution map for correction of
6616geometric distortions and chromatic aberrations,<wbr/> per
6617color channel</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6618 </td>
6619
6620 <td class="entry_units">
6621 </td>
6622
6623 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]6624 <p>N,<wbr/> M &gt;= 2</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6625 </td>
6626
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6627 <td class="entry_tags">
6628 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6629 <li><a href="#tag_DNG">DNG</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6630 </ul>
6631 </td>
6632
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6633 </tr>
6634 <tr class="entries_header">
6635 <th class="th_details" colspan="5">Details</th>
6636 </tr>
6637 <tr class="entry_cont">
6638 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6639 <p>[DNG wants a function instead].<wbr/> What's easiest
6640for implementers? With an array size (M,<wbr/> N),<wbr/> entry (i,<wbr/>
6641j) provides the destination for pixel (i/<wbr/>(M-1) * width,<wbr/>
6642j/<wbr/>(N-1) * height).<wbr/> Data is row-major,<wbr/> with each array
6643entry 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]6644 </td>
6645 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6646
6647
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6648 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6649 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6650
6651
6652 <tr class="entry" id="static_android.lens.info.geometricCorrectionMapSize">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6653 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6654 android.<wbr/>lens.<wbr/>info.<wbr/>geometric<wbr/>Correction<wbr/>Map<wbr/>Size
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6655 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6656 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6657 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6658 <span class="entry_type_container">x</span>
6659
6660 <span class="entry_type_array">
6661 2
6662 </span>
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]6663 <span class="entry_type_visibility"> [system as size]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6664 <div class="entry_type_notes">width and height of geometric correction map</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6665
6666
6667 </td> <!-- entry_type -->
6668
6669 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6670 <p>Dimensions of geometric correction
6671map</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6672 </td>
6673
6674 <td class="entry_units">
6675 </td>
6676
6677 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]6678 <p>Both values &gt;= 2</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6679 </td>
6680
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6681 <td class="entry_tags">
6682 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6683 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6684 </ul>
6685 </td>
6686
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6687 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6688
6689
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6690 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6691 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6692
6693
6694 <tr class="entry" id="static_android.lens.info.hyperfocalDistance">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6695 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6696 android.<wbr/>lens.<wbr/>info.<wbr/>hyperfocal<wbr/>Distance
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6697 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6698 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6699 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6700
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6701 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6702
6703
6704 </td> <!-- entry_type -->
6705
6706 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6707 <p>Hyperfocal distance for this lens; set to
67080 if fixed focus</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6709 </td>
6710
6711 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6712 diopters
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6713 </td>
6714
6715 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame]6716 <p>&gt;= 0</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6717 </td>
6718
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6719 <td class="entry_tags">
6720 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6721 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6722 </ul>
6723 </td>
6724
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6725 </tr>
6726 <tr class="entries_header">
6727 <th class="th_details" colspan="5">Details</th>
6728 </tr>
6729 <tr class="entry_cont">
6730 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6731 <p>The hyperfocal distance is used for the old
6732API's 'fixed' setting</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6733 </td>
6734 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6735
6736
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6737 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6738 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6739
6740
6741 <tr class="entry" id="static_android.lens.info.minimumFocusDistance">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6742 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6743 android.<wbr/>lens.<wbr/>info.<wbr/>minimum<wbr/>Focus<wbr/>Distance
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6744 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6745 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6746 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6747
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6748 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6749
6750
6751 </td> <!-- entry_type -->
6752
6753 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6754 <p>Shortest distance from frontmost surface
6755of the lens that can be focused correctly</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6756 </td>
6757
6758 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6759 diopters
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6760 </td>
6761
6762 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame]6763 <p>&gt;= 0</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6764 </td>
6765
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6766 <td class="entry_tags">
6767 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6768 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6769 </ul>
6770 </td>
6771
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6772 </tr>
6773 <tr class="entries_header">
6774 <th class="th_details" colspan="5">Details</th>
6775 </tr>
6776 <tr class="entry_cont">
6777 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6778 <p>If the lens is fixed-focus,<wbr/> this should be
67790</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6780 </td>
6781 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6782
6783
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6784 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6785 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6786
6787
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6788 <tr class="entry" id="static_android.lens.info.shadingMapSize">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6789 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6790 android.<wbr/>lens.<wbr/>info.<wbr/>shading<wbr/>Map<wbr/>Size
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6791 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6792 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6793 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6794 <span class="entry_type_container">x</span>
6795
6796 <span class="entry_type_array">
6797 2
6798 </span>
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]6799 <span class="entry_type_visibility"> [public as size]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6800 <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]6801
6802
6803 </td> <!-- entry_type -->
6804
6805 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6806 <p>Dimensions of lens shading map.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6807 </td>
6808
6809 <td class="entry_units">
6810 </td>
6811
6812 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]6813 <p>Both values &gt;= 1</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6814 </td>
6815
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6816 <td class="entry_tags">
6817 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6818 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6819 </ul>
6820 </td>
6821
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6822 </tr>
6823 <tr class="entries_header">
6824 <th class="th_details" colspan="5">Details</th>
6825 </tr>
6826 <tr class="entry_cont">
6827 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6828 <p>The map should be on the order of 30-40 rows and columns,<wbr/> and
6829must be smaller than 64x64.<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6830 </td>
6831 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6832
6833
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6834 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6835 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6836
6837
6838
6839
6840
6841 <tr class="entry" id="static_android.lens.facing">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6842 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6843 android.<wbr/>lens.<wbr/>facing
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6844 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6845 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6846 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6847
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6848 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6849
6850 <ul class="entry_type_enum">
6851 <li>
6852 <span class="entry_type_enum_name">FRONT</span>
6853 </li>
6854 <li>
6855 <span class="entry_type_enum_name">BACK</span>
6856 </li>
6857 </ul>
6858
6859 </td> <!-- entry_type -->
6860
6861 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6862 <p>Direction the camera faces relative to
6863device screen</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6864 </td>
6865
6866 <td class="entry_units">
6867 </td>
6868
6869 <td class="entry_range">
6870 </td>
6871
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6872 <td class="entry_tags">
6873 </td>
6874
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6875 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6876
6877
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6878 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6879 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6880
6881
6882 <tr class="entry" id="static_android.lens.opticalAxisAngle">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6883 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6884 android.<wbr/>lens.<wbr/>optical<wbr/>Axis<wbr/>Angle
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6885 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6886 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6887 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6888 <span class="entry_type_container">x</span>
6889
6890 <span class="entry_type_array">
6891 2
6892 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6893 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6894 <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]6895
6896
6897 </td> <!-- entry_type -->
6898
6899 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6900 <p>Relative angle of camera optical axis to the
6901perpendicular axis from the display</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6902 </td>
6903
6904 <td class="entry_units">
6905 </td>
6906
6907 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]6908 <p>[0-90) for first angle,<wbr/> [0-360) for second</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6909 </td>
6910
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6911 <td class="entry_tags">
6912 <ul class="entry_tags">
6913 <li><a href="#tag_ADV">ADV</a></li>
6914 </ul>
6915 </td>
6916
6917 </tr>
6918 <tr class="entries_header">
6919 <th class="th_details" colspan="5">Details</th>
6920 </tr>
6921 <tr class="entry_cont">
6922 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6923 <p>Examples:</p>
6924<p>(0,<wbr/>0) means that the camera optical axis
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]6925is perpendicular to the display surface;</p>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6926<p>(45,<wbr/>0) means that the camera points 45 degrees up when
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]6927device is held upright;</p>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6928<p>(45,<wbr/>90) means the camera points 45 degrees to the right when
6929the device is held upright.<wbr/></p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]6930<p>Use FACING field to determine perpendicular outgoing
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6931direction</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6932 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6933 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6934
6935
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6936 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6937 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6938
6939
6940 <tr class="entry" id="static_android.lens.position">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6941 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6942 android.<wbr/>lens.<wbr/>position
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6943 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6944 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6945 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6946 <span class="entry_type_container">x</span>
6947
6948 <span class="entry_type_array">
6949 3, location in mm, in the sensor coordinate
6950 system
6951 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6952 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6953
6954
6955 </td> <!-- entry_type -->
6956
6957 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6958 <p>Coordinates of camera optical axis on
6959device</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6960 </td>
6961
6962 <td class="entry_units">
6963 </td>
6964
6965 <td class="entry_range">
6966 </td>
6967
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6968 <td class="entry_tags">
6969 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6970 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6971 </ul>
6972 </td>
6973
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6974 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6975
6976
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6977 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6978 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6979
6980
6981
6982 <!-- end of kind -->
6983 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6984 <tr><td colspan="6" class="kind">dynamic</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6985
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6986 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6987 <tr>
6988 <th class="th_name">Property Name</th>
6989 <th class="th_type">Type</th>
6990 <th class="th_description">Description</th>
6991 <th class="th_units">Units</th>
6992 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6993 <th class="th_tags">Tags</th>
6994 </tr>
6995 </thead>
6996
6997 <tbody>
6998
6999
7000
7001
7002
7003
7004
7005
7006
7007
7008 <tr class="entry" id="dynamic_android.lens.aperture">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7009 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7010 android.<wbr/>lens.<wbr/>aperture
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7011 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7012 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7013 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7014
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7015 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7016
7017
7018 </td> <!-- entry_type -->
7019
7020 <td class="entry_description">
Zhijun He1b58d382014-01-10 10:22:53 -0800[diff] [blame]7021 <p>The ratio of lens focal length to the effective
7022aperture diameter.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7023 </td>
7024
7025 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7026 f-number (f/<wbr/>NNN)
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7027 </td>
7028
7029 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]7030 <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]7031 </td>
7032
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7033 <td class="entry_tags">
7034 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]7035 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7036 </ul>
7037 </td>
7038
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7039 </tr>
7040 <tr class="entries_header">
7041 <th class="th_details" colspan="5">Details</th>
7042 </tr>
7043 <tr class="entry_cont">
7044 <td class="entry_details" colspan="5">
Zhijun He1b58d382014-01-10 10:22:53 -0800[diff] [blame]7045 <p>This will only be supported on the camera devices that
7046have variable aperture lens.<wbr/> The aperture value can only be
7047one of the values listed in <a href="#static_android.lens.info.availableApertures">android.<wbr/>lens.<wbr/>info.<wbr/>available<wbr/>Apertures</a>.<wbr/></p>
7048<p>When this is supported and <a href="#controls_android.control.aeMode">android.<wbr/>control.<wbr/>ae<wbr/>Mode</a> is OFF,<wbr/>
7049this can be set along with <a href="#controls_android.sensor.exposureTime">android.<wbr/>sensor.<wbr/>exposure<wbr/>Time</a>,<wbr/>
7050<a href="#controls_android.sensor.sensitivity">android.<wbr/>sensor.<wbr/>sensitivity</a>,<wbr/> and android.<wbr/>sensor.<wbr/>frame<wbr/>Duration
7051to achieve manual exposure control.<wbr/></p>
7052<p>The requested aperture value may take several frames to reach the
7053requested value; the camera device will report the current (intermediate)
7054aperture size in capture result metadata while the aperture is changing.<wbr/></p>
7055<p>When this is supported and <a href="#controls_android.control.aeMode">android.<wbr/>control.<wbr/>ae<wbr/>Mode</a> is one of
7056the ON modes,<wbr/> this will be overridden by the camera device
7057auto-exposure algorithm,<wbr/> the overridden values are then provided
7058back to the user in the corresponding result.<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7059 </td>
7060 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7061
7062
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7063 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7064 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7065
7066
7067 <tr class="entry" id="dynamic_android.lens.filterDensity">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7068 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7069 android.<wbr/>lens.<wbr/>filter<wbr/>Density
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7070 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7071 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7072 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7073
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7074 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7075
7076
7077 </td> <!-- entry_type -->
7078
7079 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7080 <p>State of lens neutral density
7081filter(s)</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7082 </td>
7083
7084 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7085 number of stops of filtering
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7086 </td>
7087
7088 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]7089 <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]7090 </td>
7091
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7092 <td class="entry_tags">
7093 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]7094 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7095 </ul>
7096 </td>
7097
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7098 </tr>
7099 <tr class="entries_header">
7100 <th class="th_details" colspan="5">Details</th>
7101 </tr>
7102 <tr class="entry_cont">
7103 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7104 <p>Will not be supported on most devices.<wbr/> Can only
7105pick from supported list</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7106 </td>
7107 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7108
7109
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7110 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7111 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7112
7113
7114 <tr class="entry" id="dynamic_android.lens.focalLength">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7115 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7116 android.<wbr/>lens.<wbr/>focal<wbr/>Length
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7117 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7118 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7119 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7120
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7121 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7122
7123
7124 </td> <!-- entry_type -->
7125
7126 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7127 <p>Lens optical zoom setting</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7128 </td>
7129
7130 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7131 focal length in mm
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7132 </td>
7133
7134 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame]7135 <p>&gt; 0</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7136 </td>
7137
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7138 <td class="entry_tags">
7139 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]7140 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7141 </ul>
7142 </td>
7143
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7144 </tr>
7145 <tr class="entries_header">
7146 <th class="th_details" colspan="5">Details</th>
7147 </tr>
7148 <tr class="entry_cont">
7149 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7150 <p>Will not be supported on most devices.<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7151 </td>
7152 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7153
7154
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7155 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7156 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7157
7158
7159 <tr class="entry" id="dynamic_android.lens.focusDistance">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7160 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7161 android.<wbr/>lens.<wbr/>focus<wbr/>Distance
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7162 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7163 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7164 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7165
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7166 <span class="entry_type_visibility"> [public]</span>
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>Distance to plane of sharpest focus,<wbr/>
7173measured from frontmost surface of the lens</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7174 </td>
7175
7176 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7177 diopters (1/<wbr/>m)
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7178 </td>
7179
7180 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame]7181 <p>&gt;= 0</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7182 </td>
7183
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7184 <td class="entry_tags">
7185 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]7186 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7187 </ul>
7188 </td>
7189
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7190 </tr>
7191 <tr class="entries_header">
7192 <th class="th_details" colspan="5">Details</th>
7193 </tr>
7194 <tr class="entry_cont">
7195 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7196 <p>Should be zero for fixed-focus cameras</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7197 </td>
7198 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7199
7200
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7201 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7202 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7203
7204
7205 <tr class="entry" id="dynamic_android.lens.focusRange">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7206 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7207 android.<wbr/>lens.<wbr/>focus<wbr/>Range
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7208 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7209 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7210 <span class="entry_type_name">float</span>
Zhijun He50451ad2013-09-26 10:27:47 -0700[diff] [blame]7211 <span class="entry_type_container">x</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7212
Zhijun He50451ad2013-09-26 10:27:47 -0700[diff] [blame]7213 <span class="entry_type_array">
7214 2
7215 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7216 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7217 <div class="entry_type_notes">Range of scene distances that are in focus</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7218
7219
7220 </td> <!-- entry_type -->
7221
7222 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7223 <p>The range of scene distances that are in
7224sharp focus (depth of field)</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7225 </td>
7226
7227 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7228 pair of focus distances in diopters: (near,<wbr/>
7229 far)
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7230 </td>
7231
7232 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame]7233 <p>&gt;=0</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7234 </td>
7235
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7236 <td class="entry_tags">
7237 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]7238 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7239 </ul>
7240 </td>
7241
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7242 </tr>
7243 <tr class="entries_header">
7244 <th class="th_details" colspan="5">Details</th>
7245 </tr>
7246 <tr class="entry_cont">
7247 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7248 <p>If variable focus not supported,<wbr/> can still report
7249fixed depth of field range</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7250 </td>
7251 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7252
7253
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7254 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7255 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7256
7257
7258 <tr class="entry" id="dynamic_android.lens.opticalStabilizationMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7259 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7260 android.<wbr/>lens.<wbr/>optical<wbr/>Stabilization<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7261 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7262 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7263 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7264
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7265 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7266
7267 <ul class="entry_type_enum">
7268 <li>
7269 <span class="entry_type_enum_name">OFF</span>
7270 </li>
7271 <li>
7272 <span class="entry_type_enum_name">ON</span>
7273 <span class="entry_type_enum_optional">optional</span>
7274 </li>
7275 </ul>
7276
7277 </td> <!-- entry_type -->
7278
7279 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7280 <p>Whether optical image stabilization is
7281enabled.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7282 </td>
7283
7284 <td class="entry_units">
7285 </td>
7286
7287 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]7288 <p>android.<wbr/>lens.<wbr/>available<wbr/>Optical<wbr/>Stabilization</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7289 </td>
7290
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7291 <td class="entry_tags">
7292 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]7293 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7294 </ul>
7295 </td>
7296
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7297 </tr>
7298 <tr class="entries_header">
7299 <th class="th_details" colspan="5">Details</th>
7300 </tr>
7301 <tr class="entry_cont">
7302 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7303 <p>Will not be supported on most devices.<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7304 </td>
7305 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7306
7307
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7308 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7309 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7310
7311
7312 <tr class="entry" id="dynamic_android.lens.state">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7313 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7314 android.<wbr/>lens.<wbr/>state
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7315 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7316 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7317 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7318
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7319 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7320
7321 <ul class="entry_type_enum">
7322 <li>
7323 <span class="entry_type_enum_name">STATIONARY</span>
7324 </li>
Igor Murashkin0e323a12013-09-06 11:50:48 -0700[diff] [blame]7325 <li>
7326 <span class="entry_type_enum_name">MOVING</span>
7327 </li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7328 </ul>
7329
7330 </td> <!-- entry_type -->
7331
7332 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7333 <p>Current lens status</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7334 </td>
7335
7336 <td class="entry_units">
7337 </td>
7338
7339 <td class="entry_range">
7340 </td>
7341
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7342 <td class="entry_tags">
7343 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]7344 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7345 </ul>
7346 </td>
7347
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7348 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7349
7350
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7351 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7352 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7353
7354
7355
7356 <!-- end of kind -->
7357 </tbody>
7358
7359 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7360 <tr><td colspan="6" id="section_noiseReduction" class="section">noiseReduction</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7361
7362
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7363 <tr><td colspan="6" class="kind">controls</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7364
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7365 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7366 <tr>
7367 <th class="th_name">Property Name</th>
7368 <th class="th_type">Type</th>
7369 <th class="th_description">Description</th>
7370 <th class="th_units">Units</th>
7371 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7372 <th class="th_tags">Tags</th>
7373 </tr>
7374 </thead>
7375
7376 <tbody>
7377
7378
7379
7380
7381
7382
7383
7384
7385
7386
7387 <tr class="entry" id="controls_android.noiseReduction.mode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7388 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7389 android.<wbr/>noise<wbr/>Reduction.<wbr/>mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7390 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7391 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7392 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7393
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7394 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7395
7396 <ul class="entry_type_enum">
7397 <li>
7398 <span class="entry_type_enum_name">OFF</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]7399 <span class="entry_type_enum_notes"><p>No noise reduction is applied</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7400 </li>
7401 <li>
7402 <span class="entry_type_enum_name">FAST</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]7403 <span class="entry_type_enum_notes"><p>Must not slow down frame rate relative to sensor
7404output</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7405 </li>
7406 <li>
7407 <span class="entry_type_enum_name">HIGH_QUALITY</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]7408 <span class="entry_type_enum_notes"><p>May slow down frame rate to provide highest
7409quality</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7410 </li>
7411 </ul>
7412
7413 </td> <!-- entry_type -->
7414
7415 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7416 <p>Mode of operation for the noise reduction
7417algorithm</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7418 </td>
7419
7420 <td class="entry_units">
7421 </td>
7422
7423 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]7424 <p>android.<wbr/>noise<wbr/>Reduction.<wbr/>available<wbr/>Modes</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7425 </td>
7426
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7427 <td class="entry_tags">
7428 <ul class="entry_tags">
7429 <li><a href="#tag_V1">V1</a></li>
7430 </ul>
7431 </td>
7432
7433 </tr>
7434 <tr class="entries_header">
7435 <th class="th_details" colspan="5">Details</th>
7436 </tr>
7437 <tr class="entry_cont">
7438 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7439 <p>Noise filtering control.<wbr/> OFF means no noise reduction
7440will be applied by the HAL.<wbr/></p>
Zhijun Hef90eeaf2014-01-16 12:13:35 -0800[diff] [blame^]7441<p>FAST/<wbr/>HIGH_<wbr/>QUALITY both mean camera device determined noise filtering
7442will be applied.<wbr/> HIGH_<wbr/>QUALITY mode indicates that the camera device
7443will use the highest-quality noise filtering algorithms,<wbr/>
7444even if it slows down capture rate.<wbr/> FAST means the camera device should not
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7445slow down capture rate when applying noise filtering.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7446 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7447 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7448
7449
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7450 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7451 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7452
7453
7454 <tr class="entry" id="controls_android.noiseReduction.strength">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7455 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7456 android.<wbr/>noise<wbr/>Reduction.<wbr/>strength
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7457 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7458 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7459 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7460
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7461 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7462
7463
7464 </td> <!-- entry_type -->
7465
7466 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7467 <p>Control the amount of noise reduction
7468applied to the images</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7469 </td>
7470
7471 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7472 1-10; 10 is max noise reduction
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7473 </td>
7474
7475 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]7476 <p>1 - 10</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7477 </td>
7478
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7479 <td class="entry_tags">
7480 </td>
7481
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7482 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7483
7484
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7485 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7486 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7487
7488
7489
7490 <!-- end of kind -->
7491 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7492 <tr><td colspan="6" class="kind">dynamic</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7493
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7494 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7495 <tr>
7496 <th class="th_name">Property Name</th>
7497 <th class="th_type">Type</th>
7498 <th class="th_description">Description</th>
7499 <th class="th_units">Units</th>
7500 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7501 <th class="th_tags">Tags</th>
7502 </tr>
7503 </thead>
7504
7505 <tbody>
7506
7507
7508
7509
7510
7511
7512
7513
7514
7515
7516 <tr class="entry" id="dynamic_android.noiseReduction.mode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7517 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7518 android.<wbr/>noise<wbr/>Reduction.<wbr/>mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7519 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7520 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7521 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7522
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7523 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7524
7525 <ul class="entry_type_enum">
7526 <li>
7527 <span class="entry_type_enum_name">OFF</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]7528 <span class="entry_type_enum_notes"><p>No noise reduction is applied</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7529 </li>
7530 <li>
7531 <span class="entry_type_enum_name">FAST</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]7532 <span class="entry_type_enum_notes"><p>Must not slow down frame rate relative to sensor
7533output</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7534 </li>
7535 <li>
7536 <span class="entry_type_enum_name">HIGH_QUALITY</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]7537 <span class="entry_type_enum_notes"><p>May slow down frame rate to provide highest
7538quality</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7539 </li>
7540 </ul>
7541
7542 </td> <!-- entry_type -->
7543
7544 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7545 <p>Mode of operation for the noise reduction
7546algorithm</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7547 </td>
7548
7549 <td class="entry_units">
7550 </td>
7551
7552 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]7553 <p>android.<wbr/>noise<wbr/>Reduction.<wbr/>available<wbr/>Modes</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7554 </td>
7555
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7556 <td class="entry_tags">
7557 <ul class="entry_tags">
7558 <li><a href="#tag_V1">V1</a></li>
7559 </ul>
7560 </td>
7561
7562 </tr>
7563 <tr class="entries_header">
7564 <th class="th_details" colspan="5">Details</th>
7565 </tr>
7566 <tr class="entry_cont">
7567 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7568 <p>Noise filtering control.<wbr/> OFF means no noise reduction
7569will be applied by the HAL.<wbr/></p>
Zhijun Hef90eeaf2014-01-16 12:13:35 -0800[diff] [blame^]7570<p>FAST/<wbr/>HIGH_<wbr/>QUALITY both mean camera device determined noise filtering
7571will be applied.<wbr/> HIGH_<wbr/>QUALITY mode indicates that the camera device
7572will use the highest-quality noise filtering algorithms,<wbr/>
7573even if it slows down capture rate.<wbr/> FAST means the camera device should not
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7574slow down capture rate when applying noise filtering.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7575 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7576 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7577
7578
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7579 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7580 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7581
7582
7583
7584 <!-- end of kind -->
7585 </tbody>
7586
7587 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7588 <tr><td colspan="6" id="section_quirks" class="section">quirks</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7589
7590
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7591 <tr><td colspan="6" class="kind">static</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7592
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7593 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7594 <tr>
7595 <th class="th_name">Property Name</th>
7596 <th class="th_type">Type</th>
7597 <th class="th_description">Description</th>
7598 <th class="th_units">Units</th>
7599 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7600 <th class="th_tags">Tags</th>
7601 </tr>
7602 </thead>
7603
7604 <tbody>
7605
7606
7607
7608
7609
7610
7611
7612
7613
7614
7615 <tr class="entry" id="static_android.quirks.meteringCropRegion">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7616 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7617 android.<wbr/>quirks.<wbr/>metering<wbr/>Crop<wbr/>Region
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7618 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7619 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7620 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7621
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7622 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7623
7624
7625 </td> <!-- entry_type -->
7626
7627 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7628 <p>If set to 1,<wbr/> the camera service does not
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]7629scale 'normalized' coordinates with respect to the crop
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7630region.<wbr/> This applies to metering input (a{e,<wbr/>f,<wbr/>wb}Region
7631and output (face rectangles).<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7632 </td>
7633
7634 <td class="entry_units">
7635 </td>
7636
7637 <td class="entry_range">
7638 </td>
7639
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7640 <td class="entry_tags">
7641 </td>
7642
7643 </tr>
7644 <tr class="entries_header">
7645 <th class="th_details" colspan="5">Details</th>
7646 </tr>
7647 <tr class="entry_cont">
7648 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7649 <p>Normalized coordinates refer to those in the
7650(-1000,<wbr/>1000) range mentioned in the
7651android.<wbr/>hardware.<wbr/>Camera API.<wbr/></p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]7652<p>HAL implementations should instead always use and emit
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7653sensor array-relative coordinates for all region data.<wbr/> Does
7654not need to be listed in static metadata.<wbr/> Support will be
7655removed in future versions of camera service.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7656 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7657 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7658
7659
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7660 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7661 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7662
7663
7664 <tr class="entry" id="static_android.quirks.triggerAfWithAuto">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7665 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7666 android.<wbr/>quirks.<wbr/>trigger<wbr/>Af<wbr/>With<wbr/>Auto
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7667 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7668 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7669 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7670
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7671 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7672
7673
7674 </td> <!-- entry_type -->
7675
7676 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7677 <p>If set to 1,<wbr/> then the camera service always
7678switches to FOCUS_<wbr/>MODE_<wbr/>AUTO before issuing a AF
7679trigger.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7680 </td>
7681
7682 <td class="entry_units">
7683 </td>
7684
7685 <td class="entry_range">
7686 </td>
7687
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7688 <td class="entry_tags">
7689 </td>
7690
7691 </tr>
7692 <tr class="entries_header">
7693 <th class="th_details" colspan="5">Details</th>
7694 </tr>
7695 <tr class="entry_cont">
7696 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7697 <p>HAL implementations should implement AF trigger
7698modes for AUTO,<wbr/> MACRO,<wbr/> CONTINUOUS_<wbr/>FOCUS,<wbr/> and
7699CONTINUOUS_<wbr/>PICTURE modes instead of using this flag.<wbr/> Does
7700not need to be listed in static metadata.<wbr/> Support will be
7701removed in future versions of camera service</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7702 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7703 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7704
7705
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7706 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7707 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7708
7709
7710 <tr class="entry" id="static_android.quirks.useZslFormat">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7711 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7712 android.<wbr/>quirks.<wbr/>use<wbr/>Zsl<wbr/>Format
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7713 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7714 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7715 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7716
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7717 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7718
7719
7720 </td> <!-- entry_type -->
7721
7722 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7723 <p>If set to 1,<wbr/> the camera service uses
7724CAMERA2_<wbr/>PIXEL_<wbr/>FORMAT_<wbr/>ZSL instead of
7725HAL_<wbr/>PIXEL_<wbr/>FORMAT_<wbr/>IMPLEMENTATION_<wbr/>DEFINED for the zero
7726shutter lag stream</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7727 </td>
7728
7729 <td class="entry_units">
7730 </td>
7731
7732 <td class="entry_range">
7733 </td>
7734
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7735 <td class="entry_tags">
7736 </td>
7737
7738 </tr>
7739 <tr class="entries_header">
7740 <th class="th_details" colspan="5">Details</th>
7741 </tr>
7742 <tr class="entry_cont">
7743 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7744 <p>HAL implementations should use gralloc usage flags
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]7745to determine that a stream will be used for
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7746zero-shutter-lag,<wbr/> instead of relying on an explicit
7747format setting.<wbr/> Does not need to be listed in static
7748metadata.<wbr/> Support will be removed in future versions of
7749camera service.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7750 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7751 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7752
7753
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7754 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7755 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7756
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]7757
7758 <tr class="entry" id="static_android.quirks.usePartialResult">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7759 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7760 android.<wbr/>quirks.<wbr/>use<wbr/>Partial<wbr/>Result
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7761 </td>
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]7762 <td class="entry_type">
7763 <span class="entry_type_name">byte</span>
7764
Eino-Ville Talvala52a64a52013-11-07 14:43:43 -0800[diff] [blame]7765 <span class="entry_type_visibility"> [hidden]</span>
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]7766
7767
7768 </td> <!-- entry_type -->
7769
7770 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7771 <p>If set to 1,<wbr/> the HAL will always split result
7772metadata for a single capture into multiple buffers,<wbr/>
7773returned using multiple process_<wbr/>capture_<wbr/>result calls.<wbr/></p>
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]7774 </td>
7775
7776 <td class="entry_units">
7777 </td>
7778
7779 <td class="entry_range">
7780 </td>
7781
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7782 <td class="entry_tags">
7783 </td>
7784
7785 </tr>
7786 <tr class="entries_header">
7787 <th class="th_details" colspan="5">Details</th>
7788 </tr>
7789 <tr class="entry_cont">
7790 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7791 <p>Does not need to be listed in static
7792metadata.<wbr/> Support for partial results will be reworked in
7793future versions of camera service.<wbr/> This quirk will stop
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]7794working at that point; DO NOT USE without careful
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7795consideration of future support.<wbr/></p>
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]7796 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7797 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7798
7799
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7800 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7801 <!-- end of entry -->
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]7802
7803
7804
7805 <!-- end of kind -->
7806 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7807 <tr><td colspan="6" class="kind">dynamic</td></tr>
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]7808
7809 <thead class="entries_header">
7810 <tr>
7811 <th class="th_name">Property Name</th>
7812 <th class="th_type">Type</th>
7813 <th class="th_description">Description</th>
7814 <th class="th_units">Units</th>
7815 <th class="th_range">Range</th>
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]7816 <th class="th_tags">Tags</th>
7817 </tr>
7818 </thead>
7819
7820 <tbody>
7821
7822
7823
7824
7825
7826
7827
7828
7829
7830
7831 <tr class="entry" id="dynamic_android.quirks.partialResult">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7832 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7833 android.<wbr/>quirks.<wbr/>partial<wbr/>Result
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7834 </td>
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]7835 <td class="entry_type">
7836 <span class="entry_type_name entry_type_name_enum">byte</span>
7837
Eino-Ville Talvala52a64a52013-11-07 14:43:43 -0800[diff] [blame]7838 <span class="entry_type_visibility"> [hidden as boolean]</span>
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]7839
7840 <ul class="entry_type_enum">
7841 <li>
7842 <span class="entry_type_enum_name">FINAL</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]7843 <span class="entry_type_enum_notes"><p>The last or only metadata result buffer
7844for this capture.<wbr/></p></span>
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]7845 </li>
7846 <li>
7847 <span class="entry_type_enum_name">PARTIAL</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]7848 <span class="entry_type_enum_notes"><p>A partial buffer of result metadata for this
7849capture.<wbr/> More result buffers for this capture will be sent
7850by the HAL,<wbr/> the last of which will be marked
7851FINAL.<wbr/></p></span>
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]7852 </li>
7853 </ul>
7854
7855 </td> <!-- entry_type -->
7856
7857 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7858 <p>Whether a result given to the framework is the
7859final one for the capture,<wbr/> or only a partial that contains a
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]7860subset of the full set of dynamic metadata
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7861values.<wbr/></p>
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]7862 </td>
7863
7864 <td class="entry_units">
7865 </td>
7866
7867 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]7868 <p>Optional.<wbr/> Default value is FINAL.<wbr/></p>
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]7869 </td>
7870
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7871 <td class="entry_tags">
7872 </td>
7873
7874 </tr>
7875 <tr class="entries_header">
7876 <th class="th_details" colspan="5">Details</th>
7877 </tr>
7878 <tr class="entry_cont">
7879 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7880 <p>The entries in the result metadata buffers for a
7881single capture may not overlap,<wbr/> except for this entry.<wbr/> The
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]7882FINAL buffers must retain FIFO ordering relative to the
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7883requests that generate them,<wbr/> so the FINAL buffer for frame 3 must
7884always be sent to the framework after the FINAL buffer for frame 2,<wbr/> and
7885before the FINAL buffer for frame 4.<wbr/> PARTIAL buffers may be returned
7886in any order relative to other frames,<wbr/> but all PARTIAL buffers for a given
7887capture must arrive before the FINAL buffer for that capture.<wbr/> This entry may
7888only 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]7889 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7890 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7891
7892
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7893 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7894 <!-- end of entry -->
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]7895
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7896
7897
7898 <!-- end of kind -->
7899 </tbody>
7900
7901 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7902 <tr><td colspan="6" id="section_request" class="section">request</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7903
7904
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7905 <tr><td colspan="6" class="kind">controls</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7906
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7907 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7908 <tr>
7909 <th class="th_name">Property Name</th>
7910 <th class="th_type">Type</th>
7911 <th class="th_description">Description</th>
7912 <th class="th_units">Units</th>
7913 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7914 <th class="th_tags">Tags</th>
7915 </tr>
7916 </thead>
7917
7918 <tbody>
7919
7920
7921
7922
7923
7924
7925
7926
7927
7928
7929 <tr class="entry" id="controls_android.request.frameCount">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7930 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7931 android.<wbr/>request.<wbr/>frame<wbr/>Count
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7932 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7933 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7934 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7935
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7936 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7937
7938
7939 </td> <!-- entry_type -->
7940
7941 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7942 <p>A frame counter set by the framework.<wbr/> Must
7943be maintained unchanged in output frame.<wbr/> This value monotonically
7944increases with every new result (that is,<wbr/> each new result has a unique
7945frameCount value).<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7946 </td>
7947
7948 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7949 incrementing integer
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7950 </td>
7951
7952 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]7953 <p>Any int</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7954 </td>
7955
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7956 <td class="entry_tags">
7957 </td>
7958
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7959 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7960
7961
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7962 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7963 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7964
7965
7966 <tr class="entry" id="controls_android.request.id">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7967 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7968 android.<wbr/>request.<wbr/>id
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7969 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7970 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7971 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7972
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7973 <span class="entry_type_visibility"> [hidden]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7974
7975
7976 </td> <!-- entry_type -->
7977
7978 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7979 <p>An application-specified ID for the current
7980request.<wbr/> Must be maintained unchanged in output
7981frame</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7982 </td>
7983
7984 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7985 arbitrary integer assigned by application
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7986 </td>
7987
7988 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]7989 <p>Any int</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7990 </td>
7991
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7992 <td class="entry_tags">
7993 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]7994 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7995 </ul>
7996 </td>
7997
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7998 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7999
8000
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8001 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8002 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8003
8004
8005 <tr class="entry" id="controls_android.request.inputStreams">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8006 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8007 android.<wbr/>request.<wbr/>input<wbr/>Streams
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8008 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8009 <td class="entry_type">
Zhijun Hee36cdbe2013-09-06 14:28:37 -0700[diff] [blame]8010 <span class="entry_type_name">int32</span>
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]8011 <span class="entry_type_container">x</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8012
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]8013 <span class="entry_type_array">
8014 n
8015 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8016 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8017
8018
8019 </td> <!-- entry_type -->
8020
8021 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8022 <p>List which camera reprocess stream is used
8023for the source of reprocessing data.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8024 </td>
8025
8026 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8027 List of camera reprocess stream IDs
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8028 </td>
8029
8030 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]8031 <p>Typically,<wbr/> only one entry allowed,<wbr/> must be a valid
8032reprocess stream ID.<wbr/></p>
8033<p>If android.<wbr/>jpeg.<wbr/>needs<wbr/>Thumbnail is set,<wbr/> then multiple
8034reprocess streams may be included in a single request; they
8035must be different scaled versions of the same image.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8036 </td>
8037
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8038 <td class="entry_tags">
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]8039 <ul class="entry_tags">
8040 <li><a href="#tag_HAL2">HAL2</a></li>
8041 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8042 </td>
8043
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8044 </tr>
8045 <tr class="entries_header">
8046 <th class="th_details" colspan="5">Details</th>
8047 </tr>
8048 <tr class="entry_cont">
8049 <td class="entry_details" colspan="5">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]8050 <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]8051REPROCESS.<wbr/> Ignored otherwise</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8052 </td>
8053 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8054
8055
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8056 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8057 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8058
8059
8060 <tr class="entry" id="controls_android.request.metadataMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8061 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8062 android.<wbr/>request.<wbr/>metadata<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8063 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8064 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8065 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8066
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8067 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8068
8069 <ul class="entry_type_enum">
8070 <li>
8071 <span class="entry_type_enum_name">NONE</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]8072 <span class="entry_type_enum_notes"><p>No metadata should be produced on output,<wbr/> except
8073for application-bound buffer data.<wbr/> If no
8074application-bound streams exist,<wbr/> no frame should be
8075placed in the output frame queue.<wbr/> If such streams
8076exist,<wbr/> a frame should be placed on the output queue
8077with null metadata but with the necessary output buffer
8078information.<wbr/> Timestamp information should still be
8079included with any output stream buffers</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8080 </li>
8081 <li>
8082 <span class="entry_type_enum_name">FULL</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]8083 <span class="entry_type_enum_notes"><p>All metadata should be produced.<wbr/> Statistics will
8084only be produced if they are separately
8085enabled</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8086 </li>
8087 </ul>
8088
8089 </td> <!-- entry_type -->
8090
8091 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8092 <p>How much metadata to produce on
8093output</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8094 </td>
8095
8096 <td class="entry_units">
8097 </td>
8098
8099 <td class="entry_range">
8100 </td>
8101
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8102 <td class="entry_tags">
8103 </td>
8104
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8105 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8106
8107
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8108 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8109 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8110
8111
8112 <tr class="entry" id="controls_android.request.outputStreams">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8113 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8114 android.<wbr/>request.<wbr/>output<wbr/>Streams
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8115 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8116 <td class="entry_type">
Zhijun Hee36cdbe2013-09-06 14:28:37 -0700[diff] [blame]8117 <span class="entry_type_name">int32</span>
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]8118 <span class="entry_type_container">x</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8119
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]8120 <span class="entry_type_array">
8121 n
8122 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8123 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8124
8125
8126 </td> <!-- entry_type -->
8127
8128 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8129 <p>Lists which camera output streams image data
8130from this capture must be sent to</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8131 </td>
8132
8133 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8134 List of camera stream IDs
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8135 </td>
8136
8137 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]8138 <p>List must only include streams that have been
8139created</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8140 </td>
8141
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8142 <td class="entry_tags">
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]8143 <ul class="entry_tags">
8144 <li><a href="#tag_HAL2">HAL2</a></li>
8145 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8146 </td>
8147
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8148 </tr>
8149 <tr class="entries_header">
8150 <th class="th_details" colspan="5">Details</th>
8151 </tr>
8152 <tr class="entry_cont">
8153 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8154 <p>If no output streams are listed,<wbr/> then the image
8155data should simply be discarded.<wbr/> The image data must
8156still be captured for metadata and statistics production,<wbr/>
8157and the lens and flash must operate as requested.<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8158 </td>
8159 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8160
8161
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8162 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8163 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8164
8165
8166 <tr class="entry" id="controls_android.request.type">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8167 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8168 android.<wbr/>request.<wbr/>type
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8169 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8170 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8171 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8172
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8173 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8174
8175 <ul class="entry_type_enum">
8176 <li>
8177 <span class="entry_type_enum_name">CAPTURE</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]8178 <span class="entry_type_enum_notes"><p>Capture a new image from the imaging hardware,<wbr/>
8179and process it according to the
8180settings</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8181 </li>
8182 <li>
8183 <span class="entry_type_enum_name">REPROCESS</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]8184 <span class="entry_type_enum_notes"><p>Process previously captured data; the
8185android.<wbr/>request.<wbr/>input<wbr/>Stream parameter determines the
8186source reprocessing stream.<wbr/> TODO: Mark dynamic metadata
8187needed for reprocessing with [RP]</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8188 </li>
8189 </ul>
8190
8191 </td> <!-- entry_type -->
8192
8193 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8194 <p>The type of the request; either CAPTURE or
8195REPROCESS.<wbr/> For HAL3,<wbr/> this tag is redundant.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8196 </td>
8197
8198 <td class="entry_units">
8199 </td>
8200
8201 <td class="entry_range">
8202 </td>
8203
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8204 <td class="entry_tags">
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]8205 <ul class="entry_tags">
8206 <li><a href="#tag_HAL2">HAL2</a></li>
8207 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8208 </td>
8209
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8210 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8211
8212
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8213 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8214 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8215
8216
8217
8218 <!-- end of kind -->
8219 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8220 <tr><td colspan="6" class="kind">static</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8221
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8222 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8223 <tr>
8224 <th class="th_name">Property Name</th>
8225 <th class="th_type">Type</th>
8226 <th class="th_description">Description</th>
8227 <th class="th_units">Units</th>
8228 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8229 <th class="th_tags">Tags</th>
8230 </tr>
8231 </thead>
8232
8233 <tbody>
8234
8235
8236
8237
8238
8239
8240
8241
8242
8243
8244 <tr class="entry" id="static_android.request.maxNumOutputStreams">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8245 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8246 android.<wbr/>request.<wbr/>max<wbr/>Num<wbr/>Output<wbr/>Streams
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8247 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8248 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8249 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8250 <span class="entry_type_container">x</span>
8251
8252 <span class="entry_type_array">
8253 3
8254 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8255 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8256
8257
8258 </td> <!-- entry_type -->
8259
8260 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8261 <p>How many output streams can be allocated at
8262the same time for each type of stream</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8263 </td>
8264
8265 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8266 The number of raw sensor streams; the number of
8267 processed,<wbr/> uncompressed streams; and the number of
8268 JPEG-compressed streams
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8269 </td>
8270
8271 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame]8272 <p>&gt;=1 for Raw and JPEG-compressed stream.<wbr/> &gt;= 3
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]8273for processed,<wbr/> uncompressed streams</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8274 </td>
8275
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8276 <td class="entry_tags">
8277 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]8278 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8279 </ul>
8280 </td>
8281
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8282 </tr>
8283 <tr class="entries_header">
8284 <th class="th_details" colspan="5">Details</th>
8285 </tr>
8286 <tr class="entry_cont">
8287 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8288 <p>Video snapshot with preview callbacks requires 3
8289processed streams (preview,<wbr/> record,<wbr/> app callbacks) and
8290one JPEG stream (snapshot)</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8291 </td>
8292 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8293
8294
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8295 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8296 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8297
8298
8299 <tr class="entry" id="static_android.request.maxNumReprocessStreams">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8300 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8301 android.<wbr/>request.<wbr/>max<wbr/>Num<wbr/>Reprocess<wbr/>Streams
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8302 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8303 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8304 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8305 <span class="entry_type_container">x</span>
8306
8307 <span class="entry_type_array">
8308 1
8309 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8310 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8311
8312
8313 </td> <!-- entry_type -->
8314
8315 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8316 <p>How many reprocessing streams of any type
8317can be allocated at the same time</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8318 </td>
8319
8320 <td class="entry_units">
8321 </td>
8322
8323 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame]8324 <p>&gt;= 1</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8325 </td>
8326
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8327 <td class="entry_tags">
8328 </td>
8329
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8330 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8331
8332
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8333 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8334 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8335
8336
8337
8338 <!-- end of kind -->
8339 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8340 <tr><td colspan="6" class="kind">dynamic</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8341
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8342 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8343 <tr>
8344 <th class="th_name">Property Name</th>
8345 <th class="th_type">Type</th>
8346 <th class="th_description">Description</th>
8347 <th class="th_units">Units</th>
8348 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8349 <th class="th_tags">Tags</th>
8350 </tr>
8351 </thead>
8352
8353 <tbody>
8354
8355
8356
8357
8358
8359
8360
8361
8362
8363
8364 <tr class="entry" id="dynamic_android.request.frameCount">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8365 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8366 android.<wbr/>request.<wbr/>frame<wbr/>Count
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8367 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8368 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8369 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8370
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8371 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8372
8373
8374 </td> <!-- entry_type -->
8375
8376 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8377 <p>A frame counter set by the framework.<wbr/> This value monotonically
8378increases with every new result (that is,<wbr/> each new result has a unique
8379frameCount value).<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8380 </td>
8381
8382 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8383 count of frames
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8384 </td>
8385
8386 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame]8387 <p>&gt; 0</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8388 </td>
8389
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8390 <td class="entry_tags">
8391 </td>
8392
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8393 </tr>
8394 <tr class="entries_header">
8395 <th class="th_details" colspan="5">Details</th>
8396 </tr>
8397 <tr class="entry_cont">
8398 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8399 <p>Reset on release()</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8400 </td>
8401 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8402
8403
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8404 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8405 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8406
8407
8408 <tr class="entry" id="dynamic_android.request.id">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8409 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8410 android.<wbr/>request.<wbr/>id
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8411 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8412 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8413 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8414
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8415 <span class="entry_type_visibility"> [hidden]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8416
8417
8418 </td> <!-- entry_type -->
8419
8420 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8421 <p>An application-specified ID for the current
8422request.<wbr/> Must be maintained unchanged in output
8423frame</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8424 </td>
8425
8426 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8427 arbitrary integer assigned by application
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8428 </td>
8429
8430 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]8431 <p>Any int</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8432 </td>
8433
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8434 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]8435 <ul class="entry_tags">
8436 <li><a href="#tag_V1">V1</a></li>
8437 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8438 </td>
8439
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8440 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8441
8442
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8443 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8444 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8445
8446
8447 <tr class="entry" id="dynamic_android.request.metadataMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8448 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8449 android.<wbr/>request.<wbr/>metadata<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8450 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8451 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8452 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8453
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8454 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8455
8456 <ul class="entry_type_enum">
8457 <li>
8458 <span class="entry_type_enum_name">NONE</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]8459 <span class="entry_type_enum_notes"><p>No metadata should be produced on output,<wbr/> except
8460for application-bound buffer data.<wbr/> If no
8461application-bound streams exist,<wbr/> no frame should be
8462placed in the output frame queue.<wbr/> If such streams
8463exist,<wbr/> a frame should be placed on the output queue
8464with null metadata but with the necessary output buffer
8465information.<wbr/> Timestamp information should still be
8466included with any output stream buffers</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8467 </li>
8468 <li>
8469 <span class="entry_type_enum_name">FULL</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]8470 <span class="entry_type_enum_notes"><p>All metadata should be produced.<wbr/> Statistics will
8471only be produced if they are separately
8472enabled</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8473 </li>
8474 </ul>
8475
8476 </td> <!-- entry_type -->
8477
8478 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8479 <p>How much metadata to produce on
8480output</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8481 </td>
8482
8483 <td class="entry_units">
8484 </td>
8485
8486 <td class="entry_range">
8487 </td>
8488
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8489 <td class="entry_tags">
8490 </td>
8491
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8492 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8493
8494
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8495 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8496 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8497
8498
8499 <tr class="entry" id="dynamic_android.request.outputStreams">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8500 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8501 android.<wbr/>request.<wbr/>output<wbr/>Streams
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8502 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8503 <td class="entry_type">
Zhijun Hee36cdbe2013-09-06 14:28:37 -0700[diff] [blame]8504 <span class="entry_type_name">int32</span>
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]8505 <span class="entry_type_container">x</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8506
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]8507 <span class="entry_type_array">
8508 n
8509 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8510 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8511
8512
8513 </td> <!-- entry_type -->
8514
8515 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8516 <p>Lists which camera output streams image data
8517from this capture must be sent to</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8518 </td>
8519
8520 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8521 List of camera stream IDs
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8522 </td>
8523
8524 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]8525 <p>List must only include streams that have been
8526created</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8527 </td>
8528
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8529 <td class="entry_tags">
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]8530 <ul class="entry_tags">
8531 <li><a href="#tag_HAL2">HAL2</a></li>
8532 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8533 </td>
8534
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8535 </tr>
8536 <tr class="entries_header">
8537 <th class="th_details" colspan="5">Details</th>
8538 </tr>
8539 <tr class="entry_cont">
8540 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8541 <p>If no output streams are listed,<wbr/> then the image
8542data should simply be discarded.<wbr/> The image data must
8543still be captured for metadata and statistics production,<wbr/>
8544and the lens and flash must operate as requested.<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8545 </td>
8546 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8547
8548
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8549 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8550 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8551
8552
8553
8554 <!-- end of kind -->
8555 </tbody>
8556
8557 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8558 <tr><td colspan="6" id="section_scaler" class="section">scaler</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8559
8560
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8561 <tr><td colspan="6" class="kind">controls</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8562
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8563 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8564 <tr>
8565 <th class="th_name">Property Name</th>
8566 <th class="th_type">Type</th>
8567 <th class="th_description">Description</th>
8568 <th class="th_units">Units</th>
8569 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8570 <th class="th_tags">Tags</th>
8571 </tr>
8572 </thead>
8573
8574 <tbody>
8575
8576
8577
8578
8579
8580
8581
8582
8583
8584
8585 <tr class="entry" id="controls_android.scaler.cropRegion">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8586 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8587 android.<wbr/>scaler.<wbr/>crop<wbr/>Region
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8588 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8589 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8590 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8591 <span class="entry_type_container">x</span>
8592
8593 <span class="entry_type_array">
Eino-Ville Talvalae04ec6e2013-04-16 15:35:18 -0700[diff] [blame]8594 4
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8595 </span>
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]8596 <span class="entry_type_visibility"> [public as rectangle]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8597
8598
8599 </td> <!-- entry_type -->
8600
8601 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8602 <p>(x,<wbr/> y,<wbr/> width,<wbr/> height).<wbr/></p>
8603<p>A rectangle with the top-level corner of (x,<wbr/>y) and size
8604(width,<wbr/> height).<wbr/> The region of the sensor that is used for
8605output.<wbr/> Each stream must use this rectangle to produce its
8606output,<wbr/> cropping to a smaller region if necessary to
8607maintain the stream's aspect ratio.<wbr/></p>
8608<p>HAL2.<wbr/>x uses only (x,<wbr/> y,<wbr/> width)</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8609 </td>
8610
8611 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8612 (x,<wbr/>y) of top-left corner,<wbr/> width and height of region
8613 in pixels; (0,<wbr/>0) is top-left corner of
8614 android.<wbr/>sensor.<wbr/>active<wbr/>Array<wbr/>Size
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8615 </td>
8616
8617 <td class="entry_range">
8618 </td>
8619
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8620 <td class="entry_tags">
8621 <ul class="entry_tags">
8622 <li><a href="#tag_BC">BC</a></li>
8623 </ul>
8624 </td>
8625
8626 </tr>
8627 <tr class="entries_header">
8628 <th class="th_details" colspan="5">Details</th>
8629 </tr>
8630 <tr class="entry_cont">
8631 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8632 <p>Any additional per-stream cropping must be done to
8633maximize the final pixel area of the stream.<wbr/></p>
8634<p>For example,<wbr/> if the crop region is set to a 4:3 aspect
8635ratio,<wbr/> then 4:3 streams should use the exact crop
8636region.<wbr/> 16:9 streams should further crop vertically
8637(letterbox).<wbr/></p>
8638<p>Conversely,<wbr/> if the crop region is set to a 16:9,<wbr/> then 4:3
8639outputs should crop horizontally (pillarbox),<wbr/> and 16:9
8640streams should match exactly.<wbr/> These additional crops must
8641be centered within the crop region.<wbr/></p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]8642<p>The output streams must maintain square pixels at all
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8643times,<wbr/> no matter what the relative aspect ratios of the
8644crop region and the stream are.<wbr/> Negative values for
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]8645corner are allowed for raw output if full pixel array is
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8646larger than active pixel array.<wbr/> Width and height may be
8647rounded to nearest larger supportable width,<wbr/> especially
8648for raw output,<wbr/> where only a few fixed scales may be
8649possible.<wbr/> The width and height of the crop region cannot
8650be set to be smaller than floor( activeArraySize.<wbr/>width /<wbr/>
8651android.<wbr/>scaler.<wbr/>max<wbr/>Digital<wbr/>Zoom ) and floor(
8652activeArraySize.<wbr/>height /<wbr/> android.<wbr/>scaler.<wbr/>max<wbr/>Digital<wbr/>Zoom),<wbr/>
8653respectively.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8654 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8655 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8656
8657
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8658 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8659 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8660
8661
8662
8663 <!-- end of kind -->
8664 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8665 <tr><td colspan="6" class="kind">static</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8666
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8667 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8668 <tr>
8669 <th class="th_name">Property Name</th>
8670 <th class="th_type">Type</th>
8671 <th class="th_description">Description</th>
8672 <th class="th_units">Units</th>
8673 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8674 <th class="th_tags">Tags</th>
8675 </tr>
8676 </thead>
8677
8678 <tbody>
8679
8680
8681
8682
8683
8684
8685
8686
8687
8688
8689 <tr class="entry" id="static_android.scaler.availableFormats">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8690 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8691 android.<wbr/>scaler.<wbr/>available<wbr/>Formats
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8692 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8693 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8694 <span class="entry_type_name entry_type_name_enum">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8695 <span class="entry_type_container">x</span>
8696
8697 <span class="entry_type_array">
8698 n
8699 </span>
Eino-Ville Talvalad4e240a2013-08-08 12:56:37 -0700[diff] [blame]8700 <span class="entry_type_visibility"> [public as imageFormat]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8701 <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]8702
8703 <ul class="entry_type_enum">
8704 <li>
8705 <span class="entry_type_enum_name">RAW_SENSOR</span>
8706 <span class="entry_type_enum_value">0x20</span>
8707 </li>
8708 <li>
8709 <span class="entry_type_enum_name">YV12</span>
8710 <span class="entry_type_enum_value">0x32315659</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]8711 <span class="entry_type_enum_notes"><p>YCrCb 4:2:0 Planar</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8712 </li>
8713 <li>
Zhijun Hec2eebff2013-05-16 17:49:35 -0700[diff] [blame]8714 <span class="entry_type_enum_name">YCrCb_420_SP</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8715 <span class="entry_type_enum_value">0x11</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]8716 <span class="entry_type_enum_notes"><p>NV21</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8717 </li>
8718 <li>
Zhijun Hec2eebff2013-05-16 17:49:35 -0700[diff] [blame]8719 <span class="entry_type_enum_name">IMPLEMENTATION_DEFINED</span>
8720 <span class="entry_type_enum_value">0x22</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]8721 <span class="entry_type_enum_notes"><p>Hal Implementation Defined</p></span>
Zhijun Hec2eebff2013-05-16 17:49:35 -0700[diff] [blame]8722 </li>
8723 <li>
8724 <span class="entry_type_enum_name">YCbCr_420_888</span>
8725 <span class="entry_type_enum_value">0x23</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]8726 <span class="entry_type_enum_notes"><p>Flexible YUV420 Format</p></span>
Zhijun Hec2eebff2013-05-16 17:49:35 -0700[diff] [blame]8727 </li>
8728 <li>
8729 <span class="entry_type_enum_name">BLOB</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8730 <span class="entry_type_enum_value">0x21</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]8731 <span class="entry_type_enum_notes"><p>JPEG</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8732 </li>
8733 </ul>
8734
8735 </td> <!-- entry_type -->
8736
8737 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8738 <p>List of app-visible formats</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8739 </td>
8740
8741 <td class="entry_units">
8742 </td>
8743
8744 <td class="entry_range">
8745 </td>
8746
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8747 <td class="entry_tags">
8748 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]8749 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8750 </ul>
8751 </td>
8752
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8753 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8754
8755
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8756 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8757 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8758
8759
8760 <tr class="entry" id="static_android.scaler.availableJpegMinDurations">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8761 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8762 android.<wbr/>scaler.<wbr/>available<wbr/>Jpeg<wbr/>Min<wbr/>Durations
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8763 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8764 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8765 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8766 <span class="entry_type_container">x</span>
8767
8768 <span class="entry_type_array">
8769 n
8770 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8771 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8772
8773
8774 </td> <!-- entry_type -->
8775
8776 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8777 <p>The minimum frame duration that is supported
8778for each resolution in availableJpegSizes.<wbr/> Should
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]8779correspond to the frame duration when only that JPEG
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8780stream is active and captured in a burst,<wbr/> with all
8781processing set to FAST</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8782 </td>
8783
8784 <td class="entry_units">
8785 </td>
8786
8787 <td class="entry_range">
8788 </td>
8789
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8790 <td class="entry_tags">
8791 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]8792 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8793 </ul>
8794 </td>
8795
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8796 </tr>
8797 <tr class="entries_header">
8798 <th class="th_details" colspan="5">Details</th>
8799 </tr>
8800 <tr class="entry_cont">
8801 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8802 <p>When multiple streams are configured,<wbr/> the minimum
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8803frame duration will be &gt;= max(individual stream min
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8804durations)</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8805 </td>
8806 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8807
8808
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8809 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8810 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8811
8812
8813 <tr class="entry" id="static_android.scaler.availableJpegSizes">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8814 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8815 android.<wbr/>scaler.<wbr/>available<wbr/>Jpeg<wbr/>Sizes
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8816 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8817 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8818 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8819 <span class="entry_type_container">x</span>
8820
8821 <span class="entry_type_array">
8822 n x 2
8823 </span>
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]8824 <span class="entry_type_visibility"> [public as size]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8825
8826
8827 </td> <!-- entry_type -->
8828
8829 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8830 <p>The resolutions available for output from
8831the JPEG block.<wbr/> Listed as width x height</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8832 </td>
8833
8834 <td class="entry_units">
8835 </td>
8836
8837 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]8838 <p>Must include: - sensor maximum resolution Should
8839include: - half/<wbr/>quarter max resolution</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8840 </td>
8841
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8842 <td class="entry_tags">
8843 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]8844 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8845 </ul>
8846 </td>
8847
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8848 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8849
8850
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8851 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8852 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8853
8854
8855 <tr class="entry" id="static_android.scaler.availableMaxDigitalZoom">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8856 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8857 android.<wbr/>scaler.<wbr/>available<wbr/>Max<wbr/>Digital<wbr/>Zoom
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8858 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8859 <td class="entry_type">
Igor Murashkinf11a4df2013-05-07 10:00:46 -0700[diff] [blame]8860 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8861
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8862 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8863
8864
8865 </td> <!-- entry_type -->
8866
8867 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8868 <p>The maximum ratio between active area width
8869and crop region width,<wbr/> or between active area height and
8870crop region height,<wbr/> if the crop region height is larger
8871than width</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8872 </td>
8873
8874 <td class="entry_units">
8875 </td>
8876
8877 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame]8878 <p>&gt;=1</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8879 </td>
8880
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8881 <td class="entry_tags">
Igor Murashkinf11a4df2013-05-07 10:00:46 -0700[diff] [blame]8882 <ul class="entry_tags">
8883 <li><a href="#tag_BC">BC</a></li>
8884 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8885 </td>
8886
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8887 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8888
8889
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8890 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8891 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8892
8893
8894 <tr class="entry" id="static_android.scaler.availableProcessedMinDurations">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8895 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8896 android.<wbr/>scaler.<wbr/>available<wbr/>Processed<wbr/>Min<wbr/>Durations
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8897 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8898 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8899 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8900 <span class="entry_type_container">x</span>
8901
8902 <span class="entry_type_array">
8903 n
8904 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8905 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8906
8907
8908 </td> <!-- entry_type -->
8909
8910 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8911 <p>The minimum frame duration that is supported
8912for each resolution in availableProcessedSizes.<wbr/> Should
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]8913correspond to the frame duration when only that processed
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8914stream is active,<wbr/> with all processing set to
8915FAST</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">
8922 </td>
8923
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8924 <td class="entry_tags">
8925 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]8926 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8927 </ul>
8928 </td>
8929
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8930 </tr>
8931 <tr class="entries_header">
8932 <th class="th_details" colspan="5">Details</th>
8933 </tr>
8934 <tr class="entry_cont">
8935 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8936 <p>When multiple streams are configured,<wbr/> the minimum
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8937frame duration will be &gt;= max(individual stream min
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8938durations)</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8939 </td>
8940 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8941
8942
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8943 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8944 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8945
8946
8947 <tr class="entry" id="static_android.scaler.availableProcessedSizes">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8948 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8949 android.<wbr/>scaler.<wbr/>available<wbr/>Processed<wbr/>Sizes
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8950 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8951 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8952 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8953 <span class="entry_type_container">x</span>
8954
8955 <span class="entry_type_array">
8956 n x 2
8957 </span>
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]8958 <span class="entry_type_visibility"> [public as size]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8959
8960
8961 </td> <!-- entry_type -->
8962
8963 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8964 <p>The resolutions available for use with
8965processed output streams,<wbr/> such as YV12,<wbr/> NV12,<wbr/> and
8966platform opaque YUV/<wbr/>RGB streams to the GPU or video
8967encoders.<wbr/> Listed as width,<wbr/> height</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8968 </td>
8969
8970 <td class="entry_units">
8971 </td>
8972
8973 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]8974 <p>Must include: - sensor maximum resolution -
8975standard QCIF,<wbr/> 240p,<wbr/> 480p,<wbr/> 720p,<wbr/> and 1080p
8976resolutions</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8977 </td>
8978
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8979 <td class="entry_tags">
8980 <ul class="entry_tags">
8981 <li><a href="#tag_BC">BC</a></li>
8982 </ul>
8983 </td>
8984
8985 </tr>
8986 <tr class="entries_header">
8987 <th class="th_details" colspan="5">Details</th>
8988 </tr>
8989 <tr class="entry_cont">
8990 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8991 <p>The actual supported resolution list may be limited by
8992consumer end points for different use cases.<wbr/> For example,<wbr/> for
8993recording use case,<wbr/> the largest supported resolution may be
8994limited by max supported size from encoder,<wbr/> for preview use
8995case,<wbr/> the largest supported resolution may be limited by max
8996resolution SurfaceTexture/<wbr/>SurfaceView can support.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8997 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8998 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8999
9000
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9001 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9002 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9003
9004
9005 <tr class="entry" id="static_android.scaler.availableRawMinDurations">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9006 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9007 android.<wbr/>scaler.<wbr/>available<wbr/>Raw<wbr/>Min<wbr/>Durations
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9008 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9009 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9010 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9011 <span class="entry_type_container">x</span>
9012
9013 <span class="entry_type_array">
9014 n
9015 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9016 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9017
9018
9019 </td> <!-- entry_type -->
9020
9021 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9022 <p>The minimum frame duration that is supported
9023for each raw resolution in availableRawSizes.<wbr/> Should
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]9024correspond to the frame duration when only the raw stream
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9025is active.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9026 </td>
9027
9028 <td class="entry_units">
9029 </td>
9030
9031 <td class="entry_range">
9032 </td>
9033
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9034 <td class="entry_tags">
9035 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9036 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9037 </ul>
9038 </td>
9039
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9040 </tr>
9041 <tr class="entries_header">
9042 <th class="th_details" colspan="5">Details</th>
9043 </tr>
9044 <tr class="entry_cont">
9045 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9046 <p>When multiple streams are configured,<wbr/> the minimum
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9047frame duration will be &gt;= max(individual stream min
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9048durations)</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9049 </td>
9050 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9051
9052
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9053 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9054 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9055
9056
9057 <tr class="entry" id="static_android.scaler.availableRawSizes">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9058 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9059 android.<wbr/>scaler.<wbr/>available<wbr/>Raw<wbr/>Sizes
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9060 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9061 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9062 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9063 <span class="entry_type_container">x</span>
9064
9065 <span class="entry_type_array">
9066 n x 2
9067 </span>
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]9068 <span class="entry_type_visibility"> [system as size]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9069
9070
9071 </td> <!-- entry_type -->
9072
9073 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9074 <p>The resolutions available for use with raw
9075sensor output streams,<wbr/> listed as width,<wbr/>
9076height</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9077 </td>
9078
9079 <td class="entry_units">
9080 </td>
9081
9082 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]9083 <p>Must include: - sensor maximum resolution</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9084 </td>
9085
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9086 <td class="entry_tags">
9087 </td>
9088
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9089 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9090
9091
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9092 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9093 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9094
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9095
9096
9097 <!-- end of kind -->
9098 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9099 <tr><td colspan="6" class="kind">dynamic</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9100
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9101 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9102 <tr>
9103 <th class="th_name">Property Name</th>
9104 <th class="th_type">Type</th>
9105 <th class="th_description">Description</th>
9106 <th class="th_units">Units</th>
9107 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9108 <th class="th_tags">Tags</th>
9109 </tr>
9110 </thead>
9111
9112 <tbody>
9113
9114
9115
9116
9117
9118
9119
9120
9121
9122
9123 <tr class="entry" id="dynamic_android.scaler.cropRegion">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9124 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9125 android.<wbr/>scaler.<wbr/>crop<wbr/>Region
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9126 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9127 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9128 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9129 <span class="entry_type_container">x</span>
9130
9131 <span class="entry_type_array">
Eino-Ville Talvalae04ec6e2013-04-16 15:35:18 -0700[diff] [blame]9132 4
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9133 </span>
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]9134 <span class="entry_type_visibility"> [public as rectangle]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9135
9136
9137 </td> <!-- entry_type -->
9138
9139 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9140 <p>(x,<wbr/> y,<wbr/> width,<wbr/> height).<wbr/></p>
9141<p>A rectangle with the top-level corner of (x,<wbr/>y) and size
9142(width,<wbr/> height).<wbr/> The region of the sensor that is used for
9143output.<wbr/> Each stream must use this rectangle to produce its
9144output,<wbr/> cropping to a smaller region if necessary to
9145maintain the stream's aspect ratio.<wbr/></p>
9146<p>HAL2.<wbr/>x uses only (x,<wbr/> y,<wbr/> width)</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9147 </td>
9148
9149 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9150 (x,<wbr/>y) of top-left corner,<wbr/> width and height of region
9151 in pixels; (0,<wbr/>0) is top-left corner of
9152 android.<wbr/>sensor.<wbr/>active<wbr/>Array<wbr/>Size
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9153 </td>
9154
9155 <td class="entry_range">
9156 </td>
9157
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9158 <td class="entry_tags">
9159 <ul class="entry_tags">
9160 <li><a href="#tag_BC">BC</a></li>
9161 </ul>
9162 </td>
9163
9164 </tr>
9165 <tr class="entries_header">
9166 <th class="th_details" colspan="5">Details</th>
9167 </tr>
9168 <tr class="entry_cont">
9169 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9170 <p>Any additional per-stream cropping must be done to
9171maximize the final pixel area of the stream.<wbr/></p>
9172<p>For example,<wbr/> if the crop region is set to a 4:3 aspect
9173ratio,<wbr/> then 4:3 streams should use the exact crop
9174region.<wbr/> 16:9 streams should further crop vertically
9175(letterbox).<wbr/></p>
9176<p>Conversely,<wbr/> if the crop region is set to a 16:9,<wbr/> then 4:3
9177outputs should crop horizontally (pillarbox),<wbr/> and 16:9
9178streams should match exactly.<wbr/> These additional crops must
9179be centered within the crop region.<wbr/></p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]9180<p>The output streams must maintain square pixels at all
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9181times,<wbr/> no matter what the relative aspect ratios of the
9182crop region and the stream are.<wbr/> Negative values for
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]9183corner are allowed for raw output if full pixel array is
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9184larger than active pixel array.<wbr/> Width and height may be
9185rounded to nearest larger supportable width,<wbr/> especially
9186for raw output,<wbr/> where only a few fixed scales may be
9187possible.<wbr/> The width and height of the crop region cannot
9188be set to be smaller than floor( activeArraySize.<wbr/>width /<wbr/>
9189android.<wbr/>scaler.<wbr/>max<wbr/>Digital<wbr/>Zoom ) and floor(
9190activeArraySize.<wbr/>height /<wbr/> android.<wbr/>scaler.<wbr/>max<wbr/>Digital<wbr/>Zoom),<wbr/>
9191respectively.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9192 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9193 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9194
9195
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9196 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9197 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9198
9199
9200
9201 <!-- end of kind -->
9202 </tbody>
9203
9204 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9205 <tr><td colspan="6" id="section_sensor" class="section">sensor</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9206
9207
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9208 <tr><td colspan="6" class="kind">controls</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9209
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9210 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9211 <tr>
9212 <th class="th_name">Property Name</th>
9213 <th class="th_type">Type</th>
9214 <th class="th_description">Description</th>
9215 <th class="th_units">Units</th>
9216 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9217 <th class="th_tags">Tags</th>
9218 </tr>
9219 </thead>
9220
9221 <tbody>
9222
9223
9224
9225
9226
9227
9228
9229
9230
9231
9232 <tr class="entry" id="controls_android.sensor.exposureTime">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9233 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9234 android.<wbr/>sensor.<wbr/>exposure<wbr/>Time
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9235 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9236 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9237 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9238
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9239 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9240
9241
9242 </td> <!-- entry_type -->
9243
9244 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9245 <p>Duration each pixel is exposed to
9246light.<wbr/></p>
9247<p>If the sensor can't expose this exact duration,<wbr/> it should shorten the
9248duration exposed to the nearest possible value (rather than expose longer).<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9249 </td>
9250
9251 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9252 nanoseconds
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9253 </td>
9254
9255 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]9256 <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]9257 </td>
9258
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9259 <td class="entry_tags">
9260 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9261 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9262 </ul>
9263 </td>
9264
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9265 </tr>
9266 <tr class="entries_header">
9267 <th class="th_details" colspan="5">Details</th>
9268 </tr>
9269 <tr class="entry_cont">
9270 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9271 <p>1/<wbr/>10000 - 30 sec range.<wbr/> No bulb mode</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9272 </td>
9273 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9274
9275
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9276 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9277 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9278
9279
9280 <tr class="entry" id="controls_android.sensor.frameDuration">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9281 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9282 android.<wbr/>sensor.<wbr/>frame<wbr/>Duration
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9283 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9284 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9285 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9286
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9287 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9288
9289
9290 </td> <!-- entry_type -->
9291
9292 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9293 <p>Duration from start of frame exposure to
9294start of next frame exposure</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9295 </td>
9296
9297 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9298 nanoseconds
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9299 </td>
9300
9301 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]9302 <p>see <a href="#static_android.sensor.info.maxFrameDuration">android.<wbr/>sensor.<wbr/>info.<wbr/>max<wbr/>Frame<wbr/>Duration</a>,<wbr/>
9303android.<wbr/>scaler.<wbr/>info.<wbr/>available<wbr/>Min<wbr/>Frame<wbr/>Durations</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9304 </td>
9305
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9306 <td class="entry_tags">
9307 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9308 <li><a href="#tag_V1">V1</a></li>
9309 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9310 </ul>
9311 </td>
9312
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9313 </tr>
9314 <tr class="entries_header">
9315 <th class="th_details" colspan="5">Details</th>
9316 </tr>
9317 <tr class="entry_cont">
9318 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9319 <p>Exposure time has priority,<wbr/> so duration is set to
9320max(duration,<wbr/> exposure time + overhead)</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9321 </td>
9322 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9323
9324
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9325 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9326 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9327
9328
9329 <tr class="entry" id="controls_android.sensor.sensitivity">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9330 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9331 android.<wbr/>sensor.<wbr/>sensitivity
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9332 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9333 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9334 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9335
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9336 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9337
9338
9339 </td> <!-- entry_type -->
9340
9341 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9342 <p>Gain applied to image data.<wbr/> Must be
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]9343implemented through analog gain only if set to values
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9344below 'maximum analog sensitivity'.<wbr/></p>
9345<p>If the sensor can't apply this exact gain,<wbr/> it should lessen the
9346gain to the nearest possible value (rather than gain more).<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9347 </td>
9348
9349 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9350 ISO arithmetic units
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9351 </td>
9352
9353 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]9354 <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]9355 </td>
9356
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9357 <td class="entry_tags">
9358 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9359 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9360 </ul>
9361 </td>
9362
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9363 </tr>
9364 <tr class="entries_header">
9365 <th class="th_details" colspan="5">Details</th>
9366 </tr>
9367 <tr class="entry_cont">
9368 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9369 <p>ISO 12232:2006 REI method</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9370 </td>
9371 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9372
9373
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9374 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9375 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9376
9377
9378
9379 <!-- end of kind -->
9380 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9381 <tr><td colspan="6" class="kind">static</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9382
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9383 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9384 <tr>
9385 <th class="th_name">Property Name</th>
9386 <th class="th_type">Type</th>
9387 <th class="th_description">Description</th>
9388 <th class="th_units">Units</th>
9389 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9390 <th class="th_tags">Tags</th>
9391 </tr>
9392 </thead>
9393
9394 <tbody>
9395
9396
9397
9398
9399
9400
9401
9402
9403
9404
9405
9406
9407 <tr class="entry" id="static_android.sensor.info.activeArraySize">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9408 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9409 android.<wbr/>sensor.<wbr/>info.<wbr/>active<wbr/>Array<wbr/>Size
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9410 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9411 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9412 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9413 <span class="entry_type_container">x</span>
9414
9415 <span class="entry_type_array">
9416 4
9417 </span>
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]9418 <span class="entry_type_visibility"> [public as rectangle]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9419 <div class="entry_type_notes">Four ints defining the active pixel rectangle</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9420
9421
9422 </td> <!-- entry_type -->
9423
9424 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9425 <p>Area of raw data which corresponds to only
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]9426active pixels; smaller or equal to
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9427pixelArraySize.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9428 </td>
9429
9430 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9431 xmin,<wbr/> ymin,<wbr/> width,<wbr/> height.<wbr/> Top left of full
9432 pixel array is (0,<wbr/>0)
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9433 </td>
9434
9435 <td class="entry_range">
9436 </td>
9437
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9438 <td class="entry_tags">
9439 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9440 <li><a href="#tag_DNG">DNG</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9441 </ul>
9442 </td>
9443
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9444 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9445
9446
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9447 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9448 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9449
9450
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]9451 <tr class="entry" id="static_android.sensor.info.sensitivityRange">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9452 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9453 android.<wbr/>sensor.<wbr/>info.<wbr/>sensitivity<wbr/>Range
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9454 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9455 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9456 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9457 <span class="entry_type_container">x</span>
9458
9459 <span class="entry_type_array">
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]9460 2
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9461 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9462 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9463 <div class="entry_type_notes">Range of supported sensitivities</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9464
9465
9466 </td> <!-- entry_type -->
9467
9468 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9469 <p>Range of valid sensitivities</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">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]9476 <p>Min &lt;= 100,<wbr/> Max &gt;= 1600</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">
9480 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9481 <li><a href="#tag_BC">BC</a></li>
9482 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9483 </ul>
9484 </td>
9485
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9486 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9487
9488
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9489 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9490 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9491
9492
9493 <tr class="entry" id="static_android.sensor.info.colorFilterArrangement">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9494 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9495 android.<wbr/>sensor.<wbr/>info.<wbr/>color<wbr/>Filter<wbr/>Arrangement
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9496 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9497 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9498 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9499
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9500 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9501
9502 <ul class="entry_type_enum">
9503 <li>
9504 <span class="entry_type_enum_name">RGGB</span>
9505 </li>
9506 <li>
9507 <span class="entry_type_enum_name">GRBG</span>
9508 </li>
9509 <li>
9510 <span class="entry_type_enum_name">GBRG</span>
9511 </li>
9512 <li>
9513 <span class="entry_type_enum_name">BGGR</span>
9514 </li>
9515 <li>
9516 <span class="entry_type_enum_name">RGB</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]9517 <span class="entry_type_enum_notes"><p>Sensor is not Bayer; output has 3 16-bit
9518values for each pixel,<wbr/> instead of just 1 16-bit value
9519per pixel.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9520 </li>
9521 </ul>
9522
9523 </td> <!-- entry_type -->
9524
9525 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9526 <p>Arrangement of color filters on sensor;
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]9527represents the colors in the top-left 2x2 section of
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9528the sensor,<wbr/> in reading order</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9529 </td>
9530
9531 <td class="entry_units">
9532 </td>
9533
9534 <td class="entry_range">
9535 </td>
9536
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9537 <td class="entry_tags">
9538 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9539 <li><a href="#tag_DNG">DNG</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9540 </ul>
9541 </td>
9542
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9543 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9544
9545
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9546 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9547 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9548
9549
9550 <tr class="entry" id="static_android.sensor.info.exposureTimeRange">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9551 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9552 android.<wbr/>sensor.<wbr/>info.<wbr/>exposure<wbr/>Time<wbr/>Range
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9553 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9554 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9555 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9556 <span class="entry_type_container">x</span>
9557
9558 <span class="entry_type_array">
9559 2
9560 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9561 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9562 <div class="entry_type_notes">nanoseconds</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9563
9564
9565 </td> <!-- entry_type -->
9566
9567 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9568 <p>Range of valid exposure
9569times</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9570 </td>
9571
9572 <td class="entry_units">
9573 </td>
9574
9575 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]9576 <p>Min &lt;= 100e3 (100 us),<wbr/> Max &gt;= 30e9 (30
9577sec)</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9578 </td>
9579
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9580 <td class="entry_tags">
9581 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9582 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9583 </ul>
9584 </td>
9585
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9586 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9587
9588
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9589 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9590 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9591
9592
9593 <tr class="entry" id="static_android.sensor.info.maxFrameDuration">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9594 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9595 android.<wbr/>sensor.<wbr/>info.<wbr/>max<wbr/>Frame<wbr/>Duration
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9596 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9597 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9598 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9599
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9600 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9601
9602
9603 </td> <!-- entry_type -->
9604
9605 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9606 <p>Maximum possible frame duration (minimum frame
9607rate)</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9608 </td>
9609
9610 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9611 nanoseconds
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9612 </td>
9613
9614 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame]9615 <p>&gt;= 30e9</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9616 </td>
9617
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9618 <td class="entry_tags">
9619 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9620 <li><a href="#tag_BC">BC</a></li>
9621 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9622 </ul>
9623 </td>
9624
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9625 </tr>
9626 <tr class="entries_header">
9627 <th class="th_details" colspan="5">Details</th>
9628 </tr>
9629 <tr class="entry_cont">
9630 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9631 <p>Minimum duration is a function of resolution,<wbr/>
9632processing settings.<wbr/> See
9633android.<wbr/>scaler.<wbr/>available<wbr/>Processed<wbr/>Min<wbr/>Durations
9634android.<wbr/>scaler.<wbr/>available<wbr/>Jpeg<wbr/>Min<wbr/>Durations
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]9635<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]9636 </td>
9637 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9638
9639
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9640 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9641 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9642
9643
9644 <tr class="entry" id="static_android.sensor.info.physicalSize">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9645 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9646 android.<wbr/>sensor.<wbr/>info.<wbr/>physical<wbr/>Size
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9647 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9648 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9649 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9650 <span class="entry_type_container">x</span>
9651
9652 <span class="entry_type_array">
9653 2
9654 </span>
Timothy Knightec817d52013-08-16 16:15:29 -0700[diff] [blame]9655 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9656 <div class="entry_type_notes">width x height in millimeters</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9657
9658
9659 </td> <!-- entry_type -->
9660
9661 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9662 <p>The physical dimensions of the full pixel
9663array</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9664 </td>
9665
9666 <td class="entry_units">
9667 </td>
9668
9669 <td class="entry_range">
9670 </td>
9671
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9672 <td class="entry_tags">
9673 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9674 <li><a href="#tag_V1">V1</a></li>
9675 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9676 </ul>
9677 </td>
9678
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9679 </tr>
9680 <tr class="entries_header">
9681 <th class="th_details" colspan="5">Details</th>
9682 </tr>
9683 <tr class="entry_cont">
9684 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9685 <p>Needed for FOV calculation for old API</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9686 </td>
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
9693
9694 <tr class="entry" id="static_android.sensor.info.pixelArraySize">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9695 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9696 android.<wbr/>sensor.<wbr/>info.<wbr/>pixel<wbr/>Array<wbr/>Size
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9697 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9698 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9699 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9700 <span class="entry_type_container">x</span>
9701
9702 <span class="entry_type_array">
9703 2
9704 </span>
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]9705 <span class="entry_type_visibility"> [system as size]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9706
9707
9708 </td> <!-- entry_type -->
9709
9710 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9711 <p>Dimensions of full pixel array,<wbr/> possibly
9712including black calibration pixels</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9713 </td>
9714
9715 <td class="entry_units">
9716 </td>
9717
9718 <td class="entry_range">
9719 </td>
9720
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9721 <td class="entry_tags">
9722 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9723 <li><a href="#tag_DNG">DNG</a></li>
9724 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9725 </ul>
9726 </td>
9727
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9728 </tr>
9729 <tr class="entries_header">
9730 <th class="th_details" colspan="5">Details</th>
9731 </tr>
9732 <tr class="entry_cont">
9733 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9734 <p>Maximum output resolution for raw format must
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9735match this in
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9736android.<wbr/>scaler.<wbr/>info.<wbr/>available<wbr/>Sizes<wbr/>Per<wbr/>Format</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9737 </td>
9738 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9739
9740
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9741 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9742 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9743
9744
9745 <tr class="entry" id="static_android.sensor.info.whiteLevel">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9746 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9747 android.<wbr/>sensor.<wbr/>info.<wbr/>white<wbr/>Level
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9748 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9749 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9750 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9751
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9752 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9753
9754
9755 </td> <!-- entry_type -->
9756
9757 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9758 <p>Maximum raw value output by
9759sensor</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9760 </td>
9761
9762 <td class="entry_units">
9763 </td>
9764
9765 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame]9766 <p>&gt; 1024 (10-bit output)</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9767 </td>
9768
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9769 <td class="entry_tags">
9770 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9771 <li><a href="#tag_DNG">DNG</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9772 </ul>
9773 </td>
9774
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9775 </tr>
9776 <tr class="entries_header">
9777 <th class="th_details" colspan="5">Details</th>
9778 </tr>
9779 <tr class="entry_cont">
9780 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9781 <p>Defines sensor bit depth (10-14 bits is
9782expected)</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9783 </td>
9784 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9785
9786
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9787 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9788 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9789
9790
9791
9792
9793
9794 <tr class="entry" id="static_android.sensor.baseGainFactor">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9795 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9796 android.<wbr/>sensor.<wbr/>base<wbr/>Gain<wbr/>Factor
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9797 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9798 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9799 <span class="entry_type_name">rational</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9800
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9801 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9802
9803
9804 </td> <!-- entry_type -->
9805
9806 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9807 <p>Gain factor from electrons to raw units when
9808ISO=100</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9809 </td>
9810
9811 <td class="entry_units">
9812 </td>
9813
9814 <td class="entry_range">
9815 </td>
9816
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9817 <td class="entry_tags">
9818 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9819 <li><a href="#tag_V1">V1</a></li>
Alex Rayef40ad62013-10-01 17:52:33 -0700[diff] [blame]9820 <li><a href="#tag_FULL">FULL</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9821 </ul>
9822 </td>
9823
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9824 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9825
9826
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9827 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9828 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9829
9830
9831 <tr class="entry" id="static_android.sensor.blackLevelPattern">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9832 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9833 android.<wbr/>sensor.<wbr/>black<wbr/>Level<wbr/>Pattern
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9834 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9835 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9836 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9837 <span class="entry_type_container">x</span>
9838
9839 <span class="entry_type_array">
9840 4
9841 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9842 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9843 <div class="entry_type_notes">2x2 raw count block</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9844
9845
9846 </td> <!-- entry_type -->
9847
9848 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9849 <p>A fixed black level offset for each of the
9850Bayer mosaic channels</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9851 </td>
9852
9853 <td class="entry_units">
9854 </td>
9855
9856 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame]9857 <p>&gt;= 0 each</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9858 </td>
9859
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9860 <td class="entry_tags">
9861 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9862 <li><a href="#tag_DNG">DNG</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9863 </ul>
9864 </td>
9865
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9866 </tr>
9867 <tr class="entries_header">
9868 <th class="th_details" colspan="5">Details</th>
9869 </tr>
9870 <tr class="entry_cont">
9871 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9872 <p>As per DNG BlackLevelRepeatDim /<wbr/> BlackLevel
9873tags</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9874 </td>
9875 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9876
9877
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9878 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9879 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9880
9881
9882 <tr class="entry" id="static_android.sensor.calibrationTransform1">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9883 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9884 android.<wbr/>sensor.<wbr/>calibration<wbr/>Transform1
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9885 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9886 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9887 <span class="entry_type_name">rational</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9888 <span class="entry_type_container">x</span>
9889
9890 <span class="entry_type_array">
9891 9
9892 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9893 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9894 <div class="entry_type_notes">3x3 matrix in row-major-order</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9895
9896
9897 </td> <!-- entry_type -->
9898
9899 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9900 <p>Per-device calibration on top of color space
9901transform 1</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9902 </td>
9903
9904 <td class="entry_units">
9905 </td>
9906
9907 <td class="entry_range">
9908 </td>
9909
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9910 <td class="entry_tags">
9911 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9912 <li><a href="#tag_DNG">DNG</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9913 </ul>
9914 </td>
9915
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9916 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9917
9918
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9919 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9920 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9921
9922
9923 <tr class="entry" id="static_android.sensor.calibrationTransform2">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9924 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9925 android.<wbr/>sensor.<wbr/>calibration<wbr/>Transform2
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9926 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9927 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9928 <span class="entry_type_name">rational</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9929 <span class="entry_type_container">x</span>
9930
9931 <span class="entry_type_array">
9932 9
9933 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9934 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9935 <div class="entry_type_notes">3x3 matrix in row-major-order</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9936
9937
9938 </td> <!-- entry_type -->
9939
9940 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9941 <p>Per-device calibration on top of color space
9942transform 2</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9943 </td>
9944
9945 <td class="entry_units">
9946 </td>
9947
9948 <td class="entry_range">
9949 </td>
9950
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9951 <td class="entry_tags">
9952 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9953 <li><a href="#tag_DNG">DNG</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9954 </ul>
9955 </td>
9956
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9957 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9958
9959
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9960 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9961 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9962
9963
9964 <tr class="entry" id="static_android.sensor.colorTransform1">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9965 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9966 android.<wbr/>sensor.<wbr/>color<wbr/>Transform1
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9967 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9968 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9969 <span class="entry_type_name">rational</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9970 <span class="entry_type_container">x</span>
9971
9972 <span class="entry_type_array">
9973 9
9974 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9975 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9976 <div class="entry_type_notes">3x3 matrix in row-major-order</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9977
9978
9979 </td> <!-- entry_type -->
9980
9981 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9982 <p>Linear mapping from XYZ (D50) color space to
9983reference linear sensor color,<wbr/> for first reference
9984illuminant</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9985 </td>
9986
9987 <td class="entry_units">
9988 </td>
9989
9990 <td class="entry_range">
9991 </td>
9992
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9993 <td class="entry_tags">
9994 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9995 <li><a href="#tag_DNG">DNG</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9996 </ul>
9997 </td>
9998
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9999 </tr>
10000 <tr class="entries_header">
10001 <th class="th_details" colspan="5">Details</th>
10002 </tr>
10003 <tr class="entry_cont">
10004 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10005 <p>Use as follows XYZ = inv(transform) * clip( (raw -
10006black level(raw) ) /<wbr/> ( white level - max black level) ).<wbr/>
10007At least in the simple case</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10008 </td>
10009 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10010
10011
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10012 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10013 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10014
10015
10016 <tr class="entry" id="static_android.sensor.colorTransform2">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10017 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10018 android.<wbr/>sensor.<wbr/>color<wbr/>Transform2
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10019 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10020 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10021 <span class="entry_type_name">rational</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10022 <span class="entry_type_container">x</span>
10023
10024 <span class="entry_type_array">
10025 9
10026 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10027 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10028 <div class="entry_type_notes">3x3 matrix in row-major-order</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10029
10030
10031 </td> <!-- entry_type -->
10032
10033 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10034 <p>Linear mapping from XYZ (D50) color space to
10035reference linear sensor color,<wbr/> for second reference
10036illuminant</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10037 </td>
10038
10039 <td class="entry_units">
10040 </td>
10041
10042 <td class="entry_range">
10043 </td>
10044
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10045 <td class="entry_tags">
10046 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]10047 <li><a href="#tag_DNG">DNG</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10048 </ul>
10049 </td>
10050
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10051 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10052
10053
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10054 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10055 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10056
10057
10058 <tr class="entry" id="static_android.sensor.forwardMatrix1">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10059 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10060 android.<wbr/>sensor.<wbr/>forward<wbr/>Matrix1
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10061 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10062 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10063 <span class="entry_type_name">rational</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10064 <span class="entry_type_container">x</span>
10065
10066 <span class="entry_type_array">
10067 9
10068 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10069 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10070 <div class="entry_type_notes">3x3 matrix in row-major-order</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10071
10072
10073 </td> <!-- entry_type -->
10074
10075 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10076 <p>Used by DNG for better WB
10077adaptation</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10078 </td>
10079
10080 <td class="entry_units">
10081 </td>
10082
10083 <td class="entry_range">
10084 </td>
10085
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10086 <td class="entry_tags">
10087 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]10088 <li><a href="#tag_DNG">DNG</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10089 </ul>
10090 </td>
10091
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10092 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10093
10094
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10095 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10096 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10097
10098
10099 <tr class="entry" id="static_android.sensor.forwardMatrix2">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10100 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10101 android.<wbr/>sensor.<wbr/>forward<wbr/>Matrix2
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10102 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10103 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10104 <span class="entry_type_name">rational</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10105 <span class="entry_type_container">x</span>
10106
10107 <span class="entry_type_array">
10108 9
10109 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10110 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10111 <div class="entry_type_notes">3x3 matrix in row-major-order</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10112
10113
10114 </td> <!-- entry_type -->
10115
10116 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10117 <p>Used by DNG for better WB
10118adaptation</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10119 </td>
10120
10121 <td class="entry_units">
10122 </td>
10123
10124 <td class="entry_range">
10125 </td>
10126
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10127 <td class="entry_tags">
10128 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]10129 <li><a href="#tag_DNG">DNG</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10130 </ul>
10131 </td>
10132
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10133 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10134
10135
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10136 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10137 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10138
10139
10140 <tr class="entry" id="static_android.sensor.maxAnalogSensitivity">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10141 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10142 android.<wbr/>sensor.<wbr/>max<wbr/>Analog<wbr/>Sensitivity
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10143 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10144 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10145 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10146
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10147 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10148
10149
10150 </td> <!-- entry_type -->
10151
10152 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10153 <p>Maximum sensitivity that is implemented
10154purely through analog gain</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10155 </td>
10156
10157 <td class="entry_units">
10158 </td>
10159
10160 <td class="entry_range">
10161 </td>
10162
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10163 <td class="entry_tags">
10164 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]10165 <li><a href="#tag_V1">V1</a></li>
Alex Rayef40ad62013-10-01 17:52:33 -0700[diff] [blame]10166 <li><a href="#tag_FULL">FULL</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10167 </ul>
10168 </td>
10169
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10170 </tr>
10171 <tr class="entries_header">
10172 <th class="th_details" colspan="5">Details</th>
10173 </tr>
10174 <tr class="entry_cont">
10175 <td class="entry_details" colspan="5">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]10176 <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]10177equal to this,<wbr/> all applied gain must be analog.<wbr/> For
10178values above this,<wbr/> it can be a mix of analog and
10179digital</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10180 </td>
10181 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10182
10183
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10184 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10185 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10186
10187
10188 <tr class="entry" id="static_android.sensor.noiseModelCoefficients">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10189 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10190 android.<wbr/>sensor.<wbr/>noise<wbr/>Model<wbr/>Coefficients
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10191 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10192 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10193 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10194 <span class="entry_type_container">x</span>
10195
10196 <span class="entry_type_array">
10197 2
10198 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10199 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10200 <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]10201
10202
10203 </td> <!-- entry_type -->
10204
10205 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10206 <p>Estimation of sensor noise
10207characteristics</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10208 </td>
10209
10210 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10211 var(raw pixel value) = electrons * (baseGainFactor
10212 * iso/<wbr/>100)^2 + A * (baseGainFactor * iso/<wbr/>100)^2 +
10213 B
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10214 </td>
10215
10216 <td class="entry_range">
10217 </td>
10218
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10219 <td class="entry_tags">
10220 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]10221 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10222 </ul>
10223 </td>
10224
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10225 </tr>
10226 <tr class="entries_header">
10227 <th class="th_details" colspan="5">Details</th>
10228 </tr>
10229 <tr class="entry_cont">
10230 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10231 <p>A represents sensor read noise before analog
10232amplification; B represents noise from A/<wbr/>D conversion and
10233other circuits after amplification.<wbr/> Both noise sources
10234are assumed to be gaussian,<wbr/> independent,<wbr/> and not to vary
10235across the sensor</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10236 </td>
10237 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10238
10239
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10240 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10241 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10242
10243
10244 <tr class="entry" id="static_android.sensor.orientation">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10245 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10246 android.<wbr/>sensor.<wbr/>orientation
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10247 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10248 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10249 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10250
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10251 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10252
10253
10254 </td> <!-- entry_type -->
10255
10256 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10257 <p>Clockwise angle through which the output
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]10258image needs to be rotated to be upright on the device
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10259screen in its native orientation.<wbr/> Also defines the
10260direction of rolling shutter readout,<wbr/> which is from top
10261to bottom in the sensor's coordinate system</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10262 </td>
10263
10264 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10265 degrees clockwise rotation,<wbr/> only multiples of
10266 90
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10267 </td>
10268
10269 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]10270 <p>0,<wbr/>90,<wbr/>180,<wbr/>270</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10271 </td>
10272
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10273 <td class="entry_tags">
10274 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]10275 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10276 </ul>
10277 </td>
10278
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10279 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10280
10281
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10282 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10283 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10284
10285
10286 <tr class="entry" id="static_android.sensor.referenceIlluminant1">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10287 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10288 android.<wbr/>sensor.<wbr/>reference<wbr/>Illuminant1
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10289 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10290 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10291 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10292
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10293 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10294
10295 <ul class="entry_type_enum">
10296 <li>
10297 <span class="entry_type_enum_name">DAYLIGHT</span>
10298 <span class="entry_type_enum_value">1</span>
10299 </li>
10300 <li>
10301 <span class="entry_type_enum_name">FLUORESCENT</span>
10302 <span class="entry_type_enum_value">2</span>
10303 </li>
10304 <li>
10305 <span class="entry_type_enum_name">TUNGSTEN</span>
10306 <span class="entry_type_enum_value">3</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]10307 <span class="entry_type_enum_notes"><p>Incandescent light</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10308 </li>
10309 <li>
10310 <span class="entry_type_enum_name">FLASH</span>
10311 <span class="entry_type_enum_value">4</span>
10312 </li>
10313 <li>
10314 <span class="entry_type_enum_name">FINE_WEATHER</span>
10315 <span class="entry_type_enum_value">9</span>
10316 </li>
10317 <li>
10318 <span class="entry_type_enum_name">CLOUDY_WEATHER</span>
10319 <span class="entry_type_enum_value">10</span>
10320 </li>
10321 <li>
10322 <span class="entry_type_enum_name">SHADE</span>
10323 <span class="entry_type_enum_value">11</span>
10324 </li>
10325 <li>
10326 <span class="entry_type_enum_name">DAYLIGHT_FLUORESCENT</span>
10327 <span class="entry_type_enum_value">12</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]10328 <span class="entry_type_enum_notes"><p>D 5700 - 7100K</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10329 </li>
10330 <li>
10331 <span class="entry_type_enum_name">DAY_WHITE_FLUORESCENT</span>
10332 <span class="entry_type_enum_value">13</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]10333 <span class="entry_type_enum_notes"><p>N 4600 - 5400K</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10334 </li>
10335 <li>
10336 <span class="entry_type_enum_name">COOL_WHITE_FLUORESCENT</span>
10337 <span class="entry_type_enum_value">14</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]10338 <span class="entry_type_enum_notes"><p>W 3900 - 4500K</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10339 </li>
10340 <li>
10341 <span class="entry_type_enum_name">WHITE_FLUORESCENT</span>
10342 <span class="entry_type_enum_value">15</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]10343 <span class="entry_type_enum_notes"><p>WW 3200 - 3700K</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10344 </li>
10345 <li>
10346 <span class="entry_type_enum_name">STANDARD_A</span>
10347 <span class="entry_type_enum_value">17</span>
10348 </li>
10349 <li>
10350 <span class="entry_type_enum_name">STANDARD_B</span>
10351 <span class="entry_type_enum_value">18</span>
10352 </li>
10353 <li>
10354 <span class="entry_type_enum_name">STANDARD_C</span>
10355 <span class="entry_type_enum_value">19</span>
10356 </li>
10357 <li>
10358 <span class="entry_type_enum_name">D55</span>
10359 <span class="entry_type_enum_value">20</span>
10360 </li>
10361 <li>
10362 <span class="entry_type_enum_name">D65</span>
10363 <span class="entry_type_enum_value">21</span>
10364 </li>
10365 <li>
10366 <span class="entry_type_enum_name">D75</span>
10367 <span class="entry_type_enum_value">22</span>
10368 </li>
10369 <li>
10370 <span class="entry_type_enum_name">D50</span>
10371 <span class="entry_type_enum_value">23</span>
10372 </li>
10373 <li>
10374 <span class="entry_type_enum_name">ISO_STUDIO_TUNGSTEN</span>
10375 <span class="entry_type_enum_value">24</span>
10376 </li>
10377 </ul>
10378
10379 </td> <!-- entry_type -->
10380
10381 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10382 <p>Light source used to define transform
103831</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10384 </td>
10385
10386 <td class="entry_units">
10387 </td>
10388
10389 <td class="entry_range">
10390 </td>
10391
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10392 <td class="entry_tags">
10393 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]10394 <li><a href="#tag_DNG">DNG</a></li>
10395 <li><a href="#tag_EXIF">EXIF</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10396 </ul>
10397 </td>
10398
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10399 </tr>
10400 <tr class="entries_header">
10401 <th class="th_details" colspan="5">Details</th>
10402 </tr>
10403 <tr class="entry_cont">
10404 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10405 <p>[EXIF LightSource tag] Must all these be
10406supported? Need CCT for each!</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10407 </td>
10408 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10409
10410
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10411 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10412 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10413
10414
10415 <tr class="entry" id="static_android.sensor.referenceIlluminant2">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10416 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10417 android.<wbr/>sensor.<wbr/>reference<wbr/>Illuminant2
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10418 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10419 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10420 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10421
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10422 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10423
10424
10425 </td> <!-- entry_type -->
10426
10427 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10428 <p>Light source used to define transform
104292</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10430 </td>
10431
10432 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10433 Same as illuminant 1
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10434 </td>
10435
10436 <td class="entry_range">
10437 </td>
10438
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10439 <td class="entry_tags">
10440 </td>
10441
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10442 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10443
10444
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10445 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10446 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10447
10448
10449
10450 <!-- end of kind -->
10451 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10452 <tr><td colspan="6" class="kind">dynamic</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10453
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10454 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10455 <tr>
10456 <th class="th_name">Property Name</th>
10457 <th class="th_type">Type</th>
10458 <th class="th_description">Description</th>
10459 <th class="th_units">Units</th>
10460 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10461 <th class="th_tags">Tags</th>
10462 </tr>
10463 </thead>
10464
10465 <tbody>
10466
10467
10468
10469
10470
10471
10472
10473
10474
10475
10476 <tr class="entry" id="dynamic_android.sensor.exposureTime">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10477 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10478 android.<wbr/>sensor.<wbr/>exposure<wbr/>Time
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10479 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10480 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10481 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10482
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10483 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10484
10485
10486 </td> <!-- entry_type -->
10487
10488 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10489 <p>Duration each pixel is exposed to
10490light.<wbr/></p>
10491<p>If the sensor can't expose this exact duration,<wbr/> it should shorten the
10492duration exposed to the nearest possible value (rather than expose longer).<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10493 </td>
10494
10495 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10496 nanoseconds
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10497 </td>
10498
10499 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]10500 <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]10501 </td>
10502
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10503 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]10504 <ul class="entry_tags">
10505 <li><a href="#tag_V1">V1</a></li>
10506 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10507 </td>
10508
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10509 </tr>
10510 <tr class="entries_header">
10511 <th class="th_details" colspan="5">Details</th>
10512 </tr>
10513 <tr class="entry_cont">
10514 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10515 <p>1/<wbr/>10000 - 30 sec range.<wbr/> No bulb mode</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10516 </td>
10517 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10518
10519
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10520 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10521 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10522
10523
10524 <tr class="entry" id="dynamic_android.sensor.frameDuration">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10525 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10526 android.<wbr/>sensor.<wbr/>frame<wbr/>Duration
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10527 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10528 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10529 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10530
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10531 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10532
10533
10534 </td> <!-- entry_type -->
10535
10536 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10537 <p>Duration from start of frame exposure to
10538start of next frame exposure</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10539 </td>
10540
10541 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10542 nanoseconds
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10543 </td>
10544
10545 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]10546 <p>see <a href="#static_android.sensor.info.maxFrameDuration">android.<wbr/>sensor.<wbr/>info.<wbr/>max<wbr/>Frame<wbr/>Duration</a>,<wbr/>
10547android.<wbr/>scaler.<wbr/>info.<wbr/>available<wbr/>Min<wbr/>Frame<wbr/>Durations</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10548 </td>
10549
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10550 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]10551 <ul class="entry_tags">
10552 <li><a href="#tag_V1">V1</a></li>
10553 <li><a href="#tag_BC">BC</a></li>
10554 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10555 </td>
10556
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10557 </tr>
10558 <tr class="entries_header">
10559 <th class="th_details" colspan="5">Details</th>
10560 </tr>
10561 <tr class="entry_cont">
10562 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10563 <p>Exposure time has priority,<wbr/> so duration is set to
10564max(duration,<wbr/> exposure time + overhead)</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10565 </td>
10566 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10567
10568
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10569 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10570 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10571
10572
10573 <tr class="entry" id="dynamic_android.sensor.sensitivity">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10574 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10575 android.<wbr/>sensor.<wbr/>sensitivity
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10576 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10577 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10578 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10579
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10580 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10581
10582
10583 </td> <!-- entry_type -->
10584
10585 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10586 <p>Gain applied to image data.<wbr/> Must be
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]10587implemented through analog gain only if set to values
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10588below 'maximum analog sensitivity'.<wbr/></p>
10589<p>If the sensor can't apply this exact gain,<wbr/> it should lessen the
10590gain to the nearest possible value (rather than gain more).<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10591 </td>
10592
10593 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10594 ISO arithmetic units
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10595 </td>
10596
10597 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]10598 <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]10599 </td>
10600
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10601 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]10602 <ul class="entry_tags">
10603 <li><a href="#tag_V1">V1</a></li>
10604 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10605 </td>
10606
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10607 </tr>
10608 <tr class="entries_header">
10609 <th class="th_details" colspan="5">Details</th>
10610 </tr>
10611 <tr class="entry_cont">
10612 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10613 <p>ISO 12232:2006 REI method</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10614 </td>
10615 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10616
10617
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10618 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10619 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10620
10621
10622 <tr class="entry" id="dynamic_android.sensor.timestamp">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10623 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10624 android.<wbr/>sensor.<wbr/>timestamp
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10625 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10626 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10627 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10628
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10629 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10630
10631
10632 </td> <!-- entry_type -->
10633
10634 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10635 <p>Time at start of exposure of first
10636row</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10637 </td>
10638
10639 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10640 nanoseconds
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10641 </td>
10642
10643 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame]10644 <p>&gt; 0</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10645 </td>
10646
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10647 <td class="entry_tags">
10648 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]10649 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10650 </ul>
10651 </td>
10652
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10653 </tr>
10654 <tr class="entries_header">
10655 <th class="th_details" colspan="5">Details</th>
10656 </tr>
10657 <tr class="entry_cont">
10658 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10659 <p>Monotonic,<wbr/> should be synced to other timestamps in
10660system</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10661 </td>
10662 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10663
10664
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10665 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10666 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10667
Igor Murashkin656aa5a2013-08-13 14:23:39 -0700[diff] [blame]10668
10669 <tr class="entry" id="dynamic_android.sensor.temperature">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10670 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10671 android.<wbr/>sensor.<wbr/>temperature
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10672 </td>
Igor Murashkin656aa5a2013-08-13 14:23:39 -0700[diff] [blame]10673 <td class="entry_type">
10674 <span class="entry_type_name">float</span>
10675
10676 <span class="entry_type_visibility"> [public]</span>
10677
10678
10679 </td> <!-- entry_type -->
10680
10681 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10682 <p>The temperature of the sensor,<wbr/> sampled at the time
10683exposure began for this frame.<wbr/></p>
10684<p>The thermal diode being queried should be inside the sensor PCB,<wbr/> or
10685somewhere close to it.<wbr/></p>
Igor Murashkin656aa5a2013-08-13 14:23:39 -0700[diff] [blame]10686 </td>
10687
10688 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10689 celsius
Igor Murashkin656aa5a2013-08-13 14:23:39 -0700[diff] [blame]10690 </td>
10691
10692 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]10693 <p>Optional.<wbr/> This value is missing if no temperature is available.<wbr/></p>
Igor Murashkin656aa5a2013-08-13 14:23:39 -0700[diff] [blame]10694 </td>
10695
Igor Murashkin656aa5a2013-08-13 14:23:39 -0700[diff] [blame]10696 <td class="entry_tags">
Alex Rayef40ad62013-10-01 17:52:33 -0700[diff] [blame]10697 <ul class="entry_tags">
10698 <li><a href="#tag_FULL">FULL</a></li>
10699 </ul>
Igor Murashkin656aa5a2013-08-13 14:23:39 -0700[diff] [blame]10700 </td>
10701
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10702 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10703
10704
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10705 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10706 <!-- end of entry -->
Igor Murashkin656aa5a2013-08-13 14:23:39 -0700[diff] [blame]10707
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10708
10709
10710 <!-- end of kind -->
10711 </tbody>
10712
10713 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10714 <tr><td colspan="6" id="section_shading" class="section">shading</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10715
10716
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10717 <tr><td colspan="6" class="kind">controls</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10718
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10719 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10720 <tr>
10721 <th class="th_name">Property Name</th>
10722 <th class="th_type">Type</th>
10723 <th class="th_description">Description</th>
10724 <th class="th_units">Units</th>
10725 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10726 <th class="th_tags">Tags</th>
10727 </tr>
10728 </thead>
10729
10730 <tbody>
10731
10732
10733
10734
10735
10736
10737
10738
10739
10740
10741 <tr class="entry" id="controls_android.shading.mode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10742 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10743 android.<wbr/>shading.<wbr/>mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10744 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10745 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10746 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10747
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10748 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10749
10750 <ul class="entry_type_enum">
10751 <li>
10752 <span class="entry_type_enum_name">OFF</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]10753 <span class="entry_type_enum_notes"><p>No shading correction is applied</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10754 </li>
10755 <li>
10756 <span class="entry_type_enum_name">FAST</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]10757 <span class="entry_type_enum_notes"><p>Must not slow down frame rate relative to raw
10758bayer output</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10759 </li>
10760 <li>
10761 <span class="entry_type_enum_name">HIGH_QUALITY</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]10762 <span class="entry_type_enum_notes"><p>Frame rate may be reduced by high
10763quality</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10764 </li>
10765 </ul>
10766
10767 </td> <!-- entry_type -->
10768
10769 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10770 <p>Quality of lens shading correction applied
10771to the image data</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10772 </td>
10773
10774 <td class="entry_units">
10775 </td>
10776
10777 <td class="entry_range">
10778 </td>
10779
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10780 <td class="entry_tags">
10781 </td>
10782
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10783 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10784
10785
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10786 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10787 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10788
10789
10790 <tr class="entry" id="controls_android.shading.strength">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10791 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10792 android.<wbr/>shading.<wbr/>strength
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10793 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10794 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10795 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10796
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10797 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10798
10799
10800 </td> <!-- entry_type -->
10801
10802 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10803 <p>Control the amount of shading correction
10804applied to the images</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10805 </td>
10806
10807 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10808 unitless: 1-10; 10 is full shading
10809 compensation
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10810 </td>
10811
10812 <td class="entry_range">
10813 </td>
10814
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10815 <td class="entry_tags">
10816 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]10817 <li><a href="#tag_ADV">ADV</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10818 </ul>
10819 </td>
10820
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10821 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10822
10823
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10824 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10825 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10826
10827
10828
10829 <!-- end of kind -->
10830 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10831 <tr><td colspan="6" class="kind">dynamic</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10832
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10833 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10834 <tr>
10835 <th class="th_name">Property Name</th>
10836 <th class="th_type">Type</th>
10837 <th class="th_description">Description</th>
10838 <th class="th_units">Units</th>
10839 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10840 <th class="th_tags">Tags</th>
10841 </tr>
10842 </thead>
10843
10844 <tbody>
10845
10846
10847
10848
10849
10850
10851
10852
10853
10854
10855 <tr class="entry" id="dynamic_android.shading.mode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10856 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10857 android.<wbr/>shading.<wbr/>mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10858 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10859 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10860 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10861
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10862 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10863
10864 <ul class="entry_type_enum">
10865 <li>
10866 <span class="entry_type_enum_name">OFF</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]10867 <span class="entry_type_enum_notes"><p>No shading correction is applied</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10868 </li>
10869 <li>
10870 <span class="entry_type_enum_name">FAST</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]10871 <span class="entry_type_enum_notes"><p>Must not slow down frame rate relative to raw
10872bayer output</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10873 </li>
10874 <li>
10875 <span class="entry_type_enum_name">HIGH_QUALITY</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]10876 <span class="entry_type_enum_notes"><p>Frame rate may be reduced by high
10877quality</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10878 </li>
10879 </ul>
10880
10881 </td> <!-- entry_type -->
10882
10883 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10884 <p>Quality of lens shading correction applied
10885to the image data</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10886 </td>
10887
10888 <td class="entry_units">
10889 </td>
10890
10891 <td class="entry_range">
10892 </td>
10893
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10894 <td class="entry_tags">
10895 </td>
10896
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10897 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10898
10899
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10900 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10901 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10902
10903
10904
10905 <!-- end of kind -->
10906 </tbody>
10907
10908 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10909 <tr><td colspan="6" id="section_statistics" class="section">statistics</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10910
10911
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10912 <tr><td colspan="6" class="kind">controls</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10913
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10914 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10915 <tr>
10916 <th class="th_name">Property Name</th>
10917 <th class="th_type">Type</th>
10918 <th class="th_description">Description</th>
10919 <th class="th_units">Units</th>
10920 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10921 <th class="th_tags">Tags</th>
10922 </tr>
10923 </thead>
10924
10925 <tbody>
10926
10927
10928
10929
10930
10931
10932
10933
10934
10935
10936 <tr class="entry" id="controls_android.statistics.faceDetectMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10937 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10938 android.<wbr/>statistics.<wbr/>face<wbr/>Detect<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10939 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10940 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10941 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10942
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10943 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10944
10945 <ul class="entry_type_enum">
10946 <li>
10947 <span class="entry_type_enum_name">OFF</span>
10948 </li>
10949 <li>
10950 <span class="entry_type_enum_name">SIMPLE</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]10951 <span class="entry_type_enum_notes"><p>Optional Return rectangle and confidence
10952only</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10953 </li>
10954 <li>
10955 <span class="entry_type_enum_name">FULL</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]10956 <span class="entry_type_enum_notes"><p>Optional Return all face
10957metadata</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10958 </li>
10959 </ul>
10960
10961 </td> <!-- entry_type -->
10962
10963 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10964 <p>State of the face detector
10965unit</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10966 </td>
10967
10968 <td class="entry_units">
10969 </td>
10970
10971 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]10972 <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]10973 </td>
10974
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10975 <td class="entry_tags">
10976 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]10977 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10978 </ul>
10979 </td>
10980
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10981 </tr>
10982 <tr class="entries_header">
10983 <th class="th_details" colspan="5">Details</th>
10984 </tr>
10985 <tr class="entry_cont">
10986 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10987 <p>Whether face detection is enabled,<wbr/> and whether it
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10988should output just the basic fields or the full set of
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10989fields.<wbr/> Value must be one of the
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]10990<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]10991 </td>
10992 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10993
10994
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10995 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10996 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10997
10998
10999 <tr class="entry" id="controls_android.statistics.histogramMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11000 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11001 android.<wbr/>statistics.<wbr/>histogram<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11002 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11003 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]11004 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11005
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]11006 <span class="entry_type_visibility"> [system as boolean]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11007
11008 <ul class="entry_type_enum">
11009 <li>
11010 <span class="entry_type_enum_name">OFF</span>
11011 </li>
11012 <li>
11013 <span class="entry_type_enum_name">ON</span>
11014 </li>
11015 </ul>
11016
11017 </td> <!-- entry_type -->
11018
11019 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11020 <p>Operating mode for histogram
11021generation</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11022 </td>
11023
11024 <td class="entry_units">
11025 </td>
11026
11027 <td class="entry_range">
11028 </td>
11029
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11030 <td class="entry_tags">
11031 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]11032 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11033 </ul>
11034 </td>
11035
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11036 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11037
11038
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11039 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11040 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11041
11042
11043 <tr class="entry" id="controls_android.statistics.sharpnessMapMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11044 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11045 android.<wbr/>statistics.<wbr/>sharpness<wbr/>Map<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11046 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11047 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]11048 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11049
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]11050 <span class="entry_type_visibility"> [system as boolean]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11051
11052 <ul class="entry_type_enum">
11053 <li>
11054 <span class="entry_type_enum_name">OFF</span>
11055 </li>
11056 <li>
11057 <span class="entry_type_enum_name">ON</span>
11058 </li>
11059 </ul>
11060
11061 </td> <!-- entry_type -->
11062
11063 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11064 <p>Operating mode for sharpness map
11065generation</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11066 </td>
11067
11068 <td class="entry_units">
11069 </td>
11070
11071 <td class="entry_range">
11072 </td>
11073
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11074 <td class="entry_tags">
11075 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]11076 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11077 </ul>
11078 </td>
11079
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11080 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11081
11082
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11083 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11084 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11085
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]11086
11087 <tr class="entry" id="controls_android.statistics.lensShadingMapMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11088 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11089 android.<wbr/>statistics.<wbr/>lens<wbr/>Shading<wbr/>Map<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11090 </td>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]11091 <td class="entry_type">
11092 <span class="entry_type_name entry_type_name_enum">byte</span>
11093
11094 <span class="entry_type_visibility"> [public]</span>
11095
11096 <ul class="entry_type_enum">
11097 <li>
11098 <span class="entry_type_enum_name">OFF</span>
11099 </li>
11100 <li>
11101 <span class="entry_type_enum_name">ON</span>
11102 </li>
11103 </ul>
11104
11105 </td> <!-- entry_type -->
11106
11107 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11108 <p>Whether the HAL needs to output the lens
11109shading map in output result metadata</p>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]11110 </td>
11111
11112 <td class="entry_units">
11113 </td>
11114
11115 <td class="entry_range">
11116 </td>
11117
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11118 <td class="entry_tags">
11119 </td>
11120
11121 </tr>
11122 <tr class="entries_header">
11123 <th class="th_details" colspan="5">Details</th>
11124 </tr>
11125 <tr class="entry_cont">
11126 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11127 <p>When set to ON,<wbr/>
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]11128<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]11129the output result metadata.<wbr/></p>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]11130 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11131 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11132
11133
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11134 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11135 <!-- end of entry -->
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]11136
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11137
11138
11139 <!-- end of kind -->
11140 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11141 <tr><td colspan="6" class="kind">static</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11142
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]11143 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11144 <tr>
11145 <th class="th_name">Property Name</th>
11146 <th class="th_type">Type</th>
11147 <th class="th_description">Description</th>
11148 <th class="th_units">Units</th>
11149 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11150 <th class="th_tags">Tags</th>
11151 </tr>
11152 </thead>
11153
11154 <tbody>
11155
11156
11157
11158
11159
11160
11161
11162
11163
11164
11165
11166
11167 <tr class="entry" id="static_android.statistics.info.availableFaceDetectModes">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11168 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11169 android.<wbr/>statistics.<wbr/>info.<wbr/>available<wbr/>Face<wbr/>Detect<wbr/>Modes
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11170 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11171 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]11172 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11173 <span class="entry_type_container">x</span>
11174
11175 <span class="entry_type_array">
11176 n
11177 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]11178 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11179 <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]11180
11181
11182 </td> <!-- entry_type -->
11183
11184 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11185 <p>Which face detection modes are available,<wbr/>
11186if any</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11187 </td>
11188
11189 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11190 List of enum:
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]11191 OFF
11192 SIMPLE
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11193 FULL
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11194 </td>
11195
11196 <td class="entry_range">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11197 </td>
11198
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11199 <td class="entry_tags">
11200 </td>
11201
11202 </tr>
11203 <tr class="entries_header">
11204 <th class="th_details" colspan="5">Details</th>
11205 </tr>
11206 <tr class="entry_cont">
11207 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11208 <p>OFF means face detection is disabled,<wbr/> it must
11209be included in the list.<wbr/></p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]11210<p>SIMPLE means the device supports the
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]11211<a href="#dynamic_android.statistics.faceRectangles">android.<wbr/>statistics.<wbr/>face<wbr/>Rectangles</a> and
11212<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]11213<p>FULL means the device additionally supports the
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]11214<a href="#dynamic_android.statistics.faceIds">android.<wbr/>statistics.<wbr/>face<wbr/>Ids</a> and
11215<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]11216 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11217 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11218
11219
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11220 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11221 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11222
11223
11224 <tr class="entry" id="static_android.statistics.info.histogramBucketCount">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11225 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11226 android.<wbr/>statistics.<wbr/>info.<wbr/>histogram<wbr/>Bucket<wbr/>Count
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11227 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11228 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]11229 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11230
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]11231 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11232
11233
11234 </td> <!-- entry_type -->
11235
11236 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11237 <p>Number of histogram buckets
11238supported</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11239 </td>
11240
11241 <td class="entry_units">
11242 </td>
11243
11244 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame]11245 <p>&gt;= 64</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11246 </td>
11247
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11248 <td class="entry_tags">
11249 </td>
11250
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11251 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11252
11253
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11254 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11255 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11256
11257
11258 <tr class="entry" id="static_android.statistics.info.maxFaceCount">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11259 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11260 android.<wbr/>statistics.<wbr/>info.<wbr/>max<wbr/>Face<wbr/>Count
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11261 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11262 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]11263 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11264
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]11265 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11266
11267
11268 </td> <!-- entry_type -->
11269
11270 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11271 <p>Maximum number of simultaneously detectable
11272faces</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11273 </td>
11274
11275 <td class="entry_units">
11276 </td>
11277
11278 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame]11279 <p>&gt;= 4 if availableFaceDetectionModes lists
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]11280modes besides OFF,<wbr/> otherwise 0</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11281 </td>
11282
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11283 <td class="entry_tags">
11284 </td>
11285
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11286 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11287
11288
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11289 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11290 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11291
11292
11293 <tr class="entry" id="static_android.statistics.info.maxHistogramCount">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11294 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11295 android.<wbr/>statistics.<wbr/>info.<wbr/>max<wbr/>Histogram<wbr/>Count
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11296 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11297 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]11298 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11299
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]11300 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11301
11302
11303 </td> <!-- entry_type -->
11304
11305 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11306 <p>Maximum value possible for a histogram
11307bucket</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11308 </td>
11309
11310 <td class="entry_units">
11311 </td>
11312
11313 <td class="entry_range">
11314 </td>
11315
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11316 <td class="entry_tags">
11317 </td>
11318
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11319 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11320
11321
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11322 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11323 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11324
11325
11326 <tr class="entry" id="static_android.statistics.info.maxSharpnessMapValue">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11327 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11328 android.<wbr/>statistics.<wbr/>info.<wbr/>max<wbr/>Sharpness<wbr/>Map<wbr/>Value
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11329 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11330 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]11331 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11332
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]11333 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11334
11335
11336 </td> <!-- entry_type -->
11337
11338 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11339 <p>Maximum value possible for a sharpness map
11340region.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11341 </td>
11342
11343 <td class="entry_units">
11344 </td>
11345
11346 <td class="entry_range">
11347 </td>
11348
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11349 <td class="entry_tags">
11350 </td>
11351
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11352 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11353
11354
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11355 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11356 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11357
11358
11359 <tr class="entry" id="static_android.statistics.info.sharpnessMapSize">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11360 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11361 android.<wbr/>statistics.<wbr/>info.<wbr/>sharpness<wbr/>Map<wbr/>Size
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11362 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11363 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]11364 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11365 <span class="entry_type_container">x</span>
11366
11367 <span class="entry_type_array">
11368 2
11369 </span>
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]11370 <span class="entry_type_visibility"> [system as size]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11371 <div class="entry_type_notes">width x height</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11372
11373
11374 </td> <!-- entry_type -->
11375
11376 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11377 <p>Dimensions of the sharpness
11378map</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11379 </td>
11380
11381 <td class="entry_units">
11382 </td>
11383
11384 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]11385 <p>Must be at least 32 x 32</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11386 </td>
11387
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11388 <td class="entry_tags">
11389 </td>
11390
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11391 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11392
11393
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11394 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11395 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11396
11397
11398
11399
11400
11401
11402 <!-- end of kind -->
11403 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11404 <tr><td colspan="6" class="kind">dynamic</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11405
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]11406 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11407 <tr>
11408 <th class="th_name">Property Name</th>
11409 <th class="th_type">Type</th>
11410 <th class="th_description">Description</th>
11411 <th class="th_units">Units</th>
11412 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11413 <th class="th_tags">Tags</th>
11414 </tr>
11415 </thead>
11416
11417 <tbody>
11418
11419
11420
11421
11422
11423
11424
11425
11426
11427
11428 <tr class="entry" id="dynamic_android.statistics.faceDetectMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11429 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11430 android.<wbr/>statistics.<wbr/>face<wbr/>Detect<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11431 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11432 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]11433 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11434
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]11435 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11436
11437 <ul class="entry_type_enum">
11438 <li>
11439 <span class="entry_type_enum_name">OFF</span>
11440 </li>
11441 <li>
11442 <span class="entry_type_enum_name">SIMPLE</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]11443 <span class="entry_type_enum_notes"><p>Optional Return rectangle and confidence
11444only</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11445 </li>
11446 <li>
11447 <span class="entry_type_enum_name">FULL</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]11448 <span class="entry_type_enum_notes"><p>Optional Return all face
11449metadata</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11450 </li>
11451 </ul>
11452
11453 </td> <!-- entry_type -->
11454
11455 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11456 <p>State of the face detector
11457unit</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11458 </td>
11459
11460 <td class="entry_units">
11461 </td>
11462
11463 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]11464 <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]11465 </td>
11466
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11467 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]11468 <ul class="entry_tags">
11469 <li><a href="#tag_BC">BC</a></li>
11470 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11471 </td>
11472
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11473 </tr>
11474 <tr class="entries_header">
11475 <th class="th_details" colspan="5">Details</th>
11476 </tr>
11477 <tr class="entry_cont">
11478 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11479 <p>Whether face detection is enabled,<wbr/> and whether it
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11480should output just the basic fields or the full set of
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11481fields.<wbr/> Value must be one of the
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]11482<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]11483 </td>
11484 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11485
11486
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11487 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11488 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11489
11490
11491 <tr class="entry" id="dynamic_android.statistics.faceIds">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11492 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11493 android.<wbr/>statistics.<wbr/>face<wbr/>Ids
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11494 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11495 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]11496 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11497 <span class="entry_type_container">x</span>
11498
11499 <span class="entry_type_array">
11500 n
11501 </span>
Zhijun He3b4c2062013-10-07 11:23:30 -0700[diff] [blame]11502 <span class="entry_type_visibility"> [hidden]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11503
11504
11505 </td> <!-- entry_type -->
11506
11507 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11508 <p>List of unique IDs for detected
11509faces</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11510 </td>
11511
11512 <td class="entry_units">
11513 </td>
11514
11515 <td class="entry_range">
11516 </td>
11517
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11518 <td class="entry_tags">
11519 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]11520 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11521 </ul>
11522 </td>
11523
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11524 </tr>
11525 <tr class="entries_header">
11526 <th class="th_details" colspan="5">Details</th>
11527 </tr>
11528 <tr class="entry_cont">
11529 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11530 <p>Only available if faceDetectMode == FULL</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11531 </td>
11532 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11533
11534
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11535 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11536 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11537
11538
11539 <tr class="entry" id="dynamic_android.statistics.faceLandmarks">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11540 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11541 android.<wbr/>statistics.<wbr/>face<wbr/>Landmarks
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11542 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11543 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]11544 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11545 <span class="entry_type_container">x</span>
11546
11547 <span class="entry_type_array">
11548 n x 6
11549 </span>
Zhijun He3b4c2062013-10-07 11:23:30 -0700[diff] [blame]11550 <span class="entry_type_visibility"> [hidden]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11551 <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]11552
11553
11554 </td> <!-- entry_type -->
11555
11556 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11557 <p>List of landmarks for detected
11558faces</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11559 </td>
11560
11561 <td class="entry_units">
11562 </td>
11563
11564 <td class="entry_range">
11565 </td>
11566
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11567 <td class="entry_tags">
11568 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]11569 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11570 </ul>
11571 </td>
11572
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11573 </tr>
11574 <tr class="entries_header">
11575 <th class="th_details" colspan="5">Details</th>
11576 </tr>
11577 <tr class="entry_cont">
11578 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11579 <p>Only available if faceDetectMode == FULL</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11580 </td>
11581 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11582
11583
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11584 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11585 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11586
11587
11588 <tr class="entry" id="dynamic_android.statistics.faceRectangles">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11589 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11590 android.<wbr/>statistics.<wbr/>face<wbr/>Rectangles
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11591 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11592 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]11593 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11594 <span class="entry_type_container">x</span>
11595
11596 <span class="entry_type_array">
11597 n x 4
11598 </span>
Zhijun He3b4c2062013-10-07 11:23:30 -0700[diff] [blame]11599 <span class="entry_type_visibility"> [hidden as rectangle]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11600 <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]11601
11602
11603 </td> <!-- entry_type -->
11604
11605 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11606 <p>List of the bounding rectangles for detected
11607faces</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11608 </td>
11609
11610 <td class="entry_units">
11611 </td>
11612
11613 <td class="entry_range">
11614 </td>
11615
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11616 <td class="entry_tags">
11617 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]11618 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11619 </ul>
11620 </td>
11621
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11622 </tr>
11623 <tr class="entries_header">
11624 <th class="th_details" colspan="5">Details</th>
11625 </tr>
11626 <tr class="entry_cont">
11627 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11628 <p>Only available if faceDetectMode != OFF</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11629 </td>
11630 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11631
11632
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11633 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11634 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11635
11636
11637 <tr class="entry" id="dynamic_android.statistics.faceScores">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11638 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11639 android.<wbr/>statistics.<wbr/>face<wbr/>Scores
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11640 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11641 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]11642 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11643 <span class="entry_type_container">x</span>
11644
11645 <span class="entry_type_array">
11646 n
11647 </span>
Zhijun He3b4c2062013-10-07 11:23:30 -0700[diff] [blame]11648 <span class="entry_type_visibility"> [hidden]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11649
11650
11651 </td> <!-- entry_type -->
11652
11653 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11654 <p>List of the face confidence scores for
11655detected faces</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11656 </td>
11657
11658 <td class="entry_units">
11659 </td>
11660
11661 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]11662 <p>1-100</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11663 </td>
11664
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11665 <td class="entry_tags">
11666 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]11667 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11668 </ul>
11669 </td>
11670
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11671 </tr>
11672 <tr class="entries_header">
11673 <th class="th_details" colspan="5">Details</th>
11674 </tr>
11675 <tr class="entry_cont">
11676 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11677 <p>Only available if faceDetectMode != OFF.<wbr/> The value should be
11678meaningful (for example,<wbr/> setting 100 at all times is illegal).<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11679 </td>
11680 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11681
11682
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11683 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11684 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11685
11686
11687 <tr class="entry" id="dynamic_android.statistics.histogram">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11688 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11689 android.<wbr/>statistics.<wbr/>histogram
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11690 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11691 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]11692 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11693 <span class="entry_type_container">x</span>
11694
11695 <span class="entry_type_array">
11696 n x 3
11697 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]11698 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11699 <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]11700
11701
11702 </td> <!-- entry_type -->
11703
11704 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11705 <p>A 3-channel histogram based on the raw
11706sensor data</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11707 </td>
11708
11709 <td class="entry_units">
11710 </td>
11711
11712 <td class="entry_range">
11713 </td>
11714
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11715 <td class="entry_tags">
11716 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]11717 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11718 </ul>
11719 </td>
11720
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11721 </tr>
11722 <tr class="entries_header">
11723 <th class="th_details" colspan="5">Details</th>
11724 </tr>
11725 <tr class="entry_cont">
11726 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11727 <p>The k'th bucket (0-based) covers the input range
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]11728(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]11729(k + 1) * w /<wbr/> N ).<wbr/> If only a monochrome sharpness map is
11730supported,<wbr/> all channels should have the same data</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11731 </td>
11732 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11733
11734
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11735 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11736 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11737
11738
11739 <tr class="entry" id="dynamic_android.statistics.histogramMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11740 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11741 android.<wbr/>statistics.<wbr/>histogram<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11742 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11743 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]11744 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11745
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]11746 <span class="entry_type_visibility"> [system as boolean]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11747
11748 <ul class="entry_type_enum">
11749 <li>
11750 <span class="entry_type_enum_name">OFF</span>
11751 </li>
11752 <li>
11753 <span class="entry_type_enum_name">ON</span>
11754 </li>
11755 </ul>
11756
11757 </td> <!-- entry_type -->
11758
11759 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11760 <p>Operating mode for histogram
11761generation</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11762 </td>
11763
11764 <td class="entry_units">
11765 </td>
11766
11767 <td class="entry_range">
11768 </td>
11769
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11770 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]11771 <ul class="entry_tags">
11772 <li><a href="#tag_V1">V1</a></li>
11773 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11774 </td>
11775
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11776 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11777
11778
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11779 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11780 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11781
11782
11783 <tr class="entry" id="dynamic_android.statistics.sharpnessMap">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11784 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11785 android.<wbr/>statistics.<wbr/>sharpness<wbr/>Map
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11786 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11787 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]11788 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11789 <span class="entry_type_container">x</span>
11790
11791 <span class="entry_type_array">
11792 n x m x 3
11793 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]11794 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11795 <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]11796
11797
11798 </td> <!-- entry_type -->
11799
11800 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11801 <p>A 3-channel sharpness map,<wbr/> based on the raw
11802sensor data</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11803 </td>
11804
11805 <td class="entry_units">
11806 </td>
11807
11808 <td class="entry_range">
11809 </td>
11810
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11811 <td class="entry_tags">
11812 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]11813 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11814 </ul>
11815 </td>
11816
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11817 </tr>
11818 <tr class="entries_header">
11819 <th class="th_details" colspan="5">Details</th>
11820 </tr>
11821 <tr class="entry_cont">
11822 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11823 <p>If only a monochrome sharpness map is supported,<wbr/>
11824all channels should have the same data</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11825 </td>
11826 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11827
11828
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11829 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11830 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11831
11832
11833 <tr class="entry" id="dynamic_android.statistics.sharpnessMapMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11834 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11835 android.<wbr/>statistics.<wbr/>sharpness<wbr/>Map<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11836 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11837 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]11838 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11839
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]11840 <span class="entry_type_visibility"> [system as boolean]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11841
11842 <ul class="entry_type_enum">
11843 <li>
11844 <span class="entry_type_enum_name">OFF</span>
11845 </li>
11846 <li>
11847 <span class="entry_type_enum_name">ON</span>
11848 </li>
11849 </ul>
11850
11851 </td> <!-- entry_type -->
11852
11853 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11854 <p>Operating mode for sharpness map
11855generation</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11856 </td>
11857
11858 <td class="entry_units">
11859 </td>
11860
11861 <td class="entry_range">
11862 </td>
11863
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11864 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]11865 <ul class="entry_tags">
11866 <li><a href="#tag_V1">V1</a></li>
11867 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11868 </td>
11869
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11870 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11871
11872
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11873 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11874 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11875
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]11876
11877 <tr class="entry" id="dynamic_android.statistics.lensShadingMap">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11878 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11879 android.<wbr/>statistics.<wbr/>lens<wbr/>Shading<wbr/>Map
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11880 </td>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]11881 <td class="entry_type">
11882 <span class="entry_type_name">float</span>
11883 <span class="entry_type_container">x</span>
11884
11885 <span class="entry_type_array">
11886 4 x n x m
11887 </span>
11888 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11889 <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]11890
11891
11892 </td> <!-- entry_type -->
11893
11894 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11895 <p>The shading map is a low-resolution floating-point map
11896that lists the coefficients used to correct for vignetting,<wbr/> for each
11897Bayer color channel.<wbr/></p>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]11898 </td>
11899
11900 <td class="entry_units">
11901 </td>
11902
11903 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]11904 <p>Each gain factor is &gt;= 1</p>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]11905 </td>
11906
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11907 <td class="entry_tags">
11908 </td>
11909
11910 </tr>
11911 <tr class="entries_header">
11912 <th class="th_details" colspan="5">Details</th>
11913 </tr>
11914 <tr class="entry_cont">
11915 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11916 <p>The least shaded section of the image should have a gain factor
11917of 1; all other sections should have gains above 1.<wbr/></p>
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]11918<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]11919must take into account the colorCorrection settings.<wbr/></p>
11920<p>The shading map is for the entire active pixel array,<wbr/> and is not
11921affected by the crop region specified in the request.<wbr/> Each shading map
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]11922entry is the value of the shading compensation map over a specific
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11923pixel on the sensor.<wbr/> Specifically,<wbr/> with a (N x M) resolution shading
11924map,<wbr/> and an active pixel array size (W x H),<wbr/> shading map entry
11925(x,<wbr/>y) ϵ (0 ...<wbr/> N-1,<wbr/> 0 ...<wbr/> M-1) is the value of the shading map at
11926pixel ( ((W-1)/<wbr/>(N-1)) * x,<wbr/> ((H-1)/<wbr/>(M-1)) * y) for the four color channels.<wbr/>
11927The map is assumed to be bilinearly interpolated between the sample points.<wbr/></p>
11928<p>The channel order is [R,<wbr/> Geven,<wbr/> Godd,<wbr/> B],<wbr/> where Geven is the green
11929channel for the even rows of a Bayer pattern,<wbr/> and Godd is the odd rows.<wbr/>
11930The shading map is stored in a fully interleaved format,<wbr/> and its size
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]11931is 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]11932<p>The shading map should have on the order of 30-40 rows and columns,<wbr/>
11933and must be smaller than 64x64.<wbr/></p>
11934<p>As an example,<wbr/> given a very small map defined as:</p>
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]11935<pre><code><a href="#static_android.lens.info.shadingMapSize">android.<wbr/>lens.<wbr/>info.<wbr/>shading<wbr/>Map<wbr/>Size</a> = [ 4,<wbr/> 3 ]
11936<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]11937[ 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/>
11938 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/>
11939 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/>
11940 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/>
11941 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/>
11942 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]11943</code></pre>
11944<p>The low-resolution scaling map images for each channel are
11945(displayed using nearest-neighbor interpolation):</p>
11946<p><img alt="Red lens shading map" src="images/camera2/metadata/android.statistics.lensShadingMap/red_shading.png"/>
11947<img alt="Green (even rows) lens shading map" src="images/camera2/metadata/android.statistics.lensShadingMap/green_e_shading.png"/>
11948<img alt="Green (odd rows) lens shading map" src="images/camera2/metadata/android.statistics.lensShadingMap/green_o_shading.png"/>
11949<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]11950<p>As a visualization only,<wbr/> inverting the full-color map to recover an
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]11951image 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]11952<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]11953 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11954 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11955
11956
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11957 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11958 <!-- end of entry -->
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]11959
11960
11961 <tr class="entry" id="dynamic_android.statistics.predictedColorGains">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11962 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11963 android.<wbr/>statistics.<wbr/>predicted<wbr/>Color<wbr/>Gains
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11964 </td>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]11965 <td class="entry_type">
11966 <span class="entry_type_name">float</span>
11967 <span class="entry_type_container">x</span>
11968
11969 <span class="entry_type_array">
11970 4
11971 </span>
Igor Murashkin0fe2f132014-01-13 16:59:47 -0800[diff] [blame]11972 <span class="entry_type_visibility"> [hidden]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11973 <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]11974
11975
11976 </td> <!-- entry_type -->
11977
11978 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11979 <p>The best-fit color channel gains calculated
11980by the HAL's statistics units for the current output frame</p>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]11981 </td>
11982
11983 <td class="entry_units">
11984 </td>
11985
11986 <td class="entry_range">
Igor Murashkin0fe2f132014-01-13 16:59:47 -0800[diff] [blame]11987 <p><strong>Deprecated</strong>.<wbr/> Do not use.<wbr/></p>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]11988 </td>
11989
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11990 <td class="entry_tags">
11991 </td>
11992
11993 </tr>
11994 <tr class="entries_header">
11995 <th class="th_details" colspan="5">Details</th>
11996 </tr>
11997 <tr class="entry_cont">
11998 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11999 <p>This may be different than the gains used for this frame,<wbr/>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]12000since statistics processing on data from a new frame
12001typically completes after the transform has already been
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12002applied to that frame.<wbr/></p>
12003<p>The 4 channel gains are defined in Bayer domain,<wbr/>
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]12004see <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]12005<p>This value should always be calculated by the AWB block,<wbr/>
12006regardless of the android.<wbr/>control.<wbr/>* current values.<wbr/></p>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]12007 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12008 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12009
12010
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12011 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
12012 <!-- end of entry -->
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]12013
12014
12015 <tr class="entry" id="dynamic_android.statistics.predictedColorTransform">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12016 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12017 android.<wbr/>statistics.<wbr/>predicted<wbr/>Color<wbr/>Transform
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12018 </td>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]12019 <td class="entry_type">
12020 <span class="entry_type_name">rational</span>
12021 <span class="entry_type_container">x</span>
12022
12023 <span class="entry_type_array">
12024 3 x 3
12025 </span>
Igor Murashkin0fe2f132014-01-13 16:59:47 -0800[diff] [blame]12026 <span class="entry_type_visibility"> [hidden]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12027 <div class="entry_type_notes">3x3 rational matrix in row-major order</div>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]12028
12029
12030 </td> <!-- entry_type -->
12031
12032 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12033 <p>The best-fit color transform matrix estimate
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]12034calculated by the HAL's statistics units for the current
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12035output frame</p>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]12036 </td>
12037
12038 <td class="entry_units">
12039 </td>
12040
12041 <td class="entry_range">
Igor Murashkin0fe2f132014-01-13 16:59:47 -0800[diff] [blame]12042 <p><strong>Deprecated</strong>.<wbr/> Do not use.<wbr/></p>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]12043 </td>
12044
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12045 <td class="entry_tags">
12046 </td>
12047
12048 </tr>
12049 <tr class="entries_header">
12050 <th class="th_details" colspan="5">Details</th>
12051 </tr>
12052 <tr class="entry_cont">
12053 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12054 <p>The HAL must provide the estimate from its
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]12055statistics unit on the white balance transforms to use
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12056for the next frame.<wbr/> These are the values the HAL believes
12057are the best fit for the current output frame.<wbr/> This may
12058be different than the transform used for this frame,<wbr/> since
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]12059statistics processing on data from a new frame typically
12060completes after the transform has already been applied to
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12061that frame.<wbr/></p>
12062<p>These estimates must be provided for all frames,<wbr/> even if
12063capture settings and color transforms are set by the application.<wbr/></p>
12064<p>This value should always be calculated by the AWB block,<wbr/>
12065regardless of the android.<wbr/>control.<wbr/>* current values.<wbr/></p>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]12066 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12067 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12068
12069
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12070 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
12071 <!-- end of entry -->
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]12072
12073
12074 <tr class="entry" id="dynamic_android.statistics.sceneFlicker">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12075 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12076 android.<wbr/>statistics.<wbr/>scene<wbr/>Flicker
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12077 </td>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]12078 <td class="entry_type">
12079 <span class="entry_type_name entry_type_name_enum">byte</span>
12080
12081 <span class="entry_type_visibility"> [public]</span>
12082
12083 <ul class="entry_type_enum">
12084 <li>
12085 <span class="entry_type_enum_name">NONE</span>
12086 </li>
12087 <li>
12088 <span class="entry_type_enum_name">50HZ</span>
12089 </li>
12090 <li>
12091 <span class="entry_type_enum_name">60HZ</span>
12092 </li>
12093 </ul>
12094
12095 </td> <!-- entry_type -->
12096
12097 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12098 <p>The HAL estimated scene illumination lighting
12099frequency</p>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]12100 </td>
12101
12102 <td class="entry_units">
12103 </td>
12104
12105 <td class="entry_range">
12106 </td>
12107
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]12108 <td class="entry_tags">
12109 </td>
12110
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12111 </tr>
12112 <tr class="entries_header">
12113 <th class="th_details" colspan="5">Details</th>
12114 </tr>
12115 <tr class="entry_cont">
12116 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12117 <p>Report NONE if there doesn't appear to be flickering
12118illumination</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12119 </td>
12120 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12121
12122
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12123 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
12124 <!-- end of entry -->
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]12125
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12126
12127
12128 <!-- end of kind -->
12129 </tbody>
12130
12131 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12132 <tr><td colspan="6" id="section_tonemap" class="section">tonemap</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12133
12134
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12135 <tr><td colspan="6" class="kind">controls</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12136
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]12137 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12138 <tr>
12139 <th class="th_name">Property Name</th>
12140 <th class="th_type">Type</th>
12141 <th class="th_description">Description</th>
12142 <th class="th_units">Units</th>
12143 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12144 <th class="th_tags">Tags</th>
12145 </tr>
12146 </thead>
12147
12148 <tbody>
12149
12150
12151
12152
12153
12154
12155
12156
12157
12158
12159 <tr class="entry" id="controls_android.tonemap.curveBlue">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12160 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12161 android.<wbr/>tonemap.<wbr/>curve<wbr/>Blue
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12162 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12163 <td class="entry_type">
Eino-Ville Talvala76548fe2013-01-11 13:57:19 -0800[diff] [blame]12164 <span class="entry_type_name">float</span>
Zhijun He704d1282013-08-19 15:26:33 -0700[diff] [blame]12165 <span class="entry_type_container">x</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12166
Zhijun He704d1282013-08-19 15:26:33 -0700[diff] [blame]12167 <span class="entry_type_array">
12168 n x 2
12169 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]12170 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12171 <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]12172
12173
12174 </td> <!-- entry_type -->
12175
12176 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12177 <p>Table mapping blue input values to output
12178values</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12179 </td>
12180
12181 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12182 same as android.<wbr/>tonemap.<wbr/>curve<wbr/>Red
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12183 </td>
12184
12185 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]12186 <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]12187 </td>
12188
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12189 <td class="entry_tags">
12190 </td>
12191
12192 </tr>
12193 <tr class="entries_header">
12194 <th class="th_details" colspan="5">Details</th>
12195 </tr>
12196 <tr class="entry_cont">
12197 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12198 <p>Tonemapping /<wbr/> contrast /<wbr/> gamma curve for the blue
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]12199channel,<wbr/> to use when <a href="#controls_android.tonemap.mode">android.<wbr/>tonemap.<wbr/>mode</a> is CONTRAST_<wbr/>CURVE.<wbr/></p>
12200<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]12201 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12202 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12203
12204
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12205 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
12206 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12207
12208
12209 <tr class="entry" id="controls_android.tonemap.curveGreen">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12210 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12211 android.<wbr/>tonemap.<wbr/>curve<wbr/>Green
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12212 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12213 <td class="entry_type">
Eino-Ville Talvala76548fe2013-01-11 13:57:19 -0800[diff] [blame]12214 <span class="entry_type_name">float</span>
Zhijun He704d1282013-08-19 15:26:33 -0700[diff] [blame]12215 <span class="entry_type_container">x</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12216
Zhijun He704d1282013-08-19 15:26:33 -0700[diff] [blame]12217 <span class="entry_type_array">
12218 n x 2
12219 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]12220 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12221 <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]12222
12223
12224 </td> <!-- entry_type -->
12225
12226 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12227 <p>Table mapping green input values to output
12228values</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12229 </td>
12230
12231 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12232 same as android.<wbr/>tonemap.<wbr/>curve<wbr/>Red
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12233 </td>
12234
12235 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]12236 <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]12237 </td>
12238
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12239 <td class="entry_tags">
12240 </td>
12241
12242 </tr>
12243 <tr class="entries_header">
12244 <th class="th_details" colspan="5">Details</th>
12245 </tr>
12246 <tr class="entry_cont">
12247 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12248 <p>Tonemapping /<wbr/> contrast /<wbr/> gamma curve for the green
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]12249channel,<wbr/> to use when <a href="#controls_android.tonemap.mode">android.<wbr/>tonemap.<wbr/>mode</a> is CONTRAST_<wbr/>CURVE.<wbr/></p>
12250<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]12251 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12252 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12253
12254
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12255 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
12256 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12257
12258
12259 <tr class="entry" id="controls_android.tonemap.curveRed">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12260 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12261 android.<wbr/>tonemap.<wbr/>curve<wbr/>Red
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12262 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12263 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]12264 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12265 <span class="entry_type_container">x</span>
12266
12267 <span class="entry_type_array">
12268 n x 2
12269 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]12270 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12271 <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]12272
12273
12274 </td> <!-- entry_type -->
12275
12276 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12277 <p>Table mapping red input values to output
12278values</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12279 </td>
12280
12281 <td class="entry_units">
12282 </td>
12283
12284 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]12285 <p>0-1 on input and output coordinates.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12286 </td>
12287
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12288 <td class="entry_tags">
12289 <ul class="entry_tags">
12290 <li><a href="#tag_DNG">DNG</a></li>
12291 </ul>
12292 </td>
12293
12294 </tr>
12295 <tr class="entries_header">
12296 <th class="th_details" colspan="5">Details</th>
12297 </tr>
12298 <tr class="entry_cont">
12299 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12300 <p>Tonemapping /<wbr/> contrast /<wbr/> gamma curve for the red
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]12301channel,<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]12302<p>Since the input and output ranges may vary depending on
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12303the camera pipeline,<wbr/> the input and output pixel values
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]12304are represented by normalized floating-point values
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12305between 0 and 1,<wbr/> with 0 == black and 1 == white.<wbr/></p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]12306<p>The curve should be linearly interpolated between the
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12307defined points.<wbr/> The points will be listed in increasing
12308order of P_<wbr/>IN.<wbr/> For example,<wbr/> if the array is: [0.<wbr/>0,<wbr/> 0.<wbr/>0,<wbr/>
123090.<wbr/>3,<wbr/> 0.<wbr/>5,<wbr/> 1.<wbr/>0,<wbr/> 1.<wbr/>0],<wbr/> then the input-&gt;output mapping
12310for a few sample points would be: 0 -&gt; 0,<wbr/> 0.<wbr/>15 -&gt;
123110.<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]12312 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12313 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12314
12315
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12316 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
12317 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12318
12319
12320 <tr class="entry" id="controls_android.tonemap.mode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12321 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12322 android.<wbr/>tonemap.<wbr/>mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12323 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12324 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]12325 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12326
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]12327 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12328
12329 <ul class="entry_type_enum">
12330 <li>
12331 <span class="entry_type_enum_name">CONTRAST_CURVE</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]12332 <span class="entry_type_enum_notes"><p>Use the tone mapping curve specified in
12333android.<wbr/>tonemap.<wbr/>curve</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12334 </li>
12335 <li>
12336 <span class="entry_type_enum_name">FAST</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]12337 <span class="entry_type_enum_notes"><p>Must not slow down frame rate relative to raw
12338bayer output</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12339 </li>
12340 <li>
12341 <span class="entry_type_enum_name">HIGH_QUALITY</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]12342 <span class="entry_type_enum_notes"><p>Frame rate may be reduced by high
12343quality</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12344 </li>
12345 </ul>
12346
12347 </td> <!-- entry_type -->
12348
12349 <td class="entry_description">
12350 </td>
12351
12352 <td class="entry_units">
12353 </td>
12354
12355 <td class="entry_range">
12356 </td>
12357
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12358 <td class="entry_tags">
12359 </td>
12360
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12361 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12362
12363
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12364 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
12365 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12366
12367
12368
12369 <!-- end of kind -->
12370 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12371 <tr><td colspan="6" class="kind">static</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12372
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]12373 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12374 <tr>
12375 <th class="th_name">Property Name</th>
12376 <th class="th_type">Type</th>
12377 <th class="th_description">Description</th>
12378 <th class="th_units">Units</th>
12379 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12380 <th class="th_tags">Tags</th>
12381 </tr>
12382 </thead>
12383
12384 <tbody>
12385
12386
12387
12388
12389
12390
12391
12392
12393
12394
12395 <tr class="entry" id="static_android.tonemap.maxCurvePoints">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12396 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12397 android.<wbr/>tonemap.<wbr/>max<wbr/>Curve<wbr/>Points
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12398 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12399 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]12400 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12401
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]12402 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12403
12404
12405 </td> <!-- entry_type -->
12406
12407 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12408 <p>Maximum number of supported points in the
12409tonemap curve</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12410 </td>
12411
12412 <td class="entry_units">
12413 </td>
12414
12415 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame]12416 <p>&gt;= 128</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12417 </td>
12418
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12419 <td class="entry_tags">
12420 </td>
12421
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12422 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12423
12424
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12425 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
12426 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12427
12428
12429
12430 <!-- end of kind -->
12431 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12432 <tr><td colspan="6" class="kind">dynamic</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12433
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]12434 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12435 <tr>
12436 <th class="th_name">Property Name</th>
12437 <th class="th_type">Type</th>
12438 <th class="th_description">Description</th>
12439 <th class="th_units">Units</th>
12440 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12441 <th class="th_tags">Tags</th>
12442 </tr>
12443 </thead>
12444
12445 <tbody>
12446
12447
12448
12449
12450
12451
12452
12453
12454
12455
12456 <tr class="entry" id="dynamic_android.tonemap.curveBlue">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12457 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12458 android.<wbr/>tonemap.<wbr/>curve<wbr/>Blue
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12459 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12460 <td class="entry_type">
Eino-Ville Talvala76548fe2013-01-11 13:57:19 -0800[diff] [blame]12461 <span class="entry_type_name">float</span>
Zhijun He704d1282013-08-19 15:26:33 -0700[diff] [blame]12462 <span class="entry_type_container">x</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12463
Zhijun He704d1282013-08-19 15:26:33 -0700[diff] [blame]12464 <span class="entry_type_array">
12465 n x 2
12466 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]12467 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12468 <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]12469
12470
12471 </td> <!-- entry_type -->
12472
12473 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12474 <p>Table mapping blue input values to output
12475values</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12476 </td>
12477
12478 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12479 same as android.<wbr/>tonemap.<wbr/>curve<wbr/>Red
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12480 </td>
12481
12482 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]12483 <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]12484 </td>
12485
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12486 <td class="entry_tags">
12487 </td>
12488
12489 </tr>
12490 <tr class="entries_header">
12491 <th class="th_details" colspan="5">Details</th>
12492 </tr>
12493 <tr class="entry_cont">
12494 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12495 <p>Tonemapping /<wbr/> contrast /<wbr/> gamma curve for the blue
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]12496channel,<wbr/> to use when <a href="#controls_android.tonemap.mode">android.<wbr/>tonemap.<wbr/>mode</a> is CONTRAST_<wbr/>CURVE.<wbr/></p>
12497<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]12498 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12499 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12500
12501
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12502 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
12503 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12504
12505
12506 <tr class="entry" id="dynamic_android.tonemap.curveGreen">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12507 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12508 android.<wbr/>tonemap.<wbr/>curve<wbr/>Green
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12509 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12510 <td class="entry_type">
Eino-Ville Talvala76548fe2013-01-11 13:57:19 -0800[diff] [blame]12511 <span class="entry_type_name">float</span>
Zhijun He704d1282013-08-19 15:26:33 -0700[diff] [blame]12512 <span class="entry_type_container">x</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12513
Zhijun He704d1282013-08-19 15:26:33 -0700[diff] [blame]12514 <span class="entry_type_array">
12515 n x 2
12516 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]12517 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12518 <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]12519
12520
12521 </td> <!-- entry_type -->
12522
12523 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12524 <p>Table mapping green input values to output
12525values</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12526 </td>
12527
12528 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12529 same as android.<wbr/>tonemap.<wbr/>curve<wbr/>Red
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12530 </td>
12531
12532 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]12533 <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]12534 </td>
12535
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12536 <td class="entry_tags">
12537 </td>
12538
12539 </tr>
12540 <tr class="entries_header">
12541 <th class="th_details" colspan="5">Details</th>
12542 </tr>
12543 <tr class="entry_cont">
12544 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12545 <p>Tonemapping /<wbr/> contrast /<wbr/> gamma curve for the green
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]12546channel,<wbr/> to use when <a href="#controls_android.tonemap.mode">android.<wbr/>tonemap.<wbr/>mode</a> is CONTRAST_<wbr/>CURVE.<wbr/></p>
12547<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]12548 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12549 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12550
12551
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12552 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
12553 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12554
12555
12556 <tr class="entry" id="dynamic_android.tonemap.curveRed">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12557 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12558 android.<wbr/>tonemap.<wbr/>curve<wbr/>Red
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12559 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12560 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]12561 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12562 <span class="entry_type_container">x</span>
12563
12564 <span class="entry_type_array">
12565 n x 2
12566 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]12567 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12568 <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]12569
12570
12571 </td> <!-- entry_type -->
12572
12573 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12574 <p>Table mapping red input values to output
12575values</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12576 </td>
12577
12578 <td class="entry_units">
12579 </td>
12580
12581 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]12582 <p>0-1 on input and output coordinates.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12583 </td>
12584
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12585 <td class="entry_tags">
12586 <ul class="entry_tags">
12587 <li><a href="#tag_DNG">DNG</a></li>
12588 </ul>
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>Tonemapping /<wbr/> contrast /<wbr/> gamma curve for the red
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]12598channel,<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]12599<p>Since the input and output ranges may vary depending on
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12600the camera pipeline,<wbr/> the input and output pixel values
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]12601are represented by normalized floating-point values
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12602between 0 and 1,<wbr/> with 0 == black and 1 == white.<wbr/></p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]12603<p>The curve should be linearly interpolated between the
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12604defined points.<wbr/> The points will be listed in increasing
12605order of P_<wbr/>IN.<wbr/> For example,<wbr/> if the array is: [0.<wbr/>0,<wbr/> 0.<wbr/>0,<wbr/>
126060.<wbr/>3,<wbr/> 0.<wbr/>5,<wbr/> 1.<wbr/>0,<wbr/> 1.<wbr/>0],<wbr/> then the input-&gt;output mapping
12607for a few sample points would be: 0 -&gt; 0,<wbr/> 0.<wbr/>15 -&gt;
126080.<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]12609 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12610 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12611
12612
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12613 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
12614 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12615
12616
12617 <tr class="entry" id="dynamic_android.tonemap.mode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12618 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12619 android.<wbr/>tonemap.<wbr/>mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12620 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12621 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]12622 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12623
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]12624 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12625
12626 <ul class="entry_type_enum">
12627 <li>
12628 <span class="entry_type_enum_name">CONTRAST_CURVE</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]12629 <span class="entry_type_enum_notes"><p>Use the tone mapping curve specified in
12630android.<wbr/>tonemap.<wbr/>curve</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12631 </li>
12632 <li>
12633 <span class="entry_type_enum_name">FAST</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]12634 <span class="entry_type_enum_notes"><p>Must not slow down frame rate relative to raw
12635bayer output</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12636 </li>
12637 <li>
12638 <span class="entry_type_enum_name">HIGH_QUALITY</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]12639 <span class="entry_type_enum_notes"><p>Frame rate may be reduced by high
12640quality</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12641 </li>
12642 </ul>
12643
12644 </td> <!-- entry_type -->
12645
12646 <td class="entry_description">
12647 </td>
12648
12649 <td class="entry_units">
12650 </td>
12651
12652 <td class="entry_range">
12653 </td>
12654
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12655 <td class="entry_tags">
12656 </td>
12657
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12658 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12659
12660
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12661 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
12662 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12663
12664
12665
12666 <!-- end of kind -->
12667 </tbody>
12668
12669 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12670 <tr><td colspan="6" id="section_led" class="section">led</td></tr>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12671
12672
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12673 <tr><td colspan="6" class="kind">controls</td></tr>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12674
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]12675 <thead class="entries_header">
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12676 <tr>
12677 <th class="th_name">Property Name</th>
12678 <th class="th_type">Type</th>
12679 <th class="th_description">Description</th>
12680 <th class="th_units">Units</th>
12681 <th class="th_range">Range</th>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12682 <th class="th_tags">Tags</th>
12683 </tr>
12684 </thead>
12685
12686 <tbody>
12687
12688
12689
12690
12691
12692
12693
12694
12695
12696
12697 <tr class="entry" id="controls_android.led.transmit">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12698 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12699 android.<wbr/>led.<wbr/>transmit
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12700 </td>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12701 <td class="entry_type">
12702 <span class="entry_type_name entry_type_name_enum">byte</span>
12703
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]12704 <span class="entry_type_visibility"> [hidden as boolean]</span>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12705
12706 <ul class="entry_type_enum">
12707 <li>
12708 <span class="entry_type_enum_name">OFF</span>
12709 </li>
12710 <li>
12711 <span class="entry_type_enum_name">ON</span>
12712 </li>
12713 </ul>
12714
12715 </td> <!-- entry_type -->
12716
12717 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12718 <p>This LED is nominally used to indicate to the user
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]12719that the camera is powered on and may be streaming images back to the
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12720Application Processor.<wbr/> In certain rare circumstances,<wbr/> the OS may
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]12721disable this when video is processed locally and not transmitted to
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12722any untrusted applications.<wbr/></p>
12723<p>In particular,<wbr/> the LED <em>must</em> always be on when the data could be
12724transmitted off the device.<wbr/> The LED <em>should</em> always be on whenever
12725data is stored locally on the device.<wbr/></p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]12726<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]12727doesn't violate the above rules.<wbr/></p>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12728 </td>
12729
12730 <td class="entry_units">
12731 </td>
12732
12733 <td class="entry_range">
12734 </td>
12735
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12736 <td class="entry_tags">
12737 </td>
12738
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12739 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12740
12741
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12742 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
12743 <!-- end of entry -->
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12744
12745
12746
12747 <!-- end of kind -->
12748 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12749 <tr><td colspan="6" class="kind">dynamic</td></tr>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12750
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]12751 <thead class="entries_header">
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12752 <tr>
12753 <th class="th_name">Property Name</th>
12754 <th class="th_type">Type</th>
12755 <th class="th_description">Description</th>
12756 <th class="th_units">Units</th>
12757 <th class="th_range">Range</th>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12758 <th class="th_tags">Tags</th>
12759 </tr>
12760 </thead>
12761
12762 <tbody>
12763
12764
12765
12766
12767
12768
12769
12770
12771
12772
12773 <tr class="entry" id="dynamic_android.led.transmit">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12774 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12775 android.<wbr/>led.<wbr/>transmit
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12776 </td>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12777 <td class="entry_type">
12778 <span class="entry_type_name entry_type_name_enum">byte</span>
12779
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]12780 <span class="entry_type_visibility"> [hidden as boolean]</span>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12781
12782 <ul class="entry_type_enum">
12783 <li>
12784 <span class="entry_type_enum_name">OFF</span>
12785 </li>
12786 <li>
12787 <span class="entry_type_enum_name">ON</span>
12788 </li>
12789 </ul>
12790
12791 </td> <!-- entry_type -->
12792
12793 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12794 <p>This LED is nominally used to indicate to the user
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]12795that the camera is powered on and may be streaming images back to the
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12796Application Processor.<wbr/> In certain rare circumstances,<wbr/> the OS may
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]12797disable this when video is processed locally and not transmitted to
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12798any untrusted applications.<wbr/></p>
12799<p>In particular,<wbr/> the LED <em>must</em> always be on when the data could be
12800transmitted off the device.<wbr/> The LED <em>should</em> always be on whenever
12801data is stored locally on the device.<wbr/></p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]12802<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]12803doesn't violate the above rules.<wbr/></p>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12804 </td>
12805
12806 <td class="entry_units">
12807 </td>
12808
12809 <td class="entry_range">
12810 </td>
12811
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12812 <td class="entry_tags">
12813 </td>
12814
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12815 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12816
12817
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12818 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
12819 <!-- end of entry -->
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12820
12821
12822
12823 <!-- end of kind -->
12824 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12825 <tr><td colspan="6" class="kind">static</td></tr>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12826
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]12827 <thead class="entries_header">
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12828 <tr>
12829 <th class="th_name">Property Name</th>
12830 <th class="th_type">Type</th>
12831 <th class="th_description">Description</th>
12832 <th class="th_units">Units</th>
12833 <th class="th_range">Range</th>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12834 <th class="th_tags">Tags</th>
12835 </tr>
12836 </thead>
12837
12838 <tbody>
12839
12840
12841
12842
12843
12844
12845
12846
12847
12848
12849 <tr class="entry" id="static_android.led.availableLeds">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12850 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12851 android.<wbr/>led.<wbr/>available<wbr/>Leds
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12852 </td>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12853 <td class="entry_type">
12854 <span class="entry_type_name entry_type_name_enum">byte</span>
12855 <span class="entry_type_container">x</span>
12856
12857 <span class="entry_type_array">
12858 n
12859 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]12860 <span class="entry_type_visibility"> [hidden]</span>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12861
12862 <ul class="entry_type_enum">
12863 <li>
12864 <span class="entry_type_enum_name">TRANSMIT</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]12865 <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]12866 </li>
12867 </ul>
12868
12869 </td> <!-- entry_type -->
12870
12871 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12872 <p>A list of camera LEDs that are available on this system.<wbr/></p>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12873 </td>
12874
12875 <td class="entry_units">
12876 </td>
12877
12878 <td class="entry_range">
12879 </td>
12880
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12881 <td class="entry_tags">
12882 </td>
12883
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12884 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12885
12886
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12887 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
12888 <!-- end of entry -->
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12889
12890
12891
12892 <!-- end of kind -->
12893 </tbody>
12894
12895 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12896 <tr><td colspan="6" id="section_info" class="section">info</td></tr>
Igor Murashkin38b8cae2013-05-23 16:38:59 -0700[diff] [blame]12897
12898
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12899 <tr><td colspan="6" class="kind">static</td></tr>
Igor Murashkin38b8cae2013-05-23 16:38:59 -0700[diff] [blame]12900
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]12901 <thead class="entries_header">
Igor Murashkin38b8cae2013-05-23 16:38:59 -0700[diff] [blame]12902 <tr>
12903 <th class="th_name">Property Name</th>
12904 <th class="th_type">Type</th>
12905 <th class="th_description">Description</th>
12906 <th class="th_units">Units</th>
12907 <th class="th_range">Range</th>
Igor Murashkin38b8cae2013-05-23 16:38:59 -0700[diff] [blame]12908 <th class="th_tags">Tags</th>
12909 </tr>
12910 </thead>
12911
12912 <tbody>
12913
12914
12915
12916
12917
12918
12919
12920
12921
12922
12923 <tr class="entry" id="static_android.info.supportedHardwareLevel">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12924 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12925 android.<wbr/>info.<wbr/>supported<wbr/>Hardware<wbr/>Level
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12926 </td>
Igor Murashkin38b8cae2013-05-23 16:38:59 -0700[diff] [blame]12927 <td class="entry_type">
12928 <span class="entry_type_name entry_type_name_enum">byte</span>
12929
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]12930 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin38b8cae2013-05-23 16:38:59 -0700[diff] [blame]12931
12932 <ul class="entry_type_enum">
12933 <li>
12934 <span class="entry_type_enum_name">LIMITED</span>
12935 </li>
12936 <li>
12937 <span class="entry_type_enum_name">FULL</span>
12938 </li>
12939 </ul>
12940
12941 </td> <!-- entry_type -->
12942
12943 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12944 <p>The camera 3 HAL device can implement one of two possible
12945operational modes; limited and full.<wbr/> Full support is
12946expected from new higher-end devices.<wbr/> Limited mode has
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]12947hardware requirements roughly in line with those for a
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12948camera HAL device v1 implementation,<wbr/> and is expected from
12949older or inexpensive devices.<wbr/> Full is a strict superset of
12950limited,<wbr/> and they share the same essential operational flow.<wbr/></p>
12951<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]12952 </td>
12953
12954 <td class="entry_units">
12955 </td>
12956
12957 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]12958 <p>Optional.<wbr/> Default value is LIMITED.<wbr/></p>
Igor Murashkin38b8cae2013-05-23 16:38:59 -0700[diff] [blame]12959 </td>
12960
Igor Murashkin38b8cae2013-05-23 16:38:59 -0700[diff] [blame]12961 <td class="entry_tags">
12962 </td>
12963
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12964 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12965
12966
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12967 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
12968 <!-- end of entry -->
Igor Murashkin38b8cae2013-05-23 16:38:59 -0700[diff] [blame]12969
12970
12971
12972 <!-- end of kind -->
12973 </tbody>
12974
12975 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12976 <tr><td colspan="6" id="section_blackLevel" class="section">blackLevel</td></tr>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]12977
12978
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12979 <tr><td colspan="6" class="kind">controls</td></tr>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]12980
12981 <thead class="entries_header">
12982 <tr>
12983 <th class="th_name">Property Name</th>
12984 <th class="th_type">Type</th>
12985 <th class="th_description">Description</th>
12986 <th class="th_units">Units</th>
12987 <th class="th_range">Range</th>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]12988 <th class="th_tags">Tags</th>
12989 </tr>
12990 </thead>
12991
12992 <tbody>
12993
12994
12995
12996
12997
12998
12999
13000
13001
13002
13003 <tr class="entry" id="controls_android.blackLevel.lock">
Eino-Ville Talvala7796cfe2013-12-26 13:16:54 -0800[diff] [blame]13004 <td class="entry_name" rowspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13005 android.<wbr/>black<wbr/>Level.<wbr/>lock
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]13006 </td>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]13007 <td class="entry_type">
13008 <span class="entry_type_name entry_type_name_enum">byte</span>
13009
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]13010 <span class="entry_type_visibility"> [public as boolean]</span>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]13011
13012 <ul class="entry_type_enum">
13013 <li>
13014 <span class="entry_type_enum_name">OFF</span>
13015 </li>
13016 <li>
13017 <span class="entry_type_enum_name">ON</span>
13018 </li>
13019 </ul>
13020
13021 </td> <!-- entry_type -->
13022
13023 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13024 <p>Whether black-level compensation is locked
13025to its current values,<wbr/> or is free to vary.<wbr/></p>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]13026 </td>
13027
13028 <td class="entry_units">
13029 </td>
13030
13031 <td class="entry_range">
13032 </td>
13033
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13034 <td class="entry_tags">
13035 <ul class="entry_tags">
13036 <li><a href="#tag_HAL2">HAL2</a></li>
13037 </ul>
13038 </td>
13039
13040 </tr>
13041 <tr class="entries_header">
13042 <th class="th_details" colspan="5">Details</th>
13043 </tr>
13044 <tr class="entry_cont">
13045 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13046 <p>When set to ON,<wbr/> the values used for black-level
Eino-Ville Talvala7796cfe2013-12-26 13:16:54 -0800[diff] [blame]13047compensation will not change until the lock is set to
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13048OFF.<wbr/></p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]13049<p>Since changes to certain capture parameters (such as
13050exposure time) may require resetting of black level
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13051compensation,<wbr/> the camera device must report whether setting
Eino-Ville Talvala7796cfe2013-12-26 13:16:54 -0800[diff] [blame]13052the black level lock was successful in the output result
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13053metadata.<wbr/></p>
13054<p>For example,<wbr/> if a sequence of requests is as follows:</p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]13055<ul>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13056<li>Request 1: Exposure = 10ms,<wbr/> Black level lock = OFF</li>
13057<li>Request 2: Exposure = 10ms,<wbr/> Black level lock = ON</li>
13058<li>Request 3: Exposure = 10ms,<wbr/> Black level lock = ON</li>
13059<li>Request 4: Exposure = 20ms,<wbr/> Black level lock = ON</li>
13060<li>Request 5: Exposure = 20ms,<wbr/> Black level lock = ON</li>
13061<li>Request 6: Exposure = 20ms,<wbr/> Black level lock = ON</li>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]13062</ul>
Eino-Ville Talvala7796cfe2013-12-26 13:16:54 -0800[diff] [blame]13063<p>And the exposure change in Request 4 requires the camera
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13064device to reset the black level offsets,<wbr/> then the output
Eino-Ville Talvala7796cfe2013-12-26 13:16:54 -0800[diff] [blame]13065result metadata is expected to be:</p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]13066<ul>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13067<li>Result 1: Exposure = 10ms,<wbr/> Black level lock = OFF</li>
13068<li>Result 2: Exposure = 10ms,<wbr/> Black level lock = ON</li>
13069<li>Result 3: Exposure = 10ms,<wbr/> Black level lock = ON</li>
13070<li>Result 4: Exposure = 20ms,<wbr/> Black level lock = OFF</li>
13071<li>Result 5: Exposure = 20ms,<wbr/> Black level lock = ON</li>
13072<li>Result 6: Exposure = 20ms,<wbr/> Black level lock = ON</li>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]13073</ul>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13074<p>This indicates to the application that on frame 4,<wbr/> black
13075levels were reset due to exposure value changes,<wbr/> and pixel
13076values may not be consistent across captures.<wbr/></p>
Eino-Ville Talvala7796cfe2013-12-26 13:16:54 -0800[diff] [blame]13077<p>The camera device will maintain the lock to the extent
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13078possible,<wbr/> only overriding the lock to OFF when changes to
Eino-Ville Talvala7796cfe2013-12-26 13:16:54 -0800[diff] [blame]13079other request parameters require a black level recalculation
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13080or reset.<wbr/></p>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]13081 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13082 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]13083
Eino-Ville Talvala7796cfe2013-12-26 13:16:54 -0800[diff] [blame]13084 <tr class="entries_header">
13085 <th class="th_details" colspan="5">HAL Implementation Details</th>
13086 </tr>
13087 <tr class="entry_cont">
13088 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13089 <p>If for some reason black level locking is no longer possible
13090(for example,<wbr/> the analog gain has changed,<wbr/> which forces
13091black level offsets to be recalculated),<wbr/> then the HAL must
Eino-Ville Talvala7796cfe2013-12-26 13:16:54 -0800[diff] [blame]13092override this request (and it must report 'OFF' when this
13093does happen) until the next capture for which locking is
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13094possible again.<wbr/></p>
Eino-Ville Talvala7796cfe2013-12-26 13:16:54 -0800[diff] [blame]13095 </td>
13096 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]13097
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13098 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
13099 <!-- end of entry -->
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]13100
13101
13102
13103 <!-- end of kind -->
13104 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13105 <tr><td colspan="6" class="kind">dynamic</td></tr>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]13106
13107 <thead class="entries_header">
13108 <tr>
13109 <th class="th_name">Property Name</th>
13110 <th class="th_type">Type</th>
13111 <th class="th_description">Description</th>
13112 <th class="th_units">Units</th>
13113 <th class="th_range">Range</th>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]13114 <th class="th_tags">Tags</th>
13115 </tr>
13116 </thead>
13117
13118 <tbody>
13119
13120
13121
13122
13123
13124
13125
13126
13127
13128
13129 <tr class="entry" id="dynamic_android.blackLevel.lock">
Eino-Ville Talvala7796cfe2013-12-26 13:16:54 -0800[diff] [blame]13130 <td class="entry_name" rowspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13131 android.<wbr/>black<wbr/>Level.<wbr/>lock
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]13132 </td>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]13133 <td class="entry_type">
13134 <span class="entry_type_name entry_type_name_enum">byte</span>
13135
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]13136 <span class="entry_type_visibility"> [public as boolean]</span>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]13137
13138 <ul class="entry_type_enum">
13139 <li>
13140 <span class="entry_type_enum_name">OFF</span>
13141 </li>
13142 <li>
13143 <span class="entry_type_enum_name">ON</span>
13144 </li>
13145 </ul>
13146
13147 </td> <!-- entry_type -->
13148
13149 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13150 <p>Whether black-level compensation is locked
13151to its current values,<wbr/> or is free to vary.<wbr/></p>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]13152 </td>
13153
13154 <td class="entry_units">
13155 </td>
13156
13157 <td class="entry_range">
13158 </td>
13159
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]13160 <td class="entry_tags">
13161 <ul class="entry_tags">
13162 <li><a href="#tag_HAL2">HAL2</a></li>
13163 </ul>
13164 </td>
13165
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13166 </tr>
13167 <tr class="entries_header">
13168 <th class="th_details" colspan="5">Details</th>
13169 </tr>
13170 <tr class="entry_cont">
13171 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13172 <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]13173ON 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]13174a change in other capture settings forced the camera device to
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13175perform a black level reset.<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13176 </td>
13177 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]13178
Eino-Ville Talvala7796cfe2013-12-26 13:16:54 -0800[diff] [blame]13179 <tr class="entries_header">
13180 <th class="th_details" colspan="5">HAL Implementation Details</th>
13181 </tr>
13182 <tr class="entry_cont">
13183 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13184 <p>If for some reason black level locking is no longer possible
13185(for example,<wbr/> the analog gain has changed,<wbr/> which forces
13186black level offsets to be recalculated),<wbr/> then the HAL must
Eino-Ville Talvala7796cfe2013-12-26 13:16:54 -0800[diff] [blame]13187override this request (and it must report 'OFF' when this
13188does happen) until the next capture for which locking is
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13189possible again.<wbr/></p>
Eino-Ville Talvala7796cfe2013-12-26 13:16:54 -0800[diff] [blame]13190 </td>
13191 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]13192
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13193 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
13194 <!-- end of entry -->
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]13195
13196
13197
13198 <!-- end of kind -->
13199 </tbody>
13200
13201 <!-- end of section -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13202<!-- </namespace> -->
13203 </table>
13204
13205 <div class="tags" id="tag_index">
13206 <h2>Tags</h2>
13207 <ul>
13208 <li id="tag_AWB">AWB -
13209 Needed for auto white balance
13210
13211 <ul class="tags_entries">
13212 <li><a href="#controls_android.control.awbMode">android.control.awbMode</a> (controls)</li>
13213 </ul>
13214 </li> <!-- tag_AWB -->
13215 <li id="tag_BC">BC -
13216 Needed for backwards compatibility with old Java API
13217
13218 <ul class="tags_entries">
Eino-Ville Talvala19ce2c12013-12-30 12:03:45 -0800[diff] [blame]13219 <li><a href="#controls_android.control.aeAntibandingMode">android.control.aeAntibandingMode</a> (controls)</li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13220 <li><a href="#controls_android.control.aeExposureCompensation">android.control.aeExposureCompensation</a> (controls)</li>
13221 <li><a href="#controls_android.control.aeLock">android.control.aeLock</a> (controls)</li>
13222 <li><a href="#controls_android.control.aeMode">android.control.aeMode</a> (controls)</li>
13223 <li><a href="#controls_android.control.aeRegions">android.control.aeRegions</a> (controls)</li>
13224 <li><a href="#controls_android.control.aeTargetFpsRange">android.control.aeTargetFpsRange</a> (controls)</li>
Eino-Ville Talvala3b4383a2013-03-18 09:42:48 -0700[diff] [blame]13225 <li><a href="#controls_android.control.aePrecaptureTrigger">android.control.aePrecaptureTrigger</a> (controls)</li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13226 <li><a href="#controls_android.control.afMode">android.control.afMode</a> (controls)</li>
13227 <li><a href="#controls_android.control.afRegions">android.control.afRegions</a> (controls)</li>
Eino-Ville Talvala3b4383a2013-03-18 09:42:48 -0700[diff] [blame]13228 <li><a href="#controls_android.control.afTrigger">android.control.afTrigger</a> (controls)</li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13229 <li><a href="#controls_android.control.awbLock">android.control.awbLock</a> (controls)</li>
13230 <li><a href="#controls_android.control.awbMode">android.control.awbMode</a> (controls)</li>
13231 <li><a href="#controls_android.control.awbRegions">android.control.awbRegions</a> (controls)</li>
13232 <li><a href="#controls_android.control.captureIntent">android.control.captureIntent</a> (controls)</li>
13233 <li><a href="#controls_android.control.effectMode">android.control.effectMode</a> (controls)</li>
13234 <li><a href="#controls_android.control.mode">android.control.mode</a> (controls)</li>
13235 <li><a href="#controls_android.control.sceneMode">android.control.sceneMode</a> (controls)</li>
13236 <li><a href="#controls_android.control.videoStabilizationMode">android.control.videoStabilizationMode</a> (controls)</li>
Eino-Ville Talvala9fa0d902014-01-08 16:16:53 -0800[diff] [blame]13237 <li><a href="#static_android.control.aeAvailableModes">android.control.aeAvailableModes</a> (static)</li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13238 <li><a href="#static_android.control.aeCompensationRange">android.control.aeCompensationRange</a> (static)</li>
13239 <li><a href="#static_android.control.aeCompensationStep">android.control.aeCompensationStep</a> (static)</li>
13240 <li><a href="#static_android.control.afAvailableModes">android.control.afAvailableModes</a> (static)</li>
13241 <li><a href="#static_android.control.availableEffects">android.control.availableEffects</a> (static)</li>
13242 <li><a href="#static_android.control.availableSceneModes">android.control.availableSceneModes</a> (static)</li>
13243 <li><a href="#static_android.control.availableVideoStabilizationModes">android.control.availableVideoStabilizationModes</a> (static)</li>
13244 <li><a href="#static_android.control.awbAvailableModes">android.control.awbAvailableModes</a> (static)</li>
13245 <li><a href="#static_android.control.maxRegions">android.control.maxRegions</a> (static)</li>
13246 <li><a href="#static_android.control.sceneModeOverrides">android.control.sceneModeOverrides</a> (static)</li>
13247 <li><a href="#controls_android.flash.mode">android.flash.mode</a> (controls)</li>
13248 <li><a href="#static_android.flash.info.available">android.flash.info.available</a> (static)</li>
13249 <li><a href="#controls_android.jpeg.gpsCoordinates">android.jpeg.gpsCoordinates</a> (controls)</li>
13250 <li><a href="#controls_android.jpeg.gpsProcessingMethod">android.jpeg.gpsProcessingMethod</a> (controls)</li>
13251 <li><a href="#controls_android.jpeg.gpsTimestamp">android.jpeg.gpsTimestamp</a> (controls)</li>
13252 <li><a href="#controls_android.jpeg.orientation">android.jpeg.orientation</a> (controls)</li>
13253 <li><a href="#controls_android.jpeg.quality">android.jpeg.quality</a> (controls)</li>
13254 <li><a href="#controls_android.jpeg.thumbnailQuality">android.jpeg.thumbnailQuality</a> (controls)</li>
13255 <li><a href="#controls_android.jpeg.thumbnailSize">android.jpeg.thumbnailSize</a> (controls)</li>
13256 <li><a href="#static_android.jpeg.availableThumbnailSizes">android.jpeg.availableThumbnailSizes</a> (static)</li>
13257 <li><a href="#controls_android.lens.focusDistance">android.lens.focusDistance</a> (controls)</li>
13258 <li><a href="#static_android.lens.info.availableFocalLengths">android.lens.info.availableFocalLengths</a> (static)</li>
13259 <li><a href="#static_android.lens.info.hyperfocalDistance">android.lens.info.hyperfocalDistance</a> (static)</li>
13260 <li><a href="#dynamic_android.lens.focusRange">android.lens.focusRange</a> (dynamic)</li>
13261 <li><a href="#static_android.request.maxNumOutputStreams">android.request.maxNumOutputStreams</a> (static)</li>
13262 <li><a href="#controls_android.scaler.cropRegion">android.scaler.cropRegion</a> (controls)</li>
13263 <li><a href="#static_android.scaler.availableFormats">android.scaler.availableFormats</a> (static)</li>
13264 <li><a href="#static_android.scaler.availableJpegMinDurations">android.scaler.availableJpegMinDurations</a> (static)</li>
13265 <li><a href="#static_android.scaler.availableJpegSizes">android.scaler.availableJpegSizes</a> (static)</li>
Igor Murashkinf11a4df2013-05-07 10:00:46 -0700[diff] [blame]13266 <li><a href="#static_android.scaler.availableMaxDigitalZoom">android.scaler.availableMaxDigitalZoom</a> (static)</li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13267 <li><a href="#static_android.scaler.availableProcessedMinDurations">android.scaler.availableProcessedMinDurations</a> (static)</li>
13268 <li><a href="#static_android.scaler.availableProcessedSizes">android.scaler.availableProcessedSizes</a> (static)</li>
13269 <li><a href="#static_android.scaler.availableRawMinDurations">android.scaler.availableRawMinDurations</a> (static)</li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13270 <li><a href="#controls_android.sensor.frameDuration">android.sensor.frameDuration</a> (controls)</li>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]13271 <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]13272 <li><a href="#static_android.sensor.info.maxFrameDuration">android.sensor.info.maxFrameDuration</a> (static)</li>
13273 <li><a href="#static_android.sensor.info.physicalSize">android.sensor.info.physicalSize</a> (static)</li>
13274 <li><a href="#static_android.sensor.info.pixelArraySize">android.sensor.info.pixelArraySize</a> (static)</li>
13275 <li><a href="#static_android.sensor.orientation">android.sensor.orientation</a> (static)</li>
13276 <li><a href="#dynamic_android.sensor.timestamp">android.sensor.timestamp</a> (dynamic)</li>
13277 <li><a href="#controls_android.statistics.faceDetectMode">android.statistics.faceDetectMode</a> (controls)</li>
13278 <li><a href="#dynamic_android.statistics.faceIds">android.statistics.faceIds</a> (dynamic)</li>
13279 <li><a href="#dynamic_android.statistics.faceLandmarks">android.statistics.faceLandmarks</a> (dynamic)</li>
13280 <li><a href="#dynamic_android.statistics.faceRectangles">android.statistics.faceRectangles</a> (dynamic)</li>
13281 <li><a href="#dynamic_android.statistics.faceScores">android.statistics.faceScores</a> (dynamic)</li>
13282 <li><a href="#dynamic_android.lens.focalLength">android.lens.focalLength</a> (dynamic)</li>
13283 <li><a href="#dynamic_android.lens.focusDistance">android.lens.focusDistance</a> (dynamic)</li>
13284 </ul>
13285 </li> <!-- tag_BC -->
13286 <li id="tag_V1">V1 -
13287 New features for first camera 2 release (API1)
13288
13289 <ul class="tags_entries">
13290 <li><a href="#controls_android.demosaic.mode">android.demosaic.mode</a> (controls)</li>
13291 <li><a href="#controls_android.flash.firingPower">android.flash.firingPower</a> (controls)</li>
13292 <li><a href="#controls_android.flash.firingTime">android.flash.firingTime</a> (controls)</li>
13293 <li><a href="#static_android.flash.info.chargeDuration">android.flash.info.chargeDuration</a> (static)</li>
13294 <li><a href="#controls_android.hotPixel.mode">android.hotPixel.mode</a> (controls)</li>
13295 <li><a href="#controls_android.lens.aperture">android.lens.aperture</a> (controls)</li>
13296 <li><a href="#controls_android.lens.filterDensity">android.lens.filterDensity</a> (controls)</li>
13297 <li><a href="#controls_android.lens.focalLength">android.lens.focalLength</a> (controls)</li>
13298 <li><a href="#controls_android.lens.focusDistance">android.lens.focusDistance</a> (controls)</li>
13299 <li><a href="#controls_android.lens.opticalStabilizationMode">android.lens.opticalStabilizationMode</a> (controls)</li>
13300 <li><a href="#static_android.lens.info.availableApertures">android.lens.info.availableApertures</a> (static)</li>
13301 <li><a href="#static_android.lens.info.availableFilterDensities">android.lens.info.availableFilterDensities</a> (static)</li>
13302 <li><a href="#static_android.lens.info.availableFocalLengths">android.lens.info.availableFocalLengths</a> (static)</li>
13303 <li><a href="#static_android.lens.info.availableOpticalStabilization">android.lens.info.availableOpticalStabilization</a> (static)</li>
13304 <li><a href="#static_android.lens.info.geometricCorrectionMapSize">android.lens.info.geometricCorrectionMapSize</a> (static)</li>
13305 <li><a href="#static_android.lens.info.minimumFocusDistance">android.lens.info.minimumFocusDistance</a> (static)</li>
13306 <li><a href="#static_android.lens.info.shadingMapSize">android.lens.info.shadingMapSize</a> (static)</li>
13307 <li><a href="#static_android.lens.position">android.lens.position</a> (static)</li>
13308 <li><a href="#dynamic_android.lens.state">android.lens.state</a> (dynamic)</li>
13309 <li><a href="#controls_android.noiseReduction.mode">android.noiseReduction.mode</a> (controls)</li>
13310 <li><a href="#controls_android.request.id">android.request.id</a> (controls)</li>
13311 <li><a href="#controls_android.sensor.exposureTime">android.sensor.exposureTime</a> (controls)</li>
13312 <li><a href="#controls_android.sensor.frameDuration">android.sensor.frameDuration</a> (controls)</li>
13313 <li><a href="#controls_android.sensor.sensitivity">android.sensor.sensitivity</a> (controls)</li>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]13314 <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]13315 <li><a href="#static_android.sensor.info.exposureTimeRange">android.sensor.info.exposureTimeRange</a> (static)</li>
13316 <li><a href="#static_android.sensor.info.maxFrameDuration">android.sensor.info.maxFrameDuration</a> (static)</li>
13317 <li><a href="#static_android.sensor.info.physicalSize">android.sensor.info.physicalSize</a> (static)</li>
13318 <li><a href="#static_android.sensor.baseGainFactor">android.sensor.baseGainFactor</a> (static)</li>
13319 <li><a href="#static_android.sensor.maxAnalogSensitivity">android.sensor.maxAnalogSensitivity</a> (static)</li>
13320 <li><a href="#static_android.sensor.noiseModelCoefficients">android.sensor.noiseModelCoefficients</a> (static)</li>
13321 <li><a href="#controls_android.statistics.histogramMode">android.statistics.histogramMode</a> (controls)</li>
13322 <li><a href="#controls_android.statistics.sharpnessMapMode">android.statistics.sharpnessMapMode</a> (controls)</li>
13323 <li><a href="#dynamic_android.statistics.histogram">android.statistics.histogram</a> (dynamic)</li>
13324 <li><a href="#dynamic_android.statistics.sharpnessMap">android.statistics.sharpnessMap</a> (dynamic)</li>
13325 <li><a href="#dynamic_android.hotPixel.mode">android.hotPixel.mode</a> (dynamic)</li>
13326 <li><a href="#dynamic_android.lens.aperture">android.lens.aperture</a> (dynamic)</li>
13327 <li><a href="#dynamic_android.lens.filterDensity">android.lens.filterDensity</a> (dynamic)</li>
13328 <li><a href="#dynamic_android.lens.opticalStabilizationMode">android.lens.opticalStabilizationMode</a> (dynamic)</li>
13329 </ul>
13330 </li> <!-- tag_V1 -->
13331 <li id="tag_ADV">ADV - None
13332 <ul class="tags_entries">
13333 <li><a href="#static_android.flash.colorTemperature">android.flash.colorTemperature</a> (static)</li>
13334 <li><a href="#static_android.flash.maxEnergy">android.flash.maxEnergy</a> (static)</li>
13335 <li><a href="#controls_android.geometric.strength">android.geometric.strength</a> (controls)</li>
13336 <li><a href="#static_android.hotPixel.info.map">android.hotPixel.info.map</a> (static)</li>
13337 <li><a href="#static_android.lens.opticalAxisAngle">android.lens.opticalAxisAngle</a> (static)</li>
13338 <li><a href="#controls_android.shading.strength">android.shading.strength</a> (controls)</li>
13339 </ul>
13340 </li> <!-- tag_ADV -->
13341 <li id="tag_DNG">DNG -
13342 Needed for DNG file support
13343
13344 <ul class="tags_entries">
13345 <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]13346 <li><a href="#static_android.sensor.info.activeArraySize">android.sensor.info.activeArraySize</a> (static)</li>
13347 <li><a href="#static_android.sensor.info.colorFilterArrangement">android.sensor.info.colorFilterArrangement</a> (static)</li>
13348 <li><a href="#static_android.sensor.info.pixelArraySize">android.sensor.info.pixelArraySize</a> (static)</li>
13349 <li><a href="#static_android.sensor.info.whiteLevel">android.sensor.info.whiteLevel</a> (static)</li>
13350 <li><a href="#static_android.sensor.blackLevelPattern">android.sensor.blackLevelPattern</a> (static)</li>
13351 <li><a href="#static_android.sensor.calibrationTransform1">android.sensor.calibrationTransform1</a> (static)</li>
13352 <li><a href="#static_android.sensor.calibrationTransform2">android.sensor.calibrationTransform2</a> (static)</li>
13353 <li><a href="#static_android.sensor.colorTransform1">android.sensor.colorTransform1</a> (static)</li>
13354 <li><a href="#static_android.sensor.colorTransform2">android.sensor.colorTransform2</a> (static)</li>
13355 <li><a href="#static_android.sensor.forwardMatrix1">android.sensor.forwardMatrix1</a> (static)</li>
13356 <li><a href="#static_android.sensor.forwardMatrix2">android.sensor.forwardMatrix2</a> (static)</li>
13357 <li><a href="#static_android.sensor.referenceIlluminant1">android.sensor.referenceIlluminant1</a> (static)</li>
13358 <li><a href="#controls_android.tonemap.curveRed">android.tonemap.curveRed</a> (controls)</li>
13359 </ul>
13360 </li> <!-- tag_DNG -->
13361 <li id="tag_EXIF">EXIF - None
13362 <ul class="tags_entries">
13363 <li><a href="#static_android.sensor.referenceIlluminant1">android.sensor.referenceIlluminant1</a> (static)</li>
13364 </ul>
13365 </li> <!-- tag_EXIF -->
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]13366 <li id="tag_HAL2">HAL2 -
Alex Rayef40ad62013-10-01 17:52:33 -0700[diff] [blame]13367 Entry is only used by camera device HAL 2.x
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]13368
13369 <ul class="tags_entries">
13370 <li><a href="#controls_android.request.inputStreams">android.request.inputStreams</a> (controls)</li>
13371 <li><a href="#controls_android.request.outputStreams">android.request.outputStreams</a> (controls)</li>
13372 <li><a href="#controls_android.request.type">android.request.type</a> (controls)</li>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]13373 <li><a href="#controls_android.blackLevel.lock">android.blackLevel.lock</a> (controls)</li>
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]13374 </ul>
13375 </li> <!-- tag_HAL2 -->
Alex Rayef40ad62013-10-01 17:52:33 -0700[diff] [blame]13376 <li id="tag_FULL">FULL -
13377 Entry is required for full hardware level devices, and optional for other hardware levels
13378
13379 <ul class="tags_entries">
13380 <li><a href="#static_android.sensor.baseGainFactor">android.sensor.baseGainFactor</a> (static)</li>
13381 <li><a href="#static_android.sensor.maxAnalogSensitivity">android.sensor.maxAnalogSensitivity</a> (static)</li>
13382 <li><a href="#dynamic_android.sensor.temperature">android.sensor.temperature</a> (dynamic)</li>
13383 </ul>
13384 </li> <!-- tag_FULL -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13385 </ul>
13386 </div>
13387
13388 [ <a href="#">top</a> ]
13389
13390</body>
13391</html>