Gitiles
Code Review Sign In
gerrit-public.fairphone.software / platform / system / media / 83eb30346061b57829219715560bf3047989cfcd / . / camera / docs / docs.html
blob: fd173e7cead736873289978cac26f3cfeee646a1 [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">
Ruben Brunk83eb3032014-01-15 16:12:07 -0800[diff] [blame^]6189 <p>State of lens neutral density filter(s).<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6190 </td>
6191
6192 <td class="entry_units">
Ruben Brunk83eb3032014-01-15 16:12:07 -0800[diff] [blame^]6193 Steps of Exposure Value (EV).<wbr/>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6194 </td>
6195
6196 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]6197 <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]6198 </td>
6199
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6200 <td class="entry_tags">
6201 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6202 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6203 </ul>
6204 </td>
6205
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6206 </tr>
6207 <tr class="entries_header">
6208 <th class="th_details" colspan="5">Details</th>
6209 </tr>
6210 <tr class="entry_cont">
6211 <td class="entry_details" colspan="5">
Ruben Brunk83eb3032014-01-15 16:12:07 -0800[diff] [blame^]6212 <p>This will not be supported on most camera devices.<wbr/> On devices
6213where this is supported,<wbr/> this may only be set to one of the
6214values included in <a href="#static_android.lens.info.availableFilterDensities">android.<wbr/>lens.<wbr/>info.<wbr/>available<wbr/>Filter<wbr/>Densities</a>.<wbr/></p>
6215<p>Lens filters are typically used to lower the amount of light the
6216sensor is exposed to (measured in steps of EV).<wbr/> As used here,<wbr/> an EV
6217step is the standard logarithmic representation,<wbr/> which are
6218non-negative,<wbr/> and inversely proportional to the amount of light
6219hitting the sensor.<wbr/> For example,<wbr/> setting this to 0 would result
6220in no reduction of the incoming light,<wbr/> and setting this to 2 would
6221mean that the filter is set to reduce incoming light by two stops
6222(allowing 1/<wbr/>4 of the prior amount of light to the sensor).<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6223 </td>
6224 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6225
6226
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6227 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6228 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6229
6230
6231 <tr class="entry" id="controls_android.lens.focalLength">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6232 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6233 android.<wbr/>lens.<wbr/>focal<wbr/>Length
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6234 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6235 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6236 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6237
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6238 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6239
6240
6241 </td> <!-- entry_type -->
6242
6243 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6244 <p>Lens optical zoom setting</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6245 </td>
6246
6247 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6248 focal length in mm
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6249 </td>
6250
6251 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame]6252 <p>&gt; 0</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6253 </td>
6254
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6255 <td class="entry_tags">
6256 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6257 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6258 </ul>
6259 </td>
6260
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6261 </tr>
6262 <tr class="entries_header">
6263 <th class="th_details" colspan="5">Details</th>
6264 </tr>
6265 <tr class="entry_cont">
6266 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6267 <p>Will not be supported on most devices.<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6268 </td>
6269 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6270
6271
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6272 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6273 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6274
6275
6276 <tr class="entry" id="controls_android.lens.focusDistance">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6277 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6278 android.<wbr/>lens.<wbr/>focus<wbr/>Distance
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6279 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6280 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6281 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6282
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6283 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6284
6285
6286 </td> <!-- entry_type -->
6287
6288 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6289 <p>Distance to plane of sharpest focus,<wbr/>
6290measured from frontmost surface of the lens</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6291 </td>
6292
6293 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6294 diopters (1/<wbr/>m)
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6295 </td>
6296
6297 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame]6298 <p>&gt;= 0</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6299 </td>
6300
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6301 <td class="entry_tags">
6302 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6303 <li><a href="#tag_BC">BC</a></li>
6304 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6305 </ul>
6306 </td>
6307
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6308 </tr>
6309 <tr class="entries_header">
6310 <th class="th_details" colspan="5">Details</th>
6311 </tr>
6312 <tr class="entry_cont">
6313 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6314 <p>0 = infinity focus.<wbr/> Used value should be clamped
6315to (0,<wbr/>minimum focus distance)</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6316 </td>
6317 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6318
6319
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6320 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6321 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6322
6323
6324 <tr class="entry" id="controls_android.lens.opticalStabilizationMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6325 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6326 android.<wbr/>lens.<wbr/>optical<wbr/>Stabilization<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6327 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6328 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6329 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6330
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6331 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6332
6333 <ul class="entry_type_enum">
6334 <li>
6335 <span class="entry_type_enum_name">OFF</span>
6336 </li>
6337 <li>
6338 <span class="entry_type_enum_name">ON</span>
6339 <span class="entry_type_enum_optional">optional</span>
6340 </li>
6341 </ul>
6342
6343 </td> <!-- entry_type -->
6344
6345 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6346 <p>Whether optical image stabilization is
6347enabled.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6348 </td>
6349
6350 <td class="entry_units">
6351 </td>
6352
6353 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]6354 <p>android.<wbr/>lens.<wbr/>available<wbr/>Optical<wbr/>Stabilization</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6355 </td>
6356
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6357 <td class="entry_tags">
6358 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6359 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6360 </ul>
6361 </td>
6362
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6363 </tr>
6364 <tr class="entries_header">
6365 <th class="th_details" colspan="5">Details</th>
6366 </tr>
6367 <tr class="entry_cont">
6368 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6369 <p>Will not be supported on most devices.<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6370 </td>
6371 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6372
6373
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6374 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6375 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6376
6377
6378
6379 <!-- end of kind -->
6380 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6381 <tr><td colspan="6" class="kind">static</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6382
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6383 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6384 <tr>
6385 <th class="th_name">Property Name</th>
6386 <th class="th_type">Type</th>
6387 <th class="th_description">Description</th>
6388 <th class="th_units">Units</th>
6389 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6390 <th class="th_tags">Tags</th>
6391 </tr>
6392 </thead>
6393
6394 <tbody>
6395
6396
6397
6398
6399
6400
6401
6402
6403
6404
6405
6406
6407 <tr class="entry" id="static_android.lens.info.availableApertures">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6408 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6409 android.<wbr/>lens.<wbr/>info.<wbr/>available<wbr/>Apertures
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6410 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6411 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6412 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6413 <span class="entry_type_container">x</span>
6414
6415 <span class="entry_type_array">
6416 n
6417 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6418 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6419
6420
6421 </td> <!-- entry_type -->
6422
6423 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6424 <p>List of supported aperture
Zhijun He1b58d382014-01-10 10:22:53 -0800[diff] [blame]6425values.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6426 </td>
6427
6428 <td class="entry_units">
6429 </td>
6430
6431 <td class="entry_range">
Zhijun He1b58d382014-01-10 10:22:53 -0800[diff] [blame]6432 <p>one entry required,<wbr/> &amp;&gt; 0</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6433 </td>
6434
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6435 <td class="entry_tags">
6436 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6437 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6438 </ul>
6439 </td>
6440
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6441 </tr>
6442 <tr class="entries_header">
6443 <th class="th_details" colspan="5">Details</th>
6444 </tr>
6445 <tr class="entry_cont">
6446 <td class="entry_details" colspan="5">
Zhijun He1b58d382014-01-10 10:22:53 -0800[diff] [blame]6447 <p>If the camera device doesn't support variable apertures,<wbr/>
6448listed value will be the fixed aperture.<wbr/></p>
6449<p>If the camera device supports variable apertures,<wbr/> the aperture value
6450in this list will be sorted in ascending order.<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6451 </td>
6452 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6453
6454
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6455 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6456 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6457
6458
6459 <tr class="entry" id="static_android.lens.info.availableFilterDensities">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6460 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6461 android.<wbr/>lens.<wbr/>info.<wbr/>available<wbr/>Filter<wbr/>Densities
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6462 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6463 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6464 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6465 <span class="entry_type_container">x</span>
6466
6467 <span class="entry_type_array">
6468 n
6469 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6470 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6471
6472
6473 </td> <!-- entry_type -->
6474
6475 <td class="entry_description">
Ruben Brunk83eb3032014-01-15 16:12:07 -0800[diff] [blame^]6476 <p>List of supported neutral density filter values for
6477<a href="#controls_android.lens.filterDensity">android.<wbr/>lens.<wbr/>filter<wbr/>Density</a>.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6478 </td>
6479
6480 <td class="entry_units">
6481 </td>
6482
6483 <td class="entry_range">
Ruben Brunk83eb3032014-01-15 16:12:07 -0800[diff] [blame^]6484 <p>At least one value is required.<wbr/> Values must be &gt;= 0.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6485 </td>
6486
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6487 <td class="entry_tags">
6488 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6489 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6490 </ul>
6491 </td>
6492
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6493 </tr>
6494 <tr class="entries_header">
6495 <th class="th_details" colspan="5">Details</th>
6496 </tr>
6497 <tr class="entry_cont">
6498 <td class="entry_details" colspan="5">
Ruben Brunk83eb3032014-01-15 16:12:07 -0800[diff] [blame^]6499 <p>If changing <a href="#controls_android.lens.filterDensity">android.<wbr/>lens.<wbr/>filter<wbr/>Density</a> is not supported,<wbr/>
6500availableFilterDensities must contain only 0.<wbr/> Otherwise,<wbr/> this
6501list contains only the exact filter density values available on
6502this camera device.<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6503 </td>
6504 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6505
6506
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6507 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6508 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6509
6510
6511 <tr class="entry" id="static_android.lens.info.availableFocalLengths">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6512 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6513 android.<wbr/>lens.<wbr/>info.<wbr/>available<wbr/>Focal<wbr/>Lengths
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6514 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6515 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6516 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6517 <span class="entry_type_container">x</span>
6518
6519 <span class="entry_type_array">
6520 n
6521 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6522 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6523 <div class="entry_type_notes">the list of available focal lengths</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6524
6525
6526 </td> <!-- entry_type -->
6527
6528 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6529 <p>If fitted with optical zoom,<wbr/> what focal
6530lengths are available.<wbr/> If not,<wbr/> the static focal
6531length</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6532 </td>
6533
6534 <td class="entry_units">
6535 </td>
6536
6537 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame]6538 <p>&gt; 0</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6539 </td>
6540
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6541 <td class="entry_tags">
6542 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6543 <li><a href="#tag_BC">BC</a></li>
6544 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6545 </ul>
6546 </td>
6547
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6548 </tr>
6549 <tr class="entries_header">
6550 <th class="th_details" colspan="5">Details</th>
6551 </tr>
6552 <tr class="entry_cont">
6553 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6554 <p>If optical zoom not supported,<wbr/> only one value
6555should be reported</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6556 </td>
6557 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6558
6559
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6560 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6561 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6562
6563
6564 <tr class="entry" id="static_android.lens.info.availableOpticalStabilization">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6565 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6566 android.<wbr/>lens.<wbr/>info.<wbr/>available<wbr/>Optical<wbr/>Stabilization
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6567 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6568 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6569 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6570 <span class="entry_type_container">x</span>
6571
6572 <span class="entry_type_array">
6573 n
6574 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6575 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6576 <div class="entry_type_notes">list of enums</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6577
6578
6579 </td> <!-- entry_type -->
6580
6581 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6582 <p>List of supported optical image
6583stabilization modes</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6584 </td>
6585
6586 <td class="entry_units">
6587 </td>
6588
6589 <td class="entry_range">
6590 </td>
6591
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6592 <td class="entry_tags">
6593 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6594 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6595 </ul>
6596 </td>
6597
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6598 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6599
6600
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6601 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6602 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6603
6604
6605 <tr class="entry" id="static_android.lens.info.geometricCorrectionMap">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6606 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6607 android.<wbr/>lens.<wbr/>info.<wbr/>geometric<wbr/>Correction<wbr/>Map
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6608 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6609 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6610 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6611 <span class="entry_type_container">x</span>
6612
6613 <span class="entry_type_array">
6614 2 x 3 x n x m
6615 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6616 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6617 <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]6618
6619
6620 </td> <!-- entry_type -->
6621
6622 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6623 <p>A low-resolution map for correction of
6624geometric distortions and chromatic aberrations,<wbr/> per
6625color channel</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6626 </td>
6627
6628 <td class="entry_units">
6629 </td>
6630
6631 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]6632 <p>N,<wbr/> M &gt;= 2</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6633 </td>
6634
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6635 <td class="entry_tags">
6636 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6637 <li><a href="#tag_DNG">DNG</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6638 </ul>
6639 </td>
6640
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6641 </tr>
6642 <tr class="entries_header">
6643 <th class="th_details" colspan="5">Details</th>
6644 </tr>
6645 <tr class="entry_cont">
6646 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6647 <p>[DNG wants a function instead].<wbr/> What's easiest
6648for implementers? With an array size (M,<wbr/> N),<wbr/> entry (i,<wbr/>
6649j) provides the destination for pixel (i/<wbr/>(M-1) * width,<wbr/>
6650j/<wbr/>(N-1) * height).<wbr/> Data is row-major,<wbr/> with each array
6651entry 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]6652 </td>
6653 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6654
6655
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6656 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6657 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6658
6659
6660 <tr class="entry" id="static_android.lens.info.geometricCorrectionMapSize">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6661 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6662 android.<wbr/>lens.<wbr/>info.<wbr/>geometric<wbr/>Correction<wbr/>Map<wbr/>Size
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6663 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6664 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6665 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6666 <span class="entry_type_container">x</span>
6667
6668 <span class="entry_type_array">
6669 2
6670 </span>
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]6671 <span class="entry_type_visibility"> [system as size]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6672 <div class="entry_type_notes">width and height of geometric correction map</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6673
6674
6675 </td> <!-- entry_type -->
6676
6677 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6678 <p>Dimensions of geometric correction
6679map</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6680 </td>
6681
6682 <td class="entry_units">
6683 </td>
6684
6685 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]6686 <p>Both values &gt;= 2</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6687 </td>
6688
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6689 <td class="entry_tags">
6690 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6691 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6692 </ul>
6693 </td>
6694
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6695 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6696
6697
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6698 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6699 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6700
6701
6702 <tr class="entry" id="static_android.lens.info.hyperfocalDistance">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6703 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6704 android.<wbr/>lens.<wbr/>info.<wbr/>hyperfocal<wbr/>Distance
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6705 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6706 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6707 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6708
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6709 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6710
6711
6712 </td> <!-- entry_type -->
6713
6714 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6715 <p>Hyperfocal distance for this lens; set to
67160 if fixed focus</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6717 </td>
6718
6719 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6720 diopters
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6721 </td>
6722
6723 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame]6724 <p>&gt;= 0</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6725 </td>
6726
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6727 <td class="entry_tags">
6728 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6729 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6730 </ul>
6731 </td>
6732
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6733 </tr>
6734 <tr class="entries_header">
6735 <th class="th_details" colspan="5">Details</th>
6736 </tr>
6737 <tr class="entry_cont">
6738 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6739 <p>The hyperfocal distance is used for the old
6740API's 'fixed' setting</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6741 </td>
6742 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6743
6744
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6745 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6746 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6747
6748
6749 <tr class="entry" id="static_android.lens.info.minimumFocusDistance">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6750 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6751 android.<wbr/>lens.<wbr/>info.<wbr/>minimum<wbr/>Focus<wbr/>Distance
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6752 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6753 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6754 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6755
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6756 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6757
6758
6759 </td> <!-- entry_type -->
6760
6761 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6762 <p>Shortest distance from frontmost surface
6763of the lens that can be focused correctly</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6764 </td>
6765
6766 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6767 diopters
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6768 </td>
6769
6770 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame]6771 <p>&gt;= 0</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6772 </td>
6773
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6774 <td class="entry_tags">
6775 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6776 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6777 </ul>
6778 </td>
6779
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6780 </tr>
6781 <tr class="entries_header">
6782 <th class="th_details" colspan="5">Details</th>
6783 </tr>
6784 <tr class="entry_cont">
6785 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6786 <p>If the lens is fixed-focus,<wbr/> this should be
67870</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6788 </td>
6789 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6790
6791
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6792 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6793 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6794
6795
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6796 <tr class="entry" id="static_android.lens.info.shadingMapSize">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6797 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6798 android.<wbr/>lens.<wbr/>info.<wbr/>shading<wbr/>Map<wbr/>Size
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6799 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6800 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6801 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6802 <span class="entry_type_container">x</span>
6803
6804 <span class="entry_type_array">
6805 2
6806 </span>
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]6807 <span class="entry_type_visibility"> [public as size]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6808 <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]6809
6810
6811 </td> <!-- entry_type -->
6812
6813 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6814 <p>Dimensions of lens shading map.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6815 </td>
6816
6817 <td class="entry_units">
6818 </td>
6819
6820 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]6821 <p>Both values &gt;= 1</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6822 </td>
6823
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6824 <td class="entry_tags">
6825 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6826 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6827 </ul>
6828 </td>
6829
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6830 </tr>
6831 <tr class="entries_header">
6832 <th class="th_details" colspan="5">Details</th>
6833 </tr>
6834 <tr class="entry_cont">
6835 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6836 <p>The map should be on the order of 30-40 rows and columns,<wbr/> and
6837must be smaller than 64x64.<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6838 </td>
6839 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6840
6841
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6842 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6843 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6844
6845
6846
6847
6848
6849 <tr class="entry" id="static_android.lens.facing">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6850 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6851 android.<wbr/>lens.<wbr/>facing
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6852 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6853 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6854 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6855
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6856 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6857
6858 <ul class="entry_type_enum">
6859 <li>
6860 <span class="entry_type_enum_name">FRONT</span>
6861 </li>
6862 <li>
6863 <span class="entry_type_enum_name">BACK</span>
6864 </li>
6865 </ul>
6866
6867 </td> <!-- entry_type -->
6868
6869 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6870 <p>Direction the camera faces relative to
6871device screen</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6872 </td>
6873
6874 <td class="entry_units">
6875 </td>
6876
6877 <td class="entry_range">
6878 </td>
6879
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6880 <td class="entry_tags">
6881 </td>
6882
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6883 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6884
6885
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6886 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6887 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6888
6889
6890 <tr class="entry" id="static_android.lens.opticalAxisAngle">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6891 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6892 android.<wbr/>lens.<wbr/>optical<wbr/>Axis<wbr/>Angle
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6893 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6894 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6895 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6896 <span class="entry_type_container">x</span>
6897
6898 <span class="entry_type_array">
6899 2
6900 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6901 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6902 <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]6903
6904
6905 </td> <!-- entry_type -->
6906
6907 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6908 <p>Relative angle of camera optical axis to the
6909perpendicular axis from the display</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6910 </td>
6911
6912 <td class="entry_units">
6913 </td>
6914
6915 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]6916 <p>[0-90) for first angle,<wbr/> [0-360) for second</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6917 </td>
6918
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6919 <td class="entry_tags">
6920 <ul class="entry_tags">
6921 <li><a href="#tag_ADV">ADV</a></li>
6922 </ul>
6923 </td>
6924
6925 </tr>
6926 <tr class="entries_header">
6927 <th class="th_details" colspan="5">Details</th>
6928 </tr>
6929 <tr class="entry_cont">
6930 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6931 <p>Examples:</p>
6932<p>(0,<wbr/>0) means that the camera optical axis
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]6933is perpendicular to the display surface;</p>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6934<p>(45,<wbr/>0) means that the camera points 45 degrees up when
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]6935device is held upright;</p>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6936<p>(45,<wbr/>90) means the camera points 45 degrees to the right when
6937the device is held upright.<wbr/></p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]6938<p>Use FACING field to determine perpendicular outgoing
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6939direction</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6940 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6941 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6942
6943
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6944 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6945 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6946
6947
6948 <tr class="entry" id="static_android.lens.position">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6949 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6950 android.<wbr/>lens.<wbr/>position
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6951 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6952 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6953 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6954 <span class="entry_type_container">x</span>
6955
6956 <span class="entry_type_array">
6957 3, location in mm, in the sensor coordinate
6958 system
6959 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6960 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6961
6962
6963 </td> <!-- entry_type -->
6964
6965 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6966 <p>Coordinates of camera optical axis on
6967device</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6968 </td>
6969
6970 <td class="entry_units">
6971 </td>
6972
6973 <td class="entry_range">
6974 </td>
6975
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6976 <td class="entry_tags">
6977 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6978 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6979 </ul>
6980 </td>
6981
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6982 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6983
6984
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6985 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6986 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6987
6988
6989
6990 <!-- end of kind -->
6991 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6992 <tr><td colspan="6" class="kind">dynamic</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6993
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6994 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6995 <tr>
6996 <th class="th_name">Property Name</th>
6997 <th class="th_type">Type</th>
6998 <th class="th_description">Description</th>
6999 <th class="th_units">Units</th>
7000 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7001 <th class="th_tags">Tags</th>
7002 </tr>
7003 </thead>
7004
7005 <tbody>
7006
7007
7008
7009
7010
7011
7012
7013
7014
7015
7016 <tr class="entry" id="dynamic_android.lens.aperture">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7017 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7018 android.<wbr/>lens.<wbr/>aperture
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7019 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7020 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7021 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7022
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7023 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7024
7025
7026 </td> <!-- entry_type -->
7027
7028 <td class="entry_description">
Zhijun He1b58d382014-01-10 10:22:53 -0800[diff] [blame]7029 <p>The ratio of lens focal length to the effective
7030aperture diameter.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7031 </td>
7032
7033 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7034 f-number (f/<wbr/>NNN)
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7035 </td>
7036
7037 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]7038 <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]7039 </td>
7040
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7041 <td class="entry_tags">
7042 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]7043 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7044 </ul>
7045 </td>
7046
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7047 </tr>
7048 <tr class="entries_header">
7049 <th class="th_details" colspan="5">Details</th>
7050 </tr>
7051 <tr class="entry_cont">
7052 <td class="entry_details" colspan="5">
Zhijun He1b58d382014-01-10 10:22:53 -0800[diff] [blame]7053 <p>This will only be supported on the camera devices that
7054have variable aperture lens.<wbr/> The aperture value can only be
7055one of the values listed in <a href="#static_android.lens.info.availableApertures">android.<wbr/>lens.<wbr/>info.<wbr/>available<wbr/>Apertures</a>.<wbr/></p>
7056<p>When this is supported and <a href="#controls_android.control.aeMode">android.<wbr/>control.<wbr/>ae<wbr/>Mode</a> is OFF,<wbr/>
7057this can be set along with <a href="#controls_android.sensor.exposureTime">android.<wbr/>sensor.<wbr/>exposure<wbr/>Time</a>,<wbr/>
7058<a href="#controls_android.sensor.sensitivity">android.<wbr/>sensor.<wbr/>sensitivity</a>,<wbr/> and android.<wbr/>sensor.<wbr/>frame<wbr/>Duration
7059to achieve manual exposure control.<wbr/></p>
7060<p>The requested aperture value may take several frames to reach the
7061requested value; the camera device will report the current (intermediate)
7062aperture size in capture result metadata while the aperture is changing.<wbr/></p>
7063<p>When this is supported and <a href="#controls_android.control.aeMode">android.<wbr/>control.<wbr/>ae<wbr/>Mode</a> is one of
7064the ON modes,<wbr/> this will be overridden by the camera device
7065auto-exposure algorithm,<wbr/> the overridden values are then provided
7066back to the user in the corresponding result.<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7067 </td>
7068 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7069
7070
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7071 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7072 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7073
7074
7075 <tr class="entry" id="dynamic_android.lens.filterDensity">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7076 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7077 android.<wbr/>lens.<wbr/>filter<wbr/>Density
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7078 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7079 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7080 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7081
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7082 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7083
7084
7085 </td> <!-- entry_type -->
7086
7087 <td class="entry_description">
Ruben Brunk83eb3032014-01-15 16:12:07 -0800[diff] [blame^]7088 <p>State of lens neutral density filter(s).<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7089 </td>
7090
7091 <td class="entry_units">
Ruben Brunk83eb3032014-01-15 16:12:07 -0800[diff] [blame^]7092 Steps of Exposure Value (EV).<wbr/>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7093 </td>
7094
7095 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]7096 <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]7097 </td>
7098
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7099 <td class="entry_tags">
7100 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]7101 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7102 </ul>
7103 </td>
7104
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7105 </tr>
7106 <tr class="entries_header">
7107 <th class="th_details" colspan="5">Details</th>
7108 </tr>
7109 <tr class="entry_cont">
7110 <td class="entry_details" colspan="5">
Ruben Brunk83eb3032014-01-15 16:12:07 -0800[diff] [blame^]7111 <p>This will not be supported on most camera devices.<wbr/> On devices
7112where this is supported,<wbr/> this may only be set to one of the
7113values included in <a href="#static_android.lens.info.availableFilterDensities">android.<wbr/>lens.<wbr/>info.<wbr/>available<wbr/>Filter<wbr/>Densities</a>.<wbr/></p>
7114<p>Lens filters are typically used to lower the amount of light the
7115sensor is exposed to (measured in steps of EV).<wbr/> As used here,<wbr/> an EV
7116step is the standard logarithmic representation,<wbr/> which are
7117non-negative,<wbr/> and inversely proportional to the amount of light
7118hitting the sensor.<wbr/> For example,<wbr/> setting this to 0 would result
7119in no reduction of the incoming light,<wbr/> and setting this to 2 would
7120mean that the filter is set to reduce incoming light by two stops
7121(allowing 1/<wbr/>4 of the prior amount of light to the sensor).<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7122 </td>
7123 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7124
7125
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7126 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7127 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7128
7129
7130 <tr class="entry" id="dynamic_android.lens.focalLength">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7131 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7132 android.<wbr/>lens.<wbr/>focal<wbr/>Length
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7133 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7134 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7135 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7136
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7137 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7138
7139
7140 </td> <!-- entry_type -->
7141
7142 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7143 <p>Lens optical zoom setting</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7144 </td>
7145
7146 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7147 focal length in mm
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7148 </td>
7149
7150 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame]7151 <p>&gt; 0</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7152 </td>
7153
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7154 <td class="entry_tags">
7155 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]7156 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7157 </ul>
7158 </td>
7159
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7160 </tr>
7161 <tr class="entries_header">
7162 <th class="th_details" colspan="5">Details</th>
7163 </tr>
7164 <tr class="entry_cont">
7165 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7166 <p>Will not be supported on most devices.<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7167 </td>
7168 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7169
7170
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7171 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7172 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7173
7174
7175 <tr class="entry" id="dynamic_android.lens.focusDistance">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7176 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7177 android.<wbr/>lens.<wbr/>focus<wbr/>Distance
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7178 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7179 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7180 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7181
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7182 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7183
7184
7185 </td> <!-- entry_type -->
7186
7187 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7188 <p>Distance to plane of sharpest focus,<wbr/>
7189measured from frontmost surface of the lens</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7190 </td>
7191
7192 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7193 diopters (1/<wbr/>m)
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7194 </td>
7195
7196 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame]7197 <p>&gt;= 0</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7198 </td>
7199
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7200 <td class="entry_tags">
7201 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]7202 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7203 </ul>
7204 </td>
7205
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7206 </tr>
7207 <tr class="entries_header">
7208 <th class="th_details" colspan="5">Details</th>
7209 </tr>
7210 <tr class="entry_cont">
7211 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7212 <p>Should be zero for fixed-focus cameras</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7213 </td>
7214 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7215
7216
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7217 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7218 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7219
7220
7221 <tr class="entry" id="dynamic_android.lens.focusRange">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7222 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7223 android.<wbr/>lens.<wbr/>focus<wbr/>Range
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7224 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7225 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7226 <span class="entry_type_name">float</span>
Zhijun He50451ad2013-09-26 10:27:47 -0700[diff] [blame]7227 <span class="entry_type_container">x</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7228
Zhijun He50451ad2013-09-26 10:27:47 -0700[diff] [blame]7229 <span class="entry_type_array">
7230 2
7231 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7232 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7233 <div class="entry_type_notes">Range of scene distances that are in focus</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7234
7235
7236 </td> <!-- entry_type -->
7237
7238 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7239 <p>The range of scene distances that are in
7240sharp focus (depth of field)</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7241 </td>
7242
7243 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7244 pair of focus distances in diopters: (near,<wbr/>
7245 far)
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7246 </td>
7247
7248 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame]7249 <p>&gt;=0</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7250 </td>
7251
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7252 <td class="entry_tags">
7253 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]7254 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7255 </ul>
7256 </td>
7257
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7258 </tr>
7259 <tr class="entries_header">
7260 <th class="th_details" colspan="5">Details</th>
7261 </tr>
7262 <tr class="entry_cont">
7263 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7264 <p>If variable focus not supported,<wbr/> can still report
7265fixed depth of field range</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7266 </td>
7267 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7268
7269
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7270 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7271 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7272
7273
7274 <tr class="entry" id="dynamic_android.lens.opticalStabilizationMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7275 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7276 android.<wbr/>lens.<wbr/>optical<wbr/>Stabilization<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7277 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7278 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7279 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7280
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7281 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7282
7283 <ul class="entry_type_enum">
7284 <li>
7285 <span class="entry_type_enum_name">OFF</span>
7286 </li>
7287 <li>
7288 <span class="entry_type_enum_name">ON</span>
7289 <span class="entry_type_enum_optional">optional</span>
7290 </li>
7291 </ul>
7292
7293 </td> <!-- entry_type -->
7294
7295 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7296 <p>Whether optical image stabilization is
7297enabled.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7298 </td>
7299
7300 <td class="entry_units">
7301 </td>
7302
7303 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]7304 <p>android.<wbr/>lens.<wbr/>available<wbr/>Optical<wbr/>Stabilization</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7305 </td>
7306
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7307 <td class="entry_tags">
7308 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]7309 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7310 </ul>
7311 </td>
7312
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7313 </tr>
7314 <tr class="entries_header">
7315 <th class="th_details" colspan="5">Details</th>
7316 </tr>
7317 <tr class="entry_cont">
7318 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7319 <p>Will not be supported on most devices.<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7320 </td>
7321 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7322
7323
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7324 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7325 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7326
7327
7328 <tr class="entry" id="dynamic_android.lens.state">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7329 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7330 android.<wbr/>lens.<wbr/>state
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7331 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7332 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7333 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7334
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7335 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7336
7337 <ul class="entry_type_enum">
7338 <li>
7339 <span class="entry_type_enum_name">STATIONARY</span>
7340 </li>
Igor Murashkin0e323a12013-09-06 11:50:48 -0700[diff] [blame]7341 <li>
7342 <span class="entry_type_enum_name">MOVING</span>
7343 </li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7344 </ul>
7345
7346 </td> <!-- entry_type -->
7347
7348 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7349 <p>Current lens status</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7350 </td>
7351
7352 <td class="entry_units">
7353 </td>
7354
7355 <td class="entry_range">
7356 </td>
7357
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7358 <td class="entry_tags">
7359 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]7360 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7361 </ul>
7362 </td>
7363
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7364 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7365
7366
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7367 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7368 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7369
7370
7371
7372 <!-- end of kind -->
7373 </tbody>
7374
7375 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7376 <tr><td colspan="6" id="section_noiseReduction" class="section">noiseReduction</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7377
7378
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7379 <tr><td colspan="6" class="kind">controls</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7380
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7381 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7382 <tr>
7383 <th class="th_name">Property Name</th>
7384 <th class="th_type">Type</th>
7385 <th class="th_description">Description</th>
7386 <th class="th_units">Units</th>
7387 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7388 <th class="th_tags">Tags</th>
7389 </tr>
7390 </thead>
7391
7392 <tbody>
7393
7394
7395
7396
7397
7398
7399
7400
7401
7402
7403 <tr class="entry" id="controls_android.noiseReduction.mode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7404 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7405 android.<wbr/>noise<wbr/>Reduction.<wbr/>mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7406 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7407 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7408 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7409
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7410 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7411
7412 <ul class="entry_type_enum">
7413 <li>
7414 <span class="entry_type_enum_name">OFF</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]7415 <span class="entry_type_enum_notes"><p>No noise reduction is applied</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7416 </li>
7417 <li>
7418 <span class="entry_type_enum_name">FAST</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]7419 <span class="entry_type_enum_notes"><p>Must not slow down frame rate relative to sensor
7420output</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7421 </li>
7422 <li>
7423 <span class="entry_type_enum_name">HIGH_QUALITY</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]7424 <span class="entry_type_enum_notes"><p>May slow down frame rate to provide highest
7425quality</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7426 </li>
7427 </ul>
7428
7429 </td> <!-- entry_type -->
7430
7431 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7432 <p>Mode of operation for the noise reduction
7433algorithm</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7434 </td>
7435
7436 <td class="entry_units">
7437 </td>
7438
7439 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]7440 <p>android.<wbr/>noise<wbr/>Reduction.<wbr/>available<wbr/>Modes</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7441 </td>
7442
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7443 <td class="entry_tags">
7444 <ul class="entry_tags">
7445 <li><a href="#tag_V1">V1</a></li>
7446 </ul>
7447 </td>
7448
7449 </tr>
7450 <tr class="entries_header">
7451 <th class="th_details" colspan="5">Details</th>
7452 </tr>
7453 <tr class="entry_cont">
7454 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7455 <p>Noise filtering control.<wbr/> OFF means no noise reduction
7456will be applied by the HAL.<wbr/></p>
Zhijun Hef90eeaf2014-01-16 12:13:35 -0800[diff] [blame]7457<p>FAST/<wbr/>HIGH_<wbr/>QUALITY both mean camera device determined noise filtering
7458will be applied.<wbr/> HIGH_<wbr/>QUALITY mode indicates that the camera device
7459will use the highest-quality noise filtering algorithms,<wbr/>
7460even if it slows down capture rate.<wbr/> FAST means the camera device should not
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7461slow down capture rate when applying noise filtering.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7462 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7463 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7464
7465
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7466 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7467 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7468
7469
7470 <tr class="entry" id="controls_android.noiseReduction.strength">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7471 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7472 android.<wbr/>noise<wbr/>Reduction.<wbr/>strength
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7473 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7474 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7475 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7476
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7477 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7478
7479
7480 </td> <!-- entry_type -->
7481
7482 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7483 <p>Control the amount of noise reduction
7484applied to the images</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7485 </td>
7486
7487 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7488 1-10; 10 is max noise reduction
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7489 </td>
7490
7491 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]7492 <p>1 - 10</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7493 </td>
7494
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7495 <td class="entry_tags">
7496 </td>
7497
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7498 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7499
7500
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7501 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7502 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7503
7504
7505
7506 <!-- end of kind -->
7507 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7508 <tr><td colspan="6" class="kind">dynamic</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7509
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7510 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7511 <tr>
7512 <th class="th_name">Property Name</th>
7513 <th class="th_type">Type</th>
7514 <th class="th_description">Description</th>
7515 <th class="th_units">Units</th>
7516 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7517 <th class="th_tags">Tags</th>
7518 </tr>
7519 </thead>
7520
7521 <tbody>
7522
7523
7524
7525
7526
7527
7528
7529
7530
7531
7532 <tr class="entry" id="dynamic_android.noiseReduction.mode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7533 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7534 android.<wbr/>noise<wbr/>Reduction.<wbr/>mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7535 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7536 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7537 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7538
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7539 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7540
7541 <ul class="entry_type_enum">
7542 <li>
7543 <span class="entry_type_enum_name">OFF</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]7544 <span class="entry_type_enum_notes"><p>No noise reduction is applied</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7545 </li>
7546 <li>
7547 <span class="entry_type_enum_name">FAST</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]7548 <span class="entry_type_enum_notes"><p>Must not slow down frame rate relative to sensor
7549output</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7550 </li>
7551 <li>
7552 <span class="entry_type_enum_name">HIGH_QUALITY</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]7553 <span class="entry_type_enum_notes"><p>May slow down frame rate to provide highest
7554quality</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7555 </li>
7556 </ul>
7557
7558 </td> <!-- entry_type -->
7559
7560 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7561 <p>Mode of operation for the noise reduction
7562algorithm</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7563 </td>
7564
7565 <td class="entry_units">
7566 </td>
7567
7568 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]7569 <p>android.<wbr/>noise<wbr/>Reduction.<wbr/>available<wbr/>Modes</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7570 </td>
7571
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7572 <td class="entry_tags">
7573 <ul class="entry_tags">
7574 <li><a href="#tag_V1">V1</a></li>
7575 </ul>
7576 </td>
7577
7578 </tr>
7579 <tr class="entries_header">
7580 <th class="th_details" colspan="5">Details</th>
7581 </tr>
7582 <tr class="entry_cont">
7583 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7584 <p>Noise filtering control.<wbr/> OFF means no noise reduction
7585will be applied by the HAL.<wbr/></p>
Zhijun Hef90eeaf2014-01-16 12:13:35 -0800[diff] [blame]7586<p>FAST/<wbr/>HIGH_<wbr/>QUALITY both mean camera device determined noise filtering
7587will be applied.<wbr/> HIGH_<wbr/>QUALITY mode indicates that the camera device
7588will use the highest-quality noise filtering algorithms,<wbr/>
7589even if it slows down capture rate.<wbr/> FAST means the camera device should not
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7590slow down capture rate when applying noise filtering.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7591 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7592 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7593
7594
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7595 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7596 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7597
7598
7599
7600 <!-- end of kind -->
7601 </tbody>
7602
7603 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7604 <tr><td colspan="6" id="section_quirks" class="section">quirks</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7605
7606
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7607 <tr><td colspan="6" class="kind">static</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7608
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7609 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7610 <tr>
7611 <th class="th_name">Property Name</th>
7612 <th class="th_type">Type</th>
7613 <th class="th_description">Description</th>
7614 <th class="th_units">Units</th>
7615 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7616 <th class="th_tags">Tags</th>
7617 </tr>
7618 </thead>
7619
7620 <tbody>
7621
7622
7623
7624
7625
7626
7627
7628
7629
7630
7631 <tr class="entry" id="static_android.quirks.meteringCropRegion">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7632 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7633 android.<wbr/>quirks.<wbr/>metering<wbr/>Crop<wbr/>Region
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7634 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7635 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7636 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7637
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7638 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7639
7640
7641 </td> <!-- entry_type -->
7642
7643 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7644 <p>If set to 1,<wbr/> the camera service does not
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]7645scale 'normalized' coordinates with respect to the crop
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7646region.<wbr/> This applies to metering input (a{e,<wbr/>f,<wbr/>wb}Region
7647and output (face rectangles).<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7648 </td>
7649
7650 <td class="entry_units">
7651 </td>
7652
7653 <td class="entry_range">
7654 </td>
7655
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7656 <td class="entry_tags">
7657 </td>
7658
7659 </tr>
7660 <tr class="entries_header">
7661 <th class="th_details" colspan="5">Details</th>
7662 </tr>
7663 <tr class="entry_cont">
7664 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7665 <p>Normalized coordinates refer to those in the
7666(-1000,<wbr/>1000) range mentioned in the
7667android.<wbr/>hardware.<wbr/>Camera API.<wbr/></p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]7668<p>HAL implementations should instead always use and emit
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7669sensor array-relative coordinates for all region data.<wbr/> Does
7670not need to be listed in static metadata.<wbr/> Support will be
7671removed in future versions of camera service.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7672 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7673 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7674
7675
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7676 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7677 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7678
7679
7680 <tr class="entry" id="static_android.quirks.triggerAfWithAuto">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7681 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7682 android.<wbr/>quirks.<wbr/>trigger<wbr/>Af<wbr/>With<wbr/>Auto
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7683 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7684 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7685 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7686
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7687 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7688
7689
7690 </td> <!-- entry_type -->
7691
7692 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7693 <p>If set to 1,<wbr/> then the camera service always
7694switches to FOCUS_<wbr/>MODE_<wbr/>AUTO before issuing a AF
7695trigger.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7696 </td>
7697
7698 <td class="entry_units">
7699 </td>
7700
7701 <td class="entry_range">
7702 </td>
7703
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7704 <td class="entry_tags">
7705 </td>
7706
7707 </tr>
7708 <tr class="entries_header">
7709 <th class="th_details" colspan="5">Details</th>
7710 </tr>
7711 <tr class="entry_cont">
7712 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7713 <p>HAL implementations should implement AF trigger
7714modes for AUTO,<wbr/> MACRO,<wbr/> CONTINUOUS_<wbr/>FOCUS,<wbr/> and
7715CONTINUOUS_<wbr/>PICTURE modes instead of using this flag.<wbr/> Does
7716not need to be listed in static metadata.<wbr/> Support will be
7717removed in future versions of camera service</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7718 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7719 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7720
7721
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7722 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7723 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7724
7725
7726 <tr class="entry" id="static_android.quirks.useZslFormat">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7727 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7728 android.<wbr/>quirks.<wbr/>use<wbr/>Zsl<wbr/>Format
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7729 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7730 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7731 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7732
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7733 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7734
7735
7736 </td> <!-- entry_type -->
7737
7738 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7739 <p>If set to 1,<wbr/> the camera service uses
7740CAMERA2_<wbr/>PIXEL_<wbr/>FORMAT_<wbr/>ZSL instead of
7741HAL_<wbr/>PIXEL_<wbr/>FORMAT_<wbr/>IMPLEMENTATION_<wbr/>DEFINED for the zero
7742shutter lag stream</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7743 </td>
7744
7745 <td class="entry_units">
7746 </td>
7747
7748 <td class="entry_range">
7749 </td>
7750
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7751 <td class="entry_tags">
7752 </td>
7753
7754 </tr>
7755 <tr class="entries_header">
7756 <th class="th_details" colspan="5">Details</th>
7757 </tr>
7758 <tr class="entry_cont">
7759 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7760 <p>HAL implementations should use gralloc usage flags
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]7761to determine that a stream will be used for
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7762zero-shutter-lag,<wbr/> instead of relying on an explicit
7763format setting.<wbr/> Does not need to be listed in static
7764metadata.<wbr/> Support will be removed in future versions of
7765camera service.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7766 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7767 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7768
7769
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7770 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7771 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7772
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]7773
7774 <tr class="entry" id="static_android.quirks.usePartialResult">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7775 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7776 android.<wbr/>quirks.<wbr/>use<wbr/>Partial<wbr/>Result
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7777 </td>
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]7778 <td class="entry_type">
7779 <span class="entry_type_name">byte</span>
7780
Eino-Ville Talvala52a64a52013-11-07 14:43:43 -0800[diff] [blame]7781 <span class="entry_type_visibility"> [hidden]</span>
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]7782
7783
7784 </td> <!-- entry_type -->
7785
7786 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7787 <p>If set to 1,<wbr/> the HAL will always split result
7788metadata for a single capture into multiple buffers,<wbr/>
7789returned using multiple process_<wbr/>capture_<wbr/>result calls.<wbr/></p>
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]7790 </td>
7791
7792 <td class="entry_units">
7793 </td>
7794
7795 <td class="entry_range">
7796 </td>
7797
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7798 <td class="entry_tags">
7799 </td>
7800
7801 </tr>
7802 <tr class="entries_header">
7803 <th class="th_details" colspan="5">Details</th>
7804 </tr>
7805 <tr class="entry_cont">
7806 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7807 <p>Does not need to be listed in static
7808metadata.<wbr/> Support for partial results will be reworked in
7809future versions of camera service.<wbr/> This quirk will stop
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]7810working at that point; DO NOT USE without careful
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7811consideration of future support.<wbr/></p>
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]7812 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7813 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7814
7815
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7816 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7817 <!-- end of entry -->
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]7818
7819
7820
7821 <!-- end of kind -->
7822 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7823 <tr><td colspan="6" class="kind">dynamic</td></tr>
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]7824
7825 <thead class="entries_header">
7826 <tr>
7827 <th class="th_name">Property Name</th>
7828 <th class="th_type">Type</th>
7829 <th class="th_description">Description</th>
7830 <th class="th_units">Units</th>
7831 <th class="th_range">Range</th>
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]7832 <th class="th_tags">Tags</th>
7833 </tr>
7834 </thead>
7835
7836 <tbody>
7837
7838
7839
7840
7841
7842
7843
7844
7845
7846
7847 <tr class="entry" id="dynamic_android.quirks.partialResult">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7848 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7849 android.<wbr/>quirks.<wbr/>partial<wbr/>Result
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7850 </td>
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]7851 <td class="entry_type">
7852 <span class="entry_type_name entry_type_name_enum">byte</span>
7853
Eino-Ville Talvala52a64a52013-11-07 14:43:43 -0800[diff] [blame]7854 <span class="entry_type_visibility"> [hidden as boolean]</span>
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]7855
7856 <ul class="entry_type_enum">
7857 <li>
7858 <span class="entry_type_enum_name">FINAL</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]7859 <span class="entry_type_enum_notes"><p>The last or only metadata result buffer
7860for this capture.<wbr/></p></span>
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]7861 </li>
7862 <li>
7863 <span class="entry_type_enum_name">PARTIAL</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]7864 <span class="entry_type_enum_notes"><p>A partial buffer of result metadata for this
7865capture.<wbr/> More result buffers for this capture will be sent
7866by the HAL,<wbr/> the last of which will be marked
7867FINAL.<wbr/></p></span>
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]7868 </li>
7869 </ul>
7870
7871 </td> <!-- entry_type -->
7872
7873 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7874 <p>Whether a result given to the framework is the
7875final one for the capture,<wbr/> or only a partial that contains a
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]7876subset of the full set of dynamic metadata
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7877values.<wbr/></p>
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]7878 </td>
7879
7880 <td class="entry_units">
7881 </td>
7882
7883 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]7884 <p>Optional.<wbr/> Default value is FINAL.<wbr/></p>
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]7885 </td>
7886
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7887 <td class="entry_tags">
7888 </td>
7889
7890 </tr>
7891 <tr class="entries_header">
7892 <th class="th_details" colspan="5">Details</th>
7893 </tr>
7894 <tr class="entry_cont">
7895 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7896 <p>The entries in the result metadata buffers for a
7897single capture may not overlap,<wbr/> except for this entry.<wbr/> The
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]7898FINAL buffers must retain FIFO ordering relative to the
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7899requests that generate them,<wbr/> so the FINAL buffer for frame 3 must
7900always be sent to the framework after the FINAL buffer for frame 2,<wbr/> and
7901before the FINAL buffer for frame 4.<wbr/> PARTIAL buffers may be returned
7902in any order relative to other frames,<wbr/> but all PARTIAL buffers for a given
7903capture must arrive before the FINAL buffer for that capture.<wbr/> This entry may
7904only 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]7905 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7906 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7907
7908
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7909 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7910 <!-- end of entry -->
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]7911
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7912
7913
7914 <!-- end of kind -->
7915 </tbody>
7916
7917 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7918 <tr><td colspan="6" id="section_request" class="section">request</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7919
7920
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7921 <tr><td colspan="6" class="kind">controls</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7922
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7923 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7924 <tr>
7925 <th class="th_name">Property Name</th>
7926 <th class="th_type">Type</th>
7927 <th class="th_description">Description</th>
7928 <th class="th_units">Units</th>
7929 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7930 <th class="th_tags">Tags</th>
7931 </tr>
7932 </thead>
7933
7934 <tbody>
7935
7936
7937
7938
7939
7940
7941
7942
7943
7944
7945 <tr class="entry" id="controls_android.request.frameCount">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7946 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7947 android.<wbr/>request.<wbr/>frame<wbr/>Count
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7948 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7949 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7950 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7951
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7952 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7953
7954
7955 </td> <!-- entry_type -->
7956
7957 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7958 <p>A frame counter set by the framework.<wbr/> Must
7959be maintained unchanged in output frame.<wbr/> This value monotonically
7960increases with every new result (that is,<wbr/> each new result has a unique
7961frameCount value).<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7962 </td>
7963
7964 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7965 incrementing integer
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7966 </td>
7967
7968 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]7969 <p>Any int</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7970 </td>
7971
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7972 <td class="entry_tags">
7973 </td>
7974
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7975 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7976
7977
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7978 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7979 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7980
7981
7982 <tr class="entry" id="controls_android.request.id">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7983 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7984 android.<wbr/>request.<wbr/>id
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7985 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7986 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7987 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7988
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7989 <span class="entry_type_visibility"> [hidden]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7990
7991
7992 </td> <!-- entry_type -->
7993
7994 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7995 <p>An application-specified ID for the current
7996request.<wbr/> Must be maintained unchanged in output
7997frame</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7998 </td>
7999
8000 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8001 arbitrary integer assigned by application
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8002 </td>
8003
8004 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]8005 <p>Any int</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8006 </td>
8007
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8008 <td class="entry_tags">
8009 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]8010 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8011 </ul>
8012 </td>
8013
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8014 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8015
8016
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8017 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8018 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8019
8020
8021 <tr class="entry" id="controls_android.request.inputStreams">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8022 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8023 android.<wbr/>request.<wbr/>input<wbr/>Streams
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8024 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8025 <td class="entry_type">
Zhijun Hee36cdbe2013-09-06 14:28:37 -0700[diff] [blame]8026 <span class="entry_type_name">int32</span>
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]8027 <span class="entry_type_container">x</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8028
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]8029 <span class="entry_type_array">
8030 n
8031 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8032 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8033
8034
8035 </td> <!-- entry_type -->
8036
8037 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8038 <p>List which camera reprocess stream is used
8039for the source of reprocessing data.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8040 </td>
8041
8042 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8043 List of camera reprocess stream IDs
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8044 </td>
8045
8046 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]8047 <p>Typically,<wbr/> only one entry allowed,<wbr/> must be a valid
8048reprocess stream ID.<wbr/></p>
8049<p>If android.<wbr/>jpeg.<wbr/>needs<wbr/>Thumbnail is set,<wbr/> then multiple
8050reprocess streams may be included in a single request; they
8051must be different scaled versions of the same image.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8052 </td>
8053
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8054 <td class="entry_tags">
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]8055 <ul class="entry_tags">
8056 <li><a href="#tag_HAL2">HAL2</a></li>
8057 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8058 </td>
8059
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8060 </tr>
8061 <tr class="entries_header">
8062 <th class="th_details" colspan="5">Details</th>
8063 </tr>
8064 <tr class="entry_cont">
8065 <td class="entry_details" colspan="5">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]8066 <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]8067REPROCESS.<wbr/> Ignored otherwise</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8068 </td>
8069 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8070
8071
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8072 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8073 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8074
8075
8076 <tr class="entry" id="controls_android.request.metadataMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8077 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8078 android.<wbr/>request.<wbr/>metadata<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8079 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8080 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8081 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8082
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8083 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8084
8085 <ul class="entry_type_enum">
8086 <li>
8087 <span class="entry_type_enum_name">NONE</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]8088 <span class="entry_type_enum_notes"><p>No metadata should be produced on output,<wbr/> except
8089for application-bound buffer data.<wbr/> If no
8090application-bound streams exist,<wbr/> no frame should be
8091placed in the output frame queue.<wbr/> If such streams
8092exist,<wbr/> a frame should be placed on the output queue
8093with null metadata but with the necessary output buffer
8094information.<wbr/> Timestamp information should still be
8095included with any output stream buffers</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8096 </li>
8097 <li>
8098 <span class="entry_type_enum_name">FULL</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]8099 <span class="entry_type_enum_notes"><p>All metadata should be produced.<wbr/> Statistics will
8100only be produced if they are separately
8101enabled</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8102 </li>
8103 </ul>
8104
8105 </td> <!-- entry_type -->
8106
8107 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8108 <p>How much metadata to produce on
8109output</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8110 </td>
8111
8112 <td class="entry_units">
8113 </td>
8114
8115 <td class="entry_range">
8116 </td>
8117
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8118 <td class="entry_tags">
8119 </td>
8120
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8121 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8122
8123
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8124 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8125 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8126
8127
8128 <tr class="entry" id="controls_android.request.outputStreams">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8129 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8130 android.<wbr/>request.<wbr/>output<wbr/>Streams
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8131 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8132 <td class="entry_type">
Zhijun Hee36cdbe2013-09-06 14:28:37 -0700[diff] [blame]8133 <span class="entry_type_name">int32</span>
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]8134 <span class="entry_type_container">x</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8135
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]8136 <span class="entry_type_array">
8137 n
8138 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8139 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8140
8141
8142 </td> <!-- entry_type -->
8143
8144 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8145 <p>Lists which camera output streams image data
8146from this capture must be sent to</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8147 </td>
8148
8149 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8150 List of camera stream IDs
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8151 </td>
8152
8153 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]8154 <p>List must only include streams that have been
8155created</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8156 </td>
8157
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8158 <td class="entry_tags">
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]8159 <ul class="entry_tags">
8160 <li><a href="#tag_HAL2">HAL2</a></li>
8161 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8162 </td>
8163
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8164 </tr>
8165 <tr class="entries_header">
8166 <th class="th_details" colspan="5">Details</th>
8167 </tr>
8168 <tr class="entry_cont">
8169 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8170 <p>If no output streams are listed,<wbr/> then the image
8171data should simply be discarded.<wbr/> The image data must
8172still be captured for metadata and statistics production,<wbr/>
8173and the lens and flash must operate as requested.<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8174 </td>
8175 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8176
8177
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8178 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8179 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8180
8181
8182 <tr class="entry" id="controls_android.request.type">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8183 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8184 android.<wbr/>request.<wbr/>type
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8185 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8186 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8187 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8188
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8189 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8190
8191 <ul class="entry_type_enum">
8192 <li>
8193 <span class="entry_type_enum_name">CAPTURE</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]8194 <span class="entry_type_enum_notes"><p>Capture a new image from the imaging hardware,<wbr/>
8195and process it according to the
8196settings</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8197 </li>
8198 <li>
8199 <span class="entry_type_enum_name">REPROCESS</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]8200 <span class="entry_type_enum_notes"><p>Process previously captured data; the
8201android.<wbr/>request.<wbr/>input<wbr/>Stream parameter determines the
8202source reprocessing stream.<wbr/> TODO: Mark dynamic metadata
8203needed for reprocessing with [RP]</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8204 </li>
8205 </ul>
8206
8207 </td> <!-- entry_type -->
8208
8209 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8210 <p>The type of the request; either CAPTURE or
8211REPROCESS.<wbr/> For HAL3,<wbr/> this tag is redundant.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8212 </td>
8213
8214 <td class="entry_units">
8215 </td>
8216
8217 <td class="entry_range">
8218 </td>
8219
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8220 <td class="entry_tags">
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]8221 <ul class="entry_tags">
8222 <li><a href="#tag_HAL2">HAL2</a></li>
8223 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8224 </td>
8225
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8226 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8227
8228
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8229 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8230 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8231
8232
8233
8234 <!-- end of kind -->
8235 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8236 <tr><td colspan="6" class="kind">static</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8237
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8238 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8239 <tr>
8240 <th class="th_name">Property Name</th>
8241 <th class="th_type">Type</th>
8242 <th class="th_description">Description</th>
8243 <th class="th_units">Units</th>
8244 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8245 <th class="th_tags">Tags</th>
8246 </tr>
8247 </thead>
8248
8249 <tbody>
8250
8251
8252
8253
8254
8255
8256
8257
8258
8259
8260 <tr class="entry" id="static_android.request.maxNumOutputStreams">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8261 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8262 android.<wbr/>request.<wbr/>max<wbr/>Num<wbr/>Output<wbr/>Streams
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8263 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8264 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8265 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8266 <span class="entry_type_container">x</span>
8267
8268 <span class="entry_type_array">
8269 3
8270 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8271 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8272
8273
8274 </td> <!-- entry_type -->
8275
8276 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8277 <p>How many output streams can be allocated at
8278the same time for each type of stream</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8279 </td>
8280
8281 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8282 The number of raw sensor streams; the number of
8283 processed,<wbr/> uncompressed streams; and the number of
8284 JPEG-compressed streams
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8285 </td>
8286
8287 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame]8288 <p>&gt;=1 for Raw and JPEG-compressed stream.<wbr/> &gt;= 3
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]8289for processed,<wbr/> uncompressed streams</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8290 </td>
8291
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8292 <td class="entry_tags">
8293 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]8294 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8295 </ul>
8296 </td>
8297
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8298 </tr>
8299 <tr class="entries_header">
8300 <th class="th_details" colspan="5">Details</th>
8301 </tr>
8302 <tr class="entry_cont">
8303 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8304 <p>Video snapshot with preview callbacks requires 3
8305processed streams (preview,<wbr/> record,<wbr/> app callbacks) and
8306one JPEG stream (snapshot)</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8307 </td>
8308 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8309
8310
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8311 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8312 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8313
8314
8315 <tr class="entry" id="static_android.request.maxNumReprocessStreams">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8316 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8317 android.<wbr/>request.<wbr/>max<wbr/>Num<wbr/>Reprocess<wbr/>Streams
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8318 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8319 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8320 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8321 <span class="entry_type_container">x</span>
8322
8323 <span class="entry_type_array">
8324 1
8325 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8326 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8327
8328
8329 </td> <!-- entry_type -->
8330
8331 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8332 <p>How many reprocessing streams of any type
8333can be allocated at the same time</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8334 </td>
8335
8336 <td class="entry_units">
8337 </td>
8338
8339 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame]8340 <p>&gt;= 1</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8341 </td>
8342
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8343 <td class="entry_tags">
8344 </td>
8345
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8346 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8347
8348
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8349 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8350 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8351
8352
8353
8354 <!-- end of kind -->
8355 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8356 <tr><td colspan="6" class="kind">dynamic</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8357
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8358 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8359 <tr>
8360 <th class="th_name">Property Name</th>
8361 <th class="th_type">Type</th>
8362 <th class="th_description">Description</th>
8363 <th class="th_units">Units</th>
8364 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8365 <th class="th_tags">Tags</th>
8366 </tr>
8367 </thead>
8368
8369 <tbody>
8370
8371
8372
8373
8374
8375
8376
8377
8378
8379
8380 <tr class="entry" id="dynamic_android.request.frameCount">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8381 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8382 android.<wbr/>request.<wbr/>frame<wbr/>Count
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8383 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8384 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8385 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8386
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8387 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8388
8389
8390 </td> <!-- entry_type -->
8391
8392 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8393 <p>A frame counter set by the framework.<wbr/> This value monotonically
8394increases with every new result (that is,<wbr/> each new result has a unique
8395frameCount value).<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8396 </td>
8397
8398 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8399 count of frames
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8400 </td>
8401
8402 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame]8403 <p>&gt; 0</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8404 </td>
8405
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8406 <td class="entry_tags">
8407 </td>
8408
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8409 </tr>
8410 <tr class="entries_header">
8411 <th class="th_details" colspan="5">Details</th>
8412 </tr>
8413 <tr class="entry_cont">
8414 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8415 <p>Reset on release()</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8416 </td>
8417 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8418
8419
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8420 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8421 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8422
8423
8424 <tr class="entry" id="dynamic_android.request.id">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8425 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8426 android.<wbr/>request.<wbr/>id
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8427 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8428 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8429 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8430
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8431 <span class="entry_type_visibility"> [hidden]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8432
8433
8434 </td> <!-- entry_type -->
8435
8436 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8437 <p>An application-specified ID for the current
8438request.<wbr/> Must be maintained unchanged in output
8439frame</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8440 </td>
8441
8442 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8443 arbitrary integer assigned by application
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8444 </td>
8445
8446 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]8447 <p>Any int</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8448 </td>
8449
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8450 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]8451 <ul class="entry_tags">
8452 <li><a href="#tag_V1">V1</a></li>
8453 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8454 </td>
8455
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8456 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8457
8458
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8459 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8460 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8461
8462
8463 <tr class="entry" id="dynamic_android.request.metadataMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8464 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8465 android.<wbr/>request.<wbr/>metadata<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8466 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8467 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8468 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8469
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8470 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8471
8472 <ul class="entry_type_enum">
8473 <li>
8474 <span class="entry_type_enum_name">NONE</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]8475 <span class="entry_type_enum_notes"><p>No metadata should be produced on output,<wbr/> except
8476for application-bound buffer data.<wbr/> If no
8477application-bound streams exist,<wbr/> no frame should be
8478placed in the output frame queue.<wbr/> If such streams
8479exist,<wbr/> a frame should be placed on the output queue
8480with null metadata but with the necessary output buffer
8481information.<wbr/> Timestamp information should still be
8482included with any output stream buffers</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8483 </li>
8484 <li>
8485 <span class="entry_type_enum_name">FULL</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]8486 <span class="entry_type_enum_notes"><p>All metadata should be produced.<wbr/> Statistics will
8487only be produced if they are separately
8488enabled</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8489 </li>
8490 </ul>
8491
8492 </td> <!-- entry_type -->
8493
8494 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8495 <p>How much metadata to produce on
8496output</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8497 </td>
8498
8499 <td class="entry_units">
8500 </td>
8501
8502 <td class="entry_range">
8503 </td>
8504
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8505 <td class="entry_tags">
8506 </td>
8507
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8508 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8509
8510
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8511 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8512 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8513
8514
8515 <tr class="entry" id="dynamic_android.request.outputStreams">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8516 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8517 android.<wbr/>request.<wbr/>output<wbr/>Streams
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8518 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8519 <td class="entry_type">
Zhijun Hee36cdbe2013-09-06 14:28:37 -0700[diff] [blame]8520 <span class="entry_type_name">int32</span>
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]8521 <span class="entry_type_container">x</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8522
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]8523 <span class="entry_type_array">
8524 n
8525 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8526 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8527
8528
8529 </td> <!-- entry_type -->
8530
8531 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8532 <p>Lists which camera output streams image data
8533from this capture must be sent to</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8534 </td>
8535
8536 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8537 List of camera stream IDs
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8538 </td>
8539
8540 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]8541 <p>List must only include streams that have been
8542created</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8543 </td>
8544
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8545 <td class="entry_tags">
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]8546 <ul class="entry_tags">
8547 <li><a href="#tag_HAL2">HAL2</a></li>
8548 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8549 </td>
8550
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8551 </tr>
8552 <tr class="entries_header">
8553 <th class="th_details" colspan="5">Details</th>
8554 </tr>
8555 <tr class="entry_cont">
8556 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8557 <p>If no output streams are listed,<wbr/> then the image
8558data should simply be discarded.<wbr/> The image data must
8559still be captured for metadata and statistics production,<wbr/>
8560and the lens and flash must operate as requested.<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8561 </td>
8562 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8563
8564
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8565 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8566 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8567
8568
8569
8570 <!-- end of kind -->
8571 </tbody>
8572
8573 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8574 <tr><td colspan="6" id="section_scaler" class="section">scaler</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8575
8576
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8577 <tr><td colspan="6" class="kind">controls</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8578
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8579 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8580 <tr>
8581 <th class="th_name">Property Name</th>
8582 <th class="th_type">Type</th>
8583 <th class="th_description">Description</th>
8584 <th class="th_units">Units</th>
8585 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8586 <th class="th_tags">Tags</th>
8587 </tr>
8588 </thead>
8589
8590 <tbody>
8591
8592
8593
8594
8595
8596
8597
8598
8599
8600
8601 <tr class="entry" id="controls_android.scaler.cropRegion">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8602 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8603 android.<wbr/>scaler.<wbr/>crop<wbr/>Region
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8604 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8605 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8606 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8607 <span class="entry_type_container">x</span>
8608
8609 <span class="entry_type_array">
Eino-Ville Talvalae04ec6e2013-04-16 15:35:18 -0700[diff] [blame]8610 4
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8611 </span>
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]8612 <span class="entry_type_visibility"> [public as rectangle]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8613
8614
8615 </td> <!-- entry_type -->
8616
8617 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8618 <p>(x,<wbr/> y,<wbr/> width,<wbr/> height).<wbr/></p>
8619<p>A rectangle with the top-level corner of (x,<wbr/>y) and size
8620(width,<wbr/> height).<wbr/> The region of the sensor that is used for
8621output.<wbr/> Each stream must use this rectangle to produce its
8622output,<wbr/> cropping to a smaller region if necessary to
8623maintain the stream's aspect ratio.<wbr/></p>
8624<p>HAL2.<wbr/>x uses only (x,<wbr/> y,<wbr/> width)</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8625 </td>
8626
8627 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8628 (x,<wbr/>y) of top-left corner,<wbr/> width and height of region
8629 in pixels; (0,<wbr/>0) is top-left corner of
8630 android.<wbr/>sensor.<wbr/>active<wbr/>Array<wbr/>Size
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8631 </td>
8632
8633 <td class="entry_range">
8634 </td>
8635
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8636 <td class="entry_tags">
8637 <ul class="entry_tags">
8638 <li><a href="#tag_BC">BC</a></li>
8639 </ul>
8640 </td>
8641
8642 </tr>
8643 <tr class="entries_header">
8644 <th class="th_details" colspan="5">Details</th>
8645 </tr>
8646 <tr class="entry_cont">
8647 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8648 <p>Any additional per-stream cropping must be done to
8649maximize the final pixel area of the stream.<wbr/></p>
8650<p>For example,<wbr/> if the crop region is set to a 4:3 aspect
8651ratio,<wbr/> then 4:3 streams should use the exact crop
8652region.<wbr/> 16:9 streams should further crop vertically
8653(letterbox).<wbr/></p>
8654<p>Conversely,<wbr/> if the crop region is set to a 16:9,<wbr/> then 4:3
8655outputs should crop horizontally (pillarbox),<wbr/> and 16:9
8656streams should match exactly.<wbr/> These additional crops must
8657be centered within the crop region.<wbr/></p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]8658<p>The output streams must maintain square pixels at all
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8659times,<wbr/> no matter what the relative aspect ratios of the
8660crop region and the stream are.<wbr/> Negative values for
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]8661corner are allowed for raw output if full pixel array is
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8662larger than active pixel array.<wbr/> Width and height may be
8663rounded to nearest larger supportable width,<wbr/> especially
8664for raw output,<wbr/> where only a few fixed scales may be
8665possible.<wbr/> The width and height of the crop region cannot
8666be set to be smaller than floor( activeArraySize.<wbr/>width /<wbr/>
8667android.<wbr/>scaler.<wbr/>max<wbr/>Digital<wbr/>Zoom ) and floor(
8668activeArraySize.<wbr/>height /<wbr/> android.<wbr/>scaler.<wbr/>max<wbr/>Digital<wbr/>Zoom),<wbr/>
8669respectively.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8670 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8671 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8672
8673
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8674 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8675 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8676
8677
8678
8679 <!-- end of kind -->
8680 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8681 <tr><td colspan="6" class="kind">static</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8682
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8683 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8684 <tr>
8685 <th class="th_name">Property Name</th>
8686 <th class="th_type">Type</th>
8687 <th class="th_description">Description</th>
8688 <th class="th_units">Units</th>
8689 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8690 <th class="th_tags">Tags</th>
8691 </tr>
8692 </thead>
8693
8694 <tbody>
8695
8696
8697
8698
8699
8700
8701
8702
8703
8704
8705 <tr class="entry" id="static_android.scaler.availableFormats">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8706 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8707 android.<wbr/>scaler.<wbr/>available<wbr/>Formats
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8708 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8709 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8710 <span class="entry_type_name entry_type_name_enum">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8711 <span class="entry_type_container">x</span>
8712
8713 <span class="entry_type_array">
8714 n
8715 </span>
Eino-Ville Talvalad4e240a2013-08-08 12:56:37 -0700[diff] [blame]8716 <span class="entry_type_visibility"> [public as imageFormat]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8717 <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]8718
8719 <ul class="entry_type_enum">
8720 <li>
8721 <span class="entry_type_enum_name">RAW_SENSOR</span>
8722 <span class="entry_type_enum_value">0x20</span>
8723 </li>
8724 <li>
8725 <span class="entry_type_enum_name">YV12</span>
8726 <span class="entry_type_enum_value">0x32315659</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]8727 <span class="entry_type_enum_notes"><p>YCrCb 4:2:0 Planar</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8728 </li>
8729 <li>
Zhijun Hec2eebff2013-05-16 17:49:35 -0700[diff] [blame]8730 <span class="entry_type_enum_name">YCrCb_420_SP</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8731 <span class="entry_type_enum_value">0x11</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]8732 <span class="entry_type_enum_notes"><p>NV21</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8733 </li>
8734 <li>
Zhijun Hec2eebff2013-05-16 17:49:35 -0700[diff] [blame]8735 <span class="entry_type_enum_name">IMPLEMENTATION_DEFINED</span>
8736 <span class="entry_type_enum_value">0x22</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]8737 <span class="entry_type_enum_notes"><p>Hal Implementation Defined</p></span>
Zhijun Hec2eebff2013-05-16 17:49:35 -0700[diff] [blame]8738 </li>
8739 <li>
8740 <span class="entry_type_enum_name">YCbCr_420_888</span>
8741 <span class="entry_type_enum_value">0x23</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]8742 <span class="entry_type_enum_notes"><p>Flexible YUV420 Format</p></span>
Zhijun Hec2eebff2013-05-16 17:49:35 -0700[diff] [blame]8743 </li>
8744 <li>
8745 <span class="entry_type_enum_name">BLOB</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8746 <span class="entry_type_enum_value">0x21</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]8747 <span class="entry_type_enum_notes"><p>JPEG</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8748 </li>
8749 </ul>
8750
8751 </td> <!-- entry_type -->
8752
8753 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8754 <p>List of app-visible formats</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8755 </td>
8756
8757 <td class="entry_units">
8758 </td>
8759
8760 <td class="entry_range">
8761 </td>
8762
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8763 <td class="entry_tags">
8764 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]8765 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8766 </ul>
8767 </td>
8768
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8769 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8770
8771
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8772 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8773 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8774
8775
8776 <tr class="entry" id="static_android.scaler.availableJpegMinDurations">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8777 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8778 android.<wbr/>scaler.<wbr/>available<wbr/>Jpeg<wbr/>Min<wbr/>Durations
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8779 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8780 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8781 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8782 <span class="entry_type_container">x</span>
8783
8784 <span class="entry_type_array">
8785 n
8786 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8787 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8788
8789
8790 </td> <!-- entry_type -->
8791
8792 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8793 <p>The minimum frame duration that is supported
8794for each resolution in availableJpegSizes.<wbr/> Should
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]8795correspond to the frame duration when only that JPEG
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8796stream is active and captured in a burst,<wbr/> with all
8797processing set to FAST</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8798 </td>
8799
8800 <td class="entry_units">
8801 </td>
8802
8803 <td class="entry_range">
8804 </td>
8805
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8806 <td class="entry_tags">
8807 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]8808 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8809 </ul>
8810 </td>
8811
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8812 </tr>
8813 <tr class="entries_header">
8814 <th class="th_details" colspan="5">Details</th>
8815 </tr>
8816 <tr class="entry_cont">
8817 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8818 <p>When multiple streams are configured,<wbr/> the minimum
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8819frame duration will be &gt;= max(individual stream min
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8820durations)</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8821 </td>
8822 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8823
8824
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8825 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8826 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8827
8828
8829 <tr class="entry" id="static_android.scaler.availableJpegSizes">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8830 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8831 android.<wbr/>scaler.<wbr/>available<wbr/>Jpeg<wbr/>Sizes
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8832 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8833 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8834 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8835 <span class="entry_type_container">x</span>
8836
8837 <span class="entry_type_array">
8838 n x 2
8839 </span>
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]8840 <span class="entry_type_visibility"> [public as size]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8841
8842
8843 </td> <!-- entry_type -->
8844
8845 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8846 <p>The resolutions available for output from
8847the JPEG block.<wbr/> Listed as width x height</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8848 </td>
8849
8850 <td class="entry_units">
8851 </td>
8852
8853 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]8854 <p>Must include: - sensor maximum resolution Should
8855include: - half/<wbr/>quarter max resolution</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8856 </td>
8857
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8858 <td class="entry_tags">
8859 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]8860 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8861 </ul>
8862 </td>
8863
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8864 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8865
8866
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8867 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8868 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8869
8870
8871 <tr class="entry" id="static_android.scaler.availableMaxDigitalZoom">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8872 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8873 android.<wbr/>scaler.<wbr/>available<wbr/>Max<wbr/>Digital<wbr/>Zoom
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8874 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8875 <td class="entry_type">
Igor Murashkinf11a4df2013-05-07 10:00:46 -0700[diff] [blame]8876 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8877
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8878 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8879
8880
8881 </td> <!-- entry_type -->
8882
8883 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8884 <p>The maximum ratio between active area width
8885and crop region width,<wbr/> or between active area height and
8886crop region height,<wbr/> if the crop region height is larger
8887than width</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8888 </td>
8889
8890 <td class="entry_units">
8891 </td>
8892
8893 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame]8894 <p>&gt;=1</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8895 </td>
8896
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8897 <td class="entry_tags">
Igor Murashkinf11a4df2013-05-07 10:00:46 -0700[diff] [blame]8898 <ul class="entry_tags">
8899 <li><a href="#tag_BC">BC</a></li>
8900 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8901 </td>
8902
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8903 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8904
8905
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8906 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8907 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8908
8909
8910 <tr class="entry" id="static_android.scaler.availableProcessedMinDurations">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8911 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8912 android.<wbr/>scaler.<wbr/>available<wbr/>Processed<wbr/>Min<wbr/>Durations
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8913 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8914 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8915 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8916 <span class="entry_type_container">x</span>
8917
8918 <span class="entry_type_array">
8919 n
8920 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8921 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8922
8923
8924 </td> <!-- entry_type -->
8925
8926 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8927 <p>The minimum frame duration that is supported
8928for each resolution in availableProcessedSizes.<wbr/> Should
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]8929correspond to the frame duration when only that processed
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8930stream is active,<wbr/> with all processing set to
8931FAST</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8932 </td>
8933
8934 <td class="entry_units">
8935 </td>
8936
8937 <td class="entry_range">
8938 </td>
8939
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8940 <td class="entry_tags">
8941 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]8942 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8943 </ul>
8944 </td>
8945
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8946 </tr>
8947 <tr class="entries_header">
8948 <th class="th_details" colspan="5">Details</th>
8949 </tr>
8950 <tr class="entry_cont">
8951 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8952 <p>When multiple streams are configured,<wbr/> the minimum
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8953frame duration will be &gt;= max(individual stream min
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8954durations)</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8955 </td>
8956 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8957
8958
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8959 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8960 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8961
8962
8963 <tr class="entry" id="static_android.scaler.availableProcessedSizes">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8964 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8965 android.<wbr/>scaler.<wbr/>available<wbr/>Processed<wbr/>Sizes
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8966 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8967 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8968 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8969 <span class="entry_type_container">x</span>
8970
8971 <span class="entry_type_array">
8972 n x 2
8973 </span>
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]8974 <span class="entry_type_visibility"> [public as size]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8975
8976
8977 </td> <!-- entry_type -->
8978
8979 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8980 <p>The resolutions available for use with
8981processed output streams,<wbr/> such as YV12,<wbr/> NV12,<wbr/> and
8982platform opaque YUV/<wbr/>RGB streams to the GPU or video
8983encoders.<wbr/> Listed as width,<wbr/> height</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8984 </td>
8985
8986 <td class="entry_units">
8987 </td>
8988
8989 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]8990 <p>Must include: - sensor maximum resolution -
8991standard QCIF,<wbr/> 240p,<wbr/> 480p,<wbr/> 720p,<wbr/> and 1080p
8992resolutions</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8993 </td>
8994
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8995 <td class="entry_tags">
8996 <ul class="entry_tags">
8997 <li><a href="#tag_BC">BC</a></li>
8998 </ul>
8999 </td>
9000
9001 </tr>
9002 <tr class="entries_header">
9003 <th class="th_details" colspan="5">Details</th>
9004 </tr>
9005 <tr class="entry_cont">
9006 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9007 <p>The actual supported resolution list may be limited by
9008consumer end points for different use cases.<wbr/> For example,<wbr/> for
9009recording use case,<wbr/> the largest supported resolution may be
9010limited by max supported size from encoder,<wbr/> for preview use
9011case,<wbr/> the largest supported resolution may be limited by max
9012resolution SurfaceTexture/<wbr/>SurfaceView can support.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9013 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9014 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9015
9016
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9017 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9018 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9019
9020
9021 <tr class="entry" id="static_android.scaler.availableRawMinDurations">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9022 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9023 android.<wbr/>scaler.<wbr/>available<wbr/>Raw<wbr/>Min<wbr/>Durations
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9024 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9025 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9026 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9027 <span class="entry_type_container">x</span>
9028
9029 <span class="entry_type_array">
9030 n
9031 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9032 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9033
9034
9035 </td> <!-- entry_type -->
9036
9037 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9038 <p>The minimum frame duration that is supported
9039for each raw resolution in availableRawSizes.<wbr/> Should
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]9040correspond to the frame duration when only the raw stream
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9041is active.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9042 </td>
9043
9044 <td class="entry_units">
9045 </td>
9046
9047 <td class="entry_range">
9048 </td>
9049
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9050 <td class="entry_tags">
9051 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9052 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9053 </ul>
9054 </td>
9055
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9056 </tr>
9057 <tr class="entries_header">
9058 <th class="th_details" colspan="5">Details</th>
9059 </tr>
9060 <tr class="entry_cont">
9061 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9062 <p>When multiple streams are configured,<wbr/> the minimum
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9063frame duration will be &gt;= max(individual stream min
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9064durations)</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9065 </td>
9066 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9067
9068
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9069 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9070 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9071
9072
9073 <tr class="entry" id="static_android.scaler.availableRawSizes">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9074 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9075 android.<wbr/>scaler.<wbr/>available<wbr/>Raw<wbr/>Sizes
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9076 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9077 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9078 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9079 <span class="entry_type_container">x</span>
9080
9081 <span class="entry_type_array">
9082 n x 2
9083 </span>
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]9084 <span class="entry_type_visibility"> [system as size]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9085
9086
9087 </td> <!-- entry_type -->
9088
9089 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9090 <p>The resolutions available for use with raw
9091sensor output streams,<wbr/> listed as width,<wbr/>
9092height</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9093 </td>
9094
9095 <td class="entry_units">
9096 </td>
9097
9098 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]9099 <p>Must include: - sensor maximum resolution</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9100 </td>
9101
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9102 <td class="entry_tags">
9103 </td>
9104
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9105 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9106
9107
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9108 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9109 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9110
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9111
9112
9113 <!-- end of kind -->
9114 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9115 <tr><td colspan="6" class="kind">dynamic</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9116
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9117 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9118 <tr>
9119 <th class="th_name">Property Name</th>
9120 <th class="th_type">Type</th>
9121 <th class="th_description">Description</th>
9122 <th class="th_units">Units</th>
9123 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9124 <th class="th_tags">Tags</th>
9125 </tr>
9126 </thead>
9127
9128 <tbody>
9129
9130
9131
9132
9133
9134
9135
9136
9137
9138
9139 <tr class="entry" id="dynamic_android.scaler.cropRegion">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9140 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9141 android.<wbr/>scaler.<wbr/>crop<wbr/>Region
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9142 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9143 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9144 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9145 <span class="entry_type_container">x</span>
9146
9147 <span class="entry_type_array">
Eino-Ville Talvalae04ec6e2013-04-16 15:35:18 -0700[diff] [blame]9148 4
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9149 </span>
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]9150 <span class="entry_type_visibility"> [public as rectangle]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9151
9152
9153 </td> <!-- entry_type -->
9154
9155 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9156 <p>(x,<wbr/> y,<wbr/> width,<wbr/> height).<wbr/></p>
9157<p>A rectangle with the top-level corner of (x,<wbr/>y) and size
9158(width,<wbr/> height).<wbr/> The region of the sensor that is used for
9159output.<wbr/> Each stream must use this rectangle to produce its
9160output,<wbr/> cropping to a smaller region if necessary to
9161maintain the stream's aspect ratio.<wbr/></p>
9162<p>HAL2.<wbr/>x uses only (x,<wbr/> y,<wbr/> width)</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9163 </td>
9164
9165 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9166 (x,<wbr/>y) of top-left corner,<wbr/> width and height of region
9167 in pixels; (0,<wbr/>0) is top-left corner of
9168 android.<wbr/>sensor.<wbr/>active<wbr/>Array<wbr/>Size
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9169 </td>
9170
9171 <td class="entry_range">
9172 </td>
9173
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9174 <td class="entry_tags">
9175 <ul class="entry_tags">
9176 <li><a href="#tag_BC">BC</a></li>
9177 </ul>
9178 </td>
9179
9180 </tr>
9181 <tr class="entries_header">
9182 <th class="th_details" colspan="5">Details</th>
9183 </tr>
9184 <tr class="entry_cont">
9185 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9186 <p>Any additional per-stream cropping must be done to
9187maximize the final pixel area of the stream.<wbr/></p>
9188<p>For example,<wbr/> if the crop region is set to a 4:3 aspect
9189ratio,<wbr/> then 4:3 streams should use the exact crop
9190region.<wbr/> 16:9 streams should further crop vertically
9191(letterbox).<wbr/></p>
9192<p>Conversely,<wbr/> if the crop region is set to a 16:9,<wbr/> then 4:3
9193outputs should crop horizontally (pillarbox),<wbr/> and 16:9
9194streams should match exactly.<wbr/> These additional crops must
9195be centered within the crop region.<wbr/></p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]9196<p>The output streams must maintain square pixels at all
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9197times,<wbr/> no matter what the relative aspect ratios of the
9198crop region and the stream are.<wbr/> Negative values for
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]9199corner are allowed for raw output if full pixel array is
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9200larger than active pixel array.<wbr/> Width and height may be
9201rounded to nearest larger supportable width,<wbr/> especially
9202for raw output,<wbr/> where only a few fixed scales may be
9203possible.<wbr/> The width and height of the crop region cannot
9204be set to be smaller than floor( activeArraySize.<wbr/>width /<wbr/>
9205android.<wbr/>scaler.<wbr/>max<wbr/>Digital<wbr/>Zoom ) and floor(
9206activeArraySize.<wbr/>height /<wbr/> android.<wbr/>scaler.<wbr/>max<wbr/>Digital<wbr/>Zoom),<wbr/>
9207respectively.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9208 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9209 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9210
9211
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9212 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9213 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9214
9215
9216
9217 <!-- end of kind -->
9218 </tbody>
9219
9220 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9221 <tr><td colspan="6" id="section_sensor" class="section">sensor</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9222
9223
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9224 <tr><td colspan="6" class="kind">controls</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9225
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9226 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9227 <tr>
9228 <th class="th_name">Property Name</th>
9229 <th class="th_type">Type</th>
9230 <th class="th_description">Description</th>
9231 <th class="th_units">Units</th>
9232 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9233 <th class="th_tags">Tags</th>
9234 </tr>
9235 </thead>
9236
9237 <tbody>
9238
9239
9240
9241
9242
9243
9244
9245
9246
9247
9248 <tr class="entry" id="controls_android.sensor.exposureTime">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9249 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9250 android.<wbr/>sensor.<wbr/>exposure<wbr/>Time
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9251 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9252 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9253 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9254
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9255 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9256
9257
9258 </td> <!-- entry_type -->
9259
9260 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9261 <p>Duration each pixel is exposed to
9262light.<wbr/></p>
9263<p>If the sensor can't expose this exact duration,<wbr/> it should shorten the
9264duration exposed to the nearest possible value (rather than expose longer).<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9265 </td>
9266
9267 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9268 nanoseconds
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9269 </td>
9270
9271 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]9272 <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]9273 </td>
9274
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9275 <td class="entry_tags">
9276 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9277 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9278 </ul>
9279 </td>
9280
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9281 </tr>
9282 <tr class="entries_header">
9283 <th class="th_details" colspan="5">Details</th>
9284 </tr>
9285 <tr class="entry_cont">
9286 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9287 <p>1/<wbr/>10000 - 30 sec range.<wbr/> No bulb mode</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9288 </td>
9289 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9290
9291
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9292 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9293 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9294
9295
9296 <tr class="entry" id="controls_android.sensor.frameDuration">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9297 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9298 android.<wbr/>sensor.<wbr/>frame<wbr/>Duration
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9299 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9300 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9301 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9302
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9303 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9304
9305
9306 </td> <!-- entry_type -->
9307
9308 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9309 <p>Duration from start of frame exposure to
9310start of next frame exposure</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9311 </td>
9312
9313 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9314 nanoseconds
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9315 </td>
9316
9317 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]9318 <p>see <a href="#static_android.sensor.info.maxFrameDuration">android.<wbr/>sensor.<wbr/>info.<wbr/>max<wbr/>Frame<wbr/>Duration</a>,<wbr/>
9319android.<wbr/>scaler.<wbr/>info.<wbr/>available<wbr/>Min<wbr/>Frame<wbr/>Durations</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9320 </td>
9321
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9322 <td class="entry_tags">
9323 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9324 <li><a href="#tag_V1">V1</a></li>
9325 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9326 </ul>
9327 </td>
9328
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9329 </tr>
9330 <tr class="entries_header">
9331 <th class="th_details" colspan="5">Details</th>
9332 </tr>
9333 <tr class="entry_cont">
9334 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9335 <p>Exposure time has priority,<wbr/> so duration is set to
9336max(duration,<wbr/> exposure time + overhead)</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9337 </td>
9338 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9339
9340
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9341 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9342 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9343
9344
9345 <tr class="entry" id="controls_android.sensor.sensitivity">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9346 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9347 android.<wbr/>sensor.<wbr/>sensitivity
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9348 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9349 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9350 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9351
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9352 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9353
9354
9355 </td> <!-- entry_type -->
9356
9357 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9358 <p>Gain applied to image data.<wbr/> Must be
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]9359implemented through analog gain only if set to values
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9360below 'maximum analog sensitivity'.<wbr/></p>
9361<p>If the sensor can't apply this exact gain,<wbr/> it should lessen the
9362gain to the nearest possible value (rather than gain more).<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9363 </td>
9364
9365 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9366 ISO arithmetic units
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9367 </td>
9368
9369 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]9370 <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]9371 </td>
9372
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9373 <td class="entry_tags">
9374 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9375 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9376 </ul>
9377 </td>
9378
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9379 </tr>
9380 <tr class="entries_header">
9381 <th class="th_details" colspan="5">Details</th>
9382 </tr>
9383 <tr class="entry_cont">
9384 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9385 <p>ISO 12232:2006 REI method</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9386 </td>
9387 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9388
9389
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9390 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9391 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9392
9393
9394
9395 <!-- end of kind -->
9396 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9397 <tr><td colspan="6" class="kind">static</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9398
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9399 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9400 <tr>
9401 <th class="th_name">Property Name</th>
9402 <th class="th_type">Type</th>
9403 <th class="th_description">Description</th>
9404 <th class="th_units">Units</th>
9405 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9406 <th class="th_tags">Tags</th>
9407 </tr>
9408 </thead>
9409
9410 <tbody>
9411
9412
9413
9414
9415
9416
9417
9418
9419
9420
9421
9422
9423 <tr class="entry" id="static_android.sensor.info.activeArraySize">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9424 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9425 android.<wbr/>sensor.<wbr/>info.<wbr/>active<wbr/>Array<wbr/>Size
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9426 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9427 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9428 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9429 <span class="entry_type_container">x</span>
9430
9431 <span class="entry_type_array">
9432 4
9433 </span>
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]9434 <span class="entry_type_visibility"> [public as rectangle]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9435 <div class="entry_type_notes">Four ints defining the active pixel rectangle</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9436
9437
9438 </td> <!-- entry_type -->
9439
9440 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9441 <p>Area of raw data which corresponds to only
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]9442active pixels; smaller or equal to
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9443pixelArraySize.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9444 </td>
9445
9446 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9447 xmin,<wbr/> ymin,<wbr/> width,<wbr/> height.<wbr/> Top left of full
9448 pixel array is (0,<wbr/>0)
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9449 </td>
9450
9451 <td class="entry_range">
9452 </td>
9453
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9454 <td class="entry_tags">
9455 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9456 <li><a href="#tag_DNG">DNG</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9457 </ul>
9458 </td>
9459
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9460 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9461
9462
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9463 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9464 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9465
9466
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]9467 <tr class="entry" id="static_android.sensor.info.sensitivityRange">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9468 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9469 android.<wbr/>sensor.<wbr/>info.<wbr/>sensitivity<wbr/>Range
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9470 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9471 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9472 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9473 <span class="entry_type_container">x</span>
9474
9475 <span class="entry_type_array">
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]9476 2
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9477 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9478 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9479 <div class="entry_type_notes">Range of supported sensitivities</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9480
9481
9482 </td> <!-- entry_type -->
9483
9484 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9485 <p>Range of valid sensitivities</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9486 </td>
9487
9488 <td class="entry_units">
9489 </td>
9490
9491 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]9492 <p>Min &lt;= 100,<wbr/> Max &gt;= 1600</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9493 </td>
9494
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9495 <td class="entry_tags">
9496 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9497 <li><a href="#tag_BC">BC</a></li>
9498 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9499 </ul>
9500 </td>
9501
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9502 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9503
9504
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9505 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9506 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9507
9508
9509 <tr class="entry" id="static_android.sensor.info.colorFilterArrangement">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9510 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9511 android.<wbr/>sensor.<wbr/>info.<wbr/>color<wbr/>Filter<wbr/>Arrangement
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9512 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9513 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9514 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9515
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9516 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9517
9518 <ul class="entry_type_enum">
9519 <li>
9520 <span class="entry_type_enum_name">RGGB</span>
9521 </li>
9522 <li>
9523 <span class="entry_type_enum_name">GRBG</span>
9524 </li>
9525 <li>
9526 <span class="entry_type_enum_name">GBRG</span>
9527 </li>
9528 <li>
9529 <span class="entry_type_enum_name">BGGR</span>
9530 </li>
9531 <li>
9532 <span class="entry_type_enum_name">RGB</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]9533 <span class="entry_type_enum_notes"><p>Sensor is not Bayer; output has 3 16-bit
9534values for each pixel,<wbr/> instead of just 1 16-bit value
9535per pixel.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9536 </li>
9537 </ul>
9538
9539 </td> <!-- entry_type -->
9540
9541 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9542 <p>Arrangement of color filters on sensor;
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]9543represents the colors in the top-left 2x2 section of
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9544the sensor,<wbr/> in reading order</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9545 </td>
9546
9547 <td class="entry_units">
9548 </td>
9549
9550 <td class="entry_range">
9551 </td>
9552
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9553 <td class="entry_tags">
9554 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9555 <li><a href="#tag_DNG">DNG</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9556 </ul>
9557 </td>
9558
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9559 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9560
9561
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9562 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9563 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9564
9565
9566 <tr class="entry" id="static_android.sensor.info.exposureTimeRange">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9567 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9568 android.<wbr/>sensor.<wbr/>info.<wbr/>exposure<wbr/>Time<wbr/>Range
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9569 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9570 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9571 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9572 <span class="entry_type_container">x</span>
9573
9574 <span class="entry_type_array">
9575 2
9576 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9577 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9578 <div class="entry_type_notes">nanoseconds</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9579
9580
9581 </td> <!-- entry_type -->
9582
9583 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9584 <p>Range of valid exposure
9585times</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9586 </td>
9587
9588 <td class="entry_units">
9589 </td>
9590
9591 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]9592 <p>Min &lt;= 100e3 (100 us),<wbr/> Max &gt;= 30e9 (30
9593sec)</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9594 </td>
9595
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9596 <td class="entry_tags">
9597 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9598 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9599 </ul>
9600 </td>
9601
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9602 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9603
9604
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9605 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9606 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9607
9608
9609 <tr class="entry" id="static_android.sensor.info.maxFrameDuration">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9610 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9611 android.<wbr/>sensor.<wbr/>info.<wbr/>max<wbr/>Frame<wbr/>Duration
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9612 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9613 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9614 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9615
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9616 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9617
9618
9619 </td> <!-- entry_type -->
9620
9621 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9622 <p>Maximum possible frame duration (minimum frame
9623rate)</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9624 </td>
9625
9626 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9627 nanoseconds
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9628 </td>
9629
9630 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame]9631 <p>&gt;= 30e9</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9632 </td>
9633
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9634 <td class="entry_tags">
9635 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9636 <li><a href="#tag_BC">BC</a></li>
9637 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9638 </ul>
9639 </td>
9640
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9641 </tr>
9642 <tr class="entries_header">
9643 <th class="th_details" colspan="5">Details</th>
9644 </tr>
9645 <tr class="entry_cont">
9646 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9647 <p>Minimum duration is a function of resolution,<wbr/>
9648processing settings.<wbr/> See
9649android.<wbr/>scaler.<wbr/>available<wbr/>Processed<wbr/>Min<wbr/>Durations
9650android.<wbr/>scaler.<wbr/>available<wbr/>Jpeg<wbr/>Min<wbr/>Durations
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]9651<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]9652 </td>
9653 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9654
9655
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9656 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9657 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9658
9659
9660 <tr class="entry" id="static_android.sensor.info.physicalSize">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9661 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9662 android.<wbr/>sensor.<wbr/>info.<wbr/>physical<wbr/>Size
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9663 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9664 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9665 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9666 <span class="entry_type_container">x</span>
9667
9668 <span class="entry_type_array">
9669 2
9670 </span>
Timothy Knightec817d52013-08-16 16:15:29 -0700[diff] [blame]9671 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9672 <div class="entry_type_notes">width x height in millimeters</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9673
9674
9675 </td> <!-- entry_type -->
9676
9677 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9678 <p>The physical dimensions of the full pixel
9679array</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9680 </td>
9681
9682 <td class="entry_units">
9683 </td>
9684
9685 <td class="entry_range">
9686 </td>
9687
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9688 <td class="entry_tags">
9689 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9690 <li><a href="#tag_V1">V1</a></li>
9691 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9692 </ul>
9693 </td>
9694
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9695 </tr>
9696 <tr class="entries_header">
9697 <th class="th_details" colspan="5">Details</th>
9698 </tr>
9699 <tr class="entry_cont">
9700 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9701 <p>Needed for FOV calculation for old API</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9702 </td>
9703 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9704
9705
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9706 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9707 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9708
9709
9710 <tr class="entry" id="static_android.sensor.info.pixelArraySize">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9711 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9712 android.<wbr/>sensor.<wbr/>info.<wbr/>pixel<wbr/>Array<wbr/>Size
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9713 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9714 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9715 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9716 <span class="entry_type_container">x</span>
9717
9718 <span class="entry_type_array">
9719 2
9720 </span>
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]9721 <span class="entry_type_visibility"> [system as size]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9722
9723
9724 </td> <!-- entry_type -->
9725
9726 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9727 <p>Dimensions of full pixel array,<wbr/> possibly
9728including black calibration pixels</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9729 </td>
9730
9731 <td class="entry_units">
9732 </td>
9733
9734 <td class="entry_range">
9735 </td>
9736
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9737 <td class="entry_tags">
9738 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9739 <li><a href="#tag_DNG">DNG</a></li>
9740 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9741 </ul>
9742 </td>
9743
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9744 </tr>
9745 <tr class="entries_header">
9746 <th class="th_details" colspan="5">Details</th>
9747 </tr>
9748 <tr class="entry_cont">
9749 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9750 <p>Maximum output resolution for raw format must
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9751match this in
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9752android.<wbr/>scaler.<wbr/>info.<wbr/>available<wbr/>Sizes<wbr/>Per<wbr/>Format</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9753 </td>
9754 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9755
9756
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9757 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9758 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9759
9760
9761 <tr class="entry" id="static_android.sensor.info.whiteLevel">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9762 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9763 android.<wbr/>sensor.<wbr/>info.<wbr/>white<wbr/>Level
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9764 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9765 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9766 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9767
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9768 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9769
9770
9771 </td> <!-- entry_type -->
9772
9773 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9774 <p>Maximum raw value output by
9775sensor</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9776 </td>
9777
9778 <td class="entry_units">
9779 </td>
9780
9781 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame]9782 <p>&gt; 1024 (10-bit output)</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9783 </td>
9784
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9785 <td class="entry_tags">
9786 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9787 <li><a href="#tag_DNG">DNG</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9788 </ul>
9789 </td>
9790
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9791 </tr>
9792 <tr class="entries_header">
9793 <th class="th_details" colspan="5">Details</th>
9794 </tr>
9795 <tr class="entry_cont">
9796 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9797 <p>Defines sensor bit depth (10-14 bits is
9798expected)</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9799 </td>
9800 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9801
9802
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9803 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9804 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9805
9806
9807
9808
9809
9810 <tr class="entry" id="static_android.sensor.baseGainFactor">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9811 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9812 android.<wbr/>sensor.<wbr/>base<wbr/>Gain<wbr/>Factor
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9813 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9814 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9815 <span class="entry_type_name">rational</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9816
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9817 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9818
9819
9820 </td> <!-- entry_type -->
9821
9822 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9823 <p>Gain factor from electrons to raw units when
9824ISO=100</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9825 </td>
9826
9827 <td class="entry_units">
9828 </td>
9829
9830 <td class="entry_range">
9831 </td>
9832
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9833 <td class="entry_tags">
9834 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9835 <li><a href="#tag_V1">V1</a></li>
Alex Rayef40ad62013-10-01 17:52:33 -0700[diff] [blame]9836 <li><a href="#tag_FULL">FULL</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9837 </ul>
9838 </td>
9839
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9840 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9841
9842
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9843 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9844 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9845
9846
9847 <tr class="entry" id="static_android.sensor.blackLevelPattern">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9848 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9849 android.<wbr/>sensor.<wbr/>black<wbr/>Level<wbr/>Pattern
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9850 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9851 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9852 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9853 <span class="entry_type_container">x</span>
9854
9855 <span class="entry_type_array">
9856 4
9857 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9858 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9859 <div class="entry_type_notes">2x2 raw count block</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9860
9861
9862 </td> <!-- entry_type -->
9863
9864 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9865 <p>A fixed black level offset for each of the
9866Bayer mosaic channels</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9867 </td>
9868
9869 <td class="entry_units">
9870 </td>
9871
9872 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame]9873 <p>&gt;= 0 each</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9874 </td>
9875
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9876 <td class="entry_tags">
9877 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9878 <li><a href="#tag_DNG">DNG</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9879 </ul>
9880 </td>
9881
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9882 </tr>
9883 <tr class="entries_header">
9884 <th class="th_details" colspan="5">Details</th>
9885 </tr>
9886 <tr class="entry_cont">
9887 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9888 <p>As per DNG BlackLevelRepeatDim /<wbr/> BlackLevel
9889tags</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9890 </td>
9891 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9892
9893
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9894 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9895 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9896
9897
9898 <tr class="entry" id="static_android.sensor.calibrationTransform1">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9899 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9900 android.<wbr/>sensor.<wbr/>calibration<wbr/>Transform1
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9901 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9902 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9903 <span class="entry_type_name">rational</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9904 <span class="entry_type_container">x</span>
9905
9906 <span class="entry_type_array">
9907 9
9908 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9909 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9910 <div class="entry_type_notes">3x3 matrix in row-major-order</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9911
9912
9913 </td> <!-- entry_type -->
9914
9915 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9916 <p>Per-device calibration on top of color space
9917transform 1</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9918 </td>
9919
9920 <td class="entry_units">
9921 </td>
9922
9923 <td class="entry_range">
9924 </td>
9925
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9926 <td class="entry_tags">
9927 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9928 <li><a href="#tag_DNG">DNG</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9929 </ul>
9930 </td>
9931
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9932 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9933
9934
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9935 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9936 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9937
9938
9939 <tr class="entry" id="static_android.sensor.calibrationTransform2">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9940 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9941 android.<wbr/>sensor.<wbr/>calibration<wbr/>Transform2
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9942 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9943 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9944 <span class="entry_type_name">rational</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9945 <span class="entry_type_container">x</span>
9946
9947 <span class="entry_type_array">
9948 9
9949 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9950 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9951 <div class="entry_type_notes">3x3 matrix in row-major-order</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9952
9953
9954 </td> <!-- entry_type -->
9955
9956 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9957 <p>Per-device calibration on top of color space
9958transform 2</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9959 </td>
9960
9961 <td class="entry_units">
9962 </td>
9963
9964 <td class="entry_range">
9965 </td>
9966
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9967 <td class="entry_tags">
9968 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9969 <li><a href="#tag_DNG">DNG</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9970 </ul>
9971 </td>
9972
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9973 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9974
9975
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9976 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9977 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9978
9979
9980 <tr class="entry" id="static_android.sensor.colorTransform1">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9981 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9982 android.<wbr/>sensor.<wbr/>color<wbr/>Transform1
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9983 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9984 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9985 <span class="entry_type_name">rational</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9986 <span class="entry_type_container">x</span>
9987
9988 <span class="entry_type_array">
9989 9
9990 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9991 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9992 <div class="entry_type_notes">3x3 matrix in row-major-order</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9993
9994
9995 </td> <!-- entry_type -->
9996
9997 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9998 <p>Linear mapping from XYZ (D50) color space to
9999reference linear sensor color,<wbr/> for first reference
10000illuminant</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10001 </td>
10002
10003 <td class="entry_units">
10004 </td>
10005
10006 <td class="entry_range">
10007 </td>
10008
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10009 <td class="entry_tags">
10010 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]10011 <li><a href="#tag_DNG">DNG</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10012 </ul>
10013 </td>
10014
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10015 </tr>
10016 <tr class="entries_header">
10017 <th class="th_details" colspan="5">Details</th>
10018 </tr>
10019 <tr class="entry_cont">
10020 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10021 <p>Use as follows XYZ = inv(transform) * clip( (raw -
10022black level(raw) ) /<wbr/> ( white level - max black level) ).<wbr/>
10023At least in the simple case</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10024 </td>
10025 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10026
10027
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10028 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10029 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10030
10031
10032 <tr class="entry" id="static_android.sensor.colorTransform2">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10033 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10034 android.<wbr/>sensor.<wbr/>color<wbr/>Transform2
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10035 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10036 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10037 <span class="entry_type_name">rational</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10038 <span class="entry_type_container">x</span>
10039
10040 <span class="entry_type_array">
10041 9
10042 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10043 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10044 <div class="entry_type_notes">3x3 matrix in row-major-order</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10045
10046
10047 </td> <!-- entry_type -->
10048
10049 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10050 <p>Linear mapping from XYZ (D50) color space to
10051reference linear sensor color,<wbr/> for second reference
10052illuminant</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10053 </td>
10054
10055 <td class="entry_units">
10056 </td>
10057
10058 <td class="entry_range">
10059 </td>
10060
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10061 <td class="entry_tags">
10062 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]10063 <li><a href="#tag_DNG">DNG</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10064 </ul>
10065 </td>
10066
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10067 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10068
10069
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10070 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10071 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10072
10073
10074 <tr class="entry" id="static_android.sensor.forwardMatrix1">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10075 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10076 android.<wbr/>sensor.<wbr/>forward<wbr/>Matrix1
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10077 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10078 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10079 <span class="entry_type_name">rational</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10080 <span class="entry_type_container">x</span>
10081
10082 <span class="entry_type_array">
10083 9
10084 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10085 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10086 <div class="entry_type_notes">3x3 matrix in row-major-order</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10087
10088
10089 </td> <!-- entry_type -->
10090
10091 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10092 <p>Used by DNG for better WB
10093adaptation</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10094 </td>
10095
10096 <td class="entry_units">
10097 </td>
10098
10099 <td class="entry_range">
10100 </td>
10101
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10102 <td class="entry_tags">
10103 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]10104 <li><a href="#tag_DNG">DNG</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10105 </ul>
10106 </td>
10107
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10108 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10109
10110
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10111 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10112 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10113
10114
10115 <tr class="entry" id="static_android.sensor.forwardMatrix2">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10116 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10117 android.<wbr/>sensor.<wbr/>forward<wbr/>Matrix2
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10118 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10119 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10120 <span class="entry_type_name">rational</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10121 <span class="entry_type_container">x</span>
10122
10123 <span class="entry_type_array">
10124 9
10125 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10126 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10127 <div class="entry_type_notes">3x3 matrix in row-major-order</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10128
10129
10130 </td> <!-- entry_type -->
10131
10132 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10133 <p>Used by DNG for better WB
10134adaptation</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10135 </td>
10136
10137 <td class="entry_units">
10138 </td>
10139
10140 <td class="entry_range">
10141 </td>
10142
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10143 <td class="entry_tags">
10144 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]10145 <li><a href="#tag_DNG">DNG</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10146 </ul>
10147 </td>
10148
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10149 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10150
10151
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10152 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10153 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10154
10155
10156 <tr class="entry" id="static_android.sensor.maxAnalogSensitivity">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10157 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10158 android.<wbr/>sensor.<wbr/>max<wbr/>Analog<wbr/>Sensitivity
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10159 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10160 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10161 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10162
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10163 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10164
10165
10166 </td> <!-- entry_type -->
10167
10168 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10169 <p>Maximum sensitivity that is implemented
10170purely through analog gain</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10171 </td>
10172
10173 <td class="entry_units">
10174 </td>
10175
10176 <td class="entry_range">
10177 </td>
10178
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10179 <td class="entry_tags">
10180 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]10181 <li><a href="#tag_V1">V1</a></li>
Alex Rayef40ad62013-10-01 17:52:33 -0700[diff] [blame]10182 <li><a href="#tag_FULL">FULL</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10183 </ul>
10184 </td>
10185
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10186 </tr>
10187 <tr class="entries_header">
10188 <th class="th_details" colspan="5">Details</th>
10189 </tr>
10190 <tr class="entry_cont">
10191 <td class="entry_details" colspan="5">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]10192 <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]10193equal to this,<wbr/> all applied gain must be analog.<wbr/> For
10194values above this,<wbr/> it can be a mix of analog and
10195digital</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10196 </td>
10197 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10198
10199
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10200 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10201 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10202
10203
10204 <tr class="entry" id="static_android.sensor.noiseModelCoefficients">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10205 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10206 android.<wbr/>sensor.<wbr/>noise<wbr/>Model<wbr/>Coefficients
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10207 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10208 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10209 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10210 <span class="entry_type_container">x</span>
10211
10212 <span class="entry_type_array">
10213 2
10214 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10215 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10216 <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]10217
10218
10219 </td> <!-- entry_type -->
10220
10221 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10222 <p>Estimation of sensor noise
10223characteristics</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10224 </td>
10225
10226 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10227 var(raw pixel value) = electrons * (baseGainFactor
10228 * iso/<wbr/>100)^2 + A * (baseGainFactor * iso/<wbr/>100)^2 +
10229 B
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10230 </td>
10231
10232 <td class="entry_range">
10233 </td>
10234
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10235 <td class="entry_tags">
10236 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]10237 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10238 </ul>
10239 </td>
10240
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10241 </tr>
10242 <tr class="entries_header">
10243 <th class="th_details" colspan="5">Details</th>
10244 </tr>
10245 <tr class="entry_cont">
10246 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10247 <p>A represents sensor read noise before analog
10248amplification; B represents noise from A/<wbr/>D conversion and
10249other circuits after amplification.<wbr/> Both noise sources
10250are assumed to be gaussian,<wbr/> independent,<wbr/> and not to vary
10251across the sensor</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10252 </td>
10253 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10254
10255
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10256 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10257 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10258
10259
10260 <tr class="entry" id="static_android.sensor.orientation">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10261 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10262 android.<wbr/>sensor.<wbr/>orientation
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10263 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10264 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10265 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10266
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10267 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10268
10269
10270 </td> <!-- entry_type -->
10271
10272 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10273 <p>Clockwise angle through which the output
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]10274image needs to be rotated to be upright on the device
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10275screen in its native orientation.<wbr/> Also defines the
10276direction of rolling shutter readout,<wbr/> which is from top
10277to bottom in the sensor's coordinate system</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10278 </td>
10279
10280 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10281 degrees clockwise rotation,<wbr/> only multiples of
10282 90
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10283 </td>
10284
10285 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]10286 <p>0,<wbr/>90,<wbr/>180,<wbr/>270</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10287 </td>
10288
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10289 <td class="entry_tags">
10290 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]10291 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10292 </ul>
10293 </td>
10294
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10295 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10296
10297
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10298 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10299 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10300
10301
10302 <tr class="entry" id="static_android.sensor.referenceIlluminant1">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10303 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10304 android.<wbr/>sensor.<wbr/>reference<wbr/>Illuminant1
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10305 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10306 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10307 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10308
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10309 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10310
10311 <ul class="entry_type_enum">
10312 <li>
10313 <span class="entry_type_enum_name">DAYLIGHT</span>
10314 <span class="entry_type_enum_value">1</span>
10315 </li>
10316 <li>
10317 <span class="entry_type_enum_name">FLUORESCENT</span>
10318 <span class="entry_type_enum_value">2</span>
10319 </li>
10320 <li>
10321 <span class="entry_type_enum_name">TUNGSTEN</span>
10322 <span class="entry_type_enum_value">3</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]10323 <span class="entry_type_enum_notes"><p>Incandescent light</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10324 </li>
10325 <li>
10326 <span class="entry_type_enum_name">FLASH</span>
10327 <span class="entry_type_enum_value">4</span>
10328 </li>
10329 <li>
10330 <span class="entry_type_enum_name">FINE_WEATHER</span>
10331 <span class="entry_type_enum_value">9</span>
10332 </li>
10333 <li>
10334 <span class="entry_type_enum_name">CLOUDY_WEATHER</span>
10335 <span class="entry_type_enum_value">10</span>
10336 </li>
10337 <li>
10338 <span class="entry_type_enum_name">SHADE</span>
10339 <span class="entry_type_enum_value">11</span>
10340 </li>
10341 <li>
10342 <span class="entry_type_enum_name">DAYLIGHT_FLUORESCENT</span>
10343 <span class="entry_type_enum_value">12</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]10344 <span class="entry_type_enum_notes"><p>D 5700 - 7100K</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10345 </li>
10346 <li>
10347 <span class="entry_type_enum_name">DAY_WHITE_FLUORESCENT</span>
10348 <span class="entry_type_enum_value">13</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]10349 <span class="entry_type_enum_notes"><p>N 4600 - 5400K</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10350 </li>
10351 <li>
10352 <span class="entry_type_enum_name">COOL_WHITE_FLUORESCENT</span>
10353 <span class="entry_type_enum_value">14</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]10354 <span class="entry_type_enum_notes"><p>W 3900 - 4500K</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10355 </li>
10356 <li>
10357 <span class="entry_type_enum_name">WHITE_FLUORESCENT</span>
10358 <span class="entry_type_enum_value">15</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]10359 <span class="entry_type_enum_notes"><p>WW 3200 - 3700K</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10360 </li>
10361 <li>
10362 <span class="entry_type_enum_name">STANDARD_A</span>
10363 <span class="entry_type_enum_value">17</span>
10364 </li>
10365 <li>
10366 <span class="entry_type_enum_name">STANDARD_B</span>
10367 <span class="entry_type_enum_value">18</span>
10368 </li>
10369 <li>
10370 <span class="entry_type_enum_name">STANDARD_C</span>
10371 <span class="entry_type_enum_value">19</span>
10372 </li>
10373 <li>
10374 <span class="entry_type_enum_name">D55</span>
10375 <span class="entry_type_enum_value">20</span>
10376 </li>
10377 <li>
10378 <span class="entry_type_enum_name">D65</span>
10379 <span class="entry_type_enum_value">21</span>
10380 </li>
10381 <li>
10382 <span class="entry_type_enum_name">D75</span>
10383 <span class="entry_type_enum_value">22</span>
10384 </li>
10385 <li>
10386 <span class="entry_type_enum_name">D50</span>
10387 <span class="entry_type_enum_value">23</span>
10388 </li>
10389 <li>
10390 <span class="entry_type_enum_name">ISO_STUDIO_TUNGSTEN</span>
10391 <span class="entry_type_enum_value">24</span>
10392 </li>
10393 </ul>
10394
10395 </td> <!-- entry_type -->
10396
10397 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10398 <p>Light source used to define transform
103991</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10400 </td>
10401
10402 <td class="entry_units">
10403 </td>
10404
10405 <td class="entry_range">
10406 </td>
10407
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10408 <td class="entry_tags">
10409 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]10410 <li><a href="#tag_DNG">DNG</a></li>
10411 <li><a href="#tag_EXIF">EXIF</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10412 </ul>
10413 </td>
10414
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10415 </tr>
10416 <tr class="entries_header">
10417 <th class="th_details" colspan="5">Details</th>
10418 </tr>
10419 <tr class="entry_cont">
10420 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10421 <p>[EXIF LightSource tag] Must all these be
10422supported? Need CCT for each!</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10423 </td>
10424 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10425
10426
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10427 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10428 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10429
10430
10431 <tr class="entry" id="static_android.sensor.referenceIlluminant2">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10432 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10433 android.<wbr/>sensor.<wbr/>reference<wbr/>Illuminant2
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10434 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10435 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10436 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10437
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10438 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10439
10440
10441 </td> <!-- entry_type -->
10442
10443 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10444 <p>Light source used to define transform
104452</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10446 </td>
10447
10448 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10449 Same as illuminant 1
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10450 </td>
10451
10452 <td class="entry_range">
10453 </td>
10454
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10455 <td class="entry_tags">
10456 </td>
10457
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10458 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10459
10460
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10461 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10462 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10463
10464
10465
10466 <!-- end of kind -->
10467 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10468 <tr><td colspan="6" class="kind">dynamic</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10469
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10470 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10471 <tr>
10472 <th class="th_name">Property Name</th>
10473 <th class="th_type">Type</th>
10474 <th class="th_description">Description</th>
10475 <th class="th_units">Units</th>
10476 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10477 <th class="th_tags">Tags</th>
10478 </tr>
10479 </thead>
10480
10481 <tbody>
10482
10483
10484
10485
10486
10487
10488
10489
10490
10491
10492 <tr class="entry" id="dynamic_android.sensor.exposureTime">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10493 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10494 android.<wbr/>sensor.<wbr/>exposure<wbr/>Time
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10495 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10496 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10497 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10498
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10499 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10500
10501
10502 </td> <!-- entry_type -->
10503
10504 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10505 <p>Duration each pixel is exposed to
10506light.<wbr/></p>
10507<p>If the sensor can't expose this exact duration,<wbr/> it should shorten the
10508duration exposed to the nearest possible value (rather than expose longer).<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10509 </td>
10510
10511 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10512 nanoseconds
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10513 </td>
10514
10515 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]10516 <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]10517 </td>
10518
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10519 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]10520 <ul class="entry_tags">
10521 <li><a href="#tag_V1">V1</a></li>
10522 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10523 </td>
10524
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10525 </tr>
10526 <tr class="entries_header">
10527 <th class="th_details" colspan="5">Details</th>
10528 </tr>
10529 <tr class="entry_cont">
10530 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10531 <p>1/<wbr/>10000 - 30 sec range.<wbr/> No bulb mode</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10532 </td>
10533 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10534
10535
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10536 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10537 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10538
10539
10540 <tr class="entry" id="dynamic_android.sensor.frameDuration">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10541 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10542 android.<wbr/>sensor.<wbr/>frame<wbr/>Duration
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10543 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10544 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10545 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10546
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10547 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10548
10549
10550 </td> <!-- entry_type -->
10551
10552 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10553 <p>Duration from start of frame exposure to
10554start of next frame exposure</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10555 </td>
10556
10557 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10558 nanoseconds
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10559 </td>
10560
10561 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]10562 <p>see <a href="#static_android.sensor.info.maxFrameDuration">android.<wbr/>sensor.<wbr/>info.<wbr/>max<wbr/>Frame<wbr/>Duration</a>,<wbr/>
10563android.<wbr/>scaler.<wbr/>info.<wbr/>available<wbr/>Min<wbr/>Frame<wbr/>Durations</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10564 </td>
10565
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10566 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]10567 <ul class="entry_tags">
10568 <li><a href="#tag_V1">V1</a></li>
10569 <li><a href="#tag_BC">BC</a></li>
10570 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10571 </td>
10572
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10573 </tr>
10574 <tr class="entries_header">
10575 <th class="th_details" colspan="5">Details</th>
10576 </tr>
10577 <tr class="entry_cont">
10578 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10579 <p>Exposure time has priority,<wbr/> so duration is set to
10580max(duration,<wbr/> exposure time + overhead)</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10581 </td>
10582 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10583
10584
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10585 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10586 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10587
10588
10589 <tr class="entry" id="dynamic_android.sensor.sensitivity">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10590 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10591 android.<wbr/>sensor.<wbr/>sensitivity
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10592 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10593 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10594 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10595
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10596 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10597
10598
10599 </td> <!-- entry_type -->
10600
10601 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10602 <p>Gain applied to image data.<wbr/> Must be
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]10603implemented through analog gain only if set to values
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10604below 'maximum analog sensitivity'.<wbr/></p>
10605<p>If the sensor can't apply this exact gain,<wbr/> it should lessen the
10606gain to the nearest possible value (rather than gain more).<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10607 </td>
10608
10609 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10610 ISO arithmetic units
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10611 </td>
10612
10613 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]10614 <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]10615 </td>
10616
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10617 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]10618 <ul class="entry_tags">
10619 <li><a href="#tag_V1">V1</a></li>
10620 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10621 </td>
10622
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10623 </tr>
10624 <tr class="entries_header">
10625 <th class="th_details" colspan="5">Details</th>
10626 </tr>
10627 <tr class="entry_cont">
10628 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10629 <p>ISO 12232:2006 REI method</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10630 </td>
10631 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10632
10633
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10634 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10635 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10636
10637
10638 <tr class="entry" id="dynamic_android.sensor.timestamp">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10639 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10640 android.<wbr/>sensor.<wbr/>timestamp
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10641 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10642 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10643 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10644
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10645 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10646
10647
10648 </td> <!-- entry_type -->
10649
10650 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10651 <p>Time at start of exposure of first
10652row</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10653 </td>
10654
10655 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10656 nanoseconds
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10657 </td>
10658
10659 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame]10660 <p>&gt; 0</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10661 </td>
10662
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10663 <td class="entry_tags">
10664 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]10665 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10666 </ul>
10667 </td>
10668
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10669 </tr>
10670 <tr class="entries_header">
10671 <th class="th_details" colspan="5">Details</th>
10672 </tr>
10673 <tr class="entry_cont">
10674 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10675 <p>Monotonic,<wbr/> should be synced to other timestamps in
10676system</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10677 </td>
10678 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10679
10680
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10681 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10682 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10683
Igor Murashkin656aa5a2013-08-13 14:23:39 -0700[diff] [blame]10684
10685 <tr class="entry" id="dynamic_android.sensor.temperature">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10686 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10687 android.<wbr/>sensor.<wbr/>temperature
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10688 </td>
Igor Murashkin656aa5a2013-08-13 14:23:39 -0700[diff] [blame]10689 <td class="entry_type">
10690 <span class="entry_type_name">float</span>
10691
10692 <span class="entry_type_visibility"> [public]</span>
10693
10694
10695 </td> <!-- entry_type -->
10696
10697 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10698 <p>The temperature of the sensor,<wbr/> sampled at the time
10699exposure began for this frame.<wbr/></p>
10700<p>The thermal diode being queried should be inside the sensor PCB,<wbr/> or
10701somewhere close to it.<wbr/></p>
Igor Murashkin656aa5a2013-08-13 14:23:39 -0700[diff] [blame]10702 </td>
10703
10704 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10705 celsius
Igor Murashkin656aa5a2013-08-13 14:23:39 -0700[diff] [blame]10706 </td>
10707
10708 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]10709 <p>Optional.<wbr/> This value is missing if no temperature is available.<wbr/></p>
Igor Murashkin656aa5a2013-08-13 14:23:39 -0700[diff] [blame]10710 </td>
10711
Igor Murashkin656aa5a2013-08-13 14:23:39 -0700[diff] [blame]10712 <td class="entry_tags">
Alex Rayef40ad62013-10-01 17:52:33 -0700[diff] [blame]10713 <ul class="entry_tags">
10714 <li><a href="#tag_FULL">FULL</a></li>
10715 </ul>
Igor Murashkin656aa5a2013-08-13 14:23:39 -0700[diff] [blame]10716 </td>
10717
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10718 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10719
10720
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10721 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10722 <!-- end of entry -->
Igor Murashkin656aa5a2013-08-13 14:23:39 -0700[diff] [blame]10723
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10724
10725
10726 <!-- end of kind -->
10727 </tbody>
10728
10729 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10730 <tr><td colspan="6" id="section_shading" class="section">shading</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10731
10732
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10733 <tr><td colspan="6" class="kind">controls</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10734
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10735 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10736 <tr>
10737 <th class="th_name">Property Name</th>
10738 <th class="th_type">Type</th>
10739 <th class="th_description">Description</th>
10740 <th class="th_units">Units</th>
10741 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10742 <th class="th_tags">Tags</th>
10743 </tr>
10744 </thead>
10745
10746 <tbody>
10747
10748
10749
10750
10751
10752
10753
10754
10755
10756
10757 <tr class="entry" id="controls_android.shading.mode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10758 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10759 android.<wbr/>shading.<wbr/>mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10760 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10761 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10762 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10763
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10764 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10765
10766 <ul class="entry_type_enum">
10767 <li>
10768 <span class="entry_type_enum_name">OFF</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]10769 <span class="entry_type_enum_notes"><p>No shading correction is applied</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10770 </li>
10771 <li>
10772 <span class="entry_type_enum_name">FAST</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]10773 <span class="entry_type_enum_notes"><p>Must not slow down frame rate relative to raw
10774bayer output</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10775 </li>
10776 <li>
10777 <span class="entry_type_enum_name">HIGH_QUALITY</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]10778 <span class="entry_type_enum_notes"><p>Frame rate may be reduced by high
10779quality</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10780 </li>
10781 </ul>
10782
10783 </td> <!-- entry_type -->
10784
10785 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10786 <p>Quality of lens shading correction applied
10787to the image data</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10788 </td>
10789
10790 <td class="entry_units">
10791 </td>
10792
10793 <td class="entry_range">
10794 </td>
10795
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10796 <td class="entry_tags">
10797 </td>
10798
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10799 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10800
10801
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10802 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10803 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10804
10805
10806 <tr class="entry" id="controls_android.shading.strength">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10807 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10808 android.<wbr/>shading.<wbr/>strength
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10809 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10810 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10811 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10812
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10813 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10814
10815
10816 </td> <!-- entry_type -->
10817
10818 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10819 <p>Control the amount of shading correction
10820applied to the images</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10821 </td>
10822
10823 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10824 unitless: 1-10; 10 is full shading
10825 compensation
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10826 </td>
10827
10828 <td class="entry_range">
10829 </td>
10830
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10831 <td class="entry_tags">
10832 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]10833 <li><a href="#tag_ADV">ADV</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10834 </ul>
10835 </td>
10836
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10837 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10838
10839
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10840 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10841 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10842
10843
10844
10845 <!-- end of kind -->
10846 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10847 <tr><td colspan="6" class="kind">dynamic</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10848
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10849 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10850 <tr>
10851 <th class="th_name">Property Name</th>
10852 <th class="th_type">Type</th>
10853 <th class="th_description">Description</th>
10854 <th class="th_units">Units</th>
10855 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10856 <th class="th_tags">Tags</th>
10857 </tr>
10858 </thead>
10859
10860 <tbody>
10861
10862
10863
10864
10865
10866
10867
10868
10869
10870
10871 <tr class="entry" id="dynamic_android.shading.mode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10872 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10873 android.<wbr/>shading.<wbr/>mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10874 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10875 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10876 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10877
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10878 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10879
10880 <ul class="entry_type_enum">
10881 <li>
10882 <span class="entry_type_enum_name">OFF</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]10883 <span class="entry_type_enum_notes"><p>No shading correction is applied</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10884 </li>
10885 <li>
10886 <span class="entry_type_enum_name">FAST</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]10887 <span class="entry_type_enum_notes"><p>Must not slow down frame rate relative to raw
10888bayer output</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10889 </li>
10890 <li>
10891 <span class="entry_type_enum_name">HIGH_QUALITY</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]10892 <span class="entry_type_enum_notes"><p>Frame rate may be reduced by high
10893quality</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10894 </li>
10895 </ul>
10896
10897 </td> <!-- entry_type -->
10898
10899 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10900 <p>Quality of lens shading correction applied
10901to the image data</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10902 </td>
10903
10904 <td class="entry_units">
10905 </td>
10906
10907 <td class="entry_range">
10908 </td>
10909
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10910 <td class="entry_tags">
10911 </td>
10912
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10913 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10914
10915
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10916 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10917 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10918
10919
10920
10921 <!-- end of kind -->
10922 </tbody>
10923
10924 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10925 <tr><td colspan="6" id="section_statistics" class="section">statistics</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10926
10927
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10928 <tr><td colspan="6" class="kind">controls</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10929
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10930 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10931 <tr>
10932 <th class="th_name">Property Name</th>
10933 <th class="th_type">Type</th>
10934 <th class="th_description">Description</th>
10935 <th class="th_units">Units</th>
10936 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10937 <th class="th_tags">Tags</th>
10938 </tr>
10939 </thead>
10940
10941 <tbody>
10942
10943
10944
10945
10946
10947
10948
10949
10950
10951
10952 <tr class="entry" id="controls_android.statistics.faceDetectMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10953 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10954 android.<wbr/>statistics.<wbr/>face<wbr/>Detect<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10955 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10956 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10957 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10958
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10959 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10960
10961 <ul class="entry_type_enum">
10962 <li>
10963 <span class="entry_type_enum_name">OFF</span>
10964 </li>
10965 <li>
10966 <span class="entry_type_enum_name">SIMPLE</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]10967 <span class="entry_type_enum_notes"><p>Optional Return rectangle and confidence
10968only</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10969 </li>
10970 <li>
10971 <span class="entry_type_enum_name">FULL</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]10972 <span class="entry_type_enum_notes"><p>Optional Return all face
10973metadata</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10974 </li>
10975 </ul>
10976
10977 </td> <!-- entry_type -->
10978
10979 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10980 <p>State of the face detector
10981unit</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10982 </td>
10983
10984 <td class="entry_units">
10985 </td>
10986
10987 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]10988 <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]10989 </td>
10990
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10991 <td class="entry_tags">
10992 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]10993 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10994 </ul>
10995 </td>
10996
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10997 </tr>
10998 <tr class="entries_header">
10999 <th class="th_details" colspan="5">Details</th>
11000 </tr>
11001 <tr class="entry_cont">
11002 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11003 <p>Whether face detection is enabled,<wbr/> and whether it
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11004should output just the basic fields or the full set of
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11005fields.<wbr/> Value must be one of the
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]11006<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]11007 </td>
11008 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11009
11010
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11011 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11012 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11013
11014
11015 <tr class="entry" id="controls_android.statistics.histogramMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11016 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11017 android.<wbr/>statistics.<wbr/>histogram<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11018 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11019 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]11020 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11021
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]11022 <span class="entry_type_visibility"> [system as boolean]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11023
11024 <ul class="entry_type_enum">
11025 <li>
11026 <span class="entry_type_enum_name">OFF</span>
11027 </li>
11028 <li>
11029 <span class="entry_type_enum_name">ON</span>
11030 </li>
11031 </ul>
11032
11033 </td> <!-- entry_type -->
11034
11035 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11036 <p>Operating mode for histogram
11037generation</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11038 </td>
11039
11040 <td class="entry_units">
11041 </td>
11042
11043 <td class="entry_range">
11044 </td>
11045
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11046 <td class="entry_tags">
11047 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]11048 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11049 </ul>
11050 </td>
11051
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11052 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11053
11054
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11055 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11056 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11057
11058
11059 <tr class="entry" id="controls_android.statistics.sharpnessMapMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11060 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11061 android.<wbr/>statistics.<wbr/>sharpness<wbr/>Map<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11062 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11063 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]11064 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11065
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]11066 <span class="entry_type_visibility"> [system as boolean]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11067
11068 <ul class="entry_type_enum">
11069 <li>
11070 <span class="entry_type_enum_name">OFF</span>
11071 </li>
11072 <li>
11073 <span class="entry_type_enum_name">ON</span>
11074 </li>
11075 </ul>
11076
11077 </td> <!-- entry_type -->
11078
11079 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11080 <p>Operating mode for sharpness map
11081generation</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11082 </td>
11083
11084 <td class="entry_units">
11085 </td>
11086
11087 <td class="entry_range">
11088 </td>
11089
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11090 <td class="entry_tags">
11091 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]11092 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11093 </ul>
11094 </td>
11095
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11096 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11097
11098
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11099 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11100 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11101
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]11102
11103 <tr class="entry" id="controls_android.statistics.lensShadingMapMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11104 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11105 android.<wbr/>statistics.<wbr/>lens<wbr/>Shading<wbr/>Map<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11106 </td>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]11107 <td class="entry_type">
11108 <span class="entry_type_name entry_type_name_enum">byte</span>
11109
11110 <span class="entry_type_visibility"> [public]</span>
11111
11112 <ul class="entry_type_enum">
11113 <li>
11114 <span class="entry_type_enum_name">OFF</span>
11115 </li>
11116 <li>
11117 <span class="entry_type_enum_name">ON</span>
11118 </li>
11119 </ul>
11120
11121 </td> <!-- entry_type -->
11122
11123 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11124 <p>Whether the HAL needs to output the lens
11125shading map in output result metadata</p>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]11126 </td>
11127
11128 <td class="entry_units">
11129 </td>
11130
11131 <td class="entry_range">
11132 </td>
11133
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11134 <td class="entry_tags">
11135 </td>
11136
11137 </tr>
11138 <tr class="entries_header">
11139 <th class="th_details" colspan="5">Details</th>
11140 </tr>
11141 <tr class="entry_cont">
11142 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11143 <p>When set to ON,<wbr/>
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]11144<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]11145the output result metadata.<wbr/></p>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]11146 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11147 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11148
11149
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11150 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11151 <!-- end of entry -->
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]11152
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11153
11154
11155 <!-- end of kind -->
11156 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11157 <tr><td colspan="6" class="kind">static</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11158
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]11159 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11160 <tr>
11161 <th class="th_name">Property Name</th>
11162 <th class="th_type">Type</th>
11163 <th class="th_description">Description</th>
11164 <th class="th_units">Units</th>
11165 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11166 <th class="th_tags">Tags</th>
11167 </tr>
11168 </thead>
11169
11170 <tbody>
11171
11172
11173
11174
11175
11176
11177
11178
11179
11180
11181
11182
11183 <tr class="entry" id="static_android.statistics.info.availableFaceDetectModes">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11184 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11185 android.<wbr/>statistics.<wbr/>info.<wbr/>available<wbr/>Face<wbr/>Detect<wbr/>Modes
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11186 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11187 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]11188 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11189 <span class="entry_type_container">x</span>
11190
11191 <span class="entry_type_array">
11192 n
11193 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]11194 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11195 <div class="entry_type_notes">List of enums from android.<wbr/>statistics.<wbr/>face<wbr/>Detect<wbr/>Mode</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11196
11197
11198 </td> <!-- entry_type -->
11199
11200 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11201 <p>Which face detection modes are available,<wbr/>
11202if any</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11203 </td>
11204
11205 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11206 List of enum:
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]11207 OFF
11208 SIMPLE
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11209 FULL
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11210 </td>
11211
11212 <td class="entry_range">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11213 </td>
11214
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11215 <td class="entry_tags">
11216 </td>
11217
11218 </tr>
11219 <tr class="entries_header">
11220 <th class="th_details" colspan="5">Details</th>
11221 </tr>
11222 <tr class="entry_cont">
11223 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11224 <p>OFF means face detection is disabled,<wbr/> it must
11225be included in the list.<wbr/></p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]11226<p>SIMPLE means the device supports the
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]11227<a href="#dynamic_android.statistics.faceRectangles">android.<wbr/>statistics.<wbr/>face<wbr/>Rectangles</a> and
11228<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]11229<p>FULL means the device additionally supports the
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]11230<a href="#dynamic_android.statistics.faceIds">android.<wbr/>statistics.<wbr/>face<wbr/>Ids</a> and
11231<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]11232 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11233 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11234
11235
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11236 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11237 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11238
11239
11240 <tr class="entry" id="static_android.statistics.info.histogramBucketCount">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11241 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11242 android.<wbr/>statistics.<wbr/>info.<wbr/>histogram<wbr/>Bucket<wbr/>Count
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11243 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11244 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]11245 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11246
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]11247 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11248
11249
11250 </td> <!-- entry_type -->
11251
11252 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11253 <p>Number of histogram buckets
11254supported</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11255 </td>
11256
11257 <td class="entry_units">
11258 </td>
11259
11260 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame]11261 <p>&gt;= 64</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11262 </td>
11263
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11264 <td class="entry_tags">
11265 </td>
11266
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11267 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11268
11269
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11270 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11271 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11272
11273
11274 <tr class="entry" id="static_android.statistics.info.maxFaceCount">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11275 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11276 android.<wbr/>statistics.<wbr/>info.<wbr/>max<wbr/>Face<wbr/>Count
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11277 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11278 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]11279 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11280
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]11281 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11282
11283
11284 </td> <!-- entry_type -->
11285
11286 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11287 <p>Maximum number of simultaneously detectable
11288faces</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11289 </td>
11290
11291 <td class="entry_units">
11292 </td>
11293
11294 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame]11295 <p>&gt;= 4 if availableFaceDetectionModes lists
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]11296modes besides OFF,<wbr/> otherwise 0</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11297 </td>
11298
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11299 <td class="entry_tags">
11300 </td>
11301
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11302 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11303
11304
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11305 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11306 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11307
11308
11309 <tr class="entry" id="static_android.statistics.info.maxHistogramCount">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11310 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11311 android.<wbr/>statistics.<wbr/>info.<wbr/>max<wbr/>Histogram<wbr/>Count
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11312 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11313 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]11314 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11315
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]11316 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11317
11318
11319 </td> <!-- entry_type -->
11320
11321 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11322 <p>Maximum value possible for a histogram
11323bucket</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11324 </td>
11325
11326 <td class="entry_units">
11327 </td>
11328
11329 <td class="entry_range">
11330 </td>
11331
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11332 <td class="entry_tags">
11333 </td>
11334
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11335 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11336
11337
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11338 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11339 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11340
11341
11342 <tr class="entry" id="static_android.statistics.info.maxSharpnessMapValue">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11343 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11344 android.<wbr/>statistics.<wbr/>info.<wbr/>max<wbr/>Sharpness<wbr/>Map<wbr/>Value
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11345 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11346 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]11347 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11348
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]11349 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11350
11351
11352 </td> <!-- entry_type -->
11353
11354 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11355 <p>Maximum value possible for a sharpness map
11356region.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11357 </td>
11358
11359 <td class="entry_units">
11360 </td>
11361
11362 <td class="entry_range">
11363 </td>
11364
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11365 <td class="entry_tags">
11366 </td>
11367
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11368 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11369
11370
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11371 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11372 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11373
11374
11375 <tr class="entry" id="static_android.statistics.info.sharpnessMapSize">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11376 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11377 android.<wbr/>statistics.<wbr/>info.<wbr/>sharpness<wbr/>Map<wbr/>Size
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11378 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11379 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]11380 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11381 <span class="entry_type_container">x</span>
11382
11383 <span class="entry_type_array">
11384 2
11385 </span>
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]11386 <span class="entry_type_visibility"> [system as size]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11387 <div class="entry_type_notes">width x height</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11388
11389
11390 </td> <!-- entry_type -->
11391
11392 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11393 <p>Dimensions of the sharpness
11394map</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11395 </td>
11396
11397 <td class="entry_units">
11398 </td>
11399
11400 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]11401 <p>Must be at least 32 x 32</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11402 </td>
11403
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11404 <td class="entry_tags">
11405 </td>
11406
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11407 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11408
11409
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11410 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11411 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11412
11413
11414
11415
11416
11417
11418 <!-- end of kind -->
11419 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11420 <tr><td colspan="6" class="kind">dynamic</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11421
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]11422 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11423 <tr>
11424 <th class="th_name">Property Name</th>
11425 <th class="th_type">Type</th>
11426 <th class="th_description">Description</th>
11427 <th class="th_units">Units</th>
11428 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11429 <th class="th_tags">Tags</th>
11430 </tr>
11431 </thead>
11432
11433 <tbody>
11434
11435
11436
11437
11438
11439
11440
11441
11442
11443
11444 <tr class="entry" id="dynamic_android.statistics.faceDetectMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11445 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11446 android.<wbr/>statistics.<wbr/>face<wbr/>Detect<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11447 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11448 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]11449 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11450
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]11451 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11452
11453 <ul class="entry_type_enum">
11454 <li>
11455 <span class="entry_type_enum_name">OFF</span>
11456 </li>
11457 <li>
11458 <span class="entry_type_enum_name">SIMPLE</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]11459 <span class="entry_type_enum_notes"><p>Optional Return rectangle and confidence
11460only</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11461 </li>
11462 <li>
11463 <span class="entry_type_enum_name">FULL</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]11464 <span class="entry_type_enum_notes"><p>Optional Return all face
11465metadata</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11466 </li>
11467 </ul>
11468
11469 </td> <!-- entry_type -->
11470
11471 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11472 <p>State of the face detector
11473unit</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11474 </td>
11475
11476 <td class="entry_units">
11477 </td>
11478
11479 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]11480 <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]11481 </td>
11482
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11483 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]11484 <ul class="entry_tags">
11485 <li><a href="#tag_BC">BC</a></li>
11486 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11487 </td>
11488
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11489 </tr>
11490 <tr class="entries_header">
11491 <th class="th_details" colspan="5">Details</th>
11492 </tr>
11493 <tr class="entry_cont">
11494 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11495 <p>Whether face detection is enabled,<wbr/> and whether it
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11496should output just the basic fields or the full set of
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11497fields.<wbr/> Value must be one of the
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]11498<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]11499 </td>
11500 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11501
11502
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11503 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11504 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11505
11506
11507 <tr class="entry" id="dynamic_android.statistics.faceIds">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11508 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11509 android.<wbr/>statistics.<wbr/>face<wbr/>Ids
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11510 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11511 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]11512 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11513 <span class="entry_type_container">x</span>
11514
11515 <span class="entry_type_array">
11516 n
11517 </span>
Zhijun He3b4c2062013-10-07 11:23:30 -0700[diff] [blame]11518 <span class="entry_type_visibility"> [hidden]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11519
11520
11521 </td> <!-- entry_type -->
11522
11523 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11524 <p>List of unique IDs for detected
11525faces</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11526 </td>
11527
11528 <td class="entry_units">
11529 </td>
11530
11531 <td class="entry_range">
11532 </td>
11533
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11534 <td class="entry_tags">
11535 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]11536 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11537 </ul>
11538 </td>
11539
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11540 </tr>
11541 <tr class="entries_header">
11542 <th class="th_details" colspan="5">Details</th>
11543 </tr>
11544 <tr class="entry_cont">
11545 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11546 <p>Only available if faceDetectMode == FULL</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11547 </td>
11548 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11549
11550
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11551 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11552 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11553
11554
11555 <tr class="entry" id="dynamic_android.statistics.faceLandmarks">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11556 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11557 android.<wbr/>statistics.<wbr/>face<wbr/>Landmarks
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11558 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11559 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]11560 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11561 <span class="entry_type_container">x</span>
11562
11563 <span class="entry_type_array">
11564 n x 6
11565 </span>
Zhijun He3b4c2062013-10-07 11:23:30 -0700[diff] [blame]11566 <span class="entry_type_visibility"> [hidden]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11567 <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]11568
11569
11570 </td> <!-- entry_type -->
11571
11572 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11573 <p>List of landmarks for detected
11574faces</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11575 </td>
11576
11577 <td class="entry_units">
11578 </td>
11579
11580 <td class="entry_range">
11581 </td>
11582
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11583 <td class="entry_tags">
11584 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]11585 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11586 </ul>
11587 </td>
11588
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11589 </tr>
11590 <tr class="entries_header">
11591 <th class="th_details" colspan="5">Details</th>
11592 </tr>
11593 <tr class="entry_cont">
11594 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11595 <p>Only available if faceDetectMode == FULL</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11596 </td>
11597 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11598
11599
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11600 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11601 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11602
11603
11604 <tr class="entry" id="dynamic_android.statistics.faceRectangles">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11605 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11606 android.<wbr/>statistics.<wbr/>face<wbr/>Rectangles
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11607 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11608 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]11609 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11610 <span class="entry_type_container">x</span>
11611
11612 <span class="entry_type_array">
11613 n x 4
11614 </span>
Zhijun He3b4c2062013-10-07 11:23:30 -0700[diff] [blame]11615 <span class="entry_type_visibility"> [hidden as rectangle]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11616 <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]11617
11618
11619 </td> <!-- entry_type -->
11620
11621 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11622 <p>List of the bounding rectangles for detected
11623faces</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11624 </td>
11625
11626 <td class="entry_units">
11627 </td>
11628
11629 <td class="entry_range">
11630 </td>
11631
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11632 <td class="entry_tags">
11633 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]11634 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11635 </ul>
11636 </td>
11637
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11638 </tr>
11639 <tr class="entries_header">
11640 <th class="th_details" colspan="5">Details</th>
11641 </tr>
11642 <tr class="entry_cont">
11643 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11644 <p>Only available if faceDetectMode != OFF</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11645 </td>
11646 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11647
11648
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11649 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11650 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11651
11652
11653 <tr class="entry" id="dynamic_android.statistics.faceScores">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11654 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11655 android.<wbr/>statistics.<wbr/>face<wbr/>Scores
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11656 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11657 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]11658 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11659 <span class="entry_type_container">x</span>
11660
11661 <span class="entry_type_array">
11662 n
11663 </span>
Zhijun He3b4c2062013-10-07 11:23:30 -0700[diff] [blame]11664 <span class="entry_type_visibility"> [hidden]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11665
11666
11667 </td> <!-- entry_type -->
11668
11669 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11670 <p>List of the face confidence scores for
11671detected faces</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11672 </td>
11673
11674 <td class="entry_units">
11675 </td>
11676
11677 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]11678 <p>1-100</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11679 </td>
11680
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11681 <td class="entry_tags">
11682 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]11683 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11684 </ul>
11685 </td>
11686
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11687 </tr>
11688 <tr class="entries_header">
11689 <th class="th_details" colspan="5">Details</th>
11690 </tr>
11691 <tr class="entry_cont">
11692 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11693 <p>Only available if faceDetectMode != OFF.<wbr/> The value should be
11694meaningful (for example,<wbr/> setting 100 at all times is illegal).<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11695 </td>
11696 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11697
11698
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11699 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11700 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11701
11702
11703 <tr class="entry" id="dynamic_android.statistics.histogram">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11704 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11705 android.<wbr/>statistics.<wbr/>histogram
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11706 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11707 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]11708 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11709 <span class="entry_type_container">x</span>
11710
11711 <span class="entry_type_array">
11712 n x 3
11713 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]11714 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11715 <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]11716
11717
11718 </td> <!-- entry_type -->
11719
11720 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11721 <p>A 3-channel histogram based on the raw
11722sensor data</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11723 </td>
11724
11725 <td class="entry_units">
11726 </td>
11727
11728 <td class="entry_range">
11729 </td>
11730
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11731 <td class="entry_tags">
11732 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]11733 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11734 </ul>
11735 </td>
11736
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11737 </tr>
11738 <tr class="entries_header">
11739 <th class="th_details" colspan="5">Details</th>
11740 </tr>
11741 <tr class="entry_cont">
11742 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11743 <p>The k'th bucket (0-based) covers the input range
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]11744(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]11745(k + 1) * w /<wbr/> N ).<wbr/> If only a monochrome sharpness map is
11746supported,<wbr/> all channels should have the same data</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11747 </td>
11748 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11749
11750
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11751 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11752 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11753
11754
11755 <tr class="entry" id="dynamic_android.statistics.histogramMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11756 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11757 android.<wbr/>statistics.<wbr/>histogram<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11758 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11759 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]11760 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11761
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]11762 <span class="entry_type_visibility"> [system as boolean]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11763
11764 <ul class="entry_type_enum">
11765 <li>
11766 <span class="entry_type_enum_name">OFF</span>
11767 </li>
11768 <li>
11769 <span class="entry_type_enum_name">ON</span>
11770 </li>
11771 </ul>
11772
11773 </td> <!-- entry_type -->
11774
11775 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11776 <p>Operating mode for histogram
11777generation</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11778 </td>
11779
11780 <td class="entry_units">
11781 </td>
11782
11783 <td class="entry_range">
11784 </td>
11785
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11786 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]11787 <ul class="entry_tags">
11788 <li><a href="#tag_V1">V1</a></li>
11789 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11790 </td>
11791
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11792 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11793
11794
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11795 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11796 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11797
11798
11799 <tr class="entry" id="dynamic_android.statistics.sharpnessMap">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11800 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11801 android.<wbr/>statistics.<wbr/>sharpness<wbr/>Map
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11802 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11803 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]11804 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11805 <span class="entry_type_container">x</span>
11806
11807 <span class="entry_type_array">
11808 n x m x 3
11809 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]11810 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11811 <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]11812
11813
11814 </td> <!-- entry_type -->
11815
11816 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11817 <p>A 3-channel sharpness map,<wbr/> based on the raw
11818sensor data</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11819 </td>
11820
11821 <td class="entry_units">
11822 </td>
11823
11824 <td class="entry_range">
11825 </td>
11826
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11827 <td class="entry_tags">
11828 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]11829 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11830 </ul>
11831 </td>
11832
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11833 </tr>
11834 <tr class="entries_header">
11835 <th class="th_details" colspan="5">Details</th>
11836 </tr>
11837 <tr class="entry_cont">
11838 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11839 <p>If only a monochrome sharpness map is supported,<wbr/>
11840all channels should have the same data</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11841 </td>
11842 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11843
11844
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11845 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11846 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11847
11848
11849 <tr class="entry" id="dynamic_android.statistics.sharpnessMapMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11850 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11851 android.<wbr/>statistics.<wbr/>sharpness<wbr/>Map<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11852 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11853 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]11854 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11855
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]11856 <span class="entry_type_visibility"> [system as boolean]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11857
11858 <ul class="entry_type_enum">
11859 <li>
11860 <span class="entry_type_enum_name">OFF</span>
11861 </li>
11862 <li>
11863 <span class="entry_type_enum_name">ON</span>
11864 </li>
11865 </ul>
11866
11867 </td> <!-- entry_type -->
11868
11869 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11870 <p>Operating mode for sharpness map
11871generation</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11872 </td>
11873
11874 <td class="entry_units">
11875 </td>
11876
11877 <td class="entry_range">
11878 </td>
11879
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11880 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]11881 <ul class="entry_tags">
11882 <li><a href="#tag_V1">V1</a></li>
11883 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11884 </td>
11885
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11886 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11887
11888
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11889 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11890 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11891
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]11892
11893 <tr class="entry" id="dynamic_android.statistics.lensShadingMap">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11894 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11895 android.<wbr/>statistics.<wbr/>lens<wbr/>Shading<wbr/>Map
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11896 </td>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]11897 <td class="entry_type">
11898 <span class="entry_type_name">float</span>
11899 <span class="entry_type_container">x</span>
11900
11901 <span class="entry_type_array">
11902 4 x n x m
11903 </span>
11904 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11905 <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]11906
11907
11908 </td> <!-- entry_type -->
11909
11910 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11911 <p>The shading map is a low-resolution floating-point map
11912that lists the coefficients used to correct for vignetting,<wbr/> for each
11913Bayer color channel.<wbr/></p>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]11914 </td>
11915
11916 <td class="entry_units">
11917 </td>
11918
11919 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]11920 <p>Each gain factor is &gt;= 1</p>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]11921 </td>
11922
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11923 <td class="entry_tags">
11924 </td>
11925
11926 </tr>
11927 <tr class="entries_header">
11928 <th class="th_details" colspan="5">Details</th>
11929 </tr>
11930 <tr class="entry_cont">
11931 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11932 <p>The least shaded section of the image should have a gain factor
11933of 1; all other sections should have gains above 1.<wbr/></p>
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]11934<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]11935must take into account the colorCorrection settings.<wbr/></p>
11936<p>The shading map is for the entire active pixel array,<wbr/> and is not
11937affected by the crop region specified in the request.<wbr/> Each shading map
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]11938entry is the value of the shading compensation map over a specific
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11939pixel on the sensor.<wbr/> Specifically,<wbr/> with a (N x M) resolution shading
11940map,<wbr/> and an active pixel array size (W x H),<wbr/> shading map entry
11941(x,<wbr/>y) ϵ (0 ...<wbr/> N-1,<wbr/> 0 ...<wbr/> M-1) is the value of the shading map at
11942pixel ( ((W-1)/<wbr/>(N-1)) * x,<wbr/> ((H-1)/<wbr/>(M-1)) * y) for the four color channels.<wbr/>
11943The map is assumed to be bilinearly interpolated between the sample points.<wbr/></p>
11944<p>The channel order is [R,<wbr/> Geven,<wbr/> Godd,<wbr/> B],<wbr/> where Geven is the green
11945channel for the even rows of a Bayer pattern,<wbr/> and Godd is the odd rows.<wbr/>
11946The shading map is stored in a fully interleaved format,<wbr/> and its size
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]11947is 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]11948<p>The shading map should have on the order of 30-40 rows and columns,<wbr/>
11949and must be smaller than 64x64.<wbr/></p>
11950<p>As an example,<wbr/> given a very small map defined as:</p>
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]11951<pre><code><a href="#static_android.lens.info.shadingMapSize">android.<wbr/>lens.<wbr/>info.<wbr/>shading<wbr/>Map<wbr/>Size</a> = [ 4,<wbr/> 3 ]
11952<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]11953[ 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/>
11954 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/>
11955 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/>
11956 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/>
11957 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/>
11958 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]11959</code></pre>
11960<p>The low-resolution scaling map images for each channel are
11961(displayed using nearest-neighbor interpolation):</p>
11962<p><img alt="Red lens shading map" src="images/camera2/metadata/android.statistics.lensShadingMap/red_shading.png"/>
11963<img alt="Green (even rows) lens shading map" src="images/camera2/metadata/android.statistics.lensShadingMap/green_e_shading.png"/>
11964<img alt="Green (odd rows) lens shading map" src="images/camera2/metadata/android.statistics.lensShadingMap/green_o_shading.png"/>
11965<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]11966<p>As a visualization only,<wbr/> inverting the full-color map to recover an
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]11967image 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]11968<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]11969 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11970 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11971
11972
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11973 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11974 <!-- end of entry -->
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]11975
11976
11977 <tr class="entry" id="dynamic_android.statistics.predictedColorGains">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11978 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11979 android.<wbr/>statistics.<wbr/>predicted<wbr/>Color<wbr/>Gains
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11980 </td>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]11981 <td class="entry_type">
11982 <span class="entry_type_name">float</span>
11983 <span class="entry_type_container">x</span>
11984
11985 <span class="entry_type_array">
11986 4
11987 </span>
Igor Murashkin0fe2f132014-01-13 16:59:47 -0800[diff] [blame]11988 <span class="entry_type_visibility"> [hidden]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11989 <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]11990
11991
11992 </td> <!-- entry_type -->
11993
11994 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11995 <p>The best-fit color channel gains calculated
11996by the HAL's statistics units for the current output frame</p>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]11997 </td>
11998
11999 <td class="entry_units">
12000 </td>
12001
12002 <td class="entry_range">
Igor Murashkin0fe2f132014-01-13 16:59:47 -0800[diff] [blame]12003 <p><strong>Deprecated</strong>.<wbr/> Do not use.<wbr/></p>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]12004 </td>
12005
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12006 <td class="entry_tags">
12007 </td>
12008
12009 </tr>
12010 <tr class="entries_header">
12011 <th class="th_details" colspan="5">Details</th>
12012 </tr>
12013 <tr class="entry_cont">
12014 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12015 <p>This may be different than the gains used for this frame,<wbr/>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]12016since statistics processing on data from a new frame
12017typically completes after the transform has already been
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12018applied to that frame.<wbr/></p>
12019<p>The 4 channel gains are defined in Bayer domain,<wbr/>
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]12020see <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]12021<p>This value should always be calculated by the AWB block,<wbr/>
12022regardless of the android.<wbr/>control.<wbr/>* current values.<wbr/></p>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]12023 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12024 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12025
12026
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12027 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
12028 <!-- end of entry -->
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]12029
12030
12031 <tr class="entry" id="dynamic_android.statistics.predictedColorTransform">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12032 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12033 android.<wbr/>statistics.<wbr/>predicted<wbr/>Color<wbr/>Transform
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12034 </td>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]12035 <td class="entry_type">
12036 <span class="entry_type_name">rational</span>
12037 <span class="entry_type_container">x</span>
12038
12039 <span class="entry_type_array">
12040 3 x 3
12041 </span>
Igor Murashkin0fe2f132014-01-13 16:59:47 -0800[diff] [blame]12042 <span class="entry_type_visibility"> [hidden]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12043 <div class="entry_type_notes">3x3 rational matrix in row-major order</div>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]12044
12045
12046 </td> <!-- entry_type -->
12047
12048 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12049 <p>The best-fit color transform matrix estimate
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]12050calculated by the HAL's statistics units for the current
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12051output frame</p>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]12052 </td>
12053
12054 <td class="entry_units">
12055 </td>
12056
12057 <td class="entry_range">
Igor Murashkin0fe2f132014-01-13 16:59:47 -0800[diff] [blame]12058 <p><strong>Deprecated</strong>.<wbr/> Do not use.<wbr/></p>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]12059 </td>
12060
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12061 <td class="entry_tags">
12062 </td>
12063
12064 </tr>
12065 <tr class="entries_header">
12066 <th class="th_details" colspan="5">Details</th>
12067 </tr>
12068 <tr class="entry_cont">
12069 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12070 <p>The HAL must provide the estimate from its
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]12071statistics unit on the white balance transforms to use
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12072for the next frame.<wbr/> These are the values the HAL believes
12073are the best fit for the current output frame.<wbr/> This may
12074be different than the transform used for this frame,<wbr/> since
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]12075statistics processing on data from a new frame typically
12076completes after the transform has already been applied to
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12077that frame.<wbr/></p>
12078<p>These estimates must be provided for all frames,<wbr/> even if
12079capture settings and color transforms are set by the application.<wbr/></p>
12080<p>This value should always be calculated by the AWB block,<wbr/>
12081regardless of the android.<wbr/>control.<wbr/>* current values.<wbr/></p>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]12082 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12083 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12084
12085
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12086 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
12087 <!-- end of entry -->
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]12088
12089
12090 <tr class="entry" id="dynamic_android.statistics.sceneFlicker">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12091 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12092 android.<wbr/>statistics.<wbr/>scene<wbr/>Flicker
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12093 </td>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]12094 <td class="entry_type">
12095 <span class="entry_type_name entry_type_name_enum">byte</span>
12096
12097 <span class="entry_type_visibility"> [public]</span>
12098
12099 <ul class="entry_type_enum">
12100 <li>
12101 <span class="entry_type_enum_name">NONE</span>
12102 </li>
12103 <li>
12104 <span class="entry_type_enum_name">50HZ</span>
12105 </li>
12106 <li>
12107 <span class="entry_type_enum_name">60HZ</span>
12108 </li>
12109 </ul>
12110
12111 </td> <!-- entry_type -->
12112
12113 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12114 <p>The HAL estimated scene illumination lighting
12115frequency</p>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]12116 </td>
12117
12118 <td class="entry_units">
12119 </td>
12120
12121 <td class="entry_range">
12122 </td>
12123
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]12124 <td class="entry_tags">
12125 </td>
12126
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12127 </tr>
12128 <tr class="entries_header">
12129 <th class="th_details" colspan="5">Details</th>
12130 </tr>
12131 <tr class="entry_cont">
12132 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12133 <p>Report NONE if there doesn't appear to be flickering
12134illumination</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12135 </td>
12136 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12137
12138
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12139 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
12140 <!-- end of entry -->
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]12141
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12142
12143
12144 <!-- end of kind -->
12145 </tbody>
12146
12147 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12148 <tr><td colspan="6" id="section_tonemap" class="section">tonemap</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12149
12150
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12151 <tr><td colspan="6" class="kind">controls</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12152
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]12153 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12154 <tr>
12155 <th class="th_name">Property Name</th>
12156 <th class="th_type">Type</th>
12157 <th class="th_description">Description</th>
12158 <th class="th_units">Units</th>
12159 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12160 <th class="th_tags">Tags</th>
12161 </tr>
12162 </thead>
12163
12164 <tbody>
12165
12166
12167
12168
12169
12170
12171
12172
12173
12174
12175 <tr class="entry" id="controls_android.tonemap.curveBlue">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12176 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12177 android.<wbr/>tonemap.<wbr/>curve<wbr/>Blue
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12178 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12179 <td class="entry_type">
Eino-Ville Talvala76548fe2013-01-11 13:57:19 -0800[diff] [blame]12180 <span class="entry_type_name">float</span>
Zhijun He704d1282013-08-19 15:26:33 -0700[diff] [blame]12181 <span class="entry_type_container">x</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12182
Zhijun He704d1282013-08-19 15:26:33 -0700[diff] [blame]12183 <span class="entry_type_array">
12184 n x 2
12185 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]12186 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12187 <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]12188
12189
12190 </td> <!-- entry_type -->
12191
12192 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12193 <p>Table mapping blue input values to output
12194values</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12195 </td>
12196
12197 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12198 same as android.<wbr/>tonemap.<wbr/>curve<wbr/>Red
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12199 </td>
12200
12201 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]12202 <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]12203 </td>
12204
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12205 <td class="entry_tags">
12206 </td>
12207
12208 </tr>
12209 <tr class="entries_header">
12210 <th class="th_details" colspan="5">Details</th>
12211 </tr>
12212 <tr class="entry_cont">
12213 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12214 <p>Tonemapping /<wbr/> contrast /<wbr/> gamma curve for the blue
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]12215channel,<wbr/> to use when <a href="#controls_android.tonemap.mode">android.<wbr/>tonemap.<wbr/>mode</a> is CONTRAST_<wbr/>CURVE.<wbr/></p>
12216<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]12217 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12218 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12219
12220
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12221 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
12222 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12223
12224
12225 <tr class="entry" id="controls_android.tonemap.curveGreen">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12226 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12227 android.<wbr/>tonemap.<wbr/>curve<wbr/>Green
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12228 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12229 <td class="entry_type">
Eino-Ville Talvala76548fe2013-01-11 13:57:19 -0800[diff] [blame]12230 <span class="entry_type_name">float</span>
Zhijun He704d1282013-08-19 15:26:33 -0700[diff] [blame]12231 <span class="entry_type_container">x</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12232
Zhijun He704d1282013-08-19 15:26:33 -0700[diff] [blame]12233 <span class="entry_type_array">
12234 n x 2
12235 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]12236 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12237 <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]12238
12239
12240 </td> <!-- entry_type -->
12241
12242 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12243 <p>Table mapping green input values to output
12244values</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12245 </td>
12246
12247 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12248 same as android.<wbr/>tonemap.<wbr/>curve<wbr/>Red
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12249 </td>
12250
12251 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]12252 <p>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]12253 </td>
12254
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12255 <td class="entry_tags">
12256 </td>
12257
12258 </tr>
12259 <tr class="entries_header">
12260 <th class="th_details" colspan="5">Details</th>
12261 </tr>
12262 <tr class="entry_cont">
12263 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12264 <p>Tonemapping /<wbr/> contrast /<wbr/> gamma curve for the green
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]12265channel,<wbr/> to use when <a href="#controls_android.tonemap.mode">android.<wbr/>tonemap.<wbr/>mode</a> is CONTRAST_<wbr/>CURVE.<wbr/></p>
12266<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]12267 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12268 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12269
12270
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12271 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
12272 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12273
12274
12275 <tr class="entry" id="controls_android.tonemap.curveRed">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12276 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12277 android.<wbr/>tonemap.<wbr/>curve<wbr/>Red
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12278 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12279 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]12280 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12281 <span class="entry_type_container">x</span>
12282
12283 <span class="entry_type_array">
12284 n x 2
12285 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]12286 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12287 <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]12288
12289
12290 </td> <!-- entry_type -->
12291
12292 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12293 <p>Table mapping red input values to output
12294values</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12295 </td>
12296
12297 <td class="entry_units">
12298 </td>
12299
12300 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]12301 <p>0-1 on input and output coordinates.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12302 </td>
12303
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12304 <td class="entry_tags">
12305 <ul class="entry_tags">
12306 <li><a href="#tag_DNG">DNG</a></li>
12307 </ul>
12308 </td>
12309
12310 </tr>
12311 <tr class="entries_header">
12312 <th class="th_details" colspan="5">Details</th>
12313 </tr>
12314 <tr class="entry_cont">
12315 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12316 <p>Tonemapping /<wbr/> contrast /<wbr/> gamma curve for the red
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]12317channel,<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]12318<p>Since the input and output ranges may vary depending on
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12319the camera pipeline,<wbr/> the input and output pixel values
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]12320are represented by normalized floating-point values
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12321between 0 and 1,<wbr/> with 0 == black and 1 == white.<wbr/></p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]12322<p>The curve should be linearly interpolated between the
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12323defined points.<wbr/> The points will be listed in increasing
12324order of P_<wbr/>IN.<wbr/> For example,<wbr/> if the array is: [0.<wbr/>0,<wbr/> 0.<wbr/>0,<wbr/>
123250.<wbr/>3,<wbr/> 0.<wbr/>5,<wbr/> 1.<wbr/>0,<wbr/> 1.<wbr/>0],<wbr/> then the input-&gt;output mapping
12326for a few sample points would be: 0 -&gt; 0,<wbr/> 0.<wbr/>15 -&gt;
123270.<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]12328 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12329 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12330
12331
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12332 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
12333 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12334
12335
12336 <tr class="entry" id="controls_android.tonemap.mode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12337 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12338 android.<wbr/>tonemap.<wbr/>mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12339 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12340 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]12341 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12342
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]12343 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12344
12345 <ul class="entry_type_enum">
12346 <li>
12347 <span class="entry_type_enum_name">CONTRAST_CURVE</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]12348 <span class="entry_type_enum_notes"><p>Use the tone mapping curve specified in
12349android.<wbr/>tonemap.<wbr/>curve</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12350 </li>
12351 <li>
12352 <span class="entry_type_enum_name">FAST</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]12353 <span class="entry_type_enum_notes"><p>Must not slow down frame rate relative to raw
12354bayer output</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12355 </li>
12356 <li>
12357 <span class="entry_type_enum_name">HIGH_QUALITY</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]12358 <span class="entry_type_enum_notes"><p>Frame rate may be reduced by high
12359quality</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12360 </li>
12361 </ul>
12362
12363 </td> <!-- entry_type -->
12364
12365 <td class="entry_description">
12366 </td>
12367
12368 <td class="entry_units">
12369 </td>
12370
12371 <td class="entry_range">
12372 </td>
12373
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12374 <td class="entry_tags">
12375 </td>
12376
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12377 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12378
12379
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12380 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
12381 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12382
12383
12384
12385 <!-- end of kind -->
12386 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12387 <tr><td colspan="6" class="kind">static</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12388
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]12389 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12390 <tr>
12391 <th class="th_name">Property Name</th>
12392 <th class="th_type">Type</th>
12393 <th class="th_description">Description</th>
12394 <th class="th_units">Units</th>
12395 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12396 <th class="th_tags">Tags</th>
12397 </tr>
12398 </thead>
12399
12400 <tbody>
12401
12402
12403
12404
12405
12406
12407
12408
12409
12410
12411 <tr class="entry" id="static_android.tonemap.maxCurvePoints">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12412 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12413 android.<wbr/>tonemap.<wbr/>max<wbr/>Curve<wbr/>Points
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12414 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12415 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]12416 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12417
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]12418 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12419
12420
12421 </td> <!-- entry_type -->
12422
12423 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12424 <p>Maximum number of supported points in the
12425tonemap curve</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12426 </td>
12427
12428 <td class="entry_units">
12429 </td>
12430
12431 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame]12432 <p>&gt;= 128</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12433 </td>
12434
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12435 <td class="entry_tags">
12436 </td>
12437
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12438 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12439
12440
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12441 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
12442 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12443
12444
12445
12446 <!-- end of kind -->
12447 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12448 <tr><td colspan="6" class="kind">dynamic</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12449
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]12450 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12451 <tr>
12452 <th class="th_name">Property Name</th>
12453 <th class="th_type">Type</th>
12454 <th class="th_description">Description</th>
12455 <th class="th_units">Units</th>
12456 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12457 <th class="th_tags">Tags</th>
12458 </tr>
12459 </thead>
12460
12461 <tbody>
12462
12463
12464
12465
12466
12467
12468
12469
12470
12471
12472 <tr class="entry" id="dynamic_android.tonemap.curveBlue">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12473 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12474 android.<wbr/>tonemap.<wbr/>curve<wbr/>Blue
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12475 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12476 <td class="entry_type">
Eino-Ville Talvala76548fe2013-01-11 13:57:19 -0800[diff] [blame]12477 <span class="entry_type_name">float</span>
Zhijun He704d1282013-08-19 15:26:33 -0700[diff] [blame]12478 <span class="entry_type_container">x</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12479
Zhijun He704d1282013-08-19 15:26:33 -0700[diff] [blame]12480 <span class="entry_type_array">
12481 n x 2
12482 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]12483 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12484 <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]12485
12486
12487 </td> <!-- entry_type -->
12488
12489 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12490 <p>Table mapping blue input values to output
12491values</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12492 </td>
12493
12494 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12495 same as android.<wbr/>tonemap.<wbr/>curve<wbr/>Red
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12496 </td>
12497
12498 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]12499 <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]12500 </td>
12501
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12502 <td class="entry_tags">
12503 </td>
12504
12505 </tr>
12506 <tr class="entries_header">
12507 <th class="th_details" colspan="5">Details</th>
12508 </tr>
12509 <tr class="entry_cont">
12510 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12511 <p>Tonemapping /<wbr/> contrast /<wbr/> gamma curve for the blue
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]12512channel,<wbr/> to use when <a href="#controls_android.tonemap.mode">android.<wbr/>tonemap.<wbr/>mode</a> is CONTRAST_<wbr/>CURVE.<wbr/></p>
12513<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]12514 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12515 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12516
12517
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12518 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
12519 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12520
12521
12522 <tr class="entry" id="dynamic_android.tonemap.curveGreen">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12523 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12524 android.<wbr/>tonemap.<wbr/>curve<wbr/>Green
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12525 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12526 <td class="entry_type">
Eino-Ville Talvala76548fe2013-01-11 13:57:19 -0800[diff] [blame]12527 <span class="entry_type_name">float</span>
Zhijun He704d1282013-08-19 15:26:33 -0700[diff] [blame]12528 <span class="entry_type_container">x</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12529
Zhijun He704d1282013-08-19 15:26:33 -0700[diff] [blame]12530 <span class="entry_type_array">
12531 n x 2
12532 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]12533 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12534 <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]12535
12536
12537 </td> <!-- entry_type -->
12538
12539 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12540 <p>Table mapping green input values to output
12541values</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12542 </td>
12543
12544 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12545 same as android.<wbr/>tonemap.<wbr/>curve<wbr/>Red
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12546 </td>
12547
12548 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]12549 <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]12550 </td>
12551
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12552 <td class="entry_tags">
12553 </td>
12554
12555 </tr>
12556 <tr class="entries_header">
12557 <th class="th_details" colspan="5">Details</th>
12558 </tr>
12559 <tr class="entry_cont">
12560 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12561 <p>Tonemapping /<wbr/> contrast /<wbr/> gamma curve for the green
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]12562channel,<wbr/> to use when <a href="#controls_android.tonemap.mode">android.<wbr/>tonemap.<wbr/>mode</a> is CONTRAST_<wbr/>CURVE.<wbr/></p>
12563<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]12564 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12565 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12566
12567
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12568 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
12569 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12570
12571
12572 <tr class="entry" id="dynamic_android.tonemap.curveRed">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12573 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12574 android.<wbr/>tonemap.<wbr/>curve<wbr/>Red
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12575 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12576 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]12577 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12578 <span class="entry_type_container">x</span>
12579
12580 <span class="entry_type_array">
12581 n x 2
12582 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]12583 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12584 <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]12585
12586
12587 </td> <!-- entry_type -->
12588
12589 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12590 <p>Table mapping red input values to output
12591values</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12592 </td>
12593
12594 <td class="entry_units">
12595 </td>
12596
12597 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]12598 <p>0-1 on input and output coordinates.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12599 </td>
12600
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12601 <td class="entry_tags">
12602 <ul class="entry_tags">
12603 <li><a href="#tag_DNG">DNG</a></li>
12604 </ul>
12605 </td>
12606
12607 </tr>
12608 <tr class="entries_header">
12609 <th class="th_details" colspan="5">Details</th>
12610 </tr>
12611 <tr class="entry_cont">
12612 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12613 <p>Tonemapping /<wbr/> contrast /<wbr/> gamma curve for the red
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]12614channel,<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]12615<p>Since the input and output ranges may vary depending on
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12616the camera pipeline,<wbr/> the input and output pixel values
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]12617are represented by normalized floating-point values
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12618between 0 and 1,<wbr/> with 0 == black and 1 == white.<wbr/></p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]12619<p>The curve should be linearly interpolated between the
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12620defined points.<wbr/> The points will be listed in increasing
12621order of P_<wbr/>IN.<wbr/> For example,<wbr/> if the array is: [0.<wbr/>0,<wbr/> 0.<wbr/>0,<wbr/>
126220.<wbr/>3,<wbr/> 0.<wbr/>5,<wbr/> 1.<wbr/>0,<wbr/> 1.<wbr/>0],<wbr/> then the input-&gt;output mapping
12623for a few sample points would be: 0 -&gt; 0,<wbr/> 0.<wbr/>15 -&gt;
126240.<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]12625 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12626 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12627
12628
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12629 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
12630 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12631
12632
12633 <tr class="entry" id="dynamic_android.tonemap.mode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12634 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12635 android.<wbr/>tonemap.<wbr/>mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12636 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12637 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]12638 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12639
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]12640 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12641
12642 <ul class="entry_type_enum">
12643 <li>
12644 <span class="entry_type_enum_name">CONTRAST_CURVE</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]12645 <span class="entry_type_enum_notes"><p>Use the tone mapping curve specified in
12646android.<wbr/>tonemap.<wbr/>curve</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12647 </li>
12648 <li>
12649 <span class="entry_type_enum_name">FAST</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]12650 <span class="entry_type_enum_notes"><p>Must not slow down frame rate relative to raw
12651bayer output</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12652 </li>
12653 <li>
12654 <span class="entry_type_enum_name">HIGH_QUALITY</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]12655 <span class="entry_type_enum_notes"><p>Frame rate may be reduced by high
12656quality</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12657 </li>
12658 </ul>
12659
12660 </td> <!-- entry_type -->
12661
12662 <td class="entry_description">
12663 </td>
12664
12665 <td class="entry_units">
12666 </td>
12667
12668 <td class="entry_range">
12669 </td>
12670
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12671 <td class="entry_tags">
12672 </td>
12673
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12674 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12675
12676
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12677 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
12678 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12679
12680
12681
12682 <!-- end of kind -->
12683 </tbody>
12684
12685 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12686 <tr><td colspan="6" id="section_led" class="section">led</td></tr>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12687
12688
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12689 <tr><td colspan="6" class="kind">controls</td></tr>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12690
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]12691 <thead class="entries_header">
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12692 <tr>
12693 <th class="th_name">Property Name</th>
12694 <th class="th_type">Type</th>
12695 <th class="th_description">Description</th>
12696 <th class="th_units">Units</th>
12697 <th class="th_range">Range</th>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12698 <th class="th_tags">Tags</th>
12699 </tr>
12700 </thead>
12701
12702 <tbody>
12703
12704
12705
12706
12707
12708
12709
12710
12711
12712
12713 <tr class="entry" id="controls_android.led.transmit">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12714 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12715 android.<wbr/>led.<wbr/>transmit
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12716 </td>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12717 <td class="entry_type">
12718 <span class="entry_type_name entry_type_name_enum">byte</span>
12719
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]12720 <span class="entry_type_visibility"> [hidden as boolean]</span>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12721
12722 <ul class="entry_type_enum">
12723 <li>
12724 <span class="entry_type_enum_name">OFF</span>
12725 </li>
12726 <li>
12727 <span class="entry_type_enum_name">ON</span>
12728 </li>
12729 </ul>
12730
12731 </td> <!-- entry_type -->
12732
12733 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12734 <p>This LED is nominally used to indicate to the user
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]12735that the camera is powered on and may be streaming images back to the
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12736Application Processor.<wbr/> In certain rare circumstances,<wbr/> the OS may
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]12737disable this when video is processed locally and not transmitted to
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12738any untrusted applications.<wbr/></p>
12739<p>In particular,<wbr/> the LED <em>must</em> always be on when the data could be
12740transmitted off the device.<wbr/> The LED <em>should</em> always be on whenever
12741data is stored locally on the device.<wbr/></p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]12742<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]12743doesn't violate the above rules.<wbr/></p>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12744 </td>
12745
12746 <td class="entry_units">
12747 </td>
12748
12749 <td class="entry_range">
12750 </td>
12751
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12752 <td class="entry_tags">
12753 </td>
12754
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12755 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12756
12757
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12758 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
12759 <!-- end of entry -->
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12760
12761
12762
12763 <!-- end of kind -->
12764 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12765 <tr><td colspan="6" class="kind">dynamic</td></tr>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12766
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]12767 <thead class="entries_header">
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12768 <tr>
12769 <th class="th_name">Property Name</th>
12770 <th class="th_type">Type</th>
12771 <th class="th_description">Description</th>
12772 <th class="th_units">Units</th>
12773 <th class="th_range">Range</th>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12774 <th class="th_tags">Tags</th>
12775 </tr>
12776 </thead>
12777
12778 <tbody>
12779
12780
12781
12782
12783
12784
12785
12786
12787
12788
12789 <tr class="entry" id="dynamic_android.led.transmit">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12790 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12791 android.<wbr/>led.<wbr/>transmit
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12792 </td>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12793 <td class="entry_type">
12794 <span class="entry_type_name entry_type_name_enum">byte</span>
12795
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]12796 <span class="entry_type_visibility"> [hidden as boolean]</span>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12797
12798 <ul class="entry_type_enum">
12799 <li>
12800 <span class="entry_type_enum_name">OFF</span>
12801 </li>
12802 <li>
12803 <span class="entry_type_enum_name">ON</span>
12804 </li>
12805 </ul>
12806
12807 </td> <!-- entry_type -->
12808
12809 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12810 <p>This LED is nominally used to indicate to the user
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]12811that the camera is powered on and may be streaming images back to the
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12812Application Processor.<wbr/> In certain rare circumstances,<wbr/> the OS may
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]12813disable this when video is processed locally and not transmitted to
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12814any untrusted applications.<wbr/></p>
12815<p>In particular,<wbr/> the LED <em>must</em> always be on when the data could be
12816transmitted off the device.<wbr/> The LED <em>should</em> always be on whenever
12817data is stored locally on the device.<wbr/></p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]12818<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]12819doesn't violate the above rules.<wbr/></p>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12820 </td>
12821
12822 <td class="entry_units">
12823 </td>
12824
12825 <td class="entry_range">
12826 </td>
12827
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12828 <td class="entry_tags">
12829 </td>
12830
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12831 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12832
12833
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12834 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
12835 <!-- end of entry -->
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12836
12837
12838
12839 <!-- end of kind -->
12840 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12841 <tr><td colspan="6" class="kind">static</td></tr>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12842
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]12843 <thead class="entries_header">
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12844 <tr>
12845 <th class="th_name">Property Name</th>
12846 <th class="th_type">Type</th>
12847 <th class="th_description">Description</th>
12848 <th class="th_units">Units</th>
12849 <th class="th_range">Range</th>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12850 <th class="th_tags">Tags</th>
12851 </tr>
12852 </thead>
12853
12854 <tbody>
12855
12856
12857
12858
12859
12860
12861
12862
12863
12864
12865 <tr class="entry" id="static_android.led.availableLeds">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12866 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12867 android.<wbr/>led.<wbr/>available<wbr/>Leds
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12868 </td>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12869 <td class="entry_type">
12870 <span class="entry_type_name entry_type_name_enum">byte</span>
12871 <span class="entry_type_container">x</span>
12872
12873 <span class="entry_type_array">
12874 n
12875 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]12876 <span class="entry_type_visibility"> [hidden]</span>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12877
12878 <ul class="entry_type_enum">
12879 <li>
12880 <span class="entry_type_enum_name">TRANSMIT</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]12881 <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]12882 </li>
12883 </ul>
12884
12885 </td> <!-- entry_type -->
12886
12887 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12888 <p>A list of camera LEDs that are available on this system.<wbr/></p>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12889 </td>
12890
12891 <td class="entry_units">
12892 </td>
12893
12894 <td class="entry_range">
12895 </td>
12896
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12897 <td class="entry_tags">
12898 </td>
12899
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12900 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12901
12902
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12903 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
12904 <!-- end of entry -->
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12905
12906
12907
12908 <!-- end of kind -->
12909 </tbody>
12910
12911 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12912 <tr><td colspan="6" id="section_info" class="section">info</td></tr>
Igor Murashkin38b8cae2013-05-23 16:38:59 -0700[diff] [blame]12913
12914
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12915 <tr><td colspan="6" class="kind">static</td></tr>
Igor Murashkin38b8cae2013-05-23 16:38:59 -0700[diff] [blame]12916
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]12917 <thead class="entries_header">
Igor Murashkin38b8cae2013-05-23 16:38:59 -0700[diff] [blame]12918 <tr>
12919 <th class="th_name">Property Name</th>
12920 <th class="th_type">Type</th>
12921 <th class="th_description">Description</th>
12922 <th class="th_units">Units</th>
12923 <th class="th_range">Range</th>
Igor Murashkin38b8cae2013-05-23 16:38:59 -0700[diff] [blame]12924 <th class="th_tags">Tags</th>
12925 </tr>
12926 </thead>
12927
12928 <tbody>
12929
12930
12931
12932
12933
12934
12935
12936
12937
12938
12939 <tr class="entry" id="static_android.info.supportedHardwareLevel">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12940 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12941 android.<wbr/>info.<wbr/>supported<wbr/>Hardware<wbr/>Level
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12942 </td>
Igor Murashkin38b8cae2013-05-23 16:38:59 -0700[diff] [blame]12943 <td class="entry_type">
12944 <span class="entry_type_name entry_type_name_enum">byte</span>
12945
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]12946 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin38b8cae2013-05-23 16:38:59 -0700[diff] [blame]12947
12948 <ul class="entry_type_enum">
12949 <li>
12950 <span class="entry_type_enum_name">LIMITED</span>
12951 </li>
12952 <li>
12953 <span class="entry_type_enum_name">FULL</span>
12954 </li>
12955 </ul>
12956
12957 </td> <!-- entry_type -->
12958
12959 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12960 <p>The camera 3 HAL device can implement one of two possible
12961operational modes; limited and full.<wbr/> Full support is
12962expected from new higher-end devices.<wbr/> Limited mode has
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]12963hardware requirements roughly in line with those for a
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12964camera HAL device v1 implementation,<wbr/> and is expected from
12965older or inexpensive devices.<wbr/> Full is a strict superset of
12966limited,<wbr/> and they share the same essential operational flow.<wbr/></p>
12967<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]12968 </td>
12969
12970 <td class="entry_units">
12971 </td>
12972
12973 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]12974 <p>Optional.<wbr/> Default value is LIMITED.<wbr/></p>
Igor Murashkin38b8cae2013-05-23 16:38:59 -0700[diff] [blame]12975 </td>
12976
Igor Murashkin38b8cae2013-05-23 16:38:59 -0700[diff] [blame]12977 <td class="entry_tags">
12978 </td>
12979
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12980 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12981
12982
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12983 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
12984 <!-- end of entry -->
Igor Murashkin38b8cae2013-05-23 16:38:59 -0700[diff] [blame]12985
12986
12987
12988 <!-- end of kind -->
12989 </tbody>
12990
12991 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12992 <tr><td colspan="6" id="section_blackLevel" class="section">blackLevel</td></tr>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]12993
12994
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12995 <tr><td colspan="6" class="kind">controls</td></tr>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]12996
12997 <thead class="entries_header">
12998 <tr>
12999 <th class="th_name">Property Name</th>
13000 <th class="th_type">Type</th>
13001 <th class="th_description">Description</th>
13002 <th class="th_units">Units</th>
13003 <th class="th_range">Range</th>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]13004 <th class="th_tags">Tags</th>
13005 </tr>
13006 </thead>
13007
13008 <tbody>
13009
13010
13011
13012
13013
13014
13015
13016
13017
13018
13019 <tr class="entry" id="controls_android.blackLevel.lock">
Eino-Ville Talvala7796cfe2013-12-26 13:16:54 -0800[diff] [blame]13020 <td class="entry_name" rowspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13021 android.<wbr/>black<wbr/>Level.<wbr/>lock
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]13022 </td>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]13023 <td class="entry_type">
13024 <span class="entry_type_name entry_type_name_enum">byte</span>
13025
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]13026 <span class="entry_type_visibility"> [public as boolean]</span>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]13027
13028 <ul class="entry_type_enum">
13029 <li>
13030 <span class="entry_type_enum_name">OFF</span>
13031 </li>
13032 <li>
13033 <span class="entry_type_enum_name">ON</span>
13034 </li>
13035 </ul>
13036
13037 </td> <!-- entry_type -->
13038
13039 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13040 <p>Whether black-level compensation is locked
13041to its current values,<wbr/> or is free to vary.<wbr/></p>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]13042 </td>
13043
13044 <td class="entry_units">
13045 </td>
13046
13047 <td class="entry_range">
13048 </td>
13049
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13050 <td class="entry_tags">
13051 <ul class="entry_tags">
13052 <li><a href="#tag_HAL2">HAL2</a></li>
13053 </ul>
13054 </td>
13055
13056 </tr>
13057 <tr class="entries_header">
13058 <th class="th_details" colspan="5">Details</th>
13059 </tr>
13060 <tr class="entry_cont">
13061 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13062 <p>When set to ON,<wbr/> the values used for black-level
Eino-Ville Talvala7796cfe2013-12-26 13:16:54 -0800[diff] [blame]13063compensation will not change until the lock is set to
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13064OFF.<wbr/></p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]13065<p>Since changes to certain capture parameters (such as
13066exposure time) may require resetting of black level
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13067compensation,<wbr/> the camera device must report whether setting
Eino-Ville Talvala7796cfe2013-12-26 13:16:54 -0800[diff] [blame]13068the black level lock was successful in the output result
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13069metadata.<wbr/></p>
13070<p>For example,<wbr/> if a sequence of requests is as follows:</p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]13071<ul>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13072<li>Request 1: Exposure = 10ms,<wbr/> Black level lock = OFF</li>
13073<li>Request 2: Exposure = 10ms,<wbr/> Black level lock = ON</li>
13074<li>Request 3: Exposure = 10ms,<wbr/> Black level lock = ON</li>
13075<li>Request 4: Exposure = 20ms,<wbr/> Black level lock = ON</li>
13076<li>Request 5: Exposure = 20ms,<wbr/> Black level lock = ON</li>
13077<li>Request 6: Exposure = 20ms,<wbr/> Black level lock = ON</li>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]13078</ul>
Eino-Ville Talvala7796cfe2013-12-26 13:16:54 -0800[diff] [blame]13079<p>And the exposure change in Request 4 requires the camera
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13080device to reset the black level offsets,<wbr/> then the output
Eino-Ville Talvala7796cfe2013-12-26 13:16:54 -0800[diff] [blame]13081result metadata is expected to be:</p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]13082<ul>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13083<li>Result 1: Exposure = 10ms,<wbr/> Black level lock = OFF</li>
13084<li>Result 2: Exposure = 10ms,<wbr/> Black level lock = ON</li>
13085<li>Result 3: Exposure = 10ms,<wbr/> Black level lock = ON</li>
13086<li>Result 4: Exposure = 20ms,<wbr/> Black level lock = OFF</li>
13087<li>Result 5: Exposure = 20ms,<wbr/> Black level lock = ON</li>
13088<li>Result 6: Exposure = 20ms,<wbr/> Black level lock = ON</li>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]13089</ul>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13090<p>This indicates to the application that on frame 4,<wbr/> black
13091levels were reset due to exposure value changes,<wbr/> and pixel
13092values may not be consistent across captures.<wbr/></p>
Eino-Ville Talvala7796cfe2013-12-26 13:16:54 -0800[diff] [blame]13093<p>The camera device will maintain the lock to the extent
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13094possible,<wbr/> only overriding the lock to OFF when changes to
Eino-Ville Talvala7796cfe2013-12-26 13:16:54 -0800[diff] [blame]13095other request parameters require a black level recalculation
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13096or reset.<wbr/></p>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]13097 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13098 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]13099
Eino-Ville Talvala7796cfe2013-12-26 13:16:54 -0800[diff] [blame]13100 <tr class="entries_header">
13101 <th class="th_details" colspan="5">HAL Implementation Details</th>
13102 </tr>
13103 <tr class="entry_cont">
13104 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13105 <p>If for some reason black level locking is no longer possible
13106(for example,<wbr/> the analog gain has changed,<wbr/> which forces
13107black level offsets to be recalculated),<wbr/> then the HAL must
Eino-Ville Talvala7796cfe2013-12-26 13:16:54 -0800[diff] [blame]13108override this request (and it must report 'OFF' when this
13109does happen) until the next capture for which locking is
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13110possible again.<wbr/></p>
Eino-Ville Talvala7796cfe2013-12-26 13:16:54 -0800[diff] [blame]13111 </td>
13112 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]13113
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13114 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
13115 <!-- end of entry -->
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]13116
13117
13118
13119 <!-- end of kind -->
13120 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13121 <tr><td colspan="6" class="kind">dynamic</td></tr>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]13122
13123 <thead class="entries_header">
13124 <tr>
13125 <th class="th_name">Property Name</th>
13126 <th class="th_type">Type</th>
13127 <th class="th_description">Description</th>
13128 <th class="th_units">Units</th>
13129 <th class="th_range">Range</th>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]13130 <th class="th_tags">Tags</th>
13131 </tr>
13132 </thead>
13133
13134 <tbody>
13135
13136
13137
13138
13139
13140
13141
13142
13143
13144
13145 <tr class="entry" id="dynamic_android.blackLevel.lock">
Eino-Ville Talvala7796cfe2013-12-26 13:16:54 -0800[diff] [blame]13146 <td class="entry_name" rowspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13147 android.<wbr/>black<wbr/>Level.<wbr/>lock
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]13148 </td>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]13149 <td class="entry_type">
13150 <span class="entry_type_name entry_type_name_enum">byte</span>
13151
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]13152 <span class="entry_type_visibility"> [public as boolean]</span>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]13153
13154 <ul class="entry_type_enum">
13155 <li>
13156 <span class="entry_type_enum_name">OFF</span>
13157 </li>
13158 <li>
13159 <span class="entry_type_enum_name">ON</span>
13160 </li>
13161 </ul>
13162
13163 </td> <!-- entry_type -->
13164
13165 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13166 <p>Whether black-level compensation is locked
13167to its current values,<wbr/> or is free to vary.<wbr/></p>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]13168 </td>
13169
13170 <td class="entry_units">
13171 </td>
13172
13173 <td class="entry_range">
13174 </td>
13175
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]13176 <td class="entry_tags">
13177 <ul class="entry_tags">
13178 <li><a href="#tag_HAL2">HAL2</a></li>
13179 </ul>
13180 </td>
13181
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13182 </tr>
13183 <tr class="entries_header">
13184 <th class="th_details" colspan="5">Details</th>
13185 </tr>
13186 <tr class="entry_cont">
13187 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13188 <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]13189ON 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]13190a change in other capture settings forced the camera device to
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13191perform a black level reset.<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13192 </td>
13193 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]13194
Eino-Ville Talvala7796cfe2013-12-26 13:16:54 -0800[diff] [blame]13195 <tr class="entries_header">
13196 <th class="th_details" colspan="5">HAL Implementation Details</th>
13197 </tr>
13198 <tr class="entry_cont">
13199 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13200 <p>If for some reason black level locking is no longer possible
13201(for example,<wbr/> the analog gain has changed,<wbr/> which forces
13202black level offsets to be recalculated),<wbr/> then the HAL must
Eino-Ville Talvala7796cfe2013-12-26 13:16:54 -0800[diff] [blame]13203override this request (and it must report 'OFF' when this
13204does happen) until the next capture for which locking is
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13205possible again.<wbr/></p>
Eino-Ville Talvala7796cfe2013-12-26 13:16:54 -0800[diff] [blame]13206 </td>
13207 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]13208
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13209 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
13210 <!-- end of entry -->
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]13211
13212
13213
13214 <!-- end of kind -->
13215 </tbody>
13216
13217 <!-- end of section -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13218<!-- </namespace> -->
13219 </table>
13220
13221 <div class="tags" id="tag_index">
13222 <h2>Tags</h2>
13223 <ul>
13224 <li id="tag_AWB">AWB -
13225 Needed for auto white balance
13226
13227 <ul class="tags_entries">
13228 <li><a href="#controls_android.control.awbMode">android.control.awbMode</a> (controls)</li>
13229 </ul>
13230 </li> <!-- tag_AWB -->
13231 <li id="tag_BC">BC -
13232 Needed for backwards compatibility with old Java API
13233
13234 <ul class="tags_entries">
Eino-Ville Talvala19ce2c12013-12-30 12:03:45 -0800[diff] [blame]13235 <li><a href="#controls_android.control.aeAntibandingMode">android.control.aeAntibandingMode</a> (controls)</li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13236 <li><a href="#controls_android.control.aeExposureCompensation">android.control.aeExposureCompensation</a> (controls)</li>
13237 <li><a href="#controls_android.control.aeLock">android.control.aeLock</a> (controls)</li>
13238 <li><a href="#controls_android.control.aeMode">android.control.aeMode</a> (controls)</li>
13239 <li><a href="#controls_android.control.aeRegions">android.control.aeRegions</a> (controls)</li>
13240 <li><a href="#controls_android.control.aeTargetFpsRange">android.control.aeTargetFpsRange</a> (controls)</li>
Eino-Ville Talvala3b4383a2013-03-18 09:42:48 -0700[diff] [blame]13241 <li><a href="#controls_android.control.aePrecaptureTrigger">android.control.aePrecaptureTrigger</a> (controls)</li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13242 <li><a href="#controls_android.control.afMode">android.control.afMode</a> (controls)</li>
13243 <li><a href="#controls_android.control.afRegions">android.control.afRegions</a> (controls)</li>
Eino-Ville Talvala3b4383a2013-03-18 09:42:48 -0700[diff] [blame]13244 <li><a href="#controls_android.control.afTrigger">android.control.afTrigger</a> (controls)</li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13245 <li><a href="#controls_android.control.awbLock">android.control.awbLock</a> (controls)</li>
13246 <li><a href="#controls_android.control.awbMode">android.control.awbMode</a> (controls)</li>
13247 <li><a href="#controls_android.control.awbRegions">android.control.awbRegions</a> (controls)</li>
13248 <li><a href="#controls_android.control.captureIntent">android.control.captureIntent</a> (controls)</li>
13249 <li><a href="#controls_android.control.effectMode">android.control.effectMode</a> (controls)</li>
13250 <li><a href="#controls_android.control.mode">android.control.mode</a> (controls)</li>
13251 <li><a href="#controls_android.control.sceneMode">android.control.sceneMode</a> (controls)</li>
13252 <li><a href="#controls_android.control.videoStabilizationMode">android.control.videoStabilizationMode</a> (controls)</li>
Eino-Ville Talvala9fa0d902014-01-08 16:16:53 -0800[diff] [blame]13253 <li><a href="#static_android.control.aeAvailableModes">android.control.aeAvailableModes</a> (static)</li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13254 <li><a href="#static_android.control.aeCompensationRange">android.control.aeCompensationRange</a> (static)</li>
13255 <li><a href="#static_android.control.aeCompensationStep">android.control.aeCompensationStep</a> (static)</li>
13256 <li><a href="#static_android.control.afAvailableModes">android.control.afAvailableModes</a> (static)</li>
13257 <li><a href="#static_android.control.availableEffects">android.control.availableEffects</a> (static)</li>
13258 <li><a href="#static_android.control.availableSceneModes">android.control.availableSceneModes</a> (static)</li>
13259 <li><a href="#static_android.control.availableVideoStabilizationModes">android.control.availableVideoStabilizationModes</a> (static)</li>
13260 <li><a href="#static_android.control.awbAvailableModes">android.control.awbAvailableModes</a> (static)</li>
13261 <li><a href="#static_android.control.maxRegions">android.control.maxRegions</a> (static)</li>
13262 <li><a href="#static_android.control.sceneModeOverrides">android.control.sceneModeOverrides</a> (static)</li>
13263 <li><a href="#controls_android.flash.mode">android.flash.mode</a> (controls)</li>
13264 <li><a href="#static_android.flash.info.available">android.flash.info.available</a> (static)</li>
13265 <li><a href="#controls_android.jpeg.gpsCoordinates">android.jpeg.gpsCoordinates</a> (controls)</li>
13266 <li><a href="#controls_android.jpeg.gpsProcessingMethod">android.jpeg.gpsProcessingMethod</a> (controls)</li>
13267 <li><a href="#controls_android.jpeg.gpsTimestamp">android.jpeg.gpsTimestamp</a> (controls)</li>
13268 <li><a href="#controls_android.jpeg.orientation">android.jpeg.orientation</a> (controls)</li>
13269 <li><a href="#controls_android.jpeg.quality">android.jpeg.quality</a> (controls)</li>
13270 <li><a href="#controls_android.jpeg.thumbnailQuality">android.jpeg.thumbnailQuality</a> (controls)</li>
13271 <li><a href="#controls_android.jpeg.thumbnailSize">android.jpeg.thumbnailSize</a> (controls)</li>
13272 <li><a href="#static_android.jpeg.availableThumbnailSizes">android.jpeg.availableThumbnailSizes</a> (static)</li>
13273 <li><a href="#controls_android.lens.focusDistance">android.lens.focusDistance</a> (controls)</li>
13274 <li><a href="#static_android.lens.info.availableFocalLengths">android.lens.info.availableFocalLengths</a> (static)</li>
13275 <li><a href="#static_android.lens.info.hyperfocalDistance">android.lens.info.hyperfocalDistance</a> (static)</li>
13276 <li><a href="#dynamic_android.lens.focusRange">android.lens.focusRange</a> (dynamic)</li>
13277 <li><a href="#static_android.request.maxNumOutputStreams">android.request.maxNumOutputStreams</a> (static)</li>
13278 <li><a href="#controls_android.scaler.cropRegion">android.scaler.cropRegion</a> (controls)</li>
13279 <li><a href="#static_android.scaler.availableFormats">android.scaler.availableFormats</a> (static)</li>
13280 <li><a href="#static_android.scaler.availableJpegMinDurations">android.scaler.availableJpegMinDurations</a> (static)</li>
13281 <li><a href="#static_android.scaler.availableJpegSizes">android.scaler.availableJpegSizes</a> (static)</li>
Igor Murashkinf11a4df2013-05-07 10:00:46 -0700[diff] [blame]13282 <li><a href="#static_android.scaler.availableMaxDigitalZoom">android.scaler.availableMaxDigitalZoom</a> (static)</li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13283 <li><a href="#static_android.scaler.availableProcessedMinDurations">android.scaler.availableProcessedMinDurations</a> (static)</li>
13284 <li><a href="#static_android.scaler.availableProcessedSizes">android.scaler.availableProcessedSizes</a> (static)</li>
13285 <li><a href="#static_android.scaler.availableRawMinDurations">android.scaler.availableRawMinDurations</a> (static)</li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13286 <li><a href="#controls_android.sensor.frameDuration">android.sensor.frameDuration</a> (controls)</li>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]13287 <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]13288 <li><a href="#static_android.sensor.info.maxFrameDuration">android.sensor.info.maxFrameDuration</a> (static)</li>
13289 <li><a href="#static_android.sensor.info.physicalSize">android.sensor.info.physicalSize</a> (static)</li>
13290 <li><a href="#static_android.sensor.info.pixelArraySize">android.sensor.info.pixelArraySize</a> (static)</li>
13291 <li><a href="#static_android.sensor.orientation">android.sensor.orientation</a> (static)</li>
13292 <li><a href="#dynamic_android.sensor.timestamp">android.sensor.timestamp</a> (dynamic)</li>
13293 <li><a href="#controls_android.statistics.faceDetectMode">android.statistics.faceDetectMode</a> (controls)</li>
13294 <li><a href="#dynamic_android.statistics.faceIds">android.statistics.faceIds</a> (dynamic)</li>
13295 <li><a href="#dynamic_android.statistics.faceLandmarks">android.statistics.faceLandmarks</a> (dynamic)</li>
13296 <li><a href="#dynamic_android.statistics.faceRectangles">android.statistics.faceRectangles</a> (dynamic)</li>
13297 <li><a href="#dynamic_android.statistics.faceScores">android.statistics.faceScores</a> (dynamic)</li>
13298 <li><a href="#dynamic_android.lens.focalLength">android.lens.focalLength</a> (dynamic)</li>
13299 <li><a href="#dynamic_android.lens.focusDistance">android.lens.focusDistance</a> (dynamic)</li>
13300 </ul>
13301 </li> <!-- tag_BC -->
13302 <li id="tag_V1">V1 -
13303 New features for first camera 2 release (API1)
13304
13305 <ul class="tags_entries">
13306 <li><a href="#controls_android.demosaic.mode">android.demosaic.mode</a> (controls)</li>
13307 <li><a href="#controls_android.flash.firingPower">android.flash.firingPower</a> (controls)</li>
13308 <li><a href="#controls_android.flash.firingTime">android.flash.firingTime</a> (controls)</li>
13309 <li><a href="#static_android.flash.info.chargeDuration">android.flash.info.chargeDuration</a> (static)</li>
13310 <li><a href="#controls_android.hotPixel.mode">android.hotPixel.mode</a> (controls)</li>
13311 <li><a href="#controls_android.lens.aperture">android.lens.aperture</a> (controls)</li>
13312 <li><a href="#controls_android.lens.filterDensity">android.lens.filterDensity</a> (controls)</li>
13313 <li><a href="#controls_android.lens.focalLength">android.lens.focalLength</a> (controls)</li>
13314 <li><a href="#controls_android.lens.focusDistance">android.lens.focusDistance</a> (controls)</li>
13315 <li><a href="#controls_android.lens.opticalStabilizationMode">android.lens.opticalStabilizationMode</a> (controls)</li>
13316 <li><a href="#static_android.lens.info.availableApertures">android.lens.info.availableApertures</a> (static)</li>
13317 <li><a href="#static_android.lens.info.availableFilterDensities">android.lens.info.availableFilterDensities</a> (static)</li>
13318 <li><a href="#static_android.lens.info.availableFocalLengths">android.lens.info.availableFocalLengths</a> (static)</li>
13319 <li><a href="#static_android.lens.info.availableOpticalStabilization">android.lens.info.availableOpticalStabilization</a> (static)</li>
13320 <li><a href="#static_android.lens.info.geometricCorrectionMapSize">android.lens.info.geometricCorrectionMapSize</a> (static)</li>
13321 <li><a href="#static_android.lens.info.minimumFocusDistance">android.lens.info.minimumFocusDistance</a> (static)</li>
13322 <li><a href="#static_android.lens.info.shadingMapSize">android.lens.info.shadingMapSize</a> (static)</li>
13323 <li><a href="#static_android.lens.position">android.lens.position</a> (static)</li>
13324 <li><a href="#dynamic_android.lens.state">android.lens.state</a> (dynamic)</li>
13325 <li><a href="#controls_android.noiseReduction.mode">android.noiseReduction.mode</a> (controls)</li>
13326 <li><a href="#controls_android.request.id">android.request.id</a> (controls)</li>
13327 <li><a href="#controls_android.sensor.exposureTime">android.sensor.exposureTime</a> (controls)</li>
13328 <li><a href="#controls_android.sensor.frameDuration">android.sensor.frameDuration</a> (controls)</li>
13329 <li><a href="#controls_android.sensor.sensitivity">android.sensor.sensitivity</a> (controls)</li>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]13330 <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]13331 <li><a href="#static_android.sensor.info.exposureTimeRange">android.sensor.info.exposureTimeRange</a> (static)</li>
13332 <li><a href="#static_android.sensor.info.maxFrameDuration">android.sensor.info.maxFrameDuration</a> (static)</li>
13333 <li><a href="#static_android.sensor.info.physicalSize">android.sensor.info.physicalSize</a> (static)</li>
13334 <li><a href="#static_android.sensor.baseGainFactor">android.sensor.baseGainFactor</a> (static)</li>
13335 <li><a href="#static_android.sensor.maxAnalogSensitivity">android.sensor.maxAnalogSensitivity</a> (static)</li>
13336 <li><a href="#static_android.sensor.noiseModelCoefficients">android.sensor.noiseModelCoefficients</a> (static)</li>
13337 <li><a href="#controls_android.statistics.histogramMode">android.statistics.histogramMode</a> (controls)</li>
13338 <li><a href="#controls_android.statistics.sharpnessMapMode">android.statistics.sharpnessMapMode</a> (controls)</li>
13339 <li><a href="#dynamic_android.statistics.histogram">android.statistics.histogram</a> (dynamic)</li>
13340 <li><a href="#dynamic_android.statistics.sharpnessMap">android.statistics.sharpnessMap</a> (dynamic)</li>
13341 <li><a href="#dynamic_android.hotPixel.mode">android.hotPixel.mode</a> (dynamic)</li>
13342 <li><a href="#dynamic_android.lens.aperture">android.lens.aperture</a> (dynamic)</li>
13343 <li><a href="#dynamic_android.lens.filterDensity">android.lens.filterDensity</a> (dynamic)</li>
13344 <li><a href="#dynamic_android.lens.opticalStabilizationMode">android.lens.opticalStabilizationMode</a> (dynamic)</li>
13345 </ul>
13346 </li> <!-- tag_V1 -->
13347 <li id="tag_ADV">ADV - None
13348 <ul class="tags_entries">
13349 <li><a href="#static_android.flash.colorTemperature">android.flash.colorTemperature</a> (static)</li>
13350 <li><a href="#static_android.flash.maxEnergy">android.flash.maxEnergy</a> (static)</li>
13351 <li><a href="#controls_android.geometric.strength">android.geometric.strength</a> (controls)</li>
13352 <li><a href="#static_android.hotPixel.info.map">android.hotPixel.info.map</a> (static)</li>
13353 <li><a href="#static_android.lens.opticalAxisAngle">android.lens.opticalAxisAngle</a> (static)</li>
13354 <li><a href="#controls_android.shading.strength">android.shading.strength</a> (controls)</li>
13355 </ul>
13356 </li> <!-- tag_ADV -->
13357 <li id="tag_DNG">DNG -
13358 Needed for DNG file support
13359
13360 <ul class="tags_entries">
13361 <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]13362 <li><a href="#static_android.sensor.info.activeArraySize">android.sensor.info.activeArraySize</a> (static)</li>
13363 <li><a href="#static_android.sensor.info.colorFilterArrangement">android.sensor.info.colorFilterArrangement</a> (static)</li>
13364 <li><a href="#static_android.sensor.info.pixelArraySize">android.sensor.info.pixelArraySize</a> (static)</li>
13365 <li><a href="#static_android.sensor.info.whiteLevel">android.sensor.info.whiteLevel</a> (static)</li>
13366 <li><a href="#static_android.sensor.blackLevelPattern">android.sensor.blackLevelPattern</a> (static)</li>
13367 <li><a href="#static_android.sensor.calibrationTransform1">android.sensor.calibrationTransform1</a> (static)</li>
13368 <li><a href="#static_android.sensor.calibrationTransform2">android.sensor.calibrationTransform2</a> (static)</li>
13369 <li><a href="#static_android.sensor.colorTransform1">android.sensor.colorTransform1</a> (static)</li>
13370 <li><a href="#static_android.sensor.colorTransform2">android.sensor.colorTransform2</a> (static)</li>
13371 <li><a href="#static_android.sensor.forwardMatrix1">android.sensor.forwardMatrix1</a> (static)</li>
13372 <li><a href="#static_android.sensor.forwardMatrix2">android.sensor.forwardMatrix2</a> (static)</li>
13373 <li><a href="#static_android.sensor.referenceIlluminant1">android.sensor.referenceIlluminant1</a> (static)</li>
13374 <li><a href="#controls_android.tonemap.curveRed">android.tonemap.curveRed</a> (controls)</li>
13375 </ul>
13376 </li> <!-- tag_DNG -->
13377 <li id="tag_EXIF">EXIF - None
13378 <ul class="tags_entries">
13379 <li><a href="#static_android.sensor.referenceIlluminant1">android.sensor.referenceIlluminant1</a> (static)</li>
13380 </ul>
13381 </li> <!-- tag_EXIF -->
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]13382 <li id="tag_HAL2">HAL2 -
Alex Rayef40ad62013-10-01 17:52:33 -0700[diff] [blame]13383 Entry is only used by camera device HAL 2.x
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]13384
13385 <ul class="tags_entries">
13386 <li><a href="#controls_android.request.inputStreams">android.request.inputStreams</a> (controls)</li>
13387 <li><a href="#controls_android.request.outputStreams">android.request.outputStreams</a> (controls)</li>
13388 <li><a href="#controls_android.request.type">android.request.type</a> (controls)</li>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]13389 <li><a href="#controls_android.blackLevel.lock">android.blackLevel.lock</a> (controls)</li>
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]13390 </ul>
13391 </li> <!-- tag_HAL2 -->
Alex Rayef40ad62013-10-01 17:52:33 -0700[diff] [blame]13392 <li id="tag_FULL">FULL -
13393 Entry is required for full hardware level devices, and optional for other hardware levels
13394
13395 <ul class="tags_entries">
13396 <li><a href="#static_android.sensor.baseGainFactor">android.sensor.baseGainFactor</a> (static)</li>
13397 <li><a href="#static_android.sensor.maxAnalogSensitivity">android.sensor.maxAnalogSensitivity</a> (static)</li>
13398 <li><a href="#dynamic_android.sensor.temperature">android.sensor.temperature</a> (dynamic)</li>
13399 </ul>
13400 </li> <!-- tag_FULL -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13401 </ul>
13402 </div>
13403
13404 [ <a href="#">top</a> ]
13405
13406</body>
13407</html>