Gitiles
Code Review Sign In
gerrit-public.fairphone.software / platform / system / media / 6cb7c2c3839fbd42870643d225eb7b5fee055d06 / . / camera / docs / docs.html
blob: a0b8a66c3b3b99cc05fa39d78d9deec400401536 [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:" - " }
62 .entry_type_enum_value:before { content:" = " }
63 .entry_type_enum_value { font-family: monospace; }
64 .entry ul { margin: 0 0 0 0; list-style-position: inside; padding-left: 0.5em; }
65 .entry ul li { padding: 0 0 0 0; margin: 0 0 0 0;}
66
67 /* Entry tags flair */
68 .entry_tags ul { list-style-type: none; }
69
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]70 /* Entry details (full docs) flair */
71 .entry_details_header { font-weight: bold; background-color: #dddddd;
72 text-align: center; font-size: 1.1em; margin-left: 0em; margin-right: 0em; }
73
74 /* Entry spacer flair */
75 .entry_spacer { background-color: transparent; border-style: none; height: 0.5em; }
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]76
77 /* TODO: generate abbr element for each tag link? */
78 /* TODO for each x.y.z try to link it to the entry */
79
80 </style>
81
82 <style>
83
84 {
85 /* broken...
86 supposedly there is a bug in chrome that it lays out tables before
87 it knows its being printed, so the page-break-* styles are ignored
88 */
89 tr { page-break-after: always; page-break-inside: avoid; }
90 }
91
92 </style>
93</head>
94
95
96
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]97<body>
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]98 <h1>Android Camera HAL3.0 Properties</h1>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]99
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]100
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]101 <h2>Table of Contents</h2>
102 <ul class="toc">
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]103 <li><a href="#tag_index" class="toc_section_header">Tags</a></li>
104 <li>
105 <span class="toc_section_header"><a href="#section_colorCorrection">colorCorrection</a></span>
106 <ul class="toc_section">
107 <li>
108 <span class="toc_kind_header">controls</span>
109 <ul class="toc_section">
110 <li><a href="#controls_android.colorCorrection.mode">android.colorCorrection.mode</a></li>
111 <li><a href="#controls_android.colorCorrection.transform">android.colorCorrection.transform</a></li>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]112 <li><a href="#controls_android.colorCorrection.gains">android.colorCorrection.gains</a></li>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]113 </ul>
114 </li>
115 <li>
116 <span class="toc_kind_header">dynamic</span>
117 <ul class="toc_section">
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]118 <li><a href="#dynamic_android.colorCorrection.transform">android.colorCorrection.transform</a></li>
119 <li><a href="#dynamic_android.colorCorrection.gains">android.colorCorrection.gains</a></li>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]120 </ul>
121 </li>
122 </ul> <!-- toc_section -->
123 </li>
124 <li>
125 <span class="toc_section_header"><a href="#section_control">control</a></span>
126 <ul class="toc_section">
127 <li>
128 <span class="toc_kind_header">controls</span>
129 <ul class="toc_section">
130 <li><a href="#controls_android.control.aeAntibandingMode">android.control.aeAntibandingMode</a></li>
131 <li><a href="#controls_android.control.aeExposureCompensation">android.control.aeExposureCompensation</a></li>
132 <li><a href="#controls_android.control.aeLock">android.control.aeLock</a></li>
133 <li><a href="#controls_android.control.aeMode">android.control.aeMode</a></li>
134 <li><a href="#controls_android.control.aeRegions">android.control.aeRegions</a></li>
135 <li><a href="#controls_android.control.aeTargetFpsRange">android.control.aeTargetFpsRange</a></li>
136 <li><a href="#controls_android.control.aePrecaptureTrigger">android.control.aePrecaptureTrigger</a></li>
137 <li><a href="#controls_android.control.afMode">android.control.afMode</a></li>
138 <li><a href="#controls_android.control.afRegions">android.control.afRegions</a></li>
139 <li><a href="#controls_android.control.afTrigger">android.control.afTrigger</a></li>
140 <li><a href="#controls_android.control.awbLock">android.control.awbLock</a></li>
141 <li><a href="#controls_android.control.awbMode">android.control.awbMode</a></li>
142 <li><a href="#controls_android.control.awbRegions">android.control.awbRegions</a></li>
143 <li><a href="#controls_android.control.captureIntent">android.control.captureIntent</a></li>
144 <li><a href="#controls_android.control.effectMode">android.control.effectMode</a></li>
145 <li><a href="#controls_android.control.mode">android.control.mode</a></li>
146 <li><a href="#controls_android.control.sceneMode">android.control.sceneMode</a></li>
147 <li><a href="#controls_android.control.videoStabilizationMode">android.control.videoStabilizationMode</a></li>
148 </ul>
149 </li>
150 <li>
151 <span class="toc_kind_header">static</span>
152 <ul class="toc_section">
153 <li><a href="#static_android.control.aeAvailableAntibandingModes">android.control.aeAvailableAntibandingModes</a></li>
154 <li><a href="#static_android.control.aeAvailableModes">android.control.aeAvailableModes</a></li>
155 <li><a href="#static_android.control.aeAvailableTargetFpsRanges">android.control.aeAvailableTargetFpsRanges</a></li>
156 <li><a href="#static_android.control.aeCompensationRange">android.control.aeCompensationRange</a></li>
157 <li><a href="#static_android.control.aeCompensationStep">android.control.aeCompensationStep</a></li>
158 <li><a href="#static_android.control.afAvailableModes">android.control.afAvailableModes</a></li>
159 <li><a href="#static_android.control.availableEffects">android.control.availableEffects</a></li>
160 <li><a href="#static_android.control.availableSceneModes">android.control.availableSceneModes</a></li>
161 <li><a href="#static_android.control.availableVideoStabilizationModes">android.control.availableVideoStabilizationModes</a></li>
162 <li><a href="#static_android.control.awbAvailableModes">android.control.awbAvailableModes</a></li>
163 <li><a href="#static_android.control.maxRegions">android.control.maxRegions</a></li>
164 <li><a href="#static_android.control.sceneModeOverrides">android.control.sceneModeOverrides</a></li>
165 </ul>
166 </li>
167 <li>
168 <span class="toc_kind_header">dynamic</span>
169 <ul class="toc_section">
170 <li><a href="#dynamic_android.control.aePrecaptureId">android.control.aePrecaptureId</a></li>
171 <li><a href="#dynamic_android.control.aeRegions">android.control.aeRegions</a></li>
172 <li><a href="#dynamic_android.control.aeState">android.control.aeState</a></li>
173 <li><a href="#dynamic_android.control.afMode">android.control.afMode</a></li>
174 <li><a href="#dynamic_android.control.afRegions">android.control.afRegions</a></li>
175 <li><a href="#dynamic_android.control.afState">android.control.afState</a></li>
176 <li><a href="#dynamic_android.control.afTriggerId">android.control.afTriggerId</a></li>
177 <li><a href="#dynamic_android.control.awbMode">android.control.awbMode</a></li>
178 <li><a href="#dynamic_android.control.awbRegions">android.control.awbRegions</a></li>
179 <li><a href="#dynamic_android.control.awbState">android.control.awbState</a></li>
180 <li><a href="#dynamic_android.control.mode">android.control.mode</a></li>
181 </ul>
182 </li>
183 </ul> <!-- toc_section -->
184 </li>
185 <li>
186 <span class="toc_section_header"><a href="#section_demosaic">demosaic</a></span>
187 <ul class="toc_section">
188 <li>
189 <span class="toc_kind_header">controls</span>
190 <ul class="toc_section">
191 <li><a href="#controls_android.demosaic.mode">android.demosaic.mode</a></li>
192 </ul>
193 </li>
194 </ul> <!-- toc_section -->
195 </li>
196 <li>
197 <span class="toc_section_header"><a href="#section_edge">edge</a></span>
198 <ul class="toc_section">
199 <li>
200 <span class="toc_kind_header">controls</span>
201 <ul class="toc_section">
202 <li><a href="#controls_android.edge.mode">android.edge.mode</a></li>
203 <li><a href="#controls_android.edge.strength">android.edge.strength</a></li>
204 </ul>
205 </li>
206 <li>
207 <span class="toc_kind_header">dynamic</span>
208 <ul class="toc_section">
209 <li><a href="#dynamic_android.edge.mode">android.edge.mode</a></li>
210 </ul>
211 </li>
212 </ul> <!-- toc_section -->
213 </li>
214 <li>
215 <span class="toc_section_header"><a href="#section_flash">flash</a></span>
216 <ul class="toc_section">
217 <li>
218 <span class="toc_kind_header">controls</span>
219 <ul class="toc_section">
220 <li><a href="#controls_android.flash.firingPower">android.flash.firingPower</a></li>
221 <li><a href="#controls_android.flash.firingTime">android.flash.firingTime</a></li>
222 <li><a href="#controls_android.flash.mode">android.flash.mode</a></li>
223 </ul>
224 </li>
225 <li>
226 <span class="toc_kind_header">static</span>
227 <ul class="toc_section">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]228
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]229 <li><a href="#static_android.flash.info.available">android.flash.info.available</a></li>
230 <li><a href="#static_android.flash.info.chargeDuration">android.flash.info.chargeDuration</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]231
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]232 <li><a href="#static_android.flash.colorTemperature">android.flash.colorTemperature</a></li>
233 <li><a href="#static_android.flash.maxEnergy">android.flash.maxEnergy</a></li>
234 </ul>
235 </li>
236 <li>
237 <span class="toc_kind_header">dynamic</span>
238 <ul class="toc_section">
239 <li><a href="#dynamic_android.flash.firingPower">android.flash.firingPower</a></li>
240 <li><a href="#dynamic_android.flash.firingTime">android.flash.firingTime</a></li>
241 <li><a href="#dynamic_android.flash.mode">android.flash.mode</a></li>
242 <li><a href="#dynamic_android.flash.state">android.flash.state</a></li>
243 </ul>
244 </li>
245 </ul> <!-- toc_section -->
246 </li>
247 <li>
248 <span class="toc_section_header"><a href="#section_geometric">geometric</a></span>
249 <ul class="toc_section">
250 <li>
251 <span class="toc_kind_header">controls</span>
252 <ul class="toc_section">
253 <li><a href="#controls_android.geometric.mode">android.geometric.mode</a></li>
254 <li><a href="#controls_android.geometric.strength">android.geometric.strength</a></li>
255 </ul>
256 </li>
257 </ul> <!-- toc_section -->
258 </li>
259 <li>
260 <span class="toc_section_header"><a href="#section_hotPixel">hotPixel</a></span>
261 <ul class="toc_section">
262 <li>
263 <span class="toc_kind_header">controls</span>
264 <ul class="toc_section">
265 <li><a href="#controls_android.hotPixel.mode">android.hotPixel.mode</a></li>
266 </ul>
267 </li>
268 <li>
269 <span class="toc_kind_header">static</span>
270 <ul class="toc_section">
271
272 <li><a href="#static_android.hotPixel.info.map">android.hotPixel.info.map</a></li>
273
274 </ul>
275 </li>
276 <li>
277 <span class="toc_kind_header">dynamic</span>
278 <ul class="toc_section">
279 <li><a href="#dynamic_android.hotPixel.mode">android.hotPixel.mode</a></li>
280 </ul>
281 </li>
282 </ul> <!-- toc_section -->
283 </li>
284 <li>
285 <span class="toc_section_header"><a href="#section_jpeg">jpeg</a></span>
286 <ul class="toc_section">
287 <li>
288 <span class="toc_kind_header">controls</span>
289 <ul class="toc_section">
290 <li><a href="#controls_android.jpeg.gpsCoordinates">android.jpeg.gpsCoordinates</a></li>
291 <li><a href="#controls_android.jpeg.gpsProcessingMethod">android.jpeg.gpsProcessingMethod</a></li>
292 <li><a href="#controls_android.jpeg.gpsTimestamp">android.jpeg.gpsTimestamp</a></li>
293 <li><a href="#controls_android.jpeg.orientation">android.jpeg.orientation</a></li>
294 <li><a href="#controls_android.jpeg.quality">android.jpeg.quality</a></li>
295 <li><a href="#controls_android.jpeg.thumbnailQuality">android.jpeg.thumbnailQuality</a></li>
296 <li><a href="#controls_android.jpeg.thumbnailSize">android.jpeg.thumbnailSize</a></li>
297 </ul>
298 </li>
299 <li>
300 <span class="toc_kind_header">static</span>
301 <ul class="toc_section">
302 <li><a href="#static_android.jpeg.availableThumbnailSizes">android.jpeg.availableThumbnailSizes</a></li>
303 <li><a href="#static_android.jpeg.maxSize">android.jpeg.maxSize</a></li>
304 </ul>
305 </li>
306 <li>
307 <span class="toc_kind_header">dynamic</span>
308 <ul class="toc_section">
309 <li><a href="#dynamic_android.jpeg.gpsCoordinates">android.jpeg.gpsCoordinates</a></li>
310 <li><a href="#dynamic_android.jpeg.gpsProcessingMethod">android.jpeg.gpsProcessingMethod</a></li>
311 <li><a href="#dynamic_android.jpeg.gpsTimestamp">android.jpeg.gpsTimestamp</a></li>
312 <li><a href="#dynamic_android.jpeg.orientation">android.jpeg.orientation</a></li>
313 <li><a href="#dynamic_android.jpeg.quality">android.jpeg.quality</a></li>
314 <li><a href="#dynamic_android.jpeg.size">android.jpeg.size</a></li>
315 <li><a href="#dynamic_android.jpeg.thumbnailQuality">android.jpeg.thumbnailQuality</a></li>
316 <li><a href="#dynamic_android.jpeg.thumbnailSize">android.jpeg.thumbnailSize</a></li>
317 </ul>
318 </li>
319 </ul> <!-- toc_section -->
320 </li>
321 <li>
322 <span class="toc_section_header"><a href="#section_lens">lens</a></span>
323 <ul class="toc_section">
324 <li>
325 <span class="toc_kind_header">controls</span>
326 <ul class="toc_section">
327 <li><a href="#controls_android.lens.aperture">android.lens.aperture</a></li>
328 <li><a href="#controls_android.lens.filterDensity">android.lens.filterDensity</a></li>
329 <li><a href="#controls_android.lens.focalLength">android.lens.focalLength</a></li>
330 <li><a href="#controls_android.lens.focusDistance">android.lens.focusDistance</a></li>
331 <li><a href="#controls_android.lens.opticalStabilizationMode">android.lens.opticalStabilizationMode</a></li>
332 </ul>
333 </li>
334 <li>
335 <span class="toc_kind_header">static</span>
336 <ul class="toc_section">
337
338 <li><a href="#static_android.lens.info.availableApertures">android.lens.info.availableApertures</a></li>
339 <li><a href="#static_android.lens.info.availableFilterDensities">android.lens.info.availableFilterDensities</a></li>
340 <li><a href="#static_android.lens.info.availableFocalLengths">android.lens.info.availableFocalLengths</a></li>
341 <li><a href="#static_android.lens.info.availableOpticalStabilization">android.lens.info.availableOpticalStabilization</a></li>
342 <li><a href="#static_android.lens.info.geometricCorrectionMap">android.lens.info.geometricCorrectionMap</a></li>
343 <li><a href="#static_android.lens.info.geometricCorrectionMapSize">android.lens.info.geometricCorrectionMapSize</a></li>
344 <li><a href="#static_android.lens.info.hyperfocalDistance">android.lens.info.hyperfocalDistance</a></li>
345 <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]346 <li><a href="#static_android.lens.info.shadingMapSize">android.lens.info.shadingMapSize</a></li>
347
348 <li><a href="#static_android.lens.facing">android.lens.facing</a></li>
349 <li><a href="#static_android.lens.opticalAxisAngle">android.lens.opticalAxisAngle</a></li>
350 <li><a href="#static_android.lens.position">android.lens.position</a></li>
351 </ul>
352 </li>
353 <li>
354 <span class="toc_kind_header">dynamic</span>
355 <ul class="toc_section">
356 <li><a href="#dynamic_android.lens.aperture">android.lens.aperture</a></li>
357 <li><a href="#dynamic_android.lens.filterDensity">android.lens.filterDensity</a></li>
358 <li><a href="#dynamic_android.lens.focalLength">android.lens.focalLength</a></li>
359 <li><a href="#dynamic_android.lens.focusDistance">android.lens.focusDistance</a></li>
360 <li><a href="#dynamic_android.lens.focusRange">android.lens.focusRange</a></li>
361 <li><a href="#dynamic_android.lens.opticalStabilizationMode">android.lens.opticalStabilizationMode</a></li>
362 <li><a href="#dynamic_android.lens.state">android.lens.state</a></li>
363 </ul>
364 </li>
365 </ul> <!-- toc_section -->
366 </li>
367 <li>
368 <span class="toc_section_header"><a href="#section_noiseReduction">noiseReduction</a></span>
369 <ul class="toc_section">
370 <li>
371 <span class="toc_kind_header">controls</span>
372 <ul class="toc_section">
373 <li><a href="#controls_android.noiseReduction.mode">android.noiseReduction.mode</a></li>
374 <li><a href="#controls_android.noiseReduction.strength">android.noiseReduction.strength</a></li>
375 </ul>
376 </li>
377 <li>
378 <span class="toc_kind_header">dynamic</span>
379 <ul class="toc_section">
380 <li><a href="#dynamic_android.noiseReduction.mode">android.noiseReduction.mode</a></li>
381 </ul>
382 </li>
383 </ul> <!-- toc_section -->
384 </li>
385 <li>
386 <span class="toc_section_header"><a href="#section_quirks">quirks</a></span>
387 <ul class="toc_section">
388 <li>
389 <span class="toc_kind_header">static</span>
390 <ul class="toc_section">
391 <li><a href="#static_android.quirks.meteringCropRegion">android.quirks.meteringCropRegion</a></li>
392 <li><a href="#static_android.quirks.triggerAfWithAuto">android.quirks.triggerAfWithAuto</a></li>
393 <li><a href="#static_android.quirks.useZslFormat">android.quirks.useZslFormat</a></li>
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]394 <li><a href="#static_android.quirks.usePartialResult">android.quirks.usePartialResult</a></li>
395 </ul>
396 </li>
397 <li>
398 <span class="toc_kind_header">dynamic</span>
399 <ul class="toc_section">
400 <li><a href="#dynamic_android.quirks.partialResult">android.quirks.partialResult</a></li>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]401 </ul>
402 </li>
403 </ul> <!-- toc_section -->
404 </li>
405 <li>
406 <span class="toc_section_header"><a href="#section_request">request</a></span>
407 <ul class="toc_section">
408 <li>
409 <span class="toc_kind_header">controls</span>
410 <ul class="toc_section">
411 <li><a href="#controls_android.request.frameCount">android.request.frameCount</a></li>
412 <li><a href="#controls_android.request.id">android.request.id</a></li>
413 <li><a href="#controls_android.request.inputStreams">android.request.inputStreams</a></li>
414 <li><a href="#controls_android.request.metadataMode">android.request.metadataMode</a></li>
415 <li><a href="#controls_android.request.outputStreams">android.request.outputStreams</a></li>
416 <li><a href="#controls_android.request.type">android.request.type</a></li>
417 </ul>
418 </li>
419 <li>
420 <span class="toc_kind_header">static</span>
421 <ul class="toc_section">
422 <li><a href="#static_android.request.maxNumOutputStreams">android.request.maxNumOutputStreams</a></li>
423 <li><a href="#static_android.request.maxNumReprocessStreams">android.request.maxNumReprocessStreams</a></li>
424 </ul>
425 </li>
426 <li>
427 <span class="toc_kind_header">dynamic</span>
428 <ul class="toc_section">
429 <li><a href="#dynamic_android.request.frameCount">android.request.frameCount</a></li>
430 <li><a href="#dynamic_android.request.id">android.request.id</a></li>
431 <li><a href="#dynamic_android.request.metadataMode">android.request.metadataMode</a></li>
432 <li><a href="#dynamic_android.request.outputStreams">android.request.outputStreams</a></li>
433 </ul>
434 </li>
435 </ul> <!-- toc_section -->
436 </li>
437 <li>
438 <span class="toc_section_header"><a href="#section_scaler">scaler</a></span>
439 <ul class="toc_section">
440 <li>
441 <span class="toc_kind_header">controls</span>
442 <ul class="toc_section">
443 <li><a href="#controls_android.scaler.cropRegion">android.scaler.cropRegion</a></li>
444 </ul>
445 </li>
446 <li>
447 <span class="toc_kind_header">static</span>
448 <ul class="toc_section">
449 <li><a href="#static_android.scaler.availableFormats">android.scaler.availableFormats</a></li>
450 <li><a href="#static_android.scaler.availableJpegMinDurations">android.scaler.availableJpegMinDurations</a></li>
451 <li><a href="#static_android.scaler.availableJpegSizes">android.scaler.availableJpegSizes</a></li>
452 <li><a href="#static_android.scaler.availableMaxDigitalZoom">android.scaler.availableMaxDigitalZoom</a></li>
453 <li><a href="#static_android.scaler.availableProcessedMinDurations">android.scaler.availableProcessedMinDurations</a></li>
454 <li><a href="#static_android.scaler.availableProcessedSizes">android.scaler.availableProcessedSizes</a></li>
455 <li><a href="#static_android.scaler.availableRawMinDurations">android.scaler.availableRawMinDurations</a></li>
456 <li><a href="#static_android.scaler.availableRawSizes">android.scaler.availableRawSizes</a></li>
457 </ul>
458 </li>
459 <li>
460 <span class="toc_kind_header">dynamic</span>
461 <ul class="toc_section">
462 <li><a href="#dynamic_android.scaler.cropRegion">android.scaler.cropRegion</a></li>
463 </ul>
464 </li>
465 </ul> <!-- toc_section -->
466 </li>
467 <li>
468 <span class="toc_section_header"><a href="#section_sensor">sensor</a></span>
469 <ul class="toc_section">
470 <li>
471 <span class="toc_kind_header">controls</span>
472 <ul class="toc_section">
473 <li><a href="#controls_android.sensor.exposureTime">android.sensor.exposureTime</a></li>
474 <li><a href="#controls_android.sensor.frameDuration">android.sensor.frameDuration</a></li>
475 <li><a href="#controls_android.sensor.sensitivity">android.sensor.sensitivity</a></li>
476 </ul>
477 </li>
478 <li>
479 <span class="toc_kind_header">static</span>
480 <ul class="toc_section">
481
482 <li><a href="#static_android.sensor.info.activeArraySize">android.sensor.info.activeArraySize</a></li>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]483 <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]484 <li><a href="#static_android.sensor.info.colorFilterArrangement">android.sensor.info.colorFilterArrangement</a></li>
485 <li><a href="#static_android.sensor.info.exposureTimeRange">android.sensor.info.exposureTimeRange</a></li>
486 <li><a href="#static_android.sensor.info.maxFrameDuration">android.sensor.info.maxFrameDuration</a></li>
487 <li><a href="#static_android.sensor.info.physicalSize">android.sensor.info.physicalSize</a></li>
488 <li><a href="#static_android.sensor.info.pixelArraySize">android.sensor.info.pixelArraySize</a></li>
489 <li><a href="#static_android.sensor.info.whiteLevel">android.sensor.info.whiteLevel</a></li>
490
491 <li><a href="#static_android.sensor.baseGainFactor">android.sensor.baseGainFactor</a></li>
492 <li><a href="#static_android.sensor.blackLevelPattern">android.sensor.blackLevelPattern</a></li>
493 <li><a href="#static_android.sensor.calibrationTransform1">android.sensor.calibrationTransform1</a></li>
494 <li><a href="#static_android.sensor.calibrationTransform2">android.sensor.calibrationTransform2</a></li>
495 <li><a href="#static_android.sensor.colorTransform1">android.sensor.colorTransform1</a></li>
496 <li><a href="#static_android.sensor.colorTransform2">android.sensor.colorTransform2</a></li>
497 <li><a href="#static_android.sensor.forwardMatrix1">android.sensor.forwardMatrix1</a></li>
498 <li><a href="#static_android.sensor.forwardMatrix2">android.sensor.forwardMatrix2</a></li>
499 <li><a href="#static_android.sensor.maxAnalogSensitivity">android.sensor.maxAnalogSensitivity</a></li>
500 <li><a href="#static_android.sensor.noiseModelCoefficients">android.sensor.noiseModelCoefficients</a></li>
501 <li><a href="#static_android.sensor.orientation">android.sensor.orientation</a></li>
502 <li><a href="#static_android.sensor.referenceIlluminant1">android.sensor.referenceIlluminant1</a></li>
503 <li><a href="#static_android.sensor.referenceIlluminant2">android.sensor.referenceIlluminant2</a></li>
504 </ul>
505 </li>
506 <li>
507 <span class="toc_kind_header">dynamic</span>
508 <ul class="toc_section">
509 <li><a href="#dynamic_android.sensor.exposureTime">android.sensor.exposureTime</a></li>
510 <li><a href="#dynamic_android.sensor.frameDuration">android.sensor.frameDuration</a></li>
511 <li><a href="#dynamic_android.sensor.sensitivity">android.sensor.sensitivity</a></li>
512 <li><a href="#dynamic_android.sensor.timestamp">android.sensor.timestamp</a></li>
Igor Murashkin656aa5a2013-08-13 14:23:39 -0700[diff] [blame]513 <li><a href="#dynamic_android.sensor.temperature">android.sensor.temperature</a></li>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]514 </ul>
515 </li>
516 </ul> <!-- toc_section -->
517 </li>
518 <li>
519 <span class="toc_section_header"><a href="#section_shading">shading</a></span>
520 <ul class="toc_section">
521 <li>
522 <span class="toc_kind_header">controls</span>
523 <ul class="toc_section">
524 <li><a href="#controls_android.shading.mode">android.shading.mode</a></li>
525 <li><a href="#controls_android.shading.strength">android.shading.strength</a></li>
526 </ul>
527 </li>
528 <li>
529 <span class="toc_kind_header">dynamic</span>
530 <ul class="toc_section">
531 <li><a href="#dynamic_android.shading.mode">android.shading.mode</a></li>
532 </ul>
533 </li>
534 </ul> <!-- toc_section -->
535 </li>
536 <li>
537 <span class="toc_section_header"><a href="#section_statistics">statistics</a></span>
538 <ul class="toc_section">
539 <li>
540 <span class="toc_kind_header">controls</span>
541 <ul class="toc_section">
542 <li><a href="#controls_android.statistics.faceDetectMode">android.statistics.faceDetectMode</a></li>
543 <li><a href="#controls_android.statistics.histogramMode">android.statistics.histogramMode</a></li>
544 <li><a href="#controls_android.statistics.sharpnessMapMode">android.statistics.sharpnessMapMode</a></li>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]545 <li><a href="#controls_android.statistics.lensShadingMapMode">android.statistics.lensShadingMapMode</a></li>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]546 </ul>
547 </li>
548 <li>
549 <span class="toc_kind_header">static</span>
550 <ul class="toc_section">
551
552 <li><a href="#static_android.statistics.info.availableFaceDetectModes">android.statistics.info.availableFaceDetectModes</a></li>
553 <li><a href="#static_android.statistics.info.histogramBucketCount">android.statistics.info.histogramBucketCount</a></li>
554 <li><a href="#static_android.statistics.info.maxFaceCount">android.statistics.info.maxFaceCount</a></li>
555 <li><a href="#static_android.statistics.info.maxHistogramCount">android.statistics.info.maxHistogramCount</a></li>
556 <li><a href="#static_android.statistics.info.maxSharpnessMapValue">android.statistics.info.maxSharpnessMapValue</a></li>
557 <li><a href="#static_android.statistics.info.sharpnessMapSize">android.statistics.info.sharpnessMapSize</a></li>
558
559 </ul>
560 </li>
561 <li>
562 <span class="toc_kind_header">dynamic</span>
563 <ul class="toc_section">
564 <li><a href="#dynamic_android.statistics.faceDetectMode">android.statistics.faceDetectMode</a></li>
565 <li><a href="#dynamic_android.statistics.faceIds">android.statistics.faceIds</a></li>
566 <li><a href="#dynamic_android.statistics.faceLandmarks">android.statistics.faceLandmarks</a></li>
567 <li><a href="#dynamic_android.statistics.faceRectangles">android.statistics.faceRectangles</a></li>
568 <li><a href="#dynamic_android.statistics.faceScores">android.statistics.faceScores</a></li>
569 <li><a href="#dynamic_android.statistics.histogram">android.statistics.histogram</a></li>
570 <li><a href="#dynamic_android.statistics.histogramMode">android.statistics.histogramMode</a></li>
571 <li><a href="#dynamic_android.statistics.sharpnessMap">android.statistics.sharpnessMap</a></li>
572 <li><a href="#dynamic_android.statistics.sharpnessMapMode">android.statistics.sharpnessMapMode</a></li>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]573 <li><a href="#dynamic_android.statistics.lensShadingMap">android.statistics.lensShadingMap</a></li>
574 <li><a href="#dynamic_android.statistics.predictedColorGains">android.statistics.predictedColorGains</a></li>
575 <li><a href="#dynamic_android.statistics.predictedColorTransform">android.statistics.predictedColorTransform</a></li>
576 <li><a href="#dynamic_android.statistics.sceneFlicker">android.statistics.sceneFlicker</a></li>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]577 </ul>
578 </li>
579 </ul> <!-- toc_section -->
580 </li>
581 <li>
582 <span class="toc_section_header"><a href="#section_tonemap">tonemap</a></span>
583 <ul class="toc_section">
584 <li>
585 <span class="toc_kind_header">controls</span>
586 <ul class="toc_section">
587 <li><a href="#controls_android.tonemap.curveBlue">android.tonemap.curveBlue</a></li>
588 <li><a href="#controls_android.tonemap.curveGreen">android.tonemap.curveGreen</a></li>
589 <li><a href="#controls_android.tonemap.curveRed">android.tonemap.curveRed</a></li>
590 <li><a href="#controls_android.tonemap.mode">android.tonemap.mode</a></li>
591 </ul>
592 </li>
593 <li>
594 <span class="toc_kind_header">static</span>
595 <ul class="toc_section">
596 <li><a href="#static_android.tonemap.maxCurvePoints">android.tonemap.maxCurvePoints</a></li>
597 </ul>
598 </li>
599 <li>
600 <span class="toc_kind_header">dynamic</span>
601 <ul class="toc_section">
602 <li><a href="#dynamic_android.tonemap.curveBlue">android.tonemap.curveBlue</a></li>
603 <li><a href="#dynamic_android.tonemap.curveGreen">android.tonemap.curveGreen</a></li>
604 <li><a href="#dynamic_android.tonemap.curveRed">android.tonemap.curveRed</a></li>
605 <li><a href="#dynamic_android.tonemap.mode">android.tonemap.mode</a></li>
606 </ul>
607 </li>
608 </ul> <!-- toc_section -->
609 </li>
610 <li>
611 <span class="toc_section_header"><a href="#section_led">led</a></span>
612 <ul class="toc_section">
613 <li>
614 <span class="toc_kind_header">controls</span>
615 <ul class="toc_section">
616 <li><a href="#controls_android.led.transmit">android.led.transmit</a></li>
617 </ul>
618 </li>
619 <li>
620 <span class="toc_kind_header">dynamic</span>
621 <ul class="toc_section">
622 <li><a href="#dynamic_android.led.transmit">android.led.transmit</a></li>
623 </ul>
624 </li>
625 <li>
626 <span class="toc_kind_header">static</span>
627 <ul class="toc_section">
628 <li><a href="#static_android.led.availableLeds">android.led.availableLeds</a></li>
629 </ul>
630 </li>
631 </ul> <!-- toc_section -->
632 </li>
633 <li>
634 <span class="toc_section_header"><a href="#section_info">info</a></span>
635 <ul class="toc_section">
636 <li>
637 <span class="toc_kind_header">static</span>
638 <ul class="toc_section">
639 <li><a href="#static_android.info.supportedHardwareLevel">android.info.supportedHardwareLevel</a></li>
640 </ul>
641 </li>
642 </ul> <!-- toc_section -->
643 </li>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]644 <li>
645 <span class="toc_section_header"><a href="#section_blackLevel">blackLevel</a></span>
646 <ul class="toc_section">
647 <li>
648 <span class="toc_kind_header">controls</span>
649 <ul class="toc_section">
650 <li><a href="#controls_android.blackLevel.lock">android.blackLevel.lock</a></li>
651 </ul>
652 </li>
653 <li>
654 <span class="toc_kind_header">dynamic</span>
655 <ul class="toc_section">
656 <li><a href="#dynamic_android.blackLevel.lock">android.blackLevel.lock</a></li>
657 </ul>
658 </li>
659 </ul> <!-- toc_section -->
660 </li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]661 </ul>
662
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]663
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]664 <h1>Properties</h1>
665 <table class="properties">
666
667 <thead class="thead_dummy">
668 <tr>
669 <th class="th_name">Property Name</th>
670 <th class="th_type">Type</th>
671 <th class="th_description">Description</th>
672 <th class="th_units">Units</th>
673 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]674 <th class="th_tags">Tags</th>
675 </tr>
676 </thead> <!-- so that the first occurrence of thead is not
677 above the first occurrence of tr -->
678<!-- <namespace name="android"> -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]679 <tr><td colspan="6" id="section_colorCorrection" class="section">colorCorrection</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]680
681
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]682 <tr><td colspan="6" class="kind">controls</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]683
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]684 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]685 <tr>
686 <th class="th_name">Property Name</th>
687 <th class="th_type">Type</th>
688 <th class="th_description">Description</th>
689 <th class="th_units">Units</th>
690 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]691 <th class="th_tags">Tags</th>
692 </tr>
693 </thead>
694
695 <tbody>
696
697
698
699
700
701
702
703
704
705
706 <tr class="entry" id="controls_android.colorCorrection.mode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]707 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]708 android.<wbr/>color<wbr/>Correction.<wbr/>mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]709 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]710 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]711 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]712
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]713 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]714
715 <ul class="entry_type_enum">
716 <li>
717 <span class="entry_type_enum_name">TRANSFORM_MATRIX</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]718 <span class="entry_type_enum_notes">Use the android.<wbr/>color<wbr/>Correction.<wbr/>transform matrix
719 and android.<wbr/>color<wbr/>Correction.<wbr/>gains to do color conversion</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]720 </li>
721 <li>
722 <span class="entry_type_enum_name">FAST</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]723 <span class="entry_type_enum_notes">Must not slow down frame rate relative to raw
724 bayer output</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]725 </li>
726 <li>
727 <span class="entry_type_enum_name">HIGH_QUALITY</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]728 <span class="entry_type_enum_notes">Frame rate may be reduced by high
729 quality</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]730 </li>
731 </ul>
732
733 </td> <!-- entry_type -->
734
735 <td class="entry_description">
736 </td>
737
738 <td class="entry_units">
739 </td>
740
741 <td class="entry_range">
742 </td>
743
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]744 <td class="entry_tags">
745 </td>
746
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]747 </tr>
748 <tr class="entries_header">
749 <th class="th_details" colspan="5">Details</th>
750 </tr>
751 <tr class="entry_cont">
752 <td class="entry_details" colspan="5">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]753 <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]754should be ignored.<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]755 </td>
756 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]757
758
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]759 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
760 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]761
762
763 <tr class="entry" id="controls_android.colorCorrection.transform">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]764 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]765 android.<wbr/>color<wbr/>Correction.<wbr/>transform
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]766 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]767 <td class="entry_type">
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]768 <span class="entry_type_name">rational</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]769 <span class="entry_type_container">x</span>
770
771 <span class="entry_type_array">
772 3 x 3
773 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]774 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]775 <div class="entry_type_notes">3x3 rational matrix in row-major order</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]776
777
778 </td> <!-- entry_type -->
779
780 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]781 <p>A color transform matrix to use to transform
782from sensor RGB color space to output linear sRGB color space</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]783 </td>
784
785 <td class="entry_units">
786 </td>
787
788 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]789 <p>Output values are expected to be in the range
790(0,<wbr/>1)</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]791 </td>
792
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]793 <td class="entry_tags">
794 </td>
795
796 </tr>
797 <tr class="entries_header">
798 <th class="th_details" colspan="5">Details</th>
799 </tr>
800 <tr class="entry_cont">
801 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]802 <p>This matrix is either set by HAL when the request
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]803<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]804directly by the application in the request when the
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 TRANSFORM_<wbr/>MATRIX.<wbr/></p>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]806<p>In the latter case,<wbr/> the HAL may round the matrix to account
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]807for precision issues; the final rounded matrix should be
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]808reported back in this matrix result metadata.<wbr/></p>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]809 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]810 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]811
812
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]813 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
814 <!-- end of entry -->
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]815
816
817 <tr class="entry" id="controls_android.colorCorrection.gains">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]818 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]819 android.<wbr/>color<wbr/>Correction.<wbr/>gains
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]820 </td>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]821 <td class="entry_type">
822 <span class="entry_type_name">float</span>
823 <span class="entry_type_container">x</span>
824
825 <span class="entry_type_array">
826 4
827 </span>
828 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]829 <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]830
831
832 </td> <!-- entry_type -->
833
834 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]835 <p>Gains applying to Bayer color channels for
836white-balance</p>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]837 </td>
838
839 <td class="entry_units">
840 </td>
841
842 <td class="entry_range">
843 </td>
844
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]845 <td class="entry_tags">
846 </td>
847
848 </tr>
849 <tr class="entries_header">
850 <th class="th_details" colspan="5">Details</th>
851 </tr>
852 <tr class="entry_cont">
853 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]854 <p>The 4-channel white-balance gains are defined in
855the order of [R G_<wbr/>even G_<wbr/>odd B],<wbr/> where G_<wbr/>even is the gain
856for green pixels on even rows of the output,<wbr/> and G_<wbr/>odd
857is the gain for greenpixels on the odd rows.<wbr/> if a HAL
858does not support a separate gain for even/<wbr/>odd green channels,<wbr/>
859it should use the G_<wbr/>even value,<wbr/>and write G_<wbr/>odd equal to
860G_<wbr/>even in the output result metadata.<wbr/></p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]861<p>This array is either set by HAL when the request
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]862<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]863directly by the application in the request when the
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 TRANSFORM_<wbr/>MATRIX.<wbr/></p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]865<p>The ouput should be the gains actually applied by the HAL to
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]866the current frame.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]867 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]868 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]869
870
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]871 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
872 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]873
874
875
876 <!-- end of kind -->
877 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]878 <tr><td colspan="6" class="kind">dynamic</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]879
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]880 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]881 <tr>
882 <th class="th_name">Property Name</th>
883 <th class="th_type">Type</th>
884 <th class="th_description">Description</th>
885 <th class="th_units">Units</th>
886 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]887 <th class="th_tags">Tags</th>
888 </tr>
889 </thead>
890
891 <tbody>
892
893
894
895
896
897
898
899
900
901
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]902 <tr class="entry" id="dynamic_android.colorCorrection.transform">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]903 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]904 android.<wbr/>color<wbr/>Correction.<wbr/>transform
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]905 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]906 <td class="entry_type">
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]907 <span class="entry_type_name">rational</span>
908 <span class="entry_type_container">x</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]909
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]910 <span class="entry_type_array">
911 3 x 3
912 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]913 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]914 <div class="entry_type_notes">3x3 rational matrix in row-major order</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]915
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]916
917 </td> <!-- entry_type -->
918
919 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]920 <p>A color transform matrix to use to transform
921from sensor RGB color space to output linear sRGB color space</p>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]922 </td>
923
924 <td class="entry_units">
925 </td>
926
927 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]928 <p>Output values are expected to be in the range
929(0,<wbr/>1)</p>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]930 </td>
931
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]932 <td class="entry_tags">
933 </td>
934
935 </tr>
936 <tr class="entries_header">
937 <th class="th_details" colspan="5">Details</th>
938 </tr>
939 <tr class="entry_cont">
940 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]941 <p>This matrix is either set by HAL when the request
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]942<a href="#controls_android.colorCorrection.mode">android.<wbr/>color<wbr/>Correction.<wbr/>mode</a> is not TRANSFORM_<wbr/>MATRIX,<wbr/> or
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]943directly by the application in the request when the
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]944<a href="#controls_android.colorCorrection.mode">android.<wbr/>color<wbr/>Correction.<wbr/>mode</a> is TRANSFORM_<wbr/>MATRIX.<wbr/></p>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]945<p>In the latter case,<wbr/> the HAL may round the matrix to account
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]946for precision issues; the final rounded matrix should be
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]947reported back in this matrix result metadata.<wbr/></p>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]948 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]949 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]950
951
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]952 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
953 <!-- end of entry -->
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]954
955
956 <tr class="entry" id="dynamic_android.colorCorrection.gains">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]957 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]958 android.<wbr/>color<wbr/>Correction.<wbr/>gains
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]959 </td>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]960 <td class="entry_type">
961 <span class="entry_type_name">float</span>
962 <span class="entry_type_container">x</span>
963
964 <span class="entry_type_array">
965 4
966 </span>
967 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]968 <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]969
970
971 </td> <!-- entry_type -->
972
973 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]974 <p>Gains applying to Bayer color channels for
975white-balance</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]976 </td>
977
978 <td class="entry_units">
979 </td>
980
981 <td class="entry_range">
982 </td>
983
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]984 <td class="entry_tags">
985 </td>
986
987 </tr>
988 <tr class="entries_header">
989 <th class="th_details" colspan="5">Details</th>
990 </tr>
991 <tr class="entry_cont">
992 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]993 <p>The 4-channel white-balance gains are defined in
994the order of [R G_<wbr/>even G_<wbr/>odd B],<wbr/> where G_<wbr/>even is the gain
995for green pixels on even rows of the output,<wbr/> and G_<wbr/>odd
996is the gain for greenpixels on the odd rows.<wbr/> if a HAL
997does not support a separate gain for even/<wbr/>odd green channels,<wbr/>
998it should use the G_<wbr/>even value,<wbr/>and write G_<wbr/>odd equal to
999G_<wbr/>even in the output result metadata.<wbr/></p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]1000<p>This array is either set by HAL when the request
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]1001<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]1002directly by the application in the request when the
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 TRANSFORM_<wbr/>MATRIX.<wbr/></p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]1004<p>The ouput should be the gains actually applied by the HAL to
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1005the current frame.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1006 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1007 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1008
1009
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1010 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
1011 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1012
1013
1014
1015 <!-- end of kind -->
1016 </tbody>
1017
1018 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1019 <tr><td colspan="6" id="section_control" class="section">control</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1020
1021
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1022 <tr><td colspan="6" class="kind">controls</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1023
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]1024 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1025 <tr>
1026 <th class="th_name">Property Name</th>
1027 <th class="th_type">Type</th>
1028 <th class="th_description">Description</th>
1029 <th class="th_units">Units</th>
1030 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1031 <th class="th_tags">Tags</th>
1032 </tr>
1033 </thead>
1034
1035 <tbody>
1036
1037
1038
1039
1040
1041
1042
1043
1044
1045
1046 <tr class="entry" id="controls_android.control.aeAntibandingMode">
Eino-Ville Talvala19ce2c12013-12-30 12:03:45 -0800[diff] [blame]1047 <td class="entry_name" rowspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1048 android.<wbr/>control.<wbr/>ae<wbr/>Antibanding<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1049 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1050 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]1051 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1052
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]1053 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1054
1055 <ul class="entry_type_enum">
1056 <li>
1057 <span class="entry_type_enum_name">OFF</span>
Eino-Ville Talvala19ce2c12013-12-30 12:03:45 -0800[diff] [blame]1058 <span class="entry_type_enum_notes">
1059 The camera device will not adjust exposure duration to
1060 avoid banding problems.<wbr/>
1061 </span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1062 </li>
1063 <li>
1064 <span class="entry_type_enum_name">50HZ</span>
Eino-Ville Talvala19ce2c12013-12-30 12:03:45 -0800[diff] [blame]1065 <span class="entry_type_enum_notes">
1066 The camera device will adjust exposure duration to
1067 avoid banding problems with 50Hz illumination sources.<wbr/>
1068 </span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1069 </li>
1070 <li>
1071 <span class="entry_type_enum_name">60HZ</span>
Eino-Ville Talvala19ce2c12013-12-30 12:03:45 -0800[diff] [blame]1072 <span class="entry_type_enum_notes">
1073 The camera device will adjust exposure duration to
1074 avoid banding problems with 60Hz illumination
1075 sources.<wbr/>
1076 </span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1077 </li>
1078 <li>
1079 <span class="entry_type_enum_name">AUTO</span>
Eino-Ville Talvala19ce2c12013-12-30 12:03:45 -0800[diff] [blame]1080 <span class="entry_type_enum_notes">
1081 The camera device will automatically adapt its
1082 antibanding routine to the current illumination
1083 conditions.<wbr/> This is the default.<wbr/>
1084 </span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1085 </li>
1086 </ul>
1087
1088 </td> <!-- entry_type -->
1089
1090 <td class="entry_description">
Eino-Ville Talvala19ce2c12013-12-30 12:03:45 -0800[diff] [blame]1091 <p>The desired setting for the camera device's auto-exposure
1092algorithm's antibanding compensation.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1093 </td>
1094
1095 <td class="entry_units">
1096 </td>
1097
1098 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]1099 <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]1100 </td>
1101
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1102 <td class="entry_tags">
Eino-Ville Talvala19ce2c12013-12-30 12:03:45 -0800[diff] [blame]1103 <ul class="entry_tags">
1104 <li><a href="#tag_BC">BC</a></li>
1105 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1106 </td>
1107
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1108 </tr>
Eino-Ville Talvala19ce2c12013-12-30 12:03:45 -0800[diff] [blame]1109 <tr class="entries_header">
1110 <th class="th_details" colspan="5">Details</th>
1111 </tr>
1112 <tr class="entry_cont">
1113 <td class="entry_details" colspan="5">
1114 <p>Some kinds of lighting fixtures,<wbr/> such as some fluorescent
1115lights,<wbr/> flicker at the rate of the power supply frequency
1116(60Hz or 50Hz,<wbr/> depending on country).<wbr/> While this is
1117typically not noticeable to a person,<wbr/> it can be visible to
1118a camera device.<wbr/> If a camera sets its exposure time to the
1119wrong value,<wbr/> the flicker may become visible in the
1120viewfinder as flicker or in a final captured image,<wbr/> as a
1121set of variable-brightness bands across the image.<wbr/></p>
1122<p>Therefore,<wbr/> the auto-exposure routines of camera devices
1123include antibanding routines that ensure that the chosen
1124exposure value will not cause such banding.<wbr/> The choice of
1125exposure time depends on the rate of flicker,<wbr/> which the
1126camera device can detect automatically,<wbr/> or the expected
1127rate can be selected by the application using this
1128control.<wbr/></p>
1129<p>A given camera device may not support all of the possible
1130options for the antibanding mode.<wbr/> The
1131<a href="#static_android.control.aeAvailableAntibandingModes">android.<wbr/>control.<wbr/>ae<wbr/>Available<wbr/>Antibanding<wbr/>Modes</a> key contains
1132the available modes for a given camera device.<wbr/></p>
1133<p>The default mode is AUTO,<wbr/> which must be supported by all
1134camera devices.<wbr/></p>
1135<p>If manual exposure control is enabled (by setting
1136<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/>
1137then this setting has no effect,<wbr/> and the application must
1138ensure it selects exposure times that do not cause banding
1139issues.<wbr/> The <a href="#dynamic_android.statistics.sceneFlicker">android.<wbr/>statistics.<wbr/>scene<wbr/>Flicker</a> key can assist
1140the application in this.<wbr/></p>
1141 </td>
1142 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1143
Eino-Ville Talvala19ce2c12013-12-30 12:03:45 -0800[diff] [blame]1144 <tr class="entries_header">
1145 <th class="th_details" colspan="5">HAL Implementation Details</th>
1146 </tr>
1147 <tr class="entry_cont">
1148 <td class="entry_details" colspan="5">
1149 <p>For all capture request templates,<wbr/> this field must be set
1150to AUTO.<wbr/> AUTO is the only mode that must supported;
1151OFF,<wbr/> 50HZ,<wbr/> 60HZ are all optional.<wbr/></p>
1152<p>If manual exposure control is enabled (by setting
1153<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/>
1154then the exposure values provided by the application must not be
1155adjusted for antibanding.<wbr/></p>
1156 </td>
1157 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1158
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1159 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
1160 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1161
1162
1163 <tr class="entry" id="controls_android.control.aeExposureCompensation">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1164 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1165 android.<wbr/>control.<wbr/>ae<wbr/>Exposure<wbr/>Compensation
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1166 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1167 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]1168 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1169
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]1170 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1171
1172
1173 </td> <!-- entry_type -->
1174
1175 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1176 <p>Adjustment to AE target image
1177brightness</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1178 </td>
1179
1180 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1181 count of positive/<wbr/>negative EV steps
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1182 </td>
1183
1184 <td class="entry_range">
1185 </td>
1186
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1187 <td class="entry_tags">
1188 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]1189 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1190 </ul>
1191 </td>
1192
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1193 </tr>
1194 <tr class="entries_header">
1195 <th class="th_details" colspan="5">Details</th>
1196 </tr>
1197 <tr class="entry_cont">
1198 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1199 <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]1200exposure compensation of +2 EV; -3 will mean an exposure
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1201compensation of -1</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1202 </td>
1203 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1204
1205
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1206 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
1207 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1208
1209
1210 <tr class="entry" id="controls_android.control.aeLock">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1211 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1212 android.<wbr/>control.<wbr/>ae<wbr/>Lock
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1213 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1214 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]1215 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1216
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]1217 <span class="entry_type_visibility"> [public as boolean]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1218
1219 <ul class="entry_type_enum">
1220 <li>
Eino-Ville Talvala76548fe2013-01-11 13:57:19 -0800[diff] [blame]1221 <span class="entry_type_enum_name">OFF</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1222 <span class="entry_type_enum_notes">Autoexposure lock is disabled; the AE algorithm
1223 is free to update its parameters.<wbr/></span>
Eino-Ville Talvala76548fe2013-01-11 13:57:19 -0800[diff] [blame]1224 </li>
1225 <li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1226 <span class="entry_type_enum_name">ON</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1227 <span class="entry_type_enum_notes">Autoexposure lock is enabled; the AE algorithm
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1228 must not update the exposure and sensitivity parameters
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1229 while the lock is active</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1230 </li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1231 </ul>
1232
1233 </td> <!-- entry_type -->
1234
1235 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1236 <p>Whether AE is currently locked to its latest
1237calculated values</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1238 </td>
1239
1240 <td class="entry_units">
1241 </td>
1242
1243 <td class="entry_range">
1244 </td>
1245
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1246 <td class="entry_tags">
1247 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]1248 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1249 </ul>
1250 </td>
1251
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1252 </tr>
1253 <tr class="entries_header">
1254 <th class="th_details" colspan="5">Details</th>
1255 </tr>
1256 <tr class="entry_cont">
1257 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1258 <p>Note that even when AE is locked,<wbr/> the flash may be
1259fired if the AE mode is ON_<wbr/>AUTO_<wbr/>FLASH /<wbr/> ON_<wbr/>ALWAYS_<wbr/>FLASH /<wbr/>
1260ON_<wbr/>AUTO_<wbr/>FLASH_<wbr/>REDEYE.<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1261 </td>
1262 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1263
1264
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1265 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
1266 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1267
1268
1269 <tr class="entry" id="controls_android.control.aeMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1270 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1271 android.<wbr/>control.<wbr/>ae<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1272 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1273 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]1274 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1275
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]1276 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1277
1278 <ul class="entry_type_enum">
1279 <li>
1280 <span class="entry_type_enum_name">OFF</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1281 <span class="entry_type_enum_notes">Autoexposure is disabled; sensor.<wbr/>exposureTime,<wbr/>
1282 sensor.<wbr/>sensitivity and sensor.<wbr/>frameDuration are used</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1283 </li>
1284 <li>
1285 <span class="entry_type_enum_name">ON</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1286 <span class="entry_type_enum_notes">Autoexposure is active,<wbr/> no flash
1287 control</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1288 </li>
1289 <li>
1290 <span class="entry_type_enum_name">ON_AUTO_FLASH</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1291 <span class="entry_type_enum_notes">If autoexposure is active and flash exists,<wbr/> auto
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1292 flash control; flash may be fired when precapture
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1293 trigger is activated,<wbr/> and for captures for which
1294 captureIntent = STILL_<wbr/>CAPTURE</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1295 </li>
1296 <li>
1297 <span class="entry_type_enum_name">ON_ALWAYS_FLASH</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1298 <span class="entry_type_enum_notes">If autoexposure is active and flash exists,<wbr/> auto
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1299 flash control for precapture trigger and always flash
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1300 when captureIntent = STILL_<wbr/>CAPTURE</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1301 </li>
1302 <li>
1303 <span class="entry_type_enum_name">ON_AUTO_FLASH_REDEYE</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1304 <span class="entry_type_enum_notes">Optional.<wbr/> Automatic red eye reduction with flash.<wbr/>
1305 If deemed necessary,<wbr/> red eye reduction sequence should
1306 fire when precapture trigger is activated,<wbr/> and final
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1307 flash should fire when captureIntent =
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1308 STILL_<wbr/>CAPTURE</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1309 </li>
1310 </ul>
1311
1312 </td> <!-- entry_type -->
1313
1314 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1315 <p>Whether AE is currently updating the sensor
1316exposure and sensitivity fields</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1317 </td>
1318
1319 <td class="entry_units">
1320 </td>
1321
1322 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]1323 <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]1324 </td>
1325
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1326 <td class="entry_tags">
1327 <ul class="entry_tags">
1328 <li><a href="#tag_BC">BC</a></li>
1329 </ul>
1330 </td>
1331
1332 </tr>
1333 <tr class="entries_header">
1334 <th class="th_details" colspan="5">Details</th>
1335 </tr>
1336 <tr class="entry_cont">
1337 <td class="entry_details" colspan="5">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]1338 <p>Only effective if <a href="#controls_android.control.mode">android.<wbr/>control.<wbr/>mode</a> = AUTO.<wbr/></p>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1339<p>If auto-exposure is active,<wbr/> HAL auto-focus routine is enabled,<wbr/>
Zhijun Hef5529232013-12-13 17:48:53 -0800[diff] [blame]1340then HAL auto-exposure routine overrides the control variables
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1341that relate to auto-exposure routine,<wbr/> and these override values
1342are then available in the result metadata for that capture.<wbr/></p>
1343<p>For example,<wbr/> if auto-exposure is enabled in a request,<wbr/> the HAL should
1344overwrite the exposure,<wbr/> gain,<wbr/> and frame duration fields (and potentially
1345the flash fields,<wbr/> depending on AE mode) of the request.<wbr/> The overridden
1346values are then provided back to the user in the corresponding result.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1347 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1348 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1349
1350
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1351 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
1352 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1353
1354
1355 <tr class="entry" id="controls_android.control.aeRegions">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1356 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1357 android.<wbr/>control.<wbr/>ae<wbr/>Regions
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1358 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1359 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]1360 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1361 <span class="entry_type_container">x</span>
1362
1363 <span class="entry_type_array">
1364 5 x area_count
1365 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]1366 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1367
1368
1369 </td> <!-- entry_type -->
1370
1371 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1372 <p>List of areas to use for
1373metering</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1374 </td>
1375
1376 <td class="entry_units">
1377 </td>
1378
1379 <td class="entry_range">
1380 </td>
1381
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1382 <td class="entry_tags">
1383 <ul class="entry_tags">
1384 <li><a href="#tag_BC">BC</a></li>
1385 </ul>
1386 </td>
1387
1388 </tr>
1389 <tr class="entries_header">
1390 <th class="th_details" colspan="5">Details</th>
1391 </tr>
1392 <tr class="entry_cont">
1393 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1394 <p>Each area is a rectangle plus weight: xmin,<wbr/> ymin,<wbr/>
1395xmax,<wbr/> ymax,<wbr/> weight.<wbr/> The rectangle is defined inclusive of the
1396specified coordinates.<wbr/></p>
1397<p>The coordinate system is based on the active pixel array,<wbr/>
1398with (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]1399(<a href="#static_android.sensor.info.activeArraySize">android.<wbr/>sensor.<wbr/>info.<wbr/>active<wbr/>Array<wbr/>Size</a>.<wbr/>width - 1,<wbr/>
1400<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]1401bottom-right pixel in the active pixel array.<wbr/> The weight
1402should be nonnegative.<wbr/></p>
1403<p>If all regions have 0 weight,<wbr/> then no specific metering area
1404needs to be used by the HAL.<wbr/> If the metering region is
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]1405outside 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]1406should ignore the sections outside the region and output the
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1407used sections in the frame metadata</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1408 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1409 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1410
1411
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1412 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
1413 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1414
1415
1416 <tr class="entry" id="controls_android.control.aeTargetFpsRange">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1417 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1418 android.<wbr/>control.<wbr/>ae<wbr/>Target<wbr/>Fps<wbr/>Range
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1419 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1420 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]1421 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1422 <span class="entry_type_container">x</span>
1423
1424 <span class="entry_type_array">
1425 2
1426 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]1427 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1428
1429
1430 </td> <!-- entry_type -->
1431
1432 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1433 <p>Range over which fps can be adjusted to
1434maintain exposure</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1435 </td>
1436
1437 <td class="entry_units">
1438 </td>
1439
1440 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]1441 <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]1442 </td>
1443
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1444 <td class="entry_tags">
1445 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]1446 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1447 </ul>
1448 </td>
1449
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1450 </tr>
1451 <tr class="entries_header">
1452 <th class="th_details" colspan="5">Details</th>
1453 </tr>
1454 <tr class="entry_cont">
1455 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1456 <p>Only constrains AE algorithm,<wbr/> not manual control
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]1457of <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]1458 </td>
1459 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1460
1461
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1462 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
1463 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1464
1465
Eino-Ville Talvala3b4383a2013-03-18 09:42:48 -0700[diff] [blame]1466 <tr class="entry" id="controls_android.control.aePrecaptureTrigger">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1467 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1468 android.<wbr/>control.<wbr/>ae<wbr/>Precapture<wbr/>Trigger
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1469 </td>
Eino-Ville Talvala3b4383a2013-03-18 09:42:48 -0700[diff] [blame]1470 <td class="entry_type">
1471 <span class="entry_type_name entry_type_name_enum">byte</span>
1472
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]1473 <span class="entry_type_visibility"> [public]</span>
Eino-Ville Talvala3b4383a2013-03-18 09:42:48 -0700[diff] [blame]1474
1475 <ul class="entry_type_enum">
1476 <li>
1477 <span class="entry_type_enum_name">IDLE</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1478 <span class="entry_type_enum_notes">The trigger is idle.<wbr/></span>
Eino-Ville Talvala3b4383a2013-03-18 09:42:48 -0700[diff] [blame]1479 </li>
1480 <li>
1481 <span class="entry_type_enum_name">START</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1482 <span class="entry_type_enum_notes">The precapture metering sequence
1483 must be started.<wbr/> The exact effect of the precapture
Eino-Ville Talvala3b4383a2013-03-18 09:42:48 -0700[diff] [blame]1484 trigger depends on the current AE mode and
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1485 state.<wbr/></span>
Eino-Ville Talvala3b4383a2013-03-18 09:42:48 -0700[diff] [blame]1486 </li>
1487 </ul>
1488
1489 </td> <!-- entry_type -->
1490
1491 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1492 <p>Whether the HAL must trigger precapture
1493metering.<wbr/></p>
Eino-Ville Talvala3b4383a2013-03-18 09:42:48 -0700[diff] [blame]1494 </td>
1495
1496 <td class="entry_units">
1497 </td>
1498
1499 <td class="entry_range">
1500 </td>
1501
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1502 <td class="entry_tags">
1503 <ul class="entry_tags">
1504 <li><a href="#tag_BC">BC</a></li>
1505 </ul>
1506 </td>
1507
1508 </tr>
1509 <tr class="entries_header">
1510 <th class="th_details" colspan="5">Details</th>
1511 </tr>
1512 <tr class="entry_cont">
1513 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1514 <p>This entry is normally set to IDLE,<wbr/> or is not
1515included at all in the request settings.<wbr/> When included and
1516set to START,<wbr/> the HAL must trigger the autoexposure
1517precapture metering sequence.<wbr/></p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]1518<p>The effect of AE precapture trigger depends on the current
1519AE mode and state; see the camera HAL device v3 header for
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1520details.<wbr/></p>
Eino-Ville Talvala3b4383a2013-03-18 09:42:48 -0700[diff] [blame]1521 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1522 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1523
1524
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1525 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
1526 <!-- end of entry -->
Eino-Ville Talvala3b4383a2013-03-18 09:42:48 -0700[diff] [blame]1527
1528
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1529 <tr class="entry" id="controls_android.control.afMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1530 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1531 android.<wbr/>control.<wbr/>af<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1532 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1533 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]1534 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1535
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]1536 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1537
1538 <ul class="entry_type_enum">
1539 <li>
1540 <span class="entry_type_enum_name">OFF</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1541 <span class="entry_type_enum_notes">The auto-focus routine does not control the lens;
1542 android.<wbr/>lens.<wbr/>focus<wbr/>Distance is controlled by the
1543 application</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1544 </li>
1545 <li>
1546 <span class="entry_type_enum_name">AUTO</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1547 <span class="entry_type_enum_notes">
1548 If lens is not fixed focus.<wbr/>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]1549
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1550 Use android.<wbr/>lens.<wbr/>info.<wbr/>minimum<wbr/>Focus<wbr/>Distance to determine if lens
1551 is fixed-focus.<wbr/> In this mode,<wbr/> the lens does not move unless
1552 the autofocus trigger action is called.<wbr/> When that trigger
1553 is activated,<wbr/> AF must transition to ACTIVE_<wbr/>SCAN,<wbr/> then to
1554 the outcome of the scan (FOCUSED or NOT_<wbr/>FOCUSED).<wbr/>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]1555
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1556 Triggering AF_<wbr/>CANCEL resets the lens position to default,<wbr/>
1557 and sets the AF state to INACTIVE.<wbr/></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1558 </li>
1559 <li>
1560 <span class="entry_type_enum_name">MACRO</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1561 <span class="entry_type_enum_notes">In this mode,<wbr/> the lens does not move unless the
1562 autofocus trigger action is called.<wbr/>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]1563
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1564 When that trigger is activated,<wbr/> AF must transition to
1565 ACTIVE_<wbr/>SCAN,<wbr/> then to the outcome of the scan (FOCUSED or
1566 NOT_<wbr/>FOCUSED).<wbr/> Triggering cancel AF resets the lens
1567 position to default,<wbr/> and sets the AF state to
1568 INACTIVE.<wbr/></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1569 </li>
1570 <li>
1571 <span class="entry_type_enum_name">CONTINUOUS_VIDEO</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1572 <span class="entry_type_enum_notes">In this mode,<wbr/> the AF algorithm modifies the lens
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1573 position continually to attempt to provide a
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1574 constantly-in-focus image stream.<wbr/>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]1575
1576 The focusing behavior should be suitable for good quality
1577 video recording; typically this means slower focus
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1578 movement and no overshoots.<wbr/> When the AF trigger is not
1579 involved,<wbr/> the AF algorithm should start in INACTIVE state,<wbr/>
1580 and then transition into PASSIVE_<wbr/>SCAN and PASSIVE_<wbr/>FOCUSED
1581 states as appropriate.<wbr/> When the AF trigger is activated,<wbr/>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]1582 the algorithm should immediately transition into
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1583 AF_<wbr/>FOCUSED or AF_<wbr/>NOT_<wbr/>FOCUSED as appropriate,<wbr/> and lock the
1584 lens position until a cancel AF trigger is received.<wbr/>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]1585
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1586 Once cancel is received,<wbr/> the algorithm should transition
1587 back to INACTIVE and resume passive scan.<wbr/> Note that this
1588 behavior is not identical to CONTINUOUS_<wbr/>PICTURE,<wbr/> since an
1589 ongoing PASSIVE_<wbr/>SCAN must immediately be
1590 canceled.<wbr/></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1591 </li>
1592 <li>
1593 <span class="entry_type_enum_name">CONTINUOUS_PICTURE</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1594 <span class="entry_type_enum_notes">In this mode,<wbr/> the AF algorithm modifies the lens
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1595 position continually to attempt to provide a
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1596 constantly-in-focus image stream.<wbr/>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]1597
1598 The focusing behavior should be suitable for still image
1599 capture; typically this means focusing as fast as
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1600 possible.<wbr/> When the AF trigger is not involved,<wbr/> the AF
1601 algorithm should start in INACTIVE state,<wbr/> and then
1602 transition into PASSIVE_<wbr/>SCAN and PASSIVE_<wbr/>FOCUSED states as
1603 appropriate as it attempts to maintain focus.<wbr/> When the AF
1604 trigger is activated,<wbr/> the algorithm should finish its
1605 PASSIVE_<wbr/>SCAN if active,<wbr/> and then transition into
1606 AF_<wbr/>FOCUSED or AF_<wbr/>NOT_<wbr/>FOCUSED as appropriate,<wbr/> and lock the
1607 lens position until a cancel AF trigger is received.<wbr/>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]1608
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1609 When the AF cancel trigger is activated,<wbr/> the algorithm
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]1610 should transition back to INACTIVE and then act as if it
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1611 has just been started.<wbr/></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1612 </li>
1613 <li>
1614 <span class="entry_type_enum_name">EDOF</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1615 <span class="entry_type_enum_notes">Extended depth of field (digital focus).<wbr/> AF
1616 trigger is ignored,<wbr/> AF state should always be
1617 INACTIVE.<wbr/></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1618 </li>
1619 </ul>
1620
1621 </td> <!-- entry_type -->
1622
1623 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1624 <p>Whether AF is currently enabled,<wbr/> and what
1625mode it is set to</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1626 </td>
1627
1628 <td class="entry_units">
1629 </td>
1630
1631 <td class="entry_range">
1632 </td>
1633
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1634 <td class="entry_tags">
1635 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]1636 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1637 </ul>
1638 </td>
1639
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1640 </tr>
1641 <tr class="entries_header">
1642 <th class="th_details" colspan="5">Details</th>
1643 </tr>
1644 <tr class="entry_cont">
1645 <td class="entry_details" colspan="5">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]1646 <p>Only effective if <a href="#controls_android.control.mode">android.<wbr/>control.<wbr/>mode</a> = AUTO.<wbr/></p>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1647<p>If lens is controlled by HAL auto-focus algorithm,<wbr/> the HAL should
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]1648report the current AF status in <a href="#dynamic_android.control.afState">android.<wbr/>control.<wbr/>af<wbr/>State</a> in
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1649result metadata.<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1650 </td>
1651 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1652
1653
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1654 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
1655 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1656
1657
1658 <tr class="entry" id="controls_android.control.afRegions">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1659 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1660 android.<wbr/>control.<wbr/>af<wbr/>Regions
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1661 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1662 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]1663 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1664 <span class="entry_type_container">x</span>
1665
1666 <span class="entry_type_array">
1667 5 x area_count
1668 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]1669 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1670
1671
1672 </td> <!-- entry_type -->
1673
1674 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1675 <p>List of areas to use for focus
1676estimation</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1677 </td>
1678
1679 <td class="entry_units">
1680 </td>
1681
1682 <td class="entry_range">
1683 </td>
1684
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1685 <td class="entry_tags">
1686 <ul class="entry_tags">
1687 <li><a href="#tag_BC">BC</a></li>
1688 </ul>
1689 </td>
1690
1691 </tr>
1692 <tr class="entries_header">
1693 <th class="th_details" colspan="5">Details</th>
1694 </tr>
1695 <tr class="entry_cont">
1696 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1697 <p>Each area is a rectangle plus weight: xmin,<wbr/> ymin,<wbr/>
1698xmax,<wbr/> ymax,<wbr/> weight.<wbr/> The rectangle is defined inclusive of the
1699specified coordinates.<wbr/></p>
1700<p>The coordinate system is based on the active pixel array,<wbr/>
1701with (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]1702(<a href="#static_android.sensor.info.activeArraySize">android.<wbr/>sensor.<wbr/>info.<wbr/>active<wbr/>Array<wbr/>Size</a>.<wbr/>width - 1,<wbr/>
1703<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]1704bottom-right pixel in the active pixel array.<wbr/> The weight
1705should be nonnegative.<wbr/></p>
1706<p>If all regions have 0 weight,<wbr/> then no specific focus area
1707needs to be used by the HAL.<wbr/> If the focusing region is
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]1708outside 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]1709should ignore the sections outside the region and output the
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1710used sections in the frame metadata</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1711 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1712 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1713
1714
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1715 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
1716 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1717
1718
Eino-Ville Talvala3b4383a2013-03-18 09:42:48 -0700[diff] [blame]1719 <tr class="entry" id="controls_android.control.afTrigger">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1720 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1721 android.<wbr/>control.<wbr/>af<wbr/>Trigger
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1722 </td>
Eino-Ville Talvala3b4383a2013-03-18 09:42:48 -0700[diff] [blame]1723 <td class="entry_type">
1724 <span class="entry_type_name entry_type_name_enum">byte</span>
1725
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]1726 <span class="entry_type_visibility"> [public]</span>
Eino-Ville Talvala3b4383a2013-03-18 09:42:48 -0700[diff] [blame]1727
1728 <ul class="entry_type_enum">
1729 <li>
1730 <span class="entry_type_enum_name">IDLE</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1731 <span class="entry_type_enum_notes">The trigger is idle.<wbr/></span>
Eino-Ville Talvala3b4383a2013-03-18 09:42:48 -0700[diff] [blame]1732 </li>
1733 <li>
1734 <span class="entry_type_enum_name">START</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1735 <span class="entry_type_enum_notes">Autofocus must trigger now.<wbr/></span>
Eino-Ville Talvala3b4383a2013-03-18 09:42:48 -0700[diff] [blame]1736 </li>
1737 <li>
1738 <span class="entry_type_enum_name">CANCEL</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1739 <span class="entry_type_enum_notes">Autofocus must return to initial
1740 state,<wbr/> and cancel any active trigger.<wbr/></span>
Eino-Ville Talvala3b4383a2013-03-18 09:42:48 -0700[diff] [blame]1741 </li>
1742 </ul>
1743
1744 </td> <!-- entry_type -->
1745
1746 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1747 <p>Whether the HAL must trigger autofocus.<wbr/></p>
Eino-Ville Talvala3b4383a2013-03-18 09:42:48 -0700[diff] [blame]1748 </td>
1749
1750 <td class="entry_units">
1751 </td>
1752
1753 <td class="entry_range">
1754 </td>
1755
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1756 <td class="entry_tags">
1757 <ul class="entry_tags">
1758 <li><a href="#tag_BC">BC</a></li>
1759 </ul>
1760 </td>
1761
1762 </tr>
1763 <tr class="entries_header">
1764 <th class="th_details" colspan="5">Details</th>
1765 </tr>
1766 <tr class="entry_cont">
1767 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1768 <p>This entry is normally set to IDLE,<wbr/> or is not
1769included at all in the request settings.<wbr/></p>
1770<p>When included and set to START,<wbr/> the HAL must trigger the
1771autofocus algorithm.<wbr/> The effect of AF trigger depends on the
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]1772current AF mode and state; see the camera HAL device v3
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1773header for details.<wbr/> When set to CANCEL,<wbr/> the HAL must cancel
1774any active trigger,<wbr/> and return to initial AF state.<wbr/></p>
Eino-Ville Talvala3b4383a2013-03-18 09:42:48 -0700[diff] [blame]1775 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1776 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1777
1778
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1779 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
1780 <!-- end of entry -->
Eino-Ville Talvala3b4383a2013-03-18 09:42:48 -0700[diff] [blame]1781
1782
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1783 <tr class="entry" id="controls_android.control.awbLock">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1784 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1785 android.<wbr/>control.<wbr/>awb<wbr/>Lock
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1786 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1787 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]1788 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1789
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]1790 <span class="entry_type_visibility"> [public as boolean]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1791
1792 <ul class="entry_type_enum">
1793 <li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1794 <span class="entry_type_enum_name">OFF</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1795 <span class="entry_type_enum_notes">Auto-whitebalance lock is disabled; the AWB
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1796 algorithm is free to update its parameters if in AUTO
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1797 mode.<wbr/></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1798 </li>
Eino-Ville Talvala76548fe2013-01-11 13:57:19 -0800[diff] [blame]1799 <li>
1800 <span class="entry_type_enum_name">ON</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1801 <span class="entry_type_enum_notes">Auto-whitebalance lock is enabled; the AWB
Eino-Ville Talvala76548fe2013-01-11 13:57:19 -0800[diff] [blame]1802 algorithm must not update the exposure and sensitivity
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1803 parameters while the lock is active</span>
Eino-Ville Talvala76548fe2013-01-11 13:57:19 -0800[diff] [blame]1804 </li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1805 </ul>
1806
1807 </td> <!-- entry_type -->
1808
1809 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1810 <p>Whether AWB is currently locked to its
1811latest calculated values</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1812 </td>
1813
1814 <td class="entry_units">
1815 </td>
1816
1817 <td class="entry_range">
1818 </td>
1819
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1820 <td class="entry_tags">
1821 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]1822 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1823 </ul>
1824 </td>
1825
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1826 </tr>
1827 <tr class="entries_header">
1828 <th class="th_details" colspan="5">Details</th>
1829 </tr>
1830 <tr class="entry_cont">
1831 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1832 <p>Note that AWB lock is only meaningful for AUTO
1833mode; in other modes,<wbr/> AWB is already fixed to a specific
1834setting</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1835 </td>
1836 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1837
1838
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1839 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
1840 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1841
1842
1843 <tr class="entry" id="controls_android.control.awbMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1844 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1845 android.<wbr/>control.<wbr/>awb<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1846 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1847 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]1848 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1849
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]1850 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1851
1852 <ul class="entry_type_enum">
1853 <li>
1854 <span class="entry_type_enum_name">OFF</span>
1855 </li>
1856 <li>
1857 <span class="entry_type_enum_name">AUTO</span>
1858 </li>
1859 <li>
1860 <span class="entry_type_enum_name">INCANDESCENT</span>
1861 </li>
1862 <li>
1863 <span class="entry_type_enum_name">FLUORESCENT</span>
1864 </li>
1865 <li>
1866 <span class="entry_type_enum_name">WARM_FLUORESCENT</span>
1867 </li>
1868 <li>
1869 <span class="entry_type_enum_name">DAYLIGHT</span>
1870 </li>
1871 <li>
1872 <span class="entry_type_enum_name">CLOUDY_DAYLIGHT</span>
1873 </li>
1874 <li>
1875 <span class="entry_type_enum_name">TWILIGHT</span>
1876 </li>
1877 <li>
1878 <span class="entry_type_enum_name">SHADE</span>
1879 </li>
1880 </ul>
1881
1882 </td> <!-- entry_type -->
1883
1884 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1885 <p>Whether AWB is currently setting the color
1886transform fields,<wbr/> and what its illumination target
1887is</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1888 </td>
1889
1890 <td class="entry_units">
1891 </td>
1892
1893 <td class="entry_range">
1894 </td>
1895
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1896 <td class="entry_tags">
1897 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]1898 <li><a href="#tag_BC">BC</a></li>
1899 <li><a href="#tag_AWB">AWB</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1900 </ul>
1901 </td>
1902
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1903 </tr>
1904 <tr class="entries_header">
1905 <th class="th_details" colspan="5">Details</th>
1906 </tr>
1907 <tr class="entry_cont">
1908 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1909 <p>[BC - AWB lock,<wbr/>AWB modes]</p>
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]1910<p>Only effective if <a href="#controls_android.control.mode">android.<wbr/>control.<wbr/>mode</a> = AUTO.<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1911 </td>
1912 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1913
1914
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1915 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
1916 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1917
1918
1919 <tr class="entry" id="controls_android.control.awbRegions">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1920 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1921 android.<wbr/>control.<wbr/>awb<wbr/>Regions
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1922 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1923 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]1924 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1925 <span class="entry_type_container">x</span>
1926
1927 <span class="entry_type_array">
1928 5 x area_count
1929 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]1930 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1931
1932
1933 </td> <!-- entry_type -->
1934
1935 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1936 <p>List of areas to use for illuminant
1937estimation</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">
1944 </td>
1945
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1946 <td class="entry_tags">
1947 <ul class="entry_tags">
1948 <li><a href="#tag_BC">BC</a></li>
1949 </ul>
1950 </td>
1951
1952 </tr>
1953 <tr class="entries_header">
1954 <th class="th_details" colspan="5">Details</th>
1955 </tr>
1956 <tr class="entry_cont">
1957 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1958 <p>Only used in AUTO mode.<wbr/></p>
1959<p>Each area is a rectangle plus weight: xmin,<wbr/> ymin,<wbr/>
1960xmax,<wbr/> ymax,<wbr/> weight.<wbr/> The rectangle is defined inclusive of the
1961specified coordinates.<wbr/></p>
1962<p>The coordinate system is based on the active pixel array,<wbr/>
1963with (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]1964(<a href="#static_android.sensor.info.activeArraySize">android.<wbr/>sensor.<wbr/>info.<wbr/>active<wbr/>Array<wbr/>Size</a>.<wbr/>width - 1,<wbr/>
1965<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]1966bottom-right pixel in the active pixel array.<wbr/> The weight
1967should be nonnegative.<wbr/></p>
1968<p>If all regions have 0 weight,<wbr/> then no specific metering area
1969needs to be used by the HAL.<wbr/> If the metering region is
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]1970outside 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]1971should ignore the sections outside the region and output the
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1972used sections in the frame metadata</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1973 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1974 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1975
1976
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1977 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
1978 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1979
1980
1981 <tr class="entry" id="controls_android.control.captureIntent">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1982 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1983 android.<wbr/>control.<wbr/>capture<wbr/>Intent
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1984 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1985 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]1986 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1987
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]1988 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1989
1990 <ul class="entry_type_enum">
1991 <li>
1992 <span class="entry_type_enum_name">CUSTOM</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1993 <span class="entry_type_enum_notes">This request doesn't fall into the other
1994 categories.<wbr/> Default to preview-like
1995 behavior.<wbr/></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1996 </li>
1997 <li>
1998 <span class="entry_type_enum_name">PREVIEW</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1999 <span class="entry_type_enum_notes">This request is for a preview-like usecase.<wbr/> The
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2000 precapture trigger may be used to start off a metering
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2001 w/<wbr/>flash sequence</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2002 </li>
2003 <li>
2004 <span class="entry_type_enum_name">STILL_CAPTURE</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2005 <span class="entry_type_enum_notes">This request is for a still capture-type
2006 usecase.<wbr/></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2007 </li>
2008 <li>
2009 <span class="entry_type_enum_name">VIDEO_RECORD</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2010 <span class="entry_type_enum_notes">This request is for a video recording
2011 usecase.<wbr/></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2012 </li>
2013 <li>
2014 <span class="entry_type_enum_name">VIDEO_SNAPSHOT</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2015 <span class="entry_type_enum_notes">This request is for a video snapshot (still
2016 image while recording video) usecase</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2017 </li>
2018 <li>
2019 <span class="entry_type_enum_name">ZERO_SHUTTER_LAG</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2020 <span class="entry_type_enum_notes">This request is for a ZSL usecase; the
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2021 application will stream full-resolution images and
2022 reprocess one or several later for a final
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2023 capture</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2024 </li>
2025 </ul>
2026
2027 </td> <!-- entry_type -->
2028
2029 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2030 <p>Information to 3A routines about the purpose
2031of this capture,<wbr/> to help decide optimal 3A
2032strategy</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2033 </td>
2034
2035 <td class="entry_units">
2036 </td>
2037
2038 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]2039 <p>all must be supported</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2040 </td>
2041
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2042 <td class="entry_tags">
2043 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]2044 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2045 </ul>
2046 </td>
2047
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2048 </tr>
2049 <tr class="entries_header">
2050 <th class="th_details" colspan="5">Details</th>
2051 </tr>
2052 <tr class="entry_cont">
2053 <td class="entry_details" colspan="5">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]2054 <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]2055 </td>
2056 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2057
2058
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2059 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
2060 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2061
2062
2063 <tr class="entry" id="controls_android.control.effectMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2064 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2065 android.<wbr/>control.<wbr/>effect<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2066 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2067 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]2068 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2069
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2070 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2071
2072 <ul class="entry_type_enum">
2073 <li>
2074 <span class="entry_type_enum_name">OFF</span>
2075 </li>
2076 <li>
2077 <span class="entry_type_enum_name">MONO</span>
2078 <span class="entry_type_enum_optional">optional</span>
2079 </li>
2080 <li>
2081 <span class="entry_type_enum_name">NEGATIVE</span>
2082 <span class="entry_type_enum_optional">optional</span>
2083 </li>
2084 <li>
2085 <span class="entry_type_enum_name">SOLARIZE</span>
2086 <span class="entry_type_enum_optional">optional</span>
2087 </li>
2088 <li>
2089 <span class="entry_type_enum_name">SEPIA</span>
2090 <span class="entry_type_enum_optional">optional</span>
2091 </li>
2092 <li>
2093 <span class="entry_type_enum_name">POSTERIZE</span>
2094 <span class="entry_type_enum_optional">optional</span>
2095 </li>
2096 <li>
2097 <span class="entry_type_enum_name">WHITEBOARD</span>
2098 <span class="entry_type_enum_optional">optional</span>
2099 </li>
2100 <li>
2101 <span class="entry_type_enum_name">BLACKBOARD</span>
2102 <span class="entry_type_enum_optional">optional</span>
2103 </li>
2104 <li>
2105 <span class="entry_type_enum_name">AQUA</span>
2106 <span class="entry_type_enum_optional">optional</span>
2107 </li>
2108 </ul>
2109
2110 </td> <!-- entry_type -->
2111
2112 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2113 <p>Whether any special color effect is in use.<wbr/>
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]2114Only 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]2115 </td>
2116
2117 <td class="entry_units">
2118 </td>
2119
2120 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]2121 <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]2122 </td>
2123
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2124 <td class="entry_tags">
2125 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]2126 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2127 </ul>
2128 </td>
2129
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2130 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2131
2132
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2133 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
2134 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2135
2136
2137 <tr class="entry" id="controls_android.control.mode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2138 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2139 android.<wbr/>control.<wbr/>mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2140 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2141 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]2142 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2143
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2144 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2145
2146 <ul class="entry_type_enum">
2147 <li>
2148 <span class="entry_type_enum_name">OFF</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2149 <span class="entry_type_enum_notes">Full application control of pipeline.<wbr/> All 3A
2150 routines are disabled,<wbr/> no other settings in
2151 android.<wbr/>control.<wbr/>* have any effect</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2152 </li>
2153 <li>
2154 <span class="entry_type_enum_name">AUTO</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2155 <span class="entry_type_enum_notes">Use settings for each individual 3A routine.<wbr/>
2156 Manual control of capture parameters is disabled.<wbr/> All
2157 controls in android.<wbr/>control.<wbr/>* besides sceneMode take
2158 effect</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2159 </li>
2160 <li>
2161 <span class="entry_type_enum_name">USE_SCENE_MODE</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2162 <span class="entry_type_enum_notes">Use specific scene mode.<wbr/> Enabling this disables
2163 control.<wbr/>aeMode,<wbr/> control.<wbr/>awbMode and control.<wbr/>afMode
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2164 controls; the HAL must ignore those settings while
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2165 USE_<wbr/>SCENE_<wbr/>MODE is active (except for FACE_<wbr/>PRIORITY
2166 scene mode).<wbr/> Other control entries are still active.<wbr/>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2167 This setting can only be used if availableSceneModes !=
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2168 UNSUPPORTED</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2169 </li>
2170 </ul>
2171
2172 </td> <!-- entry_type -->
2173
2174 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2175 <p>Overall mode of 3A control
2176routines</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2177 </td>
2178
2179 <td class="entry_units">
2180 </td>
2181
2182 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]2183 <p>all must be supported</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2184 </td>
2185
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2186 <td class="entry_tags">
2187 <ul class="entry_tags">
2188 <li><a href="#tag_BC">BC</a></li>
2189 </ul>
2190 </td>
2191
2192 </tr>
2193 <tr class="entries_header">
2194 <th class="th_details" colspan="5">Details</th>
2195 </tr>
2196 <tr class="entry_cont">
2197 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2198 <p>High-level 3A control.<wbr/> When set to OFF,<wbr/> all 3A control
2199by the HAL is disabled.<wbr/> The application must set the fields for
2200capture parameters itself.<wbr/></p>
2201<p>When set to AUTO,<wbr/> the individual algorithm controls in
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]2202android.<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]2203<p>When set to USE_<wbr/>SCENE_<wbr/>MODE,<wbr/> the individual controls in
2204android.<wbr/>control.<wbr/>* are mostly disabled,<wbr/> and the HAL implements
2205one of the scene mode settings (such as ACTION,<wbr/> SUNSET,<wbr/> or PARTY)
2206as it wishes.<wbr/> The HAL scene mode 3A settings are provided by
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]2207<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]2208 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2209 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2210
2211
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2212 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
2213 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2214
2215
2216 <tr class="entry" id="controls_android.control.sceneMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2217 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2218 android.<wbr/>control.<wbr/>scene<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2219 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2220 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]2221 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2222
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2223 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2224
2225 <ul class="entry_type_enum">
2226 <li>
2227 <span class="entry_type_enum_name">UNSUPPORTED</span>
2228 <span class="entry_type_enum_value">0</span>
2229 </li>
2230 <li>
2231 <span class="entry_type_enum_name">FACE_PRIORITY</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2232 <span class="entry_type_enum_notes">if face detection support exists Use face
2233 detection data to drive 3A routines.<wbr/> If face detection
2234 statistics are disabled,<wbr/> should still operate correctly
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2235 (but not return face detection statistics to the
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2236 framework).<wbr/>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2237
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2238 Unlike the other scene modes,<wbr/> aeMode,<wbr/> awbMode,<wbr/> and afMode
2239 remain active when FACE_<wbr/>PRIORITY is set.<wbr/> This is due to
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2240 compatibility concerns with the old camera
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2241 API</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2242 </li>
2243 <li>
2244 <span class="entry_type_enum_name">ACTION</span>
2245 <span class="entry_type_enum_optional">optional</span>
2246 </li>
2247 <li>
2248 <span class="entry_type_enum_name">PORTRAIT</span>
2249 <span class="entry_type_enum_optional">optional</span>
2250 </li>
2251 <li>
2252 <span class="entry_type_enum_name">LANDSCAPE</span>
2253 <span class="entry_type_enum_optional">optional</span>
2254 </li>
2255 <li>
2256 <span class="entry_type_enum_name">NIGHT</span>
2257 <span class="entry_type_enum_optional">optional</span>
2258 </li>
2259 <li>
2260 <span class="entry_type_enum_name">NIGHT_PORTRAIT</span>
2261 <span class="entry_type_enum_optional">optional</span>
2262 </li>
2263 <li>
2264 <span class="entry_type_enum_name">THEATRE</span>
2265 <span class="entry_type_enum_optional">optional</span>
2266 </li>
2267 <li>
2268 <span class="entry_type_enum_name">BEACH</span>
2269 <span class="entry_type_enum_optional">optional</span>
2270 </li>
2271 <li>
2272 <span class="entry_type_enum_name">SNOW</span>
2273 <span class="entry_type_enum_optional">optional</span>
2274 </li>
2275 <li>
2276 <span class="entry_type_enum_name">SUNSET</span>
2277 <span class="entry_type_enum_optional">optional</span>
2278 </li>
2279 <li>
2280 <span class="entry_type_enum_name">STEADYPHOTO</span>
2281 <span class="entry_type_enum_optional">optional</span>
2282 </li>
2283 <li>
2284 <span class="entry_type_enum_name">FIREWORKS</span>
2285 <span class="entry_type_enum_optional">optional</span>
2286 </li>
2287 <li>
2288 <span class="entry_type_enum_name">SPORTS</span>
2289 <span class="entry_type_enum_optional">optional</span>
2290 </li>
2291 <li>
2292 <span class="entry_type_enum_name">PARTY</span>
2293 <span class="entry_type_enum_optional">optional</span>
2294 </li>
2295 <li>
2296 <span class="entry_type_enum_name">CANDLELIGHT</span>
2297 <span class="entry_type_enum_optional">optional</span>
2298 </li>
2299 <li>
2300 <span class="entry_type_enum_name">BARCODE</span>
2301 <span class="entry_type_enum_optional">optional</span>
2302 </li>
2303 </ul>
2304
2305 </td> <!-- entry_type -->
2306
2307 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2308 <p>Which scene mode is active when
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]2309<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]2310 </td>
2311
2312 <td class="entry_units">
2313 </td>
2314
2315 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]2316 <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]2317 </td>
2318
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2319 <td class="entry_tags">
2320 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]2321 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2322 </ul>
2323 </td>
2324
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2325 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2326
2327
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2328 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
2329 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2330
2331
2332 <tr class="entry" id="controls_android.control.videoStabilizationMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2333 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2334 android.<wbr/>control.<wbr/>video<wbr/>Stabilization<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2335 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2336 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]2337 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2338
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]2339 <span class="entry_type_visibility"> [public as boolean]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2340
2341 <ul class="entry_type_enum">
2342 <li>
2343 <span class="entry_type_enum_name">OFF</span>
2344 </li>
2345 <li>
2346 <span class="entry_type_enum_name">ON</span>
2347 </li>
2348 </ul>
2349
2350 </td> <!-- entry_type -->
2351
2352 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2353 <p>Whether video stabilization is
2354active</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2355 </td>
2356
2357 <td class="entry_units">
2358 </td>
2359
2360 <td class="entry_range">
2361 </td>
2362
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2363 <td class="entry_tags">
2364 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]2365 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2366 </ul>
2367 </td>
2368
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2369 </tr>
2370 <tr class="entries_header">
2371 <th class="th_details" colspan="5">Details</th>
2372 </tr>
2373 <tr class="entry_cont">
2374 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2375 <p>If enabled,<wbr/> video stabilization can modify the
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]2376<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]2377stabilized</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2378 </td>
2379 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2380
2381
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2382 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
2383 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2384
2385
2386
2387 <!-- end of kind -->
2388 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2389 <tr><td colspan="6" class="kind">static</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2390
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2391 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2392 <tr>
2393 <th class="th_name">Property Name</th>
2394 <th class="th_type">Type</th>
2395 <th class="th_description">Description</th>
2396 <th class="th_units">Units</th>
2397 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2398 <th class="th_tags">Tags</th>
2399 </tr>
2400 </thead>
2401
2402 <tbody>
2403
2404
2405
2406
2407
2408
2409
2410
2411
2412
2413 <tr class="entry" id="static_android.control.aeAvailableAntibandingModes">
Eino-Ville Talvala19ce2c12013-12-30 12:03:45 -0800[diff] [blame]2414 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2415 android.<wbr/>control.<wbr/>ae<wbr/>Available<wbr/>Antibanding<wbr/>Modes
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2416 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2417 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]2418 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2419 <span class="entry_type_container">x</span>
2420
2421 <span class="entry_type_array">
2422 n
2423 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2424 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2425 <div class="entry_type_notes">list of enums</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2426
2427
2428 </td> <!-- entry_type -->
2429
2430 <td class="entry_description">
Eino-Ville Talvala19ce2c12013-12-30 12:03:45 -0800[diff] [blame]2431 <p>The set of auto-exposure antibanding modes that are
2432supported by this camera device.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2433 </td>
2434
2435 <td class="entry_units">
2436 </td>
2437
2438 <td class="entry_range">
2439 </td>
2440
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2441 <td class="entry_tags">
2442 </td>
2443
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2444 </tr>
Eino-Ville Talvala19ce2c12013-12-30 12:03:45 -0800[diff] [blame]2445 <tr class="entries_header">
2446 <th class="th_details" colspan="5">Details</th>
2447 </tr>
2448 <tr class="entry_cont">
2449 <td class="entry_details" colspan="5">
2450 <p>Not all of the auto-exposure anti-banding modes may be
2451supported by a given camera device.<wbr/> This field lists the
2452valid anti-banding modes that the application may request
2453for this camera device; they must include AUTO.<wbr/></p>
2454 </td>
2455 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2456
2457
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2458 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
2459 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2460
2461
2462 <tr class="entry" id="static_android.control.aeAvailableModes">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2463 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2464 android.<wbr/>control.<wbr/>ae<wbr/>Available<wbr/>Modes
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2465 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2466 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]2467 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2468 <span class="entry_type_container">x</span>
2469
2470 <span class="entry_type_array">
2471 n
2472 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2473 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2474 <div class="entry_type_notes">list of enums</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2475
2476
2477 </td> <!-- entry_type -->
2478
2479 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2480 <p>Which subset of AE modes is
2481supported</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2482 </td>
2483
2484 <td class="entry_units">
2485 </td>
2486
2487 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]2488 <p>OFF,<wbr/> ON must be supported.<wbr/>
2489ON_<wbr/>AUTO_<wbr/>FLASH/<wbr/>ON_<wbr/>ALWAYS_<wbr/>FLASH must be supported if flash
2490unit is available</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2491 </td>
2492
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2493 <td class="entry_tags">
2494 </td>
2495
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2496 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2497
2498
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2499 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
2500 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2501
2502
2503 <tr class="entry" id="static_android.control.aeAvailableTargetFpsRanges">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2504 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2505 android.<wbr/>control.<wbr/>ae<wbr/>Available<wbr/>Target<wbr/>Fps<wbr/>Ranges
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2506 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2507 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]2508 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2509 <span class="entry_type_container">x</span>
2510
2511 <span class="entry_type_array">
2512 2 x n
2513 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2514 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2515 <div class="entry_type_notes">list of pairs of frame rates</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2516
2517
2518 </td> <!-- entry_type -->
2519
2520 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2521 <p>List of frame rate ranges supported by the
2522AE algorithm/<wbr/>hardware</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2523 </td>
2524
2525 <td class="entry_units">
2526 </td>
2527
2528 <td class="entry_range">
2529 </td>
2530
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2531 <td class="entry_tags">
2532 </td>
2533
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2534 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2535
2536
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2537 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
2538 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2539
2540
2541 <tr class="entry" id="static_android.control.aeCompensationRange">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2542 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2543 android.<wbr/>control.<wbr/>ae<wbr/>Compensation<wbr/>Range
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2544 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2545 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]2546 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2547 <span class="entry_type_container">x</span>
2548
2549 <span class="entry_type_array">
2550 2
2551 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2552 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2553
2554
2555 </td> <!-- entry_type -->
2556
2557 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2558 <p>Maximum and minimum exposure compensation
2559setting,<wbr/> in counts of
2560android.<wbr/>control.<wbr/>ae<wbr/>Compensation<wbr/>Step<wbr/>Size</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2561 </td>
2562
2563 <td class="entry_units">
2564 </td>
2565
2566 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]2567 <p>At least (-2,<wbr/>2)/<wbr/>(exp compensation step
2568size)</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2569 </td>
2570
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2571 <td class="entry_tags">
2572 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]2573 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2574 </ul>
2575 </td>
2576
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2577 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2578
2579
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2580 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
2581 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2582
2583
2584 <tr class="entry" id="static_android.control.aeCompensationStep">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2585 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2586 android.<wbr/>control.<wbr/>ae<wbr/>Compensation<wbr/>Step
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2587 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2588 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]2589 <span class="entry_type_name">rational</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2590
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2591 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2592
2593
2594 </td> <!-- entry_type -->
2595
2596 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2597 <p>Smallest step by which exposure compensation
2598can be changed</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2599 </td>
2600
2601 <td class="entry_units">
2602 </td>
2603
2604 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]2605 <p>&lt;= 1/<wbr/>2</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2606 </td>
2607
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2608 <td class="entry_tags">
2609 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]2610 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2611 </ul>
2612 </td>
2613
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2614 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2615
2616
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2617 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
2618 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2619
2620
2621 <tr class="entry" id="static_android.control.afAvailableModes">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2622 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2623 android.<wbr/>control.<wbr/>af<wbr/>Available<wbr/>Modes
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2624 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2625 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]2626 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2627 <span class="entry_type_container">x</span>
2628
2629 <span class="entry_type_array">
2630 n
2631 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2632 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2633 <div class="entry_type_notes">List of enums</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2634
2635
2636 </td> <!-- entry_type -->
2637
2638 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2639 <p>List of AF modes that can be
2640selected</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2641 </td>
2642
2643 <td class="entry_units">
2644 </td>
2645
2646 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]2647 <p>OFF must be included.<wbr/> AUTO must be supported if
2648lens allows for changing focus</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2649 </td>
2650
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2651 <td class="entry_tags">
2652 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]2653 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2654 </ul>
2655 </td>
2656
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2657 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2658
2659
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2660 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
2661 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2662
2663
2664 <tr class="entry" id="static_android.control.availableEffects">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2665 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2666 android.<wbr/>control.<wbr/>available<wbr/>Effects
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2667 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2668 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]2669 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2670 <span class="entry_type_container">x</span>
2671
2672 <span class="entry_type_array">
2673 n
2674 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2675 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2676 <div class="entry_type_notes">list of enums</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2677
2678
2679 </td> <!-- entry_type -->
2680
2681 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2682 <p>what subset of the full color effect enum
2683list is supported</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2684 </td>
2685
2686 <td class="entry_units">
2687 </td>
2688
2689 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]2690 <p>OFF must be listed</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2691 </td>
2692
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2693 <td class="entry_tags">
2694 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]2695 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2696 </ul>
2697 </td>
2698
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2699 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2700
2701
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2702 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
2703 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2704
2705
2706 <tr class="entry" id="static_android.control.availableSceneModes">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2707 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2708 android.<wbr/>control.<wbr/>available<wbr/>Scene<wbr/>Modes
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2709 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2710 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]2711 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2712 <span class="entry_type_container">x</span>
2713
2714 <span class="entry_type_array">
2715 n
2716 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2717 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2718 <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]2719
2720
2721 </td> <!-- entry_type -->
2722
2723 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2724 <p>what subset of the scene mode enum list is
2725supported.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2726 </td>
2727
2728 <td class="entry_units">
2729 </td>
2730
2731 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]2732 <p>SCENE_<wbr/>MODE_<wbr/>FACE_<wbr/>PRIORITY must be supported if face
2733detection is supported</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2734 </td>
2735
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2736 <td class="entry_tags">
2737 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]2738 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2739 </ul>
2740 </td>
2741
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2742 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2743
2744
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2745 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
2746 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2747
2748
2749 <tr class="entry" id="static_android.control.availableVideoStabilizationModes">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2750 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2751 android.<wbr/>control.<wbr/>available<wbr/>Video<wbr/>Stabilization<wbr/>Modes
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2752 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2753 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]2754 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2755 <span class="entry_type_container">x</span>
2756
2757 <span class="entry_type_array">
2758 n
2759 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2760 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2761 <div class="entry_type_notes">List of enums.<wbr/></div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2762
2763
2764 </td> <!-- entry_type -->
2765
2766 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2767 <p>List of video stabilization modes that can
2768be supported</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2769 </td>
2770
2771 <td class="entry_units">
2772 </td>
2773
2774 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]2775 <p>OFF must be included</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2776 </td>
2777
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2778 <td class="entry_tags">
2779 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]2780 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2781 </ul>
2782 </td>
2783
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2784 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2785
2786
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2787 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
2788 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2789
2790
2791 <tr class="entry" id="static_android.control.awbAvailableModes">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2792 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2793 android.<wbr/>control.<wbr/>awb<wbr/>Available<wbr/>Modes
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2794 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2795 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]2796 <span class="entry_type_name">byte</span>
Alex Raya4251d92013-04-30 16:43:44 -0700[diff] [blame]2797 <span class="entry_type_container">x</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2798
Alex Raya4251d92013-04-30 16:43:44 -0700[diff] [blame]2799 <span class="entry_type_array">
2800 n
2801 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2802 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2803 <div class="entry_type_notes">List of enums (android.<wbr/>control.<wbr/>awb<wbr/>Mode)</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2804
2805
2806 </td> <!-- entry_type -->
2807
2808 <td class="entry_description">
2809 </td>
2810
2811 <td class="entry_units">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2812 </td>
2813
2814 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]2815 <p>OFF,<wbr/> AUTO must be included</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2816 </td>
2817
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2818 <td class="entry_tags">
2819 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]2820 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2821 </ul>
2822 </td>
2823
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2824 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2825
2826
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2827 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
2828 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2829
2830
2831 <tr class="entry" id="static_android.control.maxRegions">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2832 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2833 android.<wbr/>control.<wbr/>max<wbr/>Regions
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2834 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2835 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]2836 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2837
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2838 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2839
2840
2841 </td> <!-- entry_type -->
2842
2843 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2844 <p>For AE,<wbr/> AWB,<wbr/> and AF,<wbr/> how many individual
2845regions can be listed for metering?</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2846 </td>
2847
2848 <td class="entry_units">
2849 </td>
2850
2851 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame^]2852 <p>&gt;= 1</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2853 </td>
2854
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2855 <td class="entry_tags">
2856 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]2857 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2858 </ul>
2859 </td>
2860
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2861 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2862
2863
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2864 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
2865 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2866
2867
2868 <tr class="entry" id="static_android.control.sceneModeOverrides">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2869 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2870 android.<wbr/>control.<wbr/>scene<wbr/>Mode<wbr/>Overrides
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2871 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2872 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]2873 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2874 <span class="entry_type_container">x</span>
2875
2876 <span class="entry_type_array">
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2877 3 x length(availableSceneModes)
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2878 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2879 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2880
2881
2882 </td> <!-- entry_type -->
2883
2884 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2885 <p>List of AE,<wbr/> AWB,<wbr/> and AF modes to use for
2886each available scene mode</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2887 </td>
2888
2889 <td class="entry_units">
2890 </td>
2891
2892 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]2893 <p>For each listed scene mode,<wbr/> lists the aeMode,<wbr/>
2894awbMode,<wbr/> and afMode that the HAL wants to use for that
2895scene mode.<wbr/></p>
2896<p>For each entry,<wbr/> the order is {aeMode,<wbr/> awbMode,<wbr/> afMode} in
2897order of increasing index</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2898 </td>
2899
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2900 <td class="entry_tags">
2901 <ul class="entry_tags">
2902 <li><a href="#tag_BC">BC</a></li>
2903 </ul>
2904 </td>
2905
2906 </tr>
2907 <tr class="entries_header">
2908 <th class="th_details" colspan="5">Details</th>
2909 </tr>
2910 <tr class="entry_cont">
2911 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2912 <p>When a scene mode is enabled,<wbr/> the HAL is expected
2913to override aeMode,<wbr/> awbMode,<wbr/> and afMode with its
2914preferred settings for that scene mode.<wbr/></p>
2915<p>To simplify communication with old camera API applications,<wbr/>
2916the service wants this override list in the static metadata.<wbr/>
2917The order of this list matches that of availableSceneModes,<wbr/>
2918with 3 entires for each scene mode.<wbr/> The overrides listed
2919for SCENE_<wbr/>MODE_<wbr/>FACE_<wbr/>PRIORITY are ignored,<wbr/> since for that
2920mode,<wbr/> the application-set aeMode,<wbr/> awbMode,<wbr/> and afMode are
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]2921used 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]2922AUTO.<wbr/></p>
2923<p>It is recommended that for FACE_<wbr/>PRIORITY,<wbr/> the overrides
2924should be set to 0.<wbr/> As an example,<wbr/> if availableSceneModes is
2925{ FACE_<wbr/>PRIORITY,<wbr/> ACTION,<wbr/> NIGHT },<wbr/> then the service expects
2926this field to have 9 entries; for example { 0 ,<wbr/> 0,<wbr/> 0,<wbr/>
2927ON_<wbr/>AUTO_<wbr/>FLASH,<wbr/> AUTO,<wbr/> CONTINUOUS_<wbr/>PICTURE,<wbr/> ON_<wbr/>AUTO_<wbr/>FLASH,<wbr/>
2928INCANDESCENT,<wbr/> AUTO }</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2929 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2930 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2931
2932
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2933 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
2934 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2935
2936
2937
2938 <!-- end of kind -->
2939 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2940 <tr><td colspan="6" class="kind">dynamic</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2941
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2942 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2943 <tr>
2944 <th class="th_name">Property Name</th>
2945 <th class="th_type">Type</th>
2946 <th class="th_description">Description</th>
2947 <th class="th_units">Units</th>
2948 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2949 <th class="th_tags">Tags</th>
2950 </tr>
2951 </thead>
2952
2953 <tbody>
2954
2955
2956
2957
2958
2959
2960
2961
2962
2963
2964 <tr class="entry" id="dynamic_android.control.aePrecaptureId">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2965 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2966 android.<wbr/>control.<wbr/>ae<wbr/>Precapture<wbr/>Id
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2967 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2968 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]2969 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2970
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2971 <span class="entry_type_visibility"> [hidden]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2972
2973
2974 </td> <!-- entry_type -->
2975
2976 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2977 <p>The ID sent with the latest
2978CAMERA2_<wbr/>TRIGGER_<wbr/>PRECAPTURE_<wbr/>METERING call</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2979 </td>
2980
2981 <td class="entry_units">
2982 </td>
2983
2984 <td class="entry_range">
2985 </td>
2986
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2987 <td class="entry_tags">
2988 </td>
2989
2990 </tr>
2991 <tr class="entries_header">
2992 <th class="th_details" colspan="5">Details</th>
2993 </tr>
2994 <tr class="entry_cont">
2995 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2996 <p>Must be 0 if no
2997CAMERA2_<wbr/>TRIGGER_<wbr/>PRECAPTURE_<wbr/>METERING trigger received yet
2998by HAL.<wbr/> Always updated even if AE algorithm ignores the
2999trigger</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3000 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3001 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3002
3003
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3004 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
3005 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3006
3007
3008 <tr class="entry" id="dynamic_android.control.aeRegions">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3009 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3010 android.<wbr/>control.<wbr/>ae<wbr/>Regions
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3011 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3012 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]3013 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3014 <span class="entry_type_container">x</span>
3015
3016 <span class="entry_type_array">
3017 5 x area_count
3018 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3019 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3020
3021
3022 </td> <!-- entry_type -->
3023
3024 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3025 <p>List of areas to use for
3026metering</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3027 </td>
3028
3029 <td class="entry_units">
3030 </td>
3031
3032 <td class="entry_range">
3033 </td>
3034
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3035 <td class="entry_tags">
3036 <ul class="entry_tags">
3037 <li><a href="#tag_BC">BC</a></li>
3038 </ul>
3039 </td>
3040
3041 </tr>
3042 <tr class="entries_header">
3043 <th class="th_details" colspan="5">Details</th>
3044 </tr>
3045 <tr class="entry_cont">
3046 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3047 <p>Each area is a rectangle plus weight: xmin,<wbr/> ymin,<wbr/>
3048xmax,<wbr/> ymax,<wbr/> weight.<wbr/> The rectangle is defined inclusive of the
3049specified coordinates.<wbr/></p>
3050<p>The coordinate system is based on the active pixel array,<wbr/>
3051with (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]3052(<a href="#static_android.sensor.info.activeArraySize">android.<wbr/>sensor.<wbr/>info.<wbr/>active<wbr/>Array<wbr/>Size</a>.<wbr/>width - 1,<wbr/>
3053<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]3054bottom-right pixel in the active pixel array.<wbr/> The weight
3055should be nonnegative.<wbr/></p>
3056<p>If all regions have 0 weight,<wbr/> then no specific metering area
3057needs to be used by the HAL.<wbr/> If the metering region is
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]3058outside 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]3059should ignore the sections outside the region and output the
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3060used sections in the frame metadata</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3061 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3062 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3063
3064
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3065 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
3066 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3067
3068
3069 <tr class="entry" id="dynamic_android.control.aeState">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3070 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3071 android.<wbr/>control.<wbr/>ae<wbr/>State
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3072 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3073 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]3074 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3075
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3076 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3077
3078 <ul class="entry_type_enum">
3079 <li>
3080 <span class="entry_type_enum_name">INACTIVE</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3081 <span class="entry_type_enum_notes">AE is off.<wbr/> When a camera device is opened,<wbr/> it starts in
3082 this state.<wbr/></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3083 </li>
3084 <li>
3085 <span class="entry_type_enum_name">SEARCHING</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3086 <span class="entry_type_enum_notes">AE doesn't yet have a good set of control values
3087 for the current scene</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3088 </li>
3089 <li>
3090 <span class="entry_type_enum_name">CONVERGED</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3091 <span class="entry_type_enum_notes">AE has a good set of control values for the
3092 current scene</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3093 </li>
3094 <li>
3095 <span class="entry_type_enum_name">LOCKED</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3096 <span class="entry_type_enum_notes">AE has been locked (aeMode =
3097 LOCKED)</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3098 </li>
3099 <li>
3100 <span class="entry_type_enum_name">FLASH_REQUIRED</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3101 <span class="entry_type_enum_notes">AE has a good set of control values,<wbr/> but flash
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3102 needs to be fired for good quality still
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3103 capture</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3104 </li>
3105 <li>
3106 <span class="entry_type_enum_name">PRECAPTURE</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3107 <span class="entry_type_enum_notes">AE has been asked to do a precapture sequence
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3108 (through the
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3109 trigger_<wbr/>action(CAMERA2_<wbr/>TRIGGER_<wbr/>PRECAPTURE_<wbr/>METERING)
3110 call),<wbr/> and is currently executing it.<wbr/> Once PRECAPTURE
3111 completes,<wbr/> AE will transition to CONVERGED or
3112 FLASH_<wbr/>REQUIRED as appropriate</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3113 </li>
3114 </ul>
3115
3116 </td> <!-- entry_type -->
3117
3118 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3119 <p>Current state of AE algorithm</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3120 </td>
3121
3122 <td class="entry_units">
3123 </td>
3124
3125 <td class="entry_range">
3126 </td>
3127
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3128 <td class="entry_tags">
3129 </td>
3130
3131 </tr>
3132 <tr class="entries_header">
3133 <th class="th_details" colspan="5">Details</th>
3134 </tr>
3135 <tr class="entry_cont">
3136 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3137 <p>Whenever the AE algorithm state changes,<wbr/> a
3138MSG_<wbr/>AUTOEXPOSURE notification must be send if a
3139notification callback is registered.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3140 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3141 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3142
3143
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3144 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
3145 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3146
3147
3148 <tr class="entry" id="dynamic_android.control.afMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3149 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3150 android.<wbr/>control.<wbr/>af<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3151 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3152 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]3153 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3154
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3155 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3156
3157 <ul class="entry_type_enum">
3158 <li>
3159 <span class="entry_type_enum_name">OFF</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3160 <span class="entry_type_enum_notes">The auto-focus routine does not control the lens;
3161 android.<wbr/>lens.<wbr/>focus<wbr/>Distance is controlled by the
3162 application</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3163 </li>
3164 <li>
3165 <span class="entry_type_enum_name">AUTO</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3166 <span class="entry_type_enum_notes">
3167 If lens is not fixed focus.<wbr/>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3168
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3169 Use android.<wbr/>lens.<wbr/>info.<wbr/>minimum<wbr/>Focus<wbr/>Distance to determine if lens
3170 is fixed-focus.<wbr/> In this mode,<wbr/> the lens does not move unless
3171 the autofocus trigger action is called.<wbr/> When that trigger
3172 is activated,<wbr/> AF must transition to ACTIVE_<wbr/>SCAN,<wbr/> then to
3173 the outcome of the scan (FOCUSED or NOT_<wbr/>FOCUSED).<wbr/>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3174
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3175 Triggering AF_<wbr/>CANCEL resets the lens position to default,<wbr/>
3176 and sets the AF state to INACTIVE.<wbr/></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3177 </li>
3178 <li>
3179 <span class="entry_type_enum_name">MACRO</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3180 <span class="entry_type_enum_notes">In this mode,<wbr/> the lens does not move unless the
3181 autofocus trigger action is called.<wbr/>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3182
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3183 When that trigger is activated,<wbr/> AF must transition to
3184 ACTIVE_<wbr/>SCAN,<wbr/> then to the outcome of the scan (FOCUSED or
3185 NOT_<wbr/>FOCUSED).<wbr/> Triggering cancel AF resets the lens
3186 position to default,<wbr/> and sets the AF state to
3187 INACTIVE.<wbr/></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3188 </li>
3189 <li>
3190 <span class="entry_type_enum_name">CONTINUOUS_VIDEO</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3191 <span class="entry_type_enum_notes">In this mode,<wbr/> the AF algorithm modifies the lens
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3192 position continually to attempt to provide a
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3193 constantly-in-focus image stream.<wbr/>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3194
3195 The focusing behavior should be suitable for good quality
3196 video recording; typically this means slower focus
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3197 movement and no overshoots.<wbr/> When the AF trigger is not
3198 involved,<wbr/> the AF algorithm should start in INACTIVE state,<wbr/>
3199 and then transition into PASSIVE_<wbr/>SCAN and PASSIVE_<wbr/>FOCUSED
3200 states as appropriate.<wbr/> When the AF trigger is activated,<wbr/>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3201 the algorithm should immediately transition into
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3202 AF_<wbr/>FOCUSED or AF_<wbr/>NOT_<wbr/>FOCUSED as appropriate,<wbr/> and lock the
3203 lens position until a cancel AF trigger is received.<wbr/>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3204
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3205 Once cancel is received,<wbr/> the algorithm should transition
3206 back to INACTIVE and resume passive scan.<wbr/> Note that this
3207 behavior is not identical to CONTINUOUS_<wbr/>PICTURE,<wbr/> since an
3208 ongoing PASSIVE_<wbr/>SCAN must immediately be
3209 canceled.<wbr/></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3210 </li>
3211 <li>
3212 <span class="entry_type_enum_name">CONTINUOUS_PICTURE</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3213 <span class="entry_type_enum_notes">In this mode,<wbr/> the AF algorithm modifies the lens
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3214 position continually to attempt to provide a
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3215 constantly-in-focus image stream.<wbr/>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3216
3217 The focusing behavior should be suitable for still image
3218 capture; typically this means focusing as fast as
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3219 possible.<wbr/> When the AF trigger is not involved,<wbr/> the AF
3220 algorithm should start in INACTIVE state,<wbr/> and then
3221 transition into PASSIVE_<wbr/>SCAN and PASSIVE_<wbr/>FOCUSED states as
3222 appropriate as it attempts to maintain focus.<wbr/> When the AF
3223 trigger is activated,<wbr/> the algorithm should finish its
3224 PASSIVE_<wbr/>SCAN if active,<wbr/> and then transition into
3225 AF_<wbr/>FOCUSED or AF_<wbr/>NOT_<wbr/>FOCUSED as appropriate,<wbr/> and lock the
3226 lens position until a cancel AF trigger is received.<wbr/>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3227
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3228 When the AF cancel trigger is activated,<wbr/> the algorithm
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3229 should transition back to INACTIVE and then act as if it
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3230 has just been started.<wbr/></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3231 </li>
3232 <li>
3233 <span class="entry_type_enum_name">EDOF</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3234 <span class="entry_type_enum_notes">Extended depth of field (digital focus).<wbr/> AF
3235 trigger is ignored,<wbr/> AF state should always be
3236 INACTIVE.<wbr/></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3237 </li>
3238 </ul>
3239
3240 </td> <!-- entry_type -->
3241
3242 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3243 <p>Whether AF is currently enabled,<wbr/> and what
3244mode it is set to</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3245 </td>
3246
3247 <td class="entry_units">
3248 </td>
3249
3250 <td class="entry_range">
3251 </td>
3252
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3253 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]3254 <ul class="entry_tags">
3255 <li><a href="#tag_BC">BC</a></li>
3256 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3257 </td>
3258
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3259 </tr>
3260 <tr class="entries_header">
3261 <th class="th_details" colspan="5">Details</th>
3262 </tr>
3263 <tr class="entry_cont">
3264 <td class="entry_details" colspan="5">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]3265 <p>Only effective if <a href="#controls_android.control.mode">android.<wbr/>control.<wbr/>mode</a> = AUTO.<wbr/></p>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3266<p>If lens is controlled by HAL auto-focus algorithm,<wbr/> the HAL should
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]3267report the current AF status in <a href="#dynamic_android.control.afState">android.<wbr/>control.<wbr/>af<wbr/>State</a> in
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3268result metadata.<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3269 </td>
3270 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3271
3272
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3273 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
3274 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3275
3276
3277 <tr class="entry" id="dynamic_android.control.afRegions">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3278 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3279 android.<wbr/>control.<wbr/>af<wbr/>Regions
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3280 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3281 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]3282 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3283 <span class="entry_type_container">x</span>
3284
3285 <span class="entry_type_array">
3286 5 x area_count
3287 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3288 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3289
3290
3291 </td> <!-- entry_type -->
3292
3293 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3294 <p>List of areas to use for focus
3295estimation</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3296 </td>
3297
3298 <td class="entry_units">
3299 </td>
3300
3301 <td class="entry_range">
3302 </td>
3303
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3304 <td class="entry_tags">
3305 <ul class="entry_tags">
3306 <li><a href="#tag_BC">BC</a></li>
3307 </ul>
3308 </td>
3309
3310 </tr>
3311 <tr class="entries_header">
3312 <th class="th_details" colspan="5">Details</th>
3313 </tr>
3314 <tr class="entry_cont">
3315 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3316 <p>Each area is a rectangle plus weight: xmin,<wbr/> ymin,<wbr/>
3317xmax,<wbr/> ymax,<wbr/> weight.<wbr/> The rectangle is defined inclusive of the
3318specified coordinates.<wbr/></p>
3319<p>The coordinate system is based on the active pixel array,<wbr/>
3320with (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]3321(<a href="#static_android.sensor.info.activeArraySize">android.<wbr/>sensor.<wbr/>info.<wbr/>active<wbr/>Array<wbr/>Size</a>.<wbr/>width - 1,<wbr/>
3322<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]3323bottom-right pixel in the active pixel array.<wbr/> The weight
3324should be nonnegative.<wbr/></p>
3325<p>If all regions have 0 weight,<wbr/> then no specific focus area
3326needs to be used by the HAL.<wbr/> If the focusing region is
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]3327outside 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]3328should ignore the sections outside the region and output the
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3329used sections in the frame metadata</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3330 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3331 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3332
3333
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3334 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
3335 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3336
3337
3338 <tr class="entry" id="dynamic_android.control.afState">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3339 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3340 android.<wbr/>control.<wbr/>af<wbr/>State
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3341 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3342 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]3343 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3344
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3345 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3346
3347 <ul class="entry_type_enum">
3348 <li>
3349 <span class="entry_type_enum_name">INACTIVE</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3350 <span class="entry_type_enum_notes">AF off or has not yet tried to scan/<wbr/>been asked
3351 to scan.<wbr/> When a camera device is opened,<wbr/> it starts in
3352 this state.<wbr/></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3353 </li>
3354 <li>
3355 <span class="entry_type_enum_name">PASSIVE_SCAN</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3356 <span class="entry_type_enum_notes">if CONTINUOUS_<wbr/>* modes are supported.<wbr/> AF is
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3357 currently doing an AF scan initiated by a continuous
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3358 autofocus mode</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3359 </li>
3360 <li>
3361 <span class="entry_type_enum_name">PASSIVE_FOCUSED</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3362 <span class="entry_type_enum_notes">if CONTINUOUS_<wbr/>* modes are supported.<wbr/> AF currently
3363 believes it is in focus,<wbr/> but may restart scanning at
3364 any time.<wbr/></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3365 </li>
3366 <li>
3367 <span class="entry_type_enum_name">ACTIVE_SCAN</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3368 <span class="entry_type_enum_notes">if AUTO or MACRO modes are supported.<wbr/> AF is doing
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3369 an AF scan because it was triggered by AF
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3370 trigger</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3371 </li>
3372 <li>
3373 <span class="entry_type_enum_name">FOCUSED_LOCKED</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3374 <span class="entry_type_enum_notes">if any AF mode besides OFF is supported.<wbr/> AF
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3375 believes it is focused correctly and is
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3376 locked</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3377 </li>
3378 <li>
3379 <span class="entry_type_enum_name">NOT_FOCUSED_LOCKED</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3380 <span class="entry_type_enum_notes">if any AF mode besides OFF is supported.<wbr/> AF has
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3381 failed to focus successfully and is
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3382 locked</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3383 </li>
Eino-Ville Talvala492ba7c2013-09-20 17:24:00 -0700[diff] [blame]3384 <li>
3385 <span class="entry_type_enum_name">PASSIVE_UNFOCUSED</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3386 <span class="entry_type_enum_notes">if CONTINUOUS_<wbr/>* modes are supported.<wbr/> AF finished a
3387 passive scan without finding focus,<wbr/> and may restart
3388 scanning at any time.<wbr/></span>
Eino-Ville Talvala492ba7c2013-09-20 17:24:00 -0700[diff] [blame]3389 </li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3390 </ul>
3391
3392 </td> <!-- entry_type -->
3393
3394 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3395 <p>Current state of AF algorithm</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3396 </td>
3397
3398 <td class="entry_units">
3399 </td>
3400
3401 <td class="entry_range">
3402 </td>
3403
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3404 <td class="entry_tags">
3405 </td>
3406
3407 </tr>
3408 <tr class="entries_header">
3409 <th class="th_details" colspan="5">Details</th>
3410 </tr>
3411 <tr class="entry_cont">
3412 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3413 <p>Whenever the AF algorithm state changes,<wbr/> a
3414MSG_<wbr/>AUTOFOCUS notification must be send if a notification
3415callback is registered.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3416 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3417 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3418
3419
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3420 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
3421 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3422
3423
3424 <tr class="entry" id="dynamic_android.control.afTriggerId">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3425 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3426 android.<wbr/>control.<wbr/>af<wbr/>Trigger<wbr/>Id
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3427 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3428 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]3429 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3430
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3431 <span class="entry_type_visibility"> [hidden]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3432
3433
3434 </td> <!-- entry_type -->
3435
3436 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3437 <p>The ID sent with the latest
3438CAMERA2_<wbr/>TRIGGER_<wbr/>AUTOFOCUS call</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3439 </td>
3440
3441 <td class="entry_units">
3442 </td>
3443
3444 <td class="entry_range">
3445 </td>
3446
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3447 <td class="entry_tags">
3448 </td>
3449
3450 </tr>
3451 <tr class="entries_header">
3452 <th class="th_details" colspan="5">Details</th>
3453 </tr>
3454 <tr class="entry_cont">
3455 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3456 <p>Must be 0 if no CAMERA2_<wbr/>TRIGGER_<wbr/>AUTOFOCUS trigger
3457received yet by HAL.<wbr/> Always updated even if AF algorithm
3458ignores the trigger</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3459 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3460 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3461
3462
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3463 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
3464 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3465
3466
3467 <tr class="entry" id="dynamic_android.control.awbMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3468 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3469 android.<wbr/>control.<wbr/>awb<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3470 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3471 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]3472 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3473
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3474 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3475
3476 <ul class="entry_type_enum">
3477 <li>
3478 <span class="entry_type_enum_name">OFF</span>
3479 </li>
3480 <li>
3481 <span class="entry_type_enum_name">AUTO</span>
3482 </li>
3483 <li>
3484 <span class="entry_type_enum_name">INCANDESCENT</span>
3485 </li>
3486 <li>
3487 <span class="entry_type_enum_name">FLUORESCENT</span>
3488 </li>
3489 <li>
3490 <span class="entry_type_enum_name">WARM_FLUORESCENT</span>
3491 </li>
3492 <li>
3493 <span class="entry_type_enum_name">DAYLIGHT</span>
3494 </li>
3495 <li>
3496 <span class="entry_type_enum_name">CLOUDY_DAYLIGHT</span>
3497 </li>
3498 <li>
3499 <span class="entry_type_enum_name">TWILIGHT</span>
3500 </li>
3501 <li>
3502 <span class="entry_type_enum_name">SHADE</span>
3503 </li>
3504 </ul>
3505
3506 </td> <!-- entry_type -->
3507
3508 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3509 <p>Whether AWB is currently setting the color
3510transform fields,<wbr/> and what its illumination target
3511is</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3512 </td>
3513
3514 <td class="entry_units">
3515 </td>
3516
3517 <td class="entry_range">
3518 </td>
3519
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3520 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]3521 <ul class="entry_tags">
3522 <li><a href="#tag_BC">BC</a></li>
3523 <li><a href="#tag_AWB">AWB</a></li>
3524 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3525 </td>
3526
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3527 </tr>
3528 <tr class="entries_header">
3529 <th class="th_details" colspan="5">Details</th>
3530 </tr>
3531 <tr class="entry_cont">
3532 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3533 <p>[BC - AWB lock,<wbr/>AWB modes]</p>
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]3534<p>Only effective if <a href="#controls_android.control.mode">android.<wbr/>control.<wbr/>mode</a> = AUTO.<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3535 </td>
3536 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3537
3538
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3539 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
3540 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3541
3542
3543 <tr class="entry" id="dynamic_android.control.awbRegions">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3544 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3545 android.<wbr/>control.<wbr/>awb<wbr/>Regions
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3546 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3547 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]3548 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3549 <span class="entry_type_container">x</span>
3550
3551 <span class="entry_type_array">
3552 5 x area_count
3553 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3554 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3555
3556
3557 </td> <!-- entry_type -->
3558
3559 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3560 <p>List of areas to use for illuminant
3561estimation</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3562 </td>
3563
3564 <td class="entry_units">
3565 </td>
3566
3567 <td class="entry_range">
3568 </td>
3569
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3570 <td class="entry_tags">
3571 <ul class="entry_tags">
3572 <li><a href="#tag_BC">BC</a></li>
3573 </ul>
3574 </td>
3575
3576 </tr>
3577 <tr class="entries_header">
3578 <th class="th_details" colspan="5">Details</th>
3579 </tr>
3580 <tr class="entry_cont">
3581 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3582 <p>Only used in AUTO mode.<wbr/></p>
3583<p>Each area is a rectangle plus weight: xmin,<wbr/> ymin,<wbr/>
3584xmax,<wbr/> ymax,<wbr/> weight.<wbr/> The rectangle is defined inclusive of the
3585specified coordinates.<wbr/></p>
3586<p>The coordinate system is based on the active pixel array,<wbr/>
3587with (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]3588(<a href="#static_android.sensor.info.activeArraySize">android.<wbr/>sensor.<wbr/>info.<wbr/>active<wbr/>Array<wbr/>Size</a>.<wbr/>width - 1,<wbr/>
3589<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]3590bottom-right pixel in the active pixel array.<wbr/> The weight
3591should be nonnegative.<wbr/></p>
3592<p>If all regions have 0 weight,<wbr/> then no specific metering area
3593needs to be used by the HAL.<wbr/> If the metering region is
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]3594outside 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]3595should ignore the sections outside the region and output the
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3596used sections in the frame metadata</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3597 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3598 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3599
3600
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3601 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
3602 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3603
3604
3605 <tr class="entry" id="dynamic_android.control.awbState">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3606 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3607 android.<wbr/>control.<wbr/>awb<wbr/>State
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3608 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3609 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]3610 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3611
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3612 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3613
3614 <ul class="entry_type_enum">
3615 <li>
3616 <span class="entry_type_enum_name">INACTIVE</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3617 <span class="entry_type_enum_notes">AWB is not in auto mode.<wbr/> When a camera device is opened,<wbr/> it
3618 starts in this state.<wbr/></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3619 </li>
3620 <li>
3621 <span class="entry_type_enum_name">SEARCHING</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3622 <span class="entry_type_enum_notes">AWB doesn't yet have a good set of control
3623 values for the current scene</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3624 </li>
3625 <li>
3626 <span class="entry_type_enum_name">CONVERGED</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3627 <span class="entry_type_enum_notes">AWB has a good set of control values for the
3628 current scene</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3629 </li>
3630 <li>
3631 <span class="entry_type_enum_name">LOCKED</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3632 <span class="entry_type_enum_notes">AE has been locked (aeMode =
3633 LOCKED)</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3634 </li>
3635 </ul>
3636
3637 </td> <!-- entry_type -->
3638
3639 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3640 <p>Current state of AWB algorithm</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3641 </td>
3642
3643 <td class="entry_units">
3644 </td>
3645
3646 <td class="entry_range">
3647 </td>
3648
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3649 <td class="entry_tags">
3650 </td>
3651
3652 </tr>
3653 <tr class="entries_header">
3654 <th class="th_details" colspan="5">Details</th>
3655 </tr>
3656 <tr class="entry_cont">
3657 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3658 <p>Whenever the AWB algorithm state changes,<wbr/> a
3659MSG_<wbr/>AUTOWHITEBALANCE notification must be send if a
3660notification callback is registered.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3661 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3662 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3663
3664
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3665 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
3666 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3667
3668
3669 <tr class="entry" id="dynamic_android.control.mode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3670 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3671 android.<wbr/>control.<wbr/>mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3672 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3673 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]3674 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3675
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3676 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3677
3678 <ul class="entry_type_enum">
3679 <li>
3680 <span class="entry_type_enum_name">OFF</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3681 <span class="entry_type_enum_notes">Full application control of pipeline.<wbr/> All 3A
3682 routines are disabled,<wbr/> no other settings in
3683 android.<wbr/>control.<wbr/>* have any effect</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3684 </li>
3685 <li>
3686 <span class="entry_type_enum_name">AUTO</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3687 <span class="entry_type_enum_notes">Use settings for each individual 3A routine.<wbr/>
3688 Manual control of capture parameters is disabled.<wbr/> All
3689 controls in android.<wbr/>control.<wbr/>* besides sceneMode take
3690 effect</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3691 </li>
3692 <li>
3693 <span class="entry_type_enum_name">USE_SCENE_MODE</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3694 <span class="entry_type_enum_notes">Use specific scene mode.<wbr/> Enabling this disables
3695 control.<wbr/>aeMode,<wbr/> control.<wbr/>awbMode and control.<wbr/>afMode
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3696 controls; the HAL must ignore those settings while
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3697 USE_<wbr/>SCENE_<wbr/>MODE is active (except for FACE_<wbr/>PRIORITY
3698 scene mode).<wbr/> Other control entries are still active.<wbr/>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3699 This setting can only be used if availableSceneModes !=
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3700 UNSUPPORTED</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3701 </li>
3702 </ul>
3703
3704 </td> <!-- entry_type -->
3705
3706 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3707 <p>Overall mode of 3A control
3708routines</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3709 </td>
3710
3711 <td class="entry_units">
3712 </td>
3713
3714 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]3715 <p>all must be supported</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3716 </td>
3717
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3718 <td class="entry_tags">
3719 <ul class="entry_tags">
3720 <li><a href="#tag_BC">BC</a></li>
3721 </ul>
3722 </td>
3723
3724 </tr>
3725 <tr class="entries_header">
3726 <th class="th_details" colspan="5">Details</th>
3727 </tr>
3728 <tr class="entry_cont">
3729 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3730 <p>High-level 3A control.<wbr/> When set to OFF,<wbr/> all 3A control
3731by the HAL is disabled.<wbr/> The application must set the fields for
3732capture parameters itself.<wbr/></p>
3733<p>When set to AUTO,<wbr/> the individual algorithm controls in
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]3734android.<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]3735<p>When set to USE_<wbr/>SCENE_<wbr/>MODE,<wbr/> the individual controls in
3736android.<wbr/>control.<wbr/>* are mostly disabled,<wbr/> and the HAL implements
3737one of the scene mode settings (such as ACTION,<wbr/> SUNSET,<wbr/> or PARTY)
3738as it wishes.<wbr/> The HAL scene mode 3A settings are provided by
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]3739<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]3740 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3741 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3742
3743
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3744 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
3745 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3746
3747
3748
3749 <!-- end of kind -->
3750 </tbody>
3751
3752 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3753 <tr><td colspan="6" id="section_demosaic" class="section">demosaic</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3754
3755
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3756 <tr><td colspan="6" class="kind">controls</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3757
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3758 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3759 <tr>
3760 <th class="th_name">Property Name</th>
3761 <th class="th_type">Type</th>
3762 <th class="th_description">Description</th>
3763 <th class="th_units">Units</th>
3764 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3765 <th class="th_tags">Tags</th>
3766 </tr>
3767 </thead>
3768
3769 <tbody>
3770
3771
3772
3773
3774
3775
3776
3777
3778
3779
3780 <tr class="entry" id="controls_android.demosaic.mode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3781 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3782 android.<wbr/>demosaic.<wbr/>mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3783 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3784 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]3785 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3786
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3787 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3788
3789 <ul class="entry_type_enum">
3790 <li>
3791 <span class="entry_type_enum_name">FAST</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3792 <span class="entry_type_enum_notes">Minimal or no slowdown of frame rate compared to
3793 Bayer RAW output</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3794 </li>
3795 <li>
3796 <span class="entry_type_enum_name">HIGH_QUALITY</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3797 <span class="entry_type_enum_notes">High-quality may reduce output frame
3798 rate</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3799 </li>
3800 </ul>
3801
3802 </td> <!-- entry_type -->
3803
3804 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3805 <p>Controls the quality of the demosaicing
3806processing</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3807 </td>
3808
3809 <td class="entry_units">
3810 </td>
3811
3812 <td class="entry_range">
3813 </td>
3814
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3815 <td class="entry_tags">
3816 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]3817 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3818 </ul>
3819 </td>
3820
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3821 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3822
3823
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3824 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
3825 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3826
3827
3828
3829 <!-- end of kind -->
3830 </tbody>
3831
3832 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3833 <tr><td colspan="6" id="section_edge" class="section">edge</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3834
3835
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3836 <tr><td colspan="6" class="kind">controls</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3837
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3838 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3839 <tr>
3840 <th class="th_name">Property Name</th>
3841 <th class="th_type">Type</th>
3842 <th class="th_description">Description</th>
3843 <th class="th_units">Units</th>
3844 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3845 <th class="th_tags">Tags</th>
3846 </tr>
3847 </thead>
3848
3849 <tbody>
3850
3851
3852
3853
3854
3855
3856
3857
3858
3859
3860 <tr class="entry" id="controls_android.edge.mode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3861 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3862 android.<wbr/>edge.<wbr/>mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3863 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3864 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]3865 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3866
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3867 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3868
3869 <ul class="entry_type_enum">
3870 <li>
3871 <span class="entry_type_enum_name">OFF</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3872 <span class="entry_type_enum_notes">No edge enhancement is applied</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3873 </li>
3874 <li>
3875 <span class="entry_type_enum_name">FAST</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3876 <span class="entry_type_enum_notes">Must not slow down frame rate relative to sensor
3877 output</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3878 </li>
3879 <li>
3880 <span class="entry_type_enum_name">HIGH_QUALITY</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3881 <span class="entry_type_enum_notes">Frame rate may be reduced by high
3882 quality</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3883 </li>
3884 </ul>
3885
3886 </td> <!-- entry_type -->
3887
3888 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3889 <p>Operation mode for edge
3890enhancement</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3891 </td>
3892
3893 <td class="entry_units">
3894 </td>
3895
3896 <td class="entry_range">
3897 </td>
3898
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3899 <td class="entry_tags">
3900 </td>
3901
3902 </tr>
3903 <tr class="entries_header">
3904 <th class="th_details" colspan="5">Details</th>
3905 </tr>
3906 <tr class="entry_cont">
3907 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3908 <p>Edge/<wbr/>sharpness/<wbr/>detail enhancement.<wbr/> OFF means no
3909enhancement will be applied by the HAL.<wbr/></p>
3910<p>FAST/<wbr/>HIGH_<wbr/>QUALITY both mean HAL-determined enhancement
3911will be applied.<wbr/> HIGH_<wbr/>QUALITY mode indicates that the
3912HAL should use the highest-quality enhancement algorithms,<wbr/>
3913even if it slows down capture rate.<wbr/> FAST means the HAL should
3914not slow down capture rate when applying edge enhancement.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3915 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3916 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3917
3918
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3919 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
3920 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3921
3922
3923 <tr class="entry" id="controls_android.edge.strength">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3924 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3925 android.<wbr/>edge.<wbr/>strength
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3926 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3927 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]3928 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3929
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3930 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3931
3932
3933 </td> <!-- entry_type -->
3934
3935 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3936 <p>Control the amount of edge enhancement
3937applied to the images</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3938 </td>
3939
3940 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3941 1-10; 10 is maximum sharpening
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3942 </td>
3943
3944 <td class="entry_range">
3945 </td>
3946
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3947 <td class="entry_tags">
3948 </td>
3949
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3950 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3951
3952
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3953 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
3954 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3955
3956
3957
3958 <!-- end of kind -->
3959 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3960 <tr><td colspan="6" class="kind">dynamic</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3961
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3962 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3963 <tr>
3964 <th class="th_name">Property Name</th>
3965 <th class="th_type">Type</th>
3966 <th class="th_description">Description</th>
3967 <th class="th_units">Units</th>
3968 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3969 <th class="th_tags">Tags</th>
3970 </tr>
3971 </thead>
3972
3973 <tbody>
3974
3975
3976
3977
3978
3979
3980
3981
3982
3983
3984 <tr class="entry" id="dynamic_android.edge.mode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3985 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3986 android.<wbr/>edge.<wbr/>mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3987 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3988 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]3989 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3990
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3991 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3992
3993 <ul class="entry_type_enum">
3994 <li>
3995 <span class="entry_type_enum_name">OFF</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3996 <span class="entry_type_enum_notes">No edge enhancement is applied</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3997 </li>
3998 <li>
3999 <span class="entry_type_enum_name">FAST</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4000 <span class="entry_type_enum_notes">Must not slow down frame rate relative to sensor
4001 output</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4002 </li>
4003 <li>
4004 <span class="entry_type_enum_name">HIGH_QUALITY</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4005 <span class="entry_type_enum_notes">Frame rate may be reduced by high
4006 quality</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4007 </li>
4008 </ul>
4009
4010 </td> <!-- entry_type -->
4011
4012 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4013 <p>Operation mode for edge
4014enhancement</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4015 </td>
4016
4017 <td class="entry_units">
4018 </td>
4019
4020 <td class="entry_range">
4021 </td>
4022
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4023 <td class="entry_tags">
4024 </td>
4025
4026 </tr>
4027 <tr class="entries_header">
4028 <th class="th_details" colspan="5">Details</th>
4029 </tr>
4030 <tr class="entry_cont">
4031 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4032 <p>Edge/<wbr/>sharpness/<wbr/>detail enhancement.<wbr/> OFF means no
4033enhancement will be applied by the HAL.<wbr/></p>
4034<p>FAST/<wbr/>HIGH_<wbr/>QUALITY both mean HAL-determined enhancement
4035will be applied.<wbr/> HIGH_<wbr/>QUALITY mode indicates that the
4036HAL should use the highest-quality enhancement algorithms,<wbr/>
4037even if it slows down capture rate.<wbr/> FAST means the HAL should
4038not slow down capture rate when applying edge enhancement.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4039 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4040 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4041
4042
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4043 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
4044 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4045
4046
4047
4048 <!-- end of kind -->
4049 </tbody>
4050
4051 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4052 <tr><td colspan="6" id="section_flash" class="section">flash</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4053
4054
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4055 <tr><td colspan="6" class="kind">controls</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4056
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4057 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4058 <tr>
4059 <th class="th_name">Property Name</th>
4060 <th class="th_type">Type</th>
4061 <th class="th_description">Description</th>
4062 <th class="th_units">Units</th>
4063 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4064 <th class="th_tags">Tags</th>
4065 </tr>
4066 </thead>
4067
4068 <tbody>
4069
4070
4071
4072
4073
4074
4075
4076
4077
4078
4079 <tr class="entry" id="controls_android.flash.firingPower">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4080 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4081 android.<wbr/>flash.<wbr/>firing<wbr/>Power
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4082 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4083 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4084 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4085
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4086 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4087
4088
4089 </td> <!-- entry_type -->
4090
4091 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4092 <p>Power for flash firing/<wbr/>torch</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4093 </td>
4094
4095 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4096 10 is max power; 0 is no flash.<wbr/> Linear
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4097 </td>
4098
4099 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]4100 <p>0 - 10</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4101 </td>
4102
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4103 <td class="entry_tags">
4104 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]4105 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4106 </ul>
4107 </td>
4108
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4109 </tr>
4110 <tr class="entries_header">
4111 <th class="th_details" colspan="5">Details</th>
4112 </tr>
4113 <tr class="entry_cont">
4114 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4115 <p>Power for snapshot may use a different scale than
4116for torch mode.<wbr/> Only one entry for torch mode will be
4117used</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4118 </td>
4119 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4120
4121
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4122 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
4123 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4124
4125
4126 <tr class="entry" id="controls_android.flash.firingTime">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4127 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4128 android.<wbr/>flash.<wbr/>firing<wbr/>Time
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4129 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4130 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4131 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4132
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4133 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4134
4135
4136 </td> <!-- entry_type -->
4137
4138 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4139 <p>Firing time of flash relative to start of
4140exposure</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4141 </td>
4142
4143 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4144 nanoseconds
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4145 </td>
4146
4147 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]4148 <p>0-(exposure time-flash duration)</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4149 </td>
4150
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4151 <td class="entry_tags">
4152 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]4153 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4154 </ul>
4155 </td>
4156
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4157 </tr>
4158 <tr class="entries_header">
4159 <th class="th_details" colspan="5">Details</th>
4160 </tr>
4161 <tr class="entry_cont">
4162 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4163 <p>Clamped to (0,<wbr/> exposure time - flash
4164duration).<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4165 </td>
4166 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4167
4168
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4169 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
4170 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4171
4172
4173 <tr class="entry" id="controls_android.flash.mode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4174 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4175 android.<wbr/>flash.<wbr/>mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4176 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4177 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4178 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4179
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4180 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4181
4182 <ul class="entry_type_enum">
4183 <li>
4184 <span class="entry_type_enum_name">OFF</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4185 <span class="entry_type_enum_notes">Do not fire the flash for this
4186 capture</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4187 </li>
4188 <li>
4189 <span class="entry_type_enum_name">SINGLE</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4190 <span class="entry_type_enum_notes">if android.<wbr/>flash.<wbr/>available is true Fire flash
4191 for this capture based on firingPower,<wbr/>
4192 firingTime.<wbr/></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4193 </li>
4194 <li>
4195 <span class="entry_type_enum_name">TORCH</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4196 <span class="entry_type_enum_notes">if android.<wbr/>flash.<wbr/>available is true Flash
4197 continuously on,<wbr/> power set by
4198 firingPower</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4199 </li>
4200 </ul>
4201
4202 </td> <!-- entry_type -->
4203
4204 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4205 <p>Select flash operation mode</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4206 </td>
4207
4208 <td class="entry_units">
4209 </td>
4210
4211 <td class="entry_range">
4212 </td>
4213
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4214 <td class="entry_tags">
4215 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]4216 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4217 </ul>
4218 </td>
4219
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4220 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4221
4222
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4223 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
4224 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4225
4226
4227
4228 <!-- end of kind -->
4229 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4230 <tr><td colspan="6" class="kind">static</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4231
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4232 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4233 <tr>
4234 <th class="th_name">Property Name</th>
4235 <th class="th_type">Type</th>
4236 <th class="th_description">Description</th>
4237 <th class="th_units">Units</th>
4238 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4239 <th class="th_tags">Tags</th>
4240 </tr>
4241 </thead>
4242
4243 <tbody>
4244
4245
4246
4247
4248
4249
4250
4251
4252
4253
4254
4255
4256 <tr class="entry" id="static_android.flash.info.available">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4257 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4258 android.<wbr/>flash.<wbr/>info.<wbr/>available
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4259 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4260 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4261 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4262
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4263 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4264
4265
4266 </td> <!-- entry_type -->
4267
4268 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4269 <p>Whether this camera has a
4270flash</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4271 </td>
4272
4273 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4274 boolean (0 = false,<wbr/> otherwise true)
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4275 </td>
4276
4277 <td class="entry_range">
4278 </td>
4279
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4280 <td class="entry_tags">
4281 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]4282 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4283 </ul>
4284 </td>
4285
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4286 </tr>
4287 <tr class="entries_header">
4288 <th class="th_details" colspan="5">Details</th>
4289 </tr>
4290 <tr class="entry_cont">
4291 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4292 <p>If no flash,<wbr/> none of the flash controls do
4293anything.<wbr/> All other metadata should return 0</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4294 </td>
4295 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4296
4297
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4298 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
4299 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4300
4301
4302 <tr class="entry" id="static_android.flash.info.chargeDuration">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4303 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4304 android.<wbr/>flash.<wbr/>info.<wbr/>charge<wbr/>Duration
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4305 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4306 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4307 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4308
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4309 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4310
4311
4312 </td> <!-- entry_type -->
4313
4314 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4315 <p>Time taken before flash can fire
4316again</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4317 </td>
4318
4319 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4320 nanoseconds
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4321 </td>
4322
4323 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]4324 <p>0-1e9</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4325 </td>
4326
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4327 <td class="entry_tags">
4328 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]4329 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4330 </ul>
4331 </td>
4332
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4333 </tr>
4334 <tr class="entries_header">
4335 <th class="th_details" colspan="5">Details</th>
4336 </tr>
4337 <tr class="entry_cont">
4338 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4339 <p>1 second too long/<wbr/>too short for recharge? Should
4340this be power-dependent?</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4341 </td>
4342 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4343
4344
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4345 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
4346 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4347
4348
4349
4350
4351
4352 <tr class="entry" id="static_android.flash.colorTemperature">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4353 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4354 android.<wbr/>flash.<wbr/>color<wbr/>Temperature
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4355 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4356 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4357 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4358
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4359 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4360
4361
4362 </td> <!-- entry_type -->
4363
4364 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4365 <p>The x,<wbr/>y whitepoint of the
4366flash</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4367 </td>
4368
4369 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4370 pair of floats
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4371 </td>
4372
4373 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]4374 <p>0-1 for both</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4375 </td>
4376
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4377 <td class="entry_tags">
4378 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]4379 <li><a href="#tag_ADV">ADV</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4380 </ul>
4381 </td>
4382
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4383 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4384
4385
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4386 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
4387 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4388
4389
4390 <tr class="entry" id="static_android.flash.maxEnergy">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4391 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4392 android.<wbr/>flash.<wbr/>max<wbr/>Energy
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4393 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4394 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4395 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4396
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4397 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4398
4399
4400 </td> <!-- entry_type -->
4401
4402 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4403 <p>Max energy output of the flash for a full
4404power single flash</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4405 </td>
4406
4407 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4408 lumen-seconds
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4409 </td>
4410
4411 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame^]4412 <p>&gt;= 0</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4413 </td>
4414
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4415 <td class="entry_tags">
4416 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]4417 <li><a href="#tag_ADV">ADV</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4418 </ul>
4419 </td>
4420
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4421 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4422
4423
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4424 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
4425 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4426
4427
4428
4429 <!-- end of kind -->
4430 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4431 <tr><td colspan="6" class="kind">dynamic</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4432
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4433 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4434 <tr>
4435 <th class="th_name">Property Name</th>
4436 <th class="th_type">Type</th>
4437 <th class="th_description">Description</th>
4438 <th class="th_units">Units</th>
4439 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4440 <th class="th_tags">Tags</th>
4441 </tr>
4442 </thead>
4443
4444 <tbody>
4445
4446
4447
4448
4449
4450
4451
4452
4453
4454
4455 <tr class="entry" id="dynamic_android.flash.firingPower">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4456 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4457 android.<wbr/>flash.<wbr/>firing<wbr/>Power
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4458 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4459 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4460 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4461
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4462 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4463
4464
4465 </td> <!-- entry_type -->
4466
4467 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4468 <p>Power for flash firing/<wbr/>torch</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4469 </td>
4470
4471 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4472 10 is max power; 0 is no flash.<wbr/> Linear
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4473 </td>
4474
4475 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]4476 <p>0 - 10</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4477 </td>
4478
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4479 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]4480 <ul class="entry_tags">
4481 <li><a href="#tag_V1">V1</a></li>
4482 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4483 </td>
4484
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4485 </tr>
4486 <tr class="entries_header">
4487 <th class="th_details" colspan="5">Details</th>
4488 </tr>
4489 <tr class="entry_cont">
4490 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4491 <p>Power for snapshot may use a different scale than
4492for torch mode.<wbr/> Only one entry for torch mode will be
4493used</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4494 </td>
4495 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4496
4497
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4498 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
4499 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4500
4501
4502 <tr class="entry" id="dynamic_android.flash.firingTime">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4503 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4504 android.<wbr/>flash.<wbr/>firing<wbr/>Time
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4505 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4506 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4507 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4508
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4509 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4510
4511
4512 </td> <!-- entry_type -->
4513
4514 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4515 <p>Firing time of flash relative to start of
4516exposure</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4517 </td>
4518
4519 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4520 nanoseconds
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4521 </td>
4522
4523 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]4524 <p>0-(exposure time-flash duration)</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4525 </td>
4526
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4527 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]4528 <ul class="entry_tags">
4529 <li><a href="#tag_V1">V1</a></li>
4530 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4531 </td>
4532
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4533 </tr>
4534 <tr class="entries_header">
4535 <th class="th_details" colspan="5">Details</th>
4536 </tr>
4537 <tr class="entry_cont">
4538 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4539 <p>Clamped to (0,<wbr/> exposure time - flash
4540duration).<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4541 </td>
4542 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4543
4544
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4545 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
4546 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4547
4548
4549 <tr class="entry" id="dynamic_android.flash.mode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4550 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4551 android.<wbr/>flash.<wbr/>mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4552 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4553 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4554 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4555
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4556 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4557
4558 <ul class="entry_type_enum">
4559 <li>
4560 <span class="entry_type_enum_name">OFF</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4561 <span class="entry_type_enum_notes">Do not fire the flash for this
4562 capture</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4563 </li>
4564 <li>
4565 <span class="entry_type_enum_name">SINGLE</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4566 <span class="entry_type_enum_notes">if android.<wbr/>flash.<wbr/>available is true Fire flash
4567 for this capture based on firingPower,<wbr/>
4568 firingTime.<wbr/></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4569 </li>
4570 <li>
4571 <span class="entry_type_enum_name">TORCH</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4572 <span class="entry_type_enum_notes">if android.<wbr/>flash.<wbr/>available is true Flash
4573 continuously on,<wbr/> power set by
4574 firingPower</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4575 </li>
4576 </ul>
4577
4578 </td> <!-- entry_type -->
4579
4580 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4581 <p>Select flash operation mode</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4582 </td>
4583
4584 <td class="entry_units">
4585 </td>
4586
4587 <td class="entry_range">
4588 </td>
4589
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4590 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]4591 <ul class="entry_tags">
4592 <li><a href="#tag_BC">BC</a></li>
4593 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4594 </td>
4595
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4596 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4597
4598
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4599 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
4600 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4601
4602
4603 <tr class="entry" id="dynamic_android.flash.state">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4604 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4605 android.<wbr/>flash.<wbr/>state
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4606 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4607 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4608 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4609
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4610 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4611
4612 <ul class="entry_type_enum">
4613 <li>
4614 <span class="entry_type_enum_name">UNAVAILABLE</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4615 <span class="entry_type_enum_notes">No flash on camera</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4616 </li>
4617 <li>
4618 <span class="entry_type_enum_name">CHARGING</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4619 <span class="entry_type_enum_notes">if android.<wbr/>flash.<wbr/>available is true Flash is
4620 charging and cannot be fired</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4621 </li>
4622 <li>
4623 <span class="entry_type_enum_name">READY</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4624 <span class="entry_type_enum_notes">if android.<wbr/>flash.<wbr/>available is true Flash is
4625 ready to fire</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4626 </li>
4627 <li>
4628 <span class="entry_type_enum_name">FIRED</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4629 <span class="entry_type_enum_notes">if android.<wbr/>flash.<wbr/>available is true Flash fired
4630 for this capture</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4631 </li>
4632 </ul>
4633
4634 </td> <!-- entry_type -->
4635
4636 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4637 <p>Current state of the flash
4638unit</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4639 </td>
4640
4641 <td class="entry_units">
4642 </td>
4643
4644 <td class="entry_range">
4645 </td>
4646
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4647 <td class="entry_tags">
4648 </td>
4649
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4650 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4651
4652
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4653 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
4654 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4655
4656
4657
4658 <!-- end of kind -->
4659 </tbody>
4660
4661 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4662 <tr><td colspan="6" id="section_geometric" class="section">geometric</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4663
4664
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4665 <tr><td colspan="6" class="kind">controls</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4666
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4667 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4668 <tr>
4669 <th class="th_name">Property Name</th>
4670 <th class="th_type">Type</th>
4671 <th class="th_description">Description</th>
4672 <th class="th_units">Units</th>
4673 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4674 <th class="th_tags">Tags</th>
4675 </tr>
4676 </thead>
4677
4678 <tbody>
4679
4680
4681
4682
4683
4684
4685
4686
4687
4688
4689 <tr class="entry" id="controls_android.geometric.mode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4690 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4691 android.<wbr/>geometric.<wbr/>mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4692 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4693 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4694 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4695
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4696 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4697
4698 <ul class="entry_type_enum">
4699 <li>
4700 <span class="entry_type_enum_name">OFF</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4701 <span class="entry_type_enum_notes">No geometric correction is
4702 applied</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4703 </li>
4704 <li>
4705 <span class="entry_type_enum_name">FAST</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4706 <span class="entry_type_enum_notes">Must not slow down frame rate relative to raw
4707 bayer output</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4708 </li>
4709 <li>
4710 <span class="entry_type_enum_name">HIGH_QUALITY</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4711 <span class="entry_type_enum_notes">Frame rate may be reduced by high
4712 quality</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4713 </li>
4714 </ul>
4715
4716 </td> <!-- entry_type -->
4717
4718 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4719 <p>Operating mode of geometric
4720correction</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4721 </td>
4722
4723 <td class="entry_units">
4724 </td>
4725
4726 <td class="entry_range">
4727 </td>
4728
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4729 <td class="entry_tags">
4730 </td>
4731
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4732 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4733
4734
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4735 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
4736 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4737
4738
4739 <tr class="entry" id="controls_android.geometric.strength">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4740 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4741 android.<wbr/>geometric.<wbr/>strength
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4742 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4743 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4744 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4745
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4746 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4747
4748
4749 </td> <!-- entry_type -->
4750
4751 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4752 <p>Control the amount of shading correction
4753applied to the images</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4754 </td>
4755
4756 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4757 unitless: 1-10; 10 is full shading
4758 compensation
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4759 </td>
4760
4761 <td class="entry_range">
4762 </td>
4763
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4764 <td class="entry_tags">
4765 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]4766 <li><a href="#tag_ADV">ADV</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4767 </ul>
4768 </td>
4769
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4770 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4771
4772
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4773 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
4774 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4775
4776
4777
4778 <!-- end of kind -->
4779 </tbody>
4780
4781 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4782 <tr><td colspan="6" id="section_hotPixel" class="section">hotPixel</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4783
4784
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4785 <tr><td colspan="6" class="kind">controls</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4786
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4787 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4788 <tr>
4789 <th class="th_name">Property Name</th>
4790 <th class="th_type">Type</th>
4791 <th class="th_description">Description</th>
4792 <th class="th_units">Units</th>
4793 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4794 <th class="th_tags">Tags</th>
4795 </tr>
4796 </thead>
4797
4798 <tbody>
4799
4800
4801
4802
4803
4804
4805
4806
4807
4808
4809 <tr class="entry" id="controls_android.hotPixel.mode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4810 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4811 android.<wbr/>hot<wbr/>Pixel.<wbr/>mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4812 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4813 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4814 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4815
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4816 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4817
4818 <ul class="entry_type_enum">
4819 <li>
4820 <span class="entry_type_enum_name">OFF</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4821 <span class="entry_type_enum_notes">No hot pixel correction can be
4822 applied</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4823 </li>
4824 <li>
4825 <span class="entry_type_enum_name">FAST</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4826 <span class="entry_type_enum_notes">Frame rate must not be reduced compared to raw
4827 Bayer output</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4828 </li>
4829 <li>
4830 <span class="entry_type_enum_name">HIGH_QUALITY</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4831 <span class="entry_type_enum_notes">Frame rate may be reduced by high
4832 quality</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4833 </li>
4834 </ul>
4835
4836 </td> <!-- entry_type -->
4837
4838 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4839 <p>Set operational mode for hot pixel
4840correction</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4841 </td>
4842
4843 <td class="entry_units">
4844 </td>
4845
4846 <td class="entry_range">
4847 </td>
4848
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4849 <td class="entry_tags">
4850 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]4851 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4852 </ul>
4853 </td>
4854
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4855 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4856
4857
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4858 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
4859 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4860
4861
4862
4863 <!-- end of kind -->
4864 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4865 <tr><td colspan="6" class="kind">static</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4866
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4867 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4868 <tr>
4869 <th class="th_name">Property Name</th>
4870 <th class="th_type">Type</th>
4871 <th class="th_description">Description</th>
4872 <th class="th_units">Units</th>
4873 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4874 <th class="th_tags">Tags</th>
4875 </tr>
4876 </thead>
4877
4878 <tbody>
4879
4880
4881
4882
4883
4884
4885
4886
4887
4888
4889
4890
4891 <tr class="entry" id="static_android.hotPixel.info.map">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4892 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4893 android.<wbr/>hot<wbr/>Pixel.<wbr/>info.<wbr/>map
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4894 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4895 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4896 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4897 <span class="entry_type_container">x</span>
4898
4899 <span class="entry_type_array">
4900 2 x n
4901 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4902 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4903 <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]4904
4905
4906 </td> <!-- entry_type -->
4907
4908 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4909 <p>Location of hot/<wbr/>defective pixels on
4910sensor</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4911 </td>
4912
4913 <td class="entry_units">
4914 </td>
4915
4916 <td class="entry_range">
4917 </td>
4918
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4919 <td class="entry_tags">
4920 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]4921 <li><a href="#tag_ADV">ADV</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4922 </ul>
4923 </td>
4924
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4925 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4926
4927
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4928 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
4929 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4930
4931
4932
4933
4934
4935
4936 <!-- end of kind -->
4937 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4938 <tr><td colspan="6" class="kind">dynamic</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4939
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4940 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4941 <tr>
4942 <th class="th_name">Property Name</th>
4943 <th class="th_type">Type</th>
4944 <th class="th_description">Description</th>
4945 <th class="th_units">Units</th>
4946 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4947 <th class="th_tags">Tags</th>
4948 </tr>
4949 </thead>
4950
4951 <tbody>
4952
4953
4954
4955
4956
4957
4958
4959
4960
4961
4962 <tr class="entry" id="dynamic_android.hotPixel.mode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4963 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4964 android.<wbr/>hot<wbr/>Pixel.<wbr/>mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4965 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4966 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4967 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4968
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4969 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4970
4971 <ul class="entry_type_enum">
4972 <li>
4973 <span class="entry_type_enum_name">OFF</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4974 <span class="entry_type_enum_notes">No hot pixel correction can be
4975 applied</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4976 </li>
4977 <li>
4978 <span class="entry_type_enum_name">FAST</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4979 <span class="entry_type_enum_notes">Frame rate must not be reduced compared to raw
4980 Bayer output</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4981 </li>
4982 <li>
4983 <span class="entry_type_enum_name">HIGH_QUALITY</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4984 <span class="entry_type_enum_notes">Frame rate may be reduced by high
4985 quality</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4986 </li>
4987 </ul>
4988
4989 </td> <!-- entry_type -->
4990
4991 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4992 <p>Set operational mode for hot pixel
4993correction</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4994 </td>
4995
4996 <td class="entry_units">
4997 </td>
4998
4999 <td class="entry_range">
5000 </td>
5001
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5002 <td class="entry_tags">
5003 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5004 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5005 </ul>
5006 </td>
5007
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5008 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5009
5010
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5011 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5012 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5013
5014
5015
5016 <!-- end of kind -->
5017 </tbody>
5018
5019 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5020 <tr><td colspan="6" id="section_jpeg" class="section">jpeg</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5021
5022
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5023 <tr><td colspan="6" class="kind">controls</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5024
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5025 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5026 <tr>
5027 <th class="th_name">Property Name</th>
5028 <th class="th_type">Type</th>
5029 <th class="th_description">Description</th>
5030 <th class="th_units">Units</th>
5031 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5032 <th class="th_tags">Tags</th>
5033 </tr>
5034 </thead>
5035
5036 <tbody>
5037
5038
5039
5040
5041
5042
5043
5044
5045
5046
5047 <tr class="entry" id="controls_android.jpeg.gpsCoordinates">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5048 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5049 android.<wbr/>jpeg.<wbr/>gps<wbr/>Coordinates
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5050 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5051 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5052 <span class="entry_type_name">double</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5053 <span class="entry_type_container">x</span>
5054
5055 <span class="entry_type_array">
5056 3
5057 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5058 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5059 <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]5060
5061
5062 </td> <!-- entry_type -->
5063
5064 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5065 <p>GPS coordinates to include in output JPEG
5066EXIF</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5067 </td>
5068
5069 <td class="entry_units">
5070 </td>
5071
5072 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]5073 <p>(-180 - 180],<wbr/> [-90,<wbr/>90],<wbr/> [-inf,<wbr/> inf]</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5074 </td>
5075
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5076 <td class="entry_tags">
5077 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5078 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5079 </ul>
5080 </td>
5081
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5082 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5083
5084
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5085 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5086 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5087
5088
5089 <tr class="entry" id="controls_android.jpeg.gpsProcessingMethod">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5090 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5091 android.<wbr/>jpeg.<wbr/>gps<wbr/>Processing<wbr/>Method
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5092 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5093 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5094 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5095
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]5096 <span class="entry_type_visibility"> [public as string]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5097
5098
5099 </td> <!-- entry_type -->
5100
5101 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5102 <p>32 characters describing GPS algorithm to
5103include in EXIF</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5104 </td>
5105
5106 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5107 UTF-8 null-terminated string
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5108 </td>
5109
5110 <td class="entry_range">
5111 </td>
5112
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5113 <td class="entry_tags">
5114 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5115 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5116 </ul>
5117 </td>
5118
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5119 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5120
5121
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5122 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5123 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5124
5125
5126 <tr class="entry" id="controls_android.jpeg.gpsTimestamp">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5127 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5128 android.<wbr/>jpeg.<wbr/>gps<wbr/>Timestamp
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5129 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5130 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5131 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5132
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5133 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5134
5135
5136 </td> <!-- entry_type -->
5137
5138 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5139 <p>Time GPS fix was made to include in
5140EXIF</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5141 </td>
5142
5143 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5144 UTC in seconds since January 1,<wbr/> 1970
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5145 </td>
5146
5147 <td class="entry_range">
5148 </td>
5149
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5150 <td class="entry_tags">
5151 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5152 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5153 </ul>
5154 </td>
5155
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5156 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5157
5158
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5159 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5160 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5161
5162
5163 <tr class="entry" id="controls_android.jpeg.orientation">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5164 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5165 android.<wbr/>jpeg.<wbr/>orientation
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5166 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5167 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5168 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5169
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5170 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5171
5172
5173 </td> <!-- entry_type -->
5174
5175 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5176 <p>Orientation of JPEG image to
5177write</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5178 </td>
5179
5180 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5181 Degrees in multiples of 90
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5182 </td>
5183
5184 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]5185 <p>0,<wbr/> 90,<wbr/> 180,<wbr/> 270</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5186 </td>
5187
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5188 <td class="entry_tags">
5189 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5190 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5191 </ul>
5192 </td>
5193
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5194 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5195
5196
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5197 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5198 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5199
5200
5201 <tr class="entry" id="controls_android.jpeg.quality">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5202 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5203 android.<wbr/>jpeg.<wbr/>quality
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5204 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5205 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5206 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5207
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5208 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5209
5210
5211 </td> <!-- entry_type -->
5212
5213 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5214 <p>Compression quality of the final JPEG
5215image</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5216 </td>
5217
5218 <td class="entry_units">
5219 </td>
5220
5221 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]5222 <p>1-100; larger is higher quality</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5223 </td>
5224
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5225 <td class="entry_tags">
5226 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5227 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5228 </ul>
5229 </td>
5230
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5231 </tr>
5232 <tr class="entries_header">
5233 <th class="th_details" colspan="5">Details</th>
5234 </tr>
5235 <tr class="entry_cont">
5236 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5237 <p>85-95 is typical usage range</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5238 </td>
5239 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5240
5241
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5242 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5243 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5244
5245
5246 <tr class="entry" id="controls_android.jpeg.thumbnailQuality">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5247 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5248 android.<wbr/>jpeg.<wbr/>thumbnail<wbr/>Quality
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5249 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5250 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5251 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5252
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5253 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5254
5255
5256 </td> <!-- entry_type -->
5257
5258 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5259 <p>Compression quality of JPEG
5260thumbnail</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5261 </td>
5262
5263 <td class="entry_units">
5264 </td>
5265
5266 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]5267 <p>1-100; larger is higher quality</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5268 </td>
5269
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5270 <td class="entry_tags">
5271 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5272 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5273 </ul>
5274 </td>
5275
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5276 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5277
5278
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5279 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5280 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5281
5282
5283 <tr class="entry" id="controls_android.jpeg.thumbnailSize">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5284 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5285 android.<wbr/>jpeg.<wbr/>thumbnail<wbr/>Size
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5286 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5287 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5288 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5289 <span class="entry_type_container">x</span>
5290
5291 <span class="entry_type_array">
5292 2
5293 </span>
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]5294 <span class="entry_type_visibility"> [public as size]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5295
5296
5297 </td> <!-- entry_type -->
5298
5299 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5300 <p>Resolution of embedded JPEG thumbnail</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5301 </td>
5302
5303 <td class="entry_units">
5304 </td>
5305
5306 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]5307 <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]5308 </td>
5309
5310 <td class="entry_tags">
5311 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5312 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5313 </ul>
5314 </td>
5315
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5316 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5317 <tr class="entries_header">
5318 <th class="th_details" colspan="5">Details</th>
5319 </tr>
5320 <tr class="entry_cont">
5321 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5322 <p>When set to (0,<wbr/> 0) value,<wbr/> the JPEG EXIF must not contain thumbnail,<wbr/>
5323but the captured JPEG must still be a valid image.<wbr/></p>
5324<p>When a jpeg image capture is issued,<wbr/> the thumbnail size selected should have
5325the same aspect ratio as the jpeg image.<wbr/></p>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5326 </td>
5327 </tr>
5328
5329
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5330 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5331 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5332
5333
5334
5335 <!-- end of kind -->
5336 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5337 <tr><td colspan="6" class="kind">static</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5338
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5339 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5340 <tr>
5341 <th class="th_name">Property Name</th>
5342 <th class="th_type">Type</th>
5343 <th class="th_description">Description</th>
5344 <th class="th_units">Units</th>
5345 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5346 <th class="th_tags">Tags</th>
5347 </tr>
5348 </thead>
5349
5350 <tbody>
5351
5352
5353
5354
5355
5356
5357
5358
5359
5360
5361 <tr class="entry" id="static_android.jpeg.availableThumbnailSizes">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5362 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5363 android.<wbr/>jpeg.<wbr/>available<wbr/>Thumbnail<wbr/>Sizes
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5364 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5365 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5366 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5367 <span class="entry_type_container">x</span>
5368
5369 <span class="entry_type_array">
5370 2 x n
5371 </span>
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]5372 <span class="entry_type_visibility"> [public as size]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5373
5374
5375 </td> <!-- entry_type -->
5376
5377 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5378 <p>Supported resolutions for the JPEG thumbnail</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5379 </td>
5380
5381 <td class="entry_units">
5382 </td>
5383
5384 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]5385 <p>Must include at least one valid resolution,<wbr/> plus
5386(0,<wbr/>0) for no thumbnail generation,<wbr/> and each size must be distinct.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5387 </td>
5388
5389 <td class="entry_tags">
5390 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5391 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5392 </ul>
5393 </td>
5394
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5395 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5396 <tr class="entries_header">
5397 <th class="th_details" colspan="5">Details</th>
5398 </tr>
5399 <tr class="entry_cont">
5400 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5401 <p>Below condiditions must be satisfied for this size list:</p>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5402<ul>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5403<li>The sizes must be sorted by increasing pixel area (width x height).<wbr/>
5404If several resolutions have the same area,<wbr/> they must be sorted by increasing width.<wbr/></li>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5405<li>The aspect ratio of the largest thumbnail size must be same as the
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]5406aspect 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]5407The largest size is defined as the size that has the largest pixel area
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5408in a given size list.<wbr/></li>
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]5409<li>Each size in <a href="#static_android.scaler.availableJpegSizes">android.<wbr/>scaler.<wbr/>available<wbr/>Jpeg<wbr/>Sizes</a> must have at least
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5410one corresponding size that has the same aspect ratio in availableThumbnailSizes,<wbr/>
5411and vice versa.<wbr/></li>
5412<li>All non (0,<wbr/> 0) sizes must have non-zero widths and heights.<wbr/></li>
5413</ul>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5414 </td>
5415 </tr>
5416
5417
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5418 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5419 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5420
5421
5422 <tr class="entry" id="static_android.jpeg.maxSize">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5423 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5424 android.<wbr/>jpeg.<wbr/>max<wbr/>Size
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5425 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5426 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5427 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5428
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5429 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5430
5431
5432 </td> <!-- entry_type -->
5433
5434 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5435 <p>Maximum size in bytes for the compressed
5436JPEG buffer</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5437 </td>
5438
5439 <td class="entry_units">
5440 </td>
5441
5442 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]5443 <p>Must be large enough to fit any JPEG produced by
5444the camera</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5445 </td>
5446
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5447 <td class="entry_tags">
5448 </td>
5449
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5450 </tr>
5451 <tr class="entries_header">
5452 <th class="th_details" colspan="5">Details</th>
5453 </tr>
5454 <tr class="entry_cont">
5455 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5456 <p>This is used for sizing the gralloc buffers for
5457JPEG</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5458 </td>
5459 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5460
5461
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5462 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5463 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5464
5465
5466
5467 <!-- end of kind -->
5468 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5469 <tr><td colspan="6" class="kind">dynamic</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5470
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5471 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5472 <tr>
5473 <th class="th_name">Property Name</th>
5474 <th class="th_type">Type</th>
5475 <th class="th_description">Description</th>
5476 <th class="th_units">Units</th>
5477 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5478 <th class="th_tags">Tags</th>
5479 </tr>
5480 </thead>
5481
5482 <tbody>
5483
5484
5485
5486
5487
5488
5489
5490
5491
5492
5493 <tr class="entry" id="dynamic_android.jpeg.gpsCoordinates">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5494 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5495 android.<wbr/>jpeg.<wbr/>gps<wbr/>Coordinates
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5496 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5497 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5498 <span class="entry_type_name">double</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5499 <span class="entry_type_container">x</span>
5500
5501 <span class="entry_type_array">
5502 3
5503 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5504 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5505 <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]5506
5507
5508 </td> <!-- entry_type -->
5509
5510 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5511 <p>GPS coordinates to include in output JPEG
5512EXIF</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5513 </td>
5514
5515 <td class="entry_units">
5516 </td>
5517
5518 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]5519 <p>(-180 - 180],<wbr/> [-90,<wbr/>90],<wbr/> [-inf,<wbr/> inf]</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5520 </td>
5521
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5522 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5523 <ul class="entry_tags">
5524 <li><a href="#tag_BC">BC</a></li>
5525 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5526 </td>
5527
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5528 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5529
5530
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5531 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5532 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5533
5534
5535 <tr class="entry" id="dynamic_android.jpeg.gpsProcessingMethod">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5536 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5537 android.<wbr/>jpeg.<wbr/>gps<wbr/>Processing<wbr/>Method
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5538 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5539 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5540 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5541
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]5542 <span class="entry_type_visibility"> [public as string]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5543
5544
5545 </td> <!-- entry_type -->
5546
5547 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5548 <p>32 characters describing GPS algorithm to
5549include in EXIF</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5550 </td>
5551
5552 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5553 UTF-8 null-terminated string
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5554 </td>
5555
5556 <td class="entry_range">
5557 </td>
5558
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5559 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5560 <ul class="entry_tags">
5561 <li><a href="#tag_BC">BC</a></li>
5562 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5563 </td>
5564
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5565 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5566
5567
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5568 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5569 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5570
5571
5572 <tr class="entry" id="dynamic_android.jpeg.gpsTimestamp">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5573 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5574 android.<wbr/>jpeg.<wbr/>gps<wbr/>Timestamp
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5575 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5576 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5577 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5578
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5579 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5580
5581
5582 </td> <!-- entry_type -->
5583
5584 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5585 <p>Time GPS fix was made to include in
5586EXIF</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5587 </td>
5588
5589 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5590 UTC in seconds since January 1,<wbr/> 1970
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5591 </td>
5592
5593 <td class="entry_range">
5594 </td>
5595
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5596 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5597 <ul class="entry_tags">
5598 <li><a href="#tag_BC">BC</a></li>
5599 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5600 </td>
5601
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5602 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5603
5604
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5605 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5606 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5607
5608
5609 <tr class="entry" id="dynamic_android.jpeg.orientation">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5610 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5611 android.<wbr/>jpeg.<wbr/>orientation
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5612 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5613 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5614 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5615
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5616 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5617
5618
5619 </td> <!-- entry_type -->
5620
5621 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5622 <p>Orientation of JPEG image to
5623write</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5624 </td>
5625
5626 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5627 Degrees in multiples of 90
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5628 </td>
5629
5630 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]5631 <p>0,<wbr/> 90,<wbr/> 180,<wbr/> 270</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5632 </td>
5633
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5634 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5635 <ul class="entry_tags">
5636 <li><a href="#tag_BC">BC</a></li>
5637 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5638 </td>
5639
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5640 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5641
5642
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5643 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5644 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5645
5646
5647 <tr class="entry" id="dynamic_android.jpeg.quality">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5648 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5649 android.<wbr/>jpeg.<wbr/>quality
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5650 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5651 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5652 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5653
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5654 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5655
5656
5657 </td> <!-- entry_type -->
5658
5659 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5660 <p>Compression quality of the final JPEG
5661image</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5662 </td>
5663
5664 <td class="entry_units">
5665 </td>
5666
5667 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]5668 <p>1-100; larger is higher quality</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5669 </td>
5670
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5671 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5672 <ul class="entry_tags">
5673 <li><a href="#tag_BC">BC</a></li>
5674 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5675 </td>
5676
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5677 </tr>
5678 <tr class="entries_header">
5679 <th class="th_details" colspan="5">Details</th>
5680 </tr>
5681 <tr class="entry_cont">
5682 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5683 <p>85-95 is typical usage range</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5684 </td>
5685 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5686
5687
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5688 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5689 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5690
5691
5692 <tr class="entry" id="dynamic_android.jpeg.size">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5693 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5694 android.<wbr/>jpeg.<wbr/>size
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5695 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5696 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5697 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5698
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5699 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5700
5701
5702 </td> <!-- entry_type -->
5703
5704 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5705 <p>The size of the compressed JPEG image,<wbr/> in
5706bytes</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5707 </td>
5708
5709 <td class="entry_units">
5710 </td>
5711
5712 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame^]5713 <p>&gt;= 0</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5714 </td>
5715
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5716 <td class="entry_tags">
5717 </td>
5718
5719 </tr>
5720 <tr class="entries_header">
5721 <th class="th_details" colspan="5">Details</th>
5722 </tr>
5723 <tr class="entry_cont">
5724 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5725 <p>If no JPEG output is produced for the request,<wbr/>
5726this must be 0.<wbr/></p>
5727<p>Otherwise,<wbr/> this describes the real size of the compressed
5728JPEG image placed in the output stream.<wbr/> More specifically,<wbr/>
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]5729if <a href="#static_android.jpeg.maxSize">android.<wbr/>jpeg.<wbr/>max<wbr/>Size</a> = 1000000,<wbr/> and a specific capture
5730has <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]5731the JPEG stream will be 1000000 bytes,<wbr/> of which the first
5732500000 make up the real data.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5733 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5734 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5735
5736
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5737 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5738 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5739
5740
5741 <tr class="entry" id="dynamic_android.jpeg.thumbnailQuality">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5742 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5743 android.<wbr/>jpeg.<wbr/>thumbnail<wbr/>Quality
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5744 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5745 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5746 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5747
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5748 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5749
5750
5751 </td> <!-- entry_type -->
5752
5753 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5754 <p>Compression quality of JPEG
5755thumbnail</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5756 </td>
5757
5758 <td class="entry_units">
5759 </td>
5760
5761 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]5762 <p>1-100; larger is higher quality</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5763 </td>
5764
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5765 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5766 <ul class="entry_tags">
5767 <li><a href="#tag_BC">BC</a></li>
5768 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5769 </td>
5770
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5771 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5772
5773
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5774 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5775 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5776
5777
5778 <tr class="entry" id="dynamic_android.jpeg.thumbnailSize">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5779 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5780 android.<wbr/>jpeg.<wbr/>thumbnail<wbr/>Size
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5781 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5782 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5783 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5784 <span class="entry_type_container">x</span>
5785
5786 <span class="entry_type_array">
5787 2
5788 </span>
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]5789 <span class="entry_type_visibility"> [public as size]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5790
5791
5792 </td> <!-- entry_type -->
5793
5794 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5795 <p>Resolution of embedded JPEG thumbnail</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5796 </td>
5797
5798 <td class="entry_units">
5799 </td>
5800
5801 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]5802 <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]5803 </td>
5804
5805 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5806 <ul class="entry_tags">
5807 <li><a href="#tag_BC">BC</a></li>
5808 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5809 </td>
5810
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5811 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5812 <tr class="entries_header">
5813 <th class="th_details" colspan="5">Details</th>
5814 </tr>
5815 <tr class="entry_cont">
5816 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5817 <p>When set to (0,<wbr/> 0) value,<wbr/> the JPEG EXIF must not contain thumbnail,<wbr/>
5818but the captured JPEG must still be a valid image.<wbr/></p>
5819<p>When a jpeg image capture is issued,<wbr/> the thumbnail size selected should have
5820the same aspect ratio as the jpeg image.<wbr/></p>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5821 </td>
5822 </tr>
5823
5824
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5825 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5826 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5827
5828
5829
5830 <!-- end of kind -->
5831 </tbody>
5832
5833 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5834 <tr><td colspan="6" id="section_lens" class="section">lens</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5835
5836
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5837 <tr><td colspan="6" class="kind">controls</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5838
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5839 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5840 <tr>
5841 <th class="th_name">Property Name</th>
5842 <th class="th_type">Type</th>
5843 <th class="th_description">Description</th>
5844 <th class="th_units">Units</th>
5845 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5846 <th class="th_tags">Tags</th>
5847 </tr>
5848 </thead>
5849
5850 <tbody>
5851
5852
5853
5854
5855
5856
5857
5858
5859
5860
5861 <tr class="entry" id="controls_android.lens.aperture">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5862 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5863 android.<wbr/>lens.<wbr/>aperture
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5864 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5865 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5866 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5867
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5868 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5869
5870
5871 </td> <!-- entry_type -->
5872
5873 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5874 <p>Size of the lens aperture</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5875 </td>
5876
5877 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5878 f-number (f/<wbr/>NNN)
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5879 </td>
5880
5881 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]5882 <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]5883 </td>
5884
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5885 <td class="entry_tags">
5886 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5887 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5888 </ul>
5889 </td>
5890
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5891 </tr>
5892 <tr class="entries_header">
5893 <th class="th_details" colspan="5">Details</th>
5894 </tr>
5895 <tr class="entry_cont">
5896 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5897 <p>Will not be supported on most devices.<wbr/> Can only
5898pick from supported list</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5899 </td>
5900 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5901
5902
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5903 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5904 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5905
5906
5907 <tr class="entry" id="controls_android.lens.filterDensity">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5908 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5909 android.<wbr/>lens.<wbr/>filter<wbr/>Density
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5910 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5911 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5912 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5913
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5914 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5915
5916
5917 </td> <!-- entry_type -->
5918
5919 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5920 <p>State of lens neutral density
5921filter(s)</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5922 </td>
5923
5924 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5925 number of stops of filtering
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5926 </td>
5927
5928 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]5929 <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]5930 </td>
5931
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5932 <td class="entry_tags">
5933 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5934 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5935 </ul>
5936 </td>
5937
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5938 </tr>
5939 <tr class="entries_header">
5940 <th class="th_details" colspan="5">Details</th>
5941 </tr>
5942 <tr class="entry_cont">
5943 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5944 <p>Will not be supported on most devices.<wbr/> Can only
5945pick from supported list</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5946 </td>
5947 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5948
5949
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5950 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5951 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5952
5953
5954 <tr class="entry" id="controls_android.lens.focalLength">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5955 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5956 android.<wbr/>lens.<wbr/>focal<wbr/>Length
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5957 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5958 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5959 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5960
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5961 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5962
5963
5964 </td> <!-- entry_type -->
5965
5966 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5967 <p>Lens optical zoom setting</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5968 </td>
5969
5970 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5971 focal length in mm
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5972 </td>
5973
5974 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame^]5975 <p>&gt; 0</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5976 </td>
5977
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5978 <td class="entry_tags">
5979 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5980 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5981 </ul>
5982 </td>
5983
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5984 </tr>
5985 <tr class="entries_header">
5986 <th class="th_details" colspan="5">Details</th>
5987 </tr>
5988 <tr class="entry_cont">
5989 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5990 <p>Will not be supported on most devices.<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5991 </td>
5992 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5993
5994
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5995 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5996 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5997
5998
5999 <tr class="entry" id="controls_android.lens.focusDistance">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6000 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6001 android.<wbr/>lens.<wbr/>focus<wbr/>Distance
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6002 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6003 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6004 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6005
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6006 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6007
6008
6009 </td> <!-- entry_type -->
6010
6011 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6012 <p>Distance to plane of sharpest focus,<wbr/>
6013measured from frontmost surface of the lens</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6014 </td>
6015
6016 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6017 diopters (1/<wbr/>m)
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6018 </td>
6019
6020 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame^]6021 <p>&gt;= 0</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6022 </td>
6023
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6024 <td class="entry_tags">
6025 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6026 <li><a href="#tag_BC">BC</a></li>
6027 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6028 </ul>
6029 </td>
6030
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6031 </tr>
6032 <tr class="entries_header">
6033 <th class="th_details" colspan="5">Details</th>
6034 </tr>
6035 <tr class="entry_cont">
6036 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6037 <p>0 = infinity focus.<wbr/> Used value should be clamped
6038to (0,<wbr/>minimum focus distance)</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6039 </td>
6040 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6041
6042
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6043 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6044 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6045
6046
6047 <tr class="entry" id="controls_android.lens.opticalStabilizationMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6048 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6049 android.<wbr/>lens.<wbr/>optical<wbr/>Stabilization<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6050 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6051 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6052 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6053
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6054 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6055
6056 <ul class="entry_type_enum">
6057 <li>
6058 <span class="entry_type_enum_name">OFF</span>
6059 </li>
6060 <li>
6061 <span class="entry_type_enum_name">ON</span>
6062 <span class="entry_type_enum_optional">optional</span>
6063 </li>
6064 </ul>
6065
6066 </td> <!-- entry_type -->
6067
6068 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6069 <p>Whether optical image stabilization is
6070enabled.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6071 </td>
6072
6073 <td class="entry_units">
6074 </td>
6075
6076 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]6077 <p>android.<wbr/>lens.<wbr/>available<wbr/>Optical<wbr/>Stabilization</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6078 </td>
6079
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6080 <td class="entry_tags">
6081 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6082 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6083 </ul>
6084 </td>
6085
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6086 </tr>
6087 <tr class="entries_header">
6088 <th class="th_details" colspan="5">Details</th>
6089 </tr>
6090 <tr class="entry_cont">
6091 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6092 <p>Will not be supported on most devices.<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6093 </td>
6094 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6095
6096
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6097 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6098 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6099
6100
6101
6102 <!-- end of kind -->
6103 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6104 <tr><td colspan="6" class="kind">static</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6105
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6106 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6107 <tr>
6108 <th class="th_name">Property Name</th>
6109 <th class="th_type">Type</th>
6110 <th class="th_description">Description</th>
6111 <th class="th_units">Units</th>
6112 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6113 <th class="th_tags">Tags</th>
6114 </tr>
6115 </thead>
6116
6117 <tbody>
6118
6119
6120
6121
6122
6123
6124
6125
6126
6127
6128
6129
6130 <tr class="entry" id="static_android.lens.info.availableApertures">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6131 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6132 android.<wbr/>lens.<wbr/>info.<wbr/>available<wbr/>Apertures
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6133 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6134 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6135 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6136 <span class="entry_type_container">x</span>
6137
6138 <span class="entry_type_array">
6139 n
6140 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6141 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6142
6143
6144 </td> <!-- entry_type -->
6145
6146 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6147 <p>List of supported aperture
6148values</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6149 </td>
6150
6151 <td class="entry_units">
6152 </td>
6153
6154 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]6155 <p>one entry required,<wbr/> &gt; 0</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6156 </td>
6157
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6158 <td class="entry_tags">
6159 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6160 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6161 </ul>
6162 </td>
6163
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6164 </tr>
6165 <tr class="entries_header">
6166 <th class="th_details" colspan="5">Details</th>
6167 </tr>
6168 <tr class="entry_cont">
6169 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6170 <p>If variable aperture not available,<wbr/> only setting
6171should be for the fixed aperture</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6172 </td>
6173 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6174
6175
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6176 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6177 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6178
6179
6180 <tr class="entry" id="static_android.lens.info.availableFilterDensities">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6181 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6182 android.<wbr/>lens.<wbr/>info.<wbr/>available<wbr/>Filter<wbr/>Densities
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6183 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6184 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6185 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6186 <span class="entry_type_container">x</span>
6187
6188 <span class="entry_type_array">
6189 n
6190 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6191 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6192
6193
6194 </td> <!-- entry_type -->
6195
6196 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6197 <p>List of supported ND filter
6198values</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6199 </td>
6200
6201 <td class="entry_units">
6202 </td>
6203
6204 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]6205 <p>one entry required,<wbr/> &gt;= 0</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6206 </td>
6207
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6208 <td class="entry_tags">
6209 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6210 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6211 </ul>
6212 </td>
6213
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6214 </tr>
6215 <tr class="entries_header">
6216 <th class="th_details" colspan="5">Details</th>
6217 </tr>
6218 <tr class="entry_cont">
6219 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6220 <p>If not available,<wbr/> only setting is 0.<wbr/> Otherwise,<wbr/>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6221lists the available exposure index values for dimming
6222(2 would mean the filter is set to reduce incoming
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6223light by two stops)</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6224 </td>
6225 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6226
6227
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6228 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6229 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6230
6231
6232 <tr class="entry" id="static_android.lens.info.availableFocalLengths">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6233 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6234 android.<wbr/>lens.<wbr/>info.<wbr/>available<wbr/>Focal<wbr/>Lengths
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6235 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6236 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6237 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6238 <span class="entry_type_container">x</span>
6239
6240 <span class="entry_type_array">
6241 n
6242 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6243 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6244 <div class="entry_type_notes">the list of available focal lengths</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6245
6246
6247 </td> <!-- entry_type -->
6248
6249 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6250 <p>If fitted with optical zoom,<wbr/> what focal
6251lengths are available.<wbr/> If not,<wbr/> the static focal
6252length</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6253 </td>
6254
6255 <td class="entry_units">
6256 </td>
6257
6258 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame^]6259 <p>&gt; 0</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6260 </td>
6261
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6262 <td class="entry_tags">
6263 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6264 <li><a href="#tag_BC">BC</a></li>
6265 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6266 </ul>
6267 </td>
6268
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6269 </tr>
6270 <tr class="entries_header">
6271 <th class="th_details" colspan="5">Details</th>
6272 </tr>
6273 <tr class="entry_cont">
6274 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6275 <p>If optical zoom not supported,<wbr/> only one value
6276should be reported</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6277 </td>
6278 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6279
6280
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6281 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6282 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6283
6284
6285 <tr class="entry" id="static_android.lens.info.availableOpticalStabilization">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6286 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6287 android.<wbr/>lens.<wbr/>info.<wbr/>available<wbr/>Optical<wbr/>Stabilization
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6288 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6289 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6290 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6291 <span class="entry_type_container">x</span>
6292
6293 <span class="entry_type_array">
6294 n
6295 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6296 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6297 <div class="entry_type_notes">list of enums</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6298
6299
6300 </td> <!-- entry_type -->
6301
6302 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6303 <p>List of supported optical image
6304stabilization modes</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6305 </td>
6306
6307 <td class="entry_units">
6308 </td>
6309
6310 <td class="entry_range">
6311 </td>
6312
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6313 <td class="entry_tags">
6314 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6315 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6316 </ul>
6317 </td>
6318
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6319 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6320
6321
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6322 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6323 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6324
6325
6326 <tr class="entry" id="static_android.lens.info.geometricCorrectionMap">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6327 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6328 android.<wbr/>lens.<wbr/>info.<wbr/>geometric<wbr/>Correction<wbr/>Map
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6329 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6330 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6331 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6332 <span class="entry_type_container">x</span>
6333
6334 <span class="entry_type_array">
6335 2 x 3 x n x m
6336 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6337 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6338 <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]6339
6340
6341 </td> <!-- entry_type -->
6342
6343 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6344 <p>A low-resolution map for correction of
6345geometric distortions and chromatic aberrations,<wbr/> per
6346color channel</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6347 </td>
6348
6349 <td class="entry_units">
6350 </td>
6351
6352 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]6353 <p>N,<wbr/> M &gt;= 2</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6354 </td>
6355
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6356 <td class="entry_tags">
6357 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6358 <li><a href="#tag_DNG">DNG</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6359 </ul>
6360 </td>
6361
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6362 </tr>
6363 <tr class="entries_header">
6364 <th class="th_details" colspan="5">Details</th>
6365 </tr>
6366 <tr class="entry_cont">
6367 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6368 <p>[DNG wants a function instead].<wbr/> What's easiest
6369for implementers? With an array size (M,<wbr/> N),<wbr/> entry (i,<wbr/>
6370j) provides the destination for pixel (i/<wbr/>(M-1) * width,<wbr/>
6371j/<wbr/>(N-1) * height).<wbr/> Data is row-major,<wbr/> with each array
6372entry 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]6373 </td>
6374 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6375
6376
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6377 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6378 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6379
6380
6381 <tr class="entry" id="static_android.lens.info.geometricCorrectionMapSize">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6382 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6383 android.<wbr/>lens.<wbr/>info.<wbr/>geometric<wbr/>Correction<wbr/>Map<wbr/>Size
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6384 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6385 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6386 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6387 <span class="entry_type_container">x</span>
6388
6389 <span class="entry_type_array">
6390 2
6391 </span>
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]6392 <span class="entry_type_visibility"> [system as size]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6393 <div class="entry_type_notes">width and height of geometric correction map</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6394
6395
6396 </td> <!-- entry_type -->
6397
6398 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6399 <p>Dimensions of geometric correction
6400map</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6401 </td>
6402
6403 <td class="entry_units">
6404 </td>
6405
6406 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]6407 <p>Both values &gt;= 2</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6408 </td>
6409
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6410 <td class="entry_tags">
6411 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6412 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6413 </ul>
6414 </td>
6415
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6416 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6417
6418
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6419 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6420 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6421
6422
6423 <tr class="entry" id="static_android.lens.info.hyperfocalDistance">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6424 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6425 android.<wbr/>lens.<wbr/>info.<wbr/>hyperfocal<wbr/>Distance
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6426 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6427 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6428 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6429
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6430 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6431
6432
6433 </td> <!-- entry_type -->
6434
6435 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6436 <p>Hyperfocal distance for this lens; set to
64370 if fixed focus</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6438 </td>
6439
6440 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6441 diopters
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6442 </td>
6443
6444 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame^]6445 <p>&gt;= 0</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6446 </td>
6447
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6448 <td class="entry_tags">
6449 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6450 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6451 </ul>
6452 </td>
6453
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6454 </tr>
6455 <tr class="entries_header">
6456 <th class="th_details" colspan="5">Details</th>
6457 </tr>
6458 <tr class="entry_cont">
6459 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6460 <p>The hyperfocal distance is used for the old
6461API's 'fixed' setting</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6462 </td>
6463 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6464
6465
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6466 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6467 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6468
6469
6470 <tr class="entry" id="static_android.lens.info.minimumFocusDistance">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6471 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6472 android.<wbr/>lens.<wbr/>info.<wbr/>minimum<wbr/>Focus<wbr/>Distance
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6473 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6474 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6475 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6476
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6477 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6478
6479
6480 </td> <!-- entry_type -->
6481
6482 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6483 <p>Shortest distance from frontmost surface
6484of the lens that can be focused correctly</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6485 </td>
6486
6487 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6488 diopters
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6489 </td>
6490
6491 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame^]6492 <p>&gt;= 0</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6493 </td>
6494
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6495 <td class="entry_tags">
6496 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6497 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6498 </ul>
6499 </td>
6500
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6501 </tr>
6502 <tr class="entries_header">
6503 <th class="th_details" colspan="5">Details</th>
6504 </tr>
6505 <tr class="entry_cont">
6506 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6507 <p>If the lens is fixed-focus,<wbr/> this should be
65080</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6509 </td>
6510 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6511
6512
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6513 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6514 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6515
6516
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6517 <tr class="entry" id="static_android.lens.info.shadingMapSize">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6518 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6519 android.<wbr/>lens.<wbr/>info.<wbr/>shading<wbr/>Map<wbr/>Size
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6520 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6521 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6522 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6523 <span class="entry_type_container">x</span>
6524
6525 <span class="entry_type_array">
6526 2
6527 </span>
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]6528 <span class="entry_type_visibility"> [public as size]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6529 <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]6530
6531
6532 </td> <!-- entry_type -->
6533
6534 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6535 <p>Dimensions of lens shading map.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6536 </td>
6537
6538 <td class="entry_units">
6539 </td>
6540
6541 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]6542 <p>Both values &gt;= 1</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6543 </td>
6544
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6545 <td class="entry_tags">
6546 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6547 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6548 </ul>
6549 </td>
6550
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6551 </tr>
6552 <tr class="entries_header">
6553 <th class="th_details" colspan="5">Details</th>
6554 </tr>
6555 <tr class="entry_cont">
6556 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6557 <p>The map should be on the order of 30-40 rows and columns,<wbr/> and
6558must be smaller than 64x64.<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6559 </td>
6560 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6561
6562
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6563 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6564 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6565
6566
6567
6568
6569
6570 <tr class="entry" id="static_android.lens.facing">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6571 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6572 android.<wbr/>lens.<wbr/>facing
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6573 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6574 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6575 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6576
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6577 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6578
6579 <ul class="entry_type_enum">
6580 <li>
6581 <span class="entry_type_enum_name">FRONT</span>
6582 </li>
6583 <li>
6584 <span class="entry_type_enum_name">BACK</span>
6585 </li>
6586 </ul>
6587
6588 </td> <!-- entry_type -->
6589
6590 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6591 <p>Direction the camera faces relative to
6592device screen</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6593 </td>
6594
6595 <td class="entry_units">
6596 </td>
6597
6598 <td class="entry_range">
6599 </td>
6600
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6601 <td class="entry_tags">
6602 </td>
6603
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6604 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6605
6606
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6607 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6608 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6609
6610
6611 <tr class="entry" id="static_android.lens.opticalAxisAngle">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6612 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6613 android.<wbr/>lens.<wbr/>optical<wbr/>Axis<wbr/>Angle
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6614 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6615 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6616 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6617 <span class="entry_type_container">x</span>
6618
6619 <span class="entry_type_array">
6620 2
6621 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6622 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6623 <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]6624
6625
6626 </td> <!-- entry_type -->
6627
6628 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6629 <p>Relative angle of camera optical axis to the
6630perpendicular axis from the display</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6631 </td>
6632
6633 <td class="entry_units">
6634 </td>
6635
6636 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]6637 <p>[0-90) for first angle,<wbr/> [0-360) for second</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6638 </td>
6639
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6640 <td class="entry_tags">
6641 <ul class="entry_tags">
6642 <li><a href="#tag_ADV">ADV</a></li>
6643 </ul>
6644 </td>
6645
6646 </tr>
6647 <tr class="entries_header">
6648 <th class="th_details" colspan="5">Details</th>
6649 </tr>
6650 <tr class="entry_cont">
6651 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6652 <p>Examples:</p>
6653<p>(0,<wbr/>0) means that the camera optical axis
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]6654is perpendicular to the display surface;</p>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6655<p>(45,<wbr/>0) means that the camera points 45 degrees up when
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]6656device is held upright;</p>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6657<p>(45,<wbr/>90) means the camera points 45 degrees to the right when
6658the device is held upright.<wbr/></p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]6659<p>Use FACING field to determine perpendicular outgoing
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6660direction</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6661 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6662 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6663
6664
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6665 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6666 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6667
6668
6669 <tr class="entry" id="static_android.lens.position">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6670 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6671 android.<wbr/>lens.<wbr/>position
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6672 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6673 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6674 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6675 <span class="entry_type_container">x</span>
6676
6677 <span class="entry_type_array">
6678 3, location in mm, in the sensor coordinate
6679 system
6680 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6681 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6682
6683
6684 </td> <!-- entry_type -->
6685
6686 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6687 <p>Coordinates of camera optical axis on
6688device</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6689 </td>
6690
6691 <td class="entry_units">
6692 </td>
6693
6694 <td class="entry_range">
6695 </td>
6696
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6697 <td class="entry_tags">
6698 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6699 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6700 </ul>
6701 </td>
6702
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6703 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6704
6705
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6706 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6707 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6708
6709
6710
6711 <!-- end of kind -->
6712 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6713 <tr><td colspan="6" class="kind">dynamic</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6714
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6715 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6716 <tr>
6717 <th class="th_name">Property Name</th>
6718 <th class="th_type">Type</th>
6719 <th class="th_description">Description</th>
6720 <th class="th_units">Units</th>
6721 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6722 <th class="th_tags">Tags</th>
6723 </tr>
6724 </thead>
6725
6726 <tbody>
6727
6728
6729
6730
6731
6732
6733
6734
6735
6736
6737 <tr class="entry" id="dynamic_android.lens.aperture">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6738 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6739 android.<wbr/>lens.<wbr/>aperture
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6740 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6741 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6742 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6743
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6744 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6745
6746
6747 </td> <!-- entry_type -->
6748
6749 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6750 <p>Size of the lens aperture</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6751 </td>
6752
6753 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6754 f-number (f/<wbr/>NNN)
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6755 </td>
6756
6757 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]6758 <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]6759 </td>
6760
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6761 <td class="entry_tags">
6762 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6763 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6764 </ul>
6765 </td>
6766
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6767 </tr>
6768 <tr class="entries_header">
6769 <th class="th_details" colspan="5">Details</th>
6770 </tr>
6771 <tr class="entry_cont">
6772 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6773 <p>Will not be supported on most devices.<wbr/> Can only
6774pick from supported list</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6775 </td>
6776 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6777
6778
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6779 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6780 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6781
6782
6783 <tr class="entry" id="dynamic_android.lens.filterDensity">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6784 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6785 android.<wbr/>lens.<wbr/>filter<wbr/>Density
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6786 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6787 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6788 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6789
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6790 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6791
6792
6793 </td> <!-- entry_type -->
6794
6795 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6796 <p>State of lens neutral density
6797filter(s)</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6798 </td>
6799
6800 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6801 number of stops of filtering
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6802 </td>
6803
6804 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]6805 <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]6806 </td>
6807
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6808 <td class="entry_tags">
6809 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6810 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6811 </ul>
6812 </td>
6813
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6814 </tr>
6815 <tr class="entries_header">
6816 <th class="th_details" colspan="5">Details</th>
6817 </tr>
6818 <tr class="entry_cont">
6819 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6820 <p>Will not be supported on most devices.<wbr/> Can only
6821pick from supported list</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6822 </td>
6823 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6824
6825
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6826 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6827 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6828
6829
6830 <tr class="entry" id="dynamic_android.lens.focalLength">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6831 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6832 android.<wbr/>lens.<wbr/>focal<wbr/>Length
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6833 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6834 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6835 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6836
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6837 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6838
6839
6840 </td> <!-- entry_type -->
6841
6842 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6843 <p>Lens optical zoom setting</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6844 </td>
6845
6846 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6847 focal length in mm
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6848 </td>
6849
6850 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame^]6851 <p>&gt; 0</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6852 </td>
6853
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6854 <td class="entry_tags">
6855 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6856 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6857 </ul>
6858 </td>
6859
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6860 </tr>
6861 <tr class="entries_header">
6862 <th class="th_details" colspan="5">Details</th>
6863 </tr>
6864 <tr class="entry_cont">
6865 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6866 <p>Will not be supported on most devices.<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6867 </td>
6868 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6869
6870
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6871 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6872 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6873
6874
6875 <tr class="entry" id="dynamic_android.lens.focusDistance">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6876 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6877 android.<wbr/>lens.<wbr/>focus<wbr/>Distance
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6878 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6879 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6880 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6881
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6882 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6883
6884
6885 </td> <!-- entry_type -->
6886
6887 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6888 <p>Distance to plane of sharpest focus,<wbr/>
6889measured from frontmost surface of the lens</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6890 </td>
6891
6892 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6893 diopters (1/<wbr/>m)
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6894 </td>
6895
6896 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame^]6897 <p>&gt;= 0</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6898 </td>
6899
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6900 <td class="entry_tags">
6901 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6902 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6903 </ul>
6904 </td>
6905
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6906 </tr>
6907 <tr class="entries_header">
6908 <th class="th_details" colspan="5">Details</th>
6909 </tr>
6910 <tr class="entry_cont">
6911 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6912 <p>Should be zero for fixed-focus cameras</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6913 </td>
6914 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6915
6916
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6917 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6918 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6919
6920
6921 <tr class="entry" id="dynamic_android.lens.focusRange">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6922 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6923 android.<wbr/>lens.<wbr/>focus<wbr/>Range
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6924 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6925 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6926 <span class="entry_type_name">float</span>
Zhijun He50451ad2013-09-26 10:27:47 -0700[diff] [blame]6927 <span class="entry_type_container">x</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6928
Zhijun He50451ad2013-09-26 10:27:47 -0700[diff] [blame]6929 <span class="entry_type_array">
6930 2
6931 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6932 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6933 <div class="entry_type_notes">Range of scene distances that are in focus</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6934
6935
6936 </td> <!-- entry_type -->
6937
6938 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6939 <p>The range of scene distances that are in
6940sharp focus (depth of field)</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6941 </td>
6942
6943 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6944 pair of focus distances in diopters: (near,<wbr/>
6945 far)
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6946 </td>
6947
6948 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame^]6949 <p>&gt;=0</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6950 </td>
6951
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6952 <td class="entry_tags">
6953 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6954 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6955 </ul>
6956 </td>
6957
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6958 </tr>
6959 <tr class="entries_header">
6960 <th class="th_details" colspan="5">Details</th>
6961 </tr>
6962 <tr class="entry_cont">
6963 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6964 <p>If variable focus not supported,<wbr/> can still report
6965fixed depth of field range</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6966 </td>
6967 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6968
6969
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6970 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6971 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6972
6973
6974 <tr class="entry" id="dynamic_android.lens.opticalStabilizationMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6975 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6976 android.<wbr/>lens.<wbr/>optical<wbr/>Stabilization<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6977 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6978 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6979 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6980
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6981 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6982
6983 <ul class="entry_type_enum">
6984 <li>
6985 <span class="entry_type_enum_name">OFF</span>
6986 </li>
6987 <li>
6988 <span class="entry_type_enum_name">ON</span>
6989 <span class="entry_type_enum_optional">optional</span>
6990 </li>
6991 </ul>
6992
6993 </td> <!-- entry_type -->
6994
6995 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6996 <p>Whether optical image stabilization is
6997enabled.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6998 </td>
6999
7000 <td class="entry_units">
7001 </td>
7002
7003 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]7004 <p>android.<wbr/>lens.<wbr/>available<wbr/>Optical<wbr/>Stabilization</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7005 </td>
7006
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7007 <td class="entry_tags">
7008 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]7009 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7010 </ul>
7011 </td>
7012
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7013 </tr>
7014 <tr class="entries_header">
7015 <th class="th_details" colspan="5">Details</th>
7016 </tr>
7017 <tr class="entry_cont">
7018 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7019 <p>Will not be supported on most devices.<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7020 </td>
7021 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7022
7023
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7024 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7025 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7026
7027
7028 <tr class="entry" id="dynamic_android.lens.state">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7029 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7030 android.<wbr/>lens.<wbr/>state
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7031 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7032 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7033 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7034
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7035 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7036
7037 <ul class="entry_type_enum">
7038 <li>
7039 <span class="entry_type_enum_name">STATIONARY</span>
7040 </li>
Igor Murashkin0e323a12013-09-06 11:50:48 -0700[diff] [blame]7041 <li>
7042 <span class="entry_type_enum_name">MOVING</span>
7043 </li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7044 </ul>
7045
7046 </td> <!-- entry_type -->
7047
7048 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7049 <p>Current lens status</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7050 </td>
7051
7052 <td class="entry_units">
7053 </td>
7054
7055 <td class="entry_range">
7056 </td>
7057
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7058 <td class="entry_tags">
7059 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]7060 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7061 </ul>
7062 </td>
7063
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7064 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7065
7066
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7067 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7068 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7069
7070
7071
7072 <!-- end of kind -->
7073 </tbody>
7074
7075 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7076 <tr><td colspan="6" id="section_noiseReduction" class="section">noiseReduction</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7077
7078
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7079 <tr><td colspan="6" class="kind">controls</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7080
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7081 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7082 <tr>
7083 <th class="th_name">Property Name</th>
7084 <th class="th_type">Type</th>
7085 <th class="th_description">Description</th>
7086 <th class="th_units">Units</th>
7087 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7088 <th class="th_tags">Tags</th>
7089 </tr>
7090 </thead>
7091
7092 <tbody>
7093
7094
7095
7096
7097
7098
7099
7100
7101
7102
7103 <tr class="entry" id="controls_android.noiseReduction.mode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7104 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7105 android.<wbr/>noise<wbr/>Reduction.<wbr/>mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7106 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7107 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7108 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7109
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7110 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7111
7112 <ul class="entry_type_enum">
7113 <li>
7114 <span class="entry_type_enum_name">OFF</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7115 <span class="entry_type_enum_notes">No noise reduction is applied</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7116 </li>
7117 <li>
7118 <span class="entry_type_enum_name">FAST</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7119 <span class="entry_type_enum_notes">Must not slow down frame rate relative to sensor
7120 output</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7121 </li>
7122 <li>
7123 <span class="entry_type_enum_name">HIGH_QUALITY</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7124 <span class="entry_type_enum_notes">May slow down frame rate to provide highest
7125 quality</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7126 </li>
7127 </ul>
7128
7129 </td> <!-- entry_type -->
7130
7131 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7132 <p>Mode of operation for the noise reduction
7133algorithm</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7134 </td>
7135
7136 <td class="entry_units">
7137 </td>
7138
7139 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]7140 <p>android.<wbr/>noise<wbr/>Reduction.<wbr/>available<wbr/>Modes</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7141 </td>
7142
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7143 <td class="entry_tags">
7144 <ul class="entry_tags">
7145 <li><a href="#tag_V1">V1</a></li>
7146 </ul>
7147 </td>
7148
7149 </tr>
7150 <tr class="entries_header">
7151 <th class="th_details" colspan="5">Details</th>
7152 </tr>
7153 <tr class="entry_cont">
7154 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7155 <p>Noise filtering control.<wbr/> OFF means no noise reduction
7156will be applied by the HAL.<wbr/></p>
7157<p>FAST/<wbr/>HIGH_<wbr/>QUALITY both mean HAL-determined noise filtering
7158will be applied.<wbr/> HIGH_<wbr/>QUALITY mode indicates that the HAL
7159should use the highest-quality noise filtering algorithms,<wbr/>
7160even if it slows down capture rate.<wbr/> FAST means the HAL should not
7161slow down capture rate when applying noise filtering.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7162 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7163 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7164
7165
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7166 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7167 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7168
7169
7170 <tr class="entry" id="controls_android.noiseReduction.strength">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7171 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7172 android.<wbr/>noise<wbr/>Reduction.<wbr/>strength
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7173 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7174 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7175 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7176
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7177 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7178
7179
7180 </td> <!-- entry_type -->
7181
7182 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7183 <p>Control the amount of noise reduction
7184applied to the images</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7185 </td>
7186
7187 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7188 1-10; 10 is max noise reduction
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7189 </td>
7190
7191 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]7192 <p>1 - 10</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7193 </td>
7194
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7195 <td class="entry_tags">
7196 </td>
7197
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7198 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7199
7200
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7201 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7202 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7203
7204
7205
7206 <!-- end of kind -->
7207 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7208 <tr><td colspan="6" class="kind">dynamic</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7209
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7210 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7211 <tr>
7212 <th class="th_name">Property Name</th>
7213 <th class="th_type">Type</th>
7214 <th class="th_description">Description</th>
7215 <th class="th_units">Units</th>
7216 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7217 <th class="th_tags">Tags</th>
7218 </tr>
7219 </thead>
7220
7221 <tbody>
7222
7223
7224
7225
7226
7227
7228
7229
7230
7231
7232 <tr class="entry" id="dynamic_android.noiseReduction.mode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7233 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7234 android.<wbr/>noise<wbr/>Reduction.<wbr/>mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7235 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7236 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7237 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7238
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7239 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7240
7241 <ul class="entry_type_enum">
7242 <li>
7243 <span class="entry_type_enum_name">OFF</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7244 <span class="entry_type_enum_notes">No noise reduction is applied</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7245 </li>
7246 <li>
7247 <span class="entry_type_enum_name">FAST</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7248 <span class="entry_type_enum_notes">Must not slow down frame rate relative to sensor
7249 output</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7250 </li>
7251 <li>
7252 <span class="entry_type_enum_name">HIGH_QUALITY</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7253 <span class="entry_type_enum_notes">May slow down frame rate to provide highest
7254 quality</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7255 </li>
7256 </ul>
7257
7258 </td> <!-- entry_type -->
7259
7260 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7261 <p>Mode of operation for the noise reduction
7262algorithm</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7263 </td>
7264
7265 <td class="entry_units">
7266 </td>
7267
7268 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]7269 <p>android.<wbr/>noise<wbr/>Reduction.<wbr/>available<wbr/>Modes</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7270 </td>
7271
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7272 <td class="entry_tags">
7273 <ul class="entry_tags">
7274 <li><a href="#tag_V1">V1</a></li>
7275 </ul>
7276 </td>
7277
7278 </tr>
7279 <tr class="entries_header">
7280 <th class="th_details" colspan="5">Details</th>
7281 </tr>
7282 <tr class="entry_cont">
7283 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7284 <p>Noise filtering control.<wbr/> OFF means no noise reduction
7285will be applied by the HAL.<wbr/></p>
7286<p>FAST/<wbr/>HIGH_<wbr/>QUALITY both mean HAL-determined noise filtering
7287will be applied.<wbr/> HIGH_<wbr/>QUALITY mode indicates that the HAL
7288should use the highest-quality noise filtering algorithms,<wbr/>
7289even if it slows down capture rate.<wbr/> FAST means the HAL should not
7290slow down capture rate when applying noise filtering.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7291 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7292 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7293
7294
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7295 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7296 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7297
7298
7299
7300 <!-- end of kind -->
7301 </tbody>
7302
7303 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7304 <tr><td colspan="6" id="section_quirks" class="section">quirks</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7305
7306
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7307 <tr><td colspan="6" class="kind">static</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7308
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7309 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7310 <tr>
7311 <th class="th_name">Property Name</th>
7312 <th class="th_type">Type</th>
7313 <th class="th_description">Description</th>
7314 <th class="th_units">Units</th>
7315 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7316 <th class="th_tags">Tags</th>
7317 </tr>
7318 </thead>
7319
7320 <tbody>
7321
7322
7323
7324
7325
7326
7327
7328
7329
7330
7331 <tr class="entry" id="static_android.quirks.meteringCropRegion">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7332 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7333 android.<wbr/>quirks.<wbr/>metering<wbr/>Crop<wbr/>Region
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7334 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7335 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7336 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7337
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7338 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7339
7340
7341 </td> <!-- entry_type -->
7342
7343 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7344 <p>If set to 1,<wbr/> the camera service does not
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]7345scale 'normalized' coordinates with respect to the crop
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7346region.<wbr/> This applies to metering input (a{e,<wbr/>f,<wbr/>wb}Region
7347and output (face rectangles).<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7348 </td>
7349
7350 <td class="entry_units">
7351 </td>
7352
7353 <td class="entry_range">
7354 </td>
7355
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7356 <td class="entry_tags">
7357 </td>
7358
7359 </tr>
7360 <tr class="entries_header">
7361 <th class="th_details" colspan="5">Details</th>
7362 </tr>
7363 <tr class="entry_cont">
7364 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7365 <p>Normalized coordinates refer to those in the
7366(-1000,<wbr/>1000) range mentioned in the
7367android.<wbr/>hardware.<wbr/>Camera API.<wbr/></p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]7368<p>HAL implementations should instead always use and emit
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7369sensor array-relative coordinates for all region data.<wbr/> Does
7370not need to be listed in static metadata.<wbr/> Support will be
7371removed in future versions of camera service.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7372 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7373 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7374
7375
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7376 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7377 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7378
7379
7380 <tr class="entry" id="static_android.quirks.triggerAfWithAuto">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7381 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7382 android.<wbr/>quirks.<wbr/>trigger<wbr/>Af<wbr/>With<wbr/>Auto
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7383 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7384 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7385 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7386
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7387 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7388
7389
7390 </td> <!-- entry_type -->
7391
7392 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7393 <p>If set to 1,<wbr/> then the camera service always
7394switches to FOCUS_<wbr/>MODE_<wbr/>AUTO before issuing a AF
7395trigger.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7396 </td>
7397
7398 <td class="entry_units">
7399 </td>
7400
7401 <td class="entry_range">
7402 </td>
7403
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7404 <td class="entry_tags">
7405 </td>
7406
7407 </tr>
7408 <tr class="entries_header">
7409 <th class="th_details" colspan="5">Details</th>
7410 </tr>
7411 <tr class="entry_cont">
7412 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7413 <p>HAL implementations should implement AF trigger
7414modes for AUTO,<wbr/> MACRO,<wbr/> CONTINUOUS_<wbr/>FOCUS,<wbr/> and
7415CONTINUOUS_<wbr/>PICTURE modes instead of using this flag.<wbr/> Does
7416not need to be listed in static metadata.<wbr/> Support will be
7417removed in future versions of camera service</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7418 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7419 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7420
7421
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7422 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7423 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7424
7425
7426 <tr class="entry" id="static_android.quirks.useZslFormat">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7427 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7428 android.<wbr/>quirks.<wbr/>use<wbr/>Zsl<wbr/>Format
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7429 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7430 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7431 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7432
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7433 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7434
7435
7436 </td> <!-- entry_type -->
7437
7438 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7439 <p>If set to 1,<wbr/> the camera service uses
7440CAMERA2_<wbr/>PIXEL_<wbr/>FORMAT_<wbr/>ZSL instead of
7441HAL_<wbr/>PIXEL_<wbr/>FORMAT_<wbr/>IMPLEMENTATION_<wbr/>DEFINED for the zero
7442shutter lag stream</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7443 </td>
7444
7445 <td class="entry_units">
7446 </td>
7447
7448 <td class="entry_range">
7449 </td>
7450
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7451 <td class="entry_tags">
7452 </td>
7453
7454 </tr>
7455 <tr class="entries_header">
7456 <th class="th_details" colspan="5">Details</th>
7457 </tr>
7458 <tr class="entry_cont">
7459 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7460 <p>HAL implementations should use gralloc usage flags
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]7461to determine that a stream will be used for
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7462zero-shutter-lag,<wbr/> instead of relying on an explicit
7463format setting.<wbr/> Does not need to be listed in static
7464metadata.<wbr/> Support will be removed in future versions of
7465camera service.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7466 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7467 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7468
7469
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7470 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7471 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7472
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]7473
7474 <tr class="entry" id="static_android.quirks.usePartialResult">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7475 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7476 android.<wbr/>quirks.<wbr/>use<wbr/>Partial<wbr/>Result
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7477 </td>
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]7478 <td class="entry_type">
7479 <span class="entry_type_name">byte</span>
7480
Eino-Ville Talvala52a64a52013-11-07 14:43:43 -0800[diff] [blame]7481 <span class="entry_type_visibility"> [hidden]</span>
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]7482
7483
7484 </td> <!-- entry_type -->
7485
7486 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7487 <p>If set to 1,<wbr/> the HAL will always split result
7488metadata for a single capture into multiple buffers,<wbr/>
7489returned using multiple process_<wbr/>capture_<wbr/>result calls.<wbr/></p>
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]7490 </td>
7491
7492 <td class="entry_units">
7493 </td>
7494
7495 <td class="entry_range">
7496 </td>
7497
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7498 <td class="entry_tags">
7499 </td>
7500
7501 </tr>
7502 <tr class="entries_header">
7503 <th class="th_details" colspan="5">Details</th>
7504 </tr>
7505 <tr class="entry_cont">
7506 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7507 <p>Does not need to be listed in static
7508metadata.<wbr/> Support for partial results will be reworked in
7509future versions of camera service.<wbr/> This quirk will stop
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]7510working at that point; DO NOT USE without careful
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7511consideration of future support.<wbr/></p>
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]7512 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7513 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7514
7515
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7516 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7517 <!-- end of entry -->
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]7518
7519
7520
7521 <!-- end of kind -->
7522 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7523 <tr><td colspan="6" class="kind">dynamic</td></tr>
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]7524
7525 <thead class="entries_header">
7526 <tr>
7527 <th class="th_name">Property Name</th>
7528 <th class="th_type">Type</th>
7529 <th class="th_description">Description</th>
7530 <th class="th_units">Units</th>
7531 <th class="th_range">Range</th>
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]7532 <th class="th_tags">Tags</th>
7533 </tr>
7534 </thead>
7535
7536 <tbody>
7537
7538
7539
7540
7541
7542
7543
7544
7545
7546
7547 <tr class="entry" id="dynamic_android.quirks.partialResult">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7548 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7549 android.<wbr/>quirks.<wbr/>partial<wbr/>Result
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7550 </td>
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]7551 <td class="entry_type">
7552 <span class="entry_type_name entry_type_name_enum">byte</span>
7553
Eino-Ville Talvala52a64a52013-11-07 14:43:43 -0800[diff] [blame]7554 <span class="entry_type_visibility"> [hidden as boolean]</span>
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]7555
7556 <ul class="entry_type_enum">
7557 <li>
7558 <span class="entry_type_enum_name">FINAL</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7559 <span class="entry_type_enum_notes">The last or only metadata result buffer
7560 for this capture.<wbr/></span>
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]7561 </li>
7562 <li>
7563 <span class="entry_type_enum_name">PARTIAL</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7564 <span class="entry_type_enum_notes">A partial buffer of result metadata for this
7565 capture.<wbr/> More result buffers for this capture will be sent
7566 by the HAL,<wbr/> the last of which will be marked
7567 FINAL.<wbr/></span>
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]7568 </li>
7569 </ul>
7570
7571 </td> <!-- entry_type -->
7572
7573 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7574 <p>Whether a result given to the framework is the
7575final one for the capture,<wbr/> or only a partial that contains a
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]7576subset of the full set of dynamic metadata
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7577values.<wbr/></p>
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]7578 </td>
7579
7580 <td class="entry_units">
7581 </td>
7582
7583 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]7584 <p>Optional.<wbr/> Default value is FINAL.<wbr/></p>
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]7585 </td>
7586
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7587 <td class="entry_tags">
7588 </td>
7589
7590 </tr>
7591 <tr class="entries_header">
7592 <th class="th_details" colspan="5">Details</th>
7593 </tr>
7594 <tr class="entry_cont">
7595 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7596 <p>The entries in the result metadata buffers for a
7597single capture may not overlap,<wbr/> except for this entry.<wbr/> The
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]7598FINAL buffers must retain FIFO ordering relative to the
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7599requests that generate them,<wbr/> so the FINAL buffer for frame 3 must
7600always be sent to the framework after the FINAL buffer for frame 2,<wbr/> and
7601before the FINAL buffer for frame 4.<wbr/> PARTIAL buffers may be returned
7602in any order relative to other frames,<wbr/> but all PARTIAL buffers for a given
7603capture must arrive before the FINAL buffer for that capture.<wbr/> This entry may
7604only 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]7605 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7606 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7607
7608
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7609 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7610 <!-- end of entry -->
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]7611
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7612
7613
7614 <!-- end of kind -->
7615 </tbody>
7616
7617 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7618 <tr><td colspan="6" id="section_request" class="section">request</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7619
7620
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7621 <tr><td colspan="6" class="kind">controls</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7622
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7623 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7624 <tr>
7625 <th class="th_name">Property Name</th>
7626 <th class="th_type">Type</th>
7627 <th class="th_description">Description</th>
7628 <th class="th_units">Units</th>
7629 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7630 <th class="th_tags">Tags</th>
7631 </tr>
7632 </thead>
7633
7634 <tbody>
7635
7636
7637
7638
7639
7640
7641
7642
7643
7644
7645 <tr class="entry" id="controls_android.request.frameCount">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7646 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7647 android.<wbr/>request.<wbr/>frame<wbr/>Count
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7648 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7649 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7650 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7651
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7652 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7653
7654
7655 </td> <!-- entry_type -->
7656
7657 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7658 <p>A frame counter set by the framework.<wbr/> Must
7659be maintained unchanged in output frame.<wbr/> This value monotonically
7660increases with every new result (that is,<wbr/> each new result has a unique
7661frameCount value).<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7662 </td>
7663
7664 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7665 incrementing integer
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7666 </td>
7667
7668 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]7669 <p>Any int</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7670 </td>
7671
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7672 <td class="entry_tags">
7673 </td>
7674
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7675 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7676
7677
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7678 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7679 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7680
7681
7682 <tr class="entry" id="controls_android.request.id">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7683 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7684 android.<wbr/>request.<wbr/>id
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7685 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7686 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7687 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7688
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7689 <span class="entry_type_visibility"> [hidden]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7690
7691
7692 </td> <!-- entry_type -->
7693
7694 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7695 <p>An application-specified ID for the current
7696request.<wbr/> Must be maintained unchanged in output
7697frame</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7698 </td>
7699
7700 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7701 arbitrary integer assigned by application
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7702 </td>
7703
7704 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]7705 <p>Any int</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7706 </td>
7707
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7708 <td class="entry_tags">
7709 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]7710 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7711 </ul>
7712 </td>
7713
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7714 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7715
7716
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7717 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7718 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7719
7720
7721 <tr class="entry" id="controls_android.request.inputStreams">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7722 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7723 android.<wbr/>request.<wbr/>input<wbr/>Streams
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7724 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7725 <td class="entry_type">
Zhijun Hee36cdbe2013-09-06 14:28:37 -0700[diff] [blame]7726 <span class="entry_type_name">int32</span>
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]7727 <span class="entry_type_container">x</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7728
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]7729 <span class="entry_type_array">
7730 n
7731 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7732 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7733
7734
7735 </td> <!-- entry_type -->
7736
7737 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7738 <p>List which camera reprocess stream is used
7739for the source of reprocessing data.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7740 </td>
7741
7742 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7743 List of camera reprocess stream IDs
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7744 </td>
7745
7746 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]7747 <p>Typically,<wbr/> only one entry allowed,<wbr/> must be a valid
7748reprocess stream ID.<wbr/></p>
7749<p>If android.<wbr/>jpeg.<wbr/>needs<wbr/>Thumbnail is set,<wbr/> then multiple
7750reprocess streams may be included in a single request; they
7751must be different scaled versions of the same image.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7752 </td>
7753
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7754 <td class="entry_tags">
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]7755 <ul class="entry_tags">
7756 <li><a href="#tag_HAL2">HAL2</a></li>
7757 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7758 </td>
7759
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7760 </tr>
7761 <tr class="entries_header">
7762 <th class="th_details" colspan="5">Details</th>
7763 </tr>
7764 <tr class="entry_cont">
7765 <td class="entry_details" colspan="5">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]7766 <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]7767REPROCESS.<wbr/> Ignored otherwise</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7768 </td>
7769 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7770
7771
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7772 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7773 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7774
7775
7776 <tr class="entry" id="controls_android.request.metadataMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7777 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7778 android.<wbr/>request.<wbr/>metadata<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7779 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7780 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7781 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7782
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7783 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7784
7785 <ul class="entry_type_enum">
7786 <li>
7787 <span class="entry_type_enum_name">NONE</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7788 <span class="entry_type_enum_notes">No metadata should be produced on output,<wbr/> except
7789 for application-bound buffer data.<wbr/> If no
7790 application-bound streams exist,<wbr/> no frame should be
7791 placed in the output frame queue.<wbr/> If such streams
7792 exist,<wbr/> a frame should be placed on the output queue
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7793 with null metadata but with the necessary output buffer
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7794 information.<wbr/> Timestamp information should still be
7795 included with any output stream buffers</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7796 </li>
7797 <li>
7798 <span class="entry_type_enum_name">FULL</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7799 <span class="entry_type_enum_notes">All metadata should be produced.<wbr/> Statistics will
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7800 only be produced if they are separately
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7801 enabled</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7802 </li>
7803 </ul>
7804
7805 </td> <!-- entry_type -->
7806
7807 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7808 <p>How much metadata to produce on
7809output</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7810 </td>
7811
7812 <td class="entry_units">
7813 </td>
7814
7815 <td class="entry_range">
7816 </td>
7817
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7818 <td class="entry_tags">
7819 </td>
7820
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7821 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7822
7823
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7824 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7825 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7826
7827
7828 <tr class="entry" id="controls_android.request.outputStreams">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7829 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7830 android.<wbr/>request.<wbr/>output<wbr/>Streams
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7831 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7832 <td class="entry_type">
Zhijun Hee36cdbe2013-09-06 14:28:37 -0700[diff] [blame]7833 <span class="entry_type_name">int32</span>
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]7834 <span class="entry_type_container">x</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7835
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]7836 <span class="entry_type_array">
7837 n
7838 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7839 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7840
7841
7842 </td> <!-- entry_type -->
7843
7844 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7845 <p>Lists which camera output streams image data
7846from this capture must be sent to</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7847 </td>
7848
7849 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7850 List of camera stream IDs
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7851 </td>
7852
7853 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]7854 <p>List must only include streams that have been
7855created</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7856 </td>
7857
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7858 <td class="entry_tags">
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]7859 <ul class="entry_tags">
7860 <li><a href="#tag_HAL2">HAL2</a></li>
7861 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7862 </td>
7863
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7864 </tr>
7865 <tr class="entries_header">
7866 <th class="th_details" colspan="5">Details</th>
7867 </tr>
7868 <tr class="entry_cont">
7869 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7870 <p>If no output streams are listed,<wbr/> then the image
7871data should simply be discarded.<wbr/> The image data must
7872still be captured for metadata and statistics production,<wbr/>
7873and the lens and flash must operate as requested.<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7874 </td>
7875 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7876
7877
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7878 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7879 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7880
7881
7882 <tr class="entry" id="controls_android.request.type">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7883 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7884 android.<wbr/>request.<wbr/>type
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7885 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7886 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7887 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7888
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7889 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7890
7891 <ul class="entry_type_enum">
7892 <li>
7893 <span class="entry_type_enum_name">CAPTURE</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7894 <span class="entry_type_enum_notes">Capture a new image from the imaging hardware,<wbr/>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7895 and process it according to the
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7896 settings</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7897 </li>
7898 <li>
7899 <span class="entry_type_enum_name">REPROCESS</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7900 <span class="entry_type_enum_notes">Process previously captured data; the
7901 android.<wbr/>request.<wbr/>input<wbr/>Stream parameter determines the
7902 source reprocessing stream.<wbr/> TODO: Mark dynamic metadata
7903 needed for reprocessing with [RP]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7904 </li>
7905 </ul>
7906
7907 </td> <!-- entry_type -->
7908
7909 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7910 <p>The type of the request; either CAPTURE or
7911REPROCESS.<wbr/> For HAL3,<wbr/> this tag is redundant.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7912 </td>
7913
7914 <td class="entry_units">
7915 </td>
7916
7917 <td class="entry_range">
7918 </td>
7919
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7920 <td class="entry_tags">
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]7921 <ul class="entry_tags">
7922 <li><a href="#tag_HAL2">HAL2</a></li>
7923 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7924 </td>
7925
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7926 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7927
7928
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7929 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7930 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7931
7932
7933
7934 <!-- end of kind -->
7935 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7936 <tr><td colspan="6" class="kind">static</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7937
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7938 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7939 <tr>
7940 <th class="th_name">Property Name</th>
7941 <th class="th_type">Type</th>
7942 <th class="th_description">Description</th>
7943 <th class="th_units">Units</th>
7944 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7945 <th class="th_tags">Tags</th>
7946 </tr>
7947 </thead>
7948
7949 <tbody>
7950
7951
7952
7953
7954
7955
7956
7957
7958
7959
7960 <tr class="entry" id="static_android.request.maxNumOutputStreams">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7961 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7962 android.<wbr/>request.<wbr/>max<wbr/>Num<wbr/>Output<wbr/>Streams
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7963 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7964 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7965 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7966 <span class="entry_type_container">x</span>
7967
7968 <span class="entry_type_array">
7969 3
7970 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7971 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7972
7973
7974 </td> <!-- entry_type -->
7975
7976 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7977 <p>How many output streams can be allocated at
7978the same time for each type of stream</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7979 </td>
7980
7981 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7982 The number of raw sensor streams; the number of
7983 processed,<wbr/> uncompressed streams; and the number of
7984 JPEG-compressed streams
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7985 </td>
7986
7987 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame^]7988 <p>&gt;=1 for Raw and JPEG-compressed stream.<wbr/> &gt;= 3
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]7989for processed,<wbr/> uncompressed streams</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7990 </td>
7991
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7992 <td class="entry_tags">
7993 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]7994 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7995 </ul>
7996 </td>
7997
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7998 </tr>
7999 <tr class="entries_header">
8000 <th class="th_details" colspan="5">Details</th>
8001 </tr>
8002 <tr class="entry_cont">
8003 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8004 <p>Video snapshot with preview callbacks requires 3
8005processed streams (preview,<wbr/> record,<wbr/> app callbacks) and
8006one JPEG stream (snapshot)</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8007 </td>
8008 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8009
8010
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8011 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8012 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8013
8014
8015 <tr class="entry" id="static_android.request.maxNumReprocessStreams">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8016 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8017 android.<wbr/>request.<wbr/>max<wbr/>Num<wbr/>Reprocess<wbr/>Streams
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8018 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8019 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8020 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8021 <span class="entry_type_container">x</span>
8022
8023 <span class="entry_type_array">
8024 1
8025 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8026 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8027
8028
8029 </td> <!-- entry_type -->
8030
8031 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8032 <p>How many reprocessing streams of any type
8033can be allocated at the same time</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8034 </td>
8035
8036 <td class="entry_units">
8037 </td>
8038
8039 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame^]8040 <p>&gt;= 1</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8041 </td>
8042
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8043 <td class="entry_tags">
8044 </td>
8045
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8046 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8047
8048
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8049 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8050 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8051
8052
8053
8054 <!-- end of kind -->
8055 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8056 <tr><td colspan="6" class="kind">dynamic</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8057
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8058 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8059 <tr>
8060 <th class="th_name">Property Name</th>
8061 <th class="th_type">Type</th>
8062 <th class="th_description">Description</th>
8063 <th class="th_units">Units</th>
8064 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8065 <th class="th_tags">Tags</th>
8066 </tr>
8067 </thead>
8068
8069 <tbody>
8070
8071
8072
8073
8074
8075
8076
8077
8078
8079
8080 <tr class="entry" id="dynamic_android.request.frameCount">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8081 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8082 android.<wbr/>request.<wbr/>frame<wbr/>Count
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8083 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8084 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8085 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8086
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8087 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8088
8089
8090 </td> <!-- entry_type -->
8091
8092 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8093 <p>A frame counter set by the framework.<wbr/> This value monotonically
8094increases with every new result (that is,<wbr/> each new result has a unique
8095frameCount value).<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8096 </td>
8097
8098 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8099 count of frames
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8100 </td>
8101
8102 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame^]8103 <p>&gt; 0</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8104 </td>
8105
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8106 <td class="entry_tags">
8107 </td>
8108
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8109 </tr>
8110 <tr class="entries_header">
8111 <th class="th_details" colspan="5">Details</th>
8112 </tr>
8113 <tr class="entry_cont">
8114 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8115 <p>Reset on release()</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8116 </td>
8117 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8118
8119
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8120 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8121 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8122
8123
8124 <tr class="entry" id="dynamic_android.request.id">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8125 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8126 android.<wbr/>request.<wbr/>id
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8127 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8128 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8129 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8130
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8131 <span class="entry_type_visibility"> [hidden]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8132
8133
8134 </td> <!-- entry_type -->
8135
8136 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8137 <p>An application-specified ID for the current
8138request.<wbr/> Must be maintained unchanged in output
8139frame</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8140 </td>
8141
8142 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8143 arbitrary integer assigned by application
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8144 </td>
8145
8146 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]8147 <p>Any int</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8148 </td>
8149
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8150 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]8151 <ul class="entry_tags">
8152 <li><a href="#tag_V1">V1</a></li>
8153 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8154 </td>
8155
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8156 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8157
8158
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8159 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8160 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8161
8162
8163 <tr class="entry" id="dynamic_android.request.metadataMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8164 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8165 android.<wbr/>request.<wbr/>metadata<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8166 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8167 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8168 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8169
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8170 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8171
8172 <ul class="entry_type_enum">
8173 <li>
8174 <span class="entry_type_enum_name">NONE</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8175 <span class="entry_type_enum_notes">No metadata should be produced on output,<wbr/> except
8176 for application-bound buffer data.<wbr/> If no
8177 application-bound streams exist,<wbr/> no frame should be
8178 placed in the output frame queue.<wbr/> If such streams
8179 exist,<wbr/> a frame should be placed on the output queue
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8180 with null metadata but with the necessary output buffer
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8181 information.<wbr/> Timestamp information should still be
8182 included with any output stream buffers</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8183 </li>
8184 <li>
8185 <span class="entry_type_enum_name">FULL</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8186 <span class="entry_type_enum_notes">All metadata should be produced.<wbr/> Statistics will
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8187 only be produced if they are separately
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8188 enabled</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8189 </li>
8190 </ul>
8191
8192 </td> <!-- entry_type -->
8193
8194 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8195 <p>How much metadata to produce on
8196output</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8197 </td>
8198
8199 <td class="entry_units">
8200 </td>
8201
8202 <td class="entry_range">
8203 </td>
8204
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8205 <td class="entry_tags">
8206 </td>
8207
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8208 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8209
8210
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8211 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8212 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8213
8214
8215 <tr class="entry" id="dynamic_android.request.outputStreams">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8216 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8217 android.<wbr/>request.<wbr/>output<wbr/>Streams
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8218 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8219 <td class="entry_type">
Zhijun Hee36cdbe2013-09-06 14:28:37 -0700[diff] [blame]8220 <span class="entry_type_name">int32</span>
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]8221 <span class="entry_type_container">x</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8222
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]8223 <span class="entry_type_array">
8224 n
8225 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8226 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8227
8228
8229 </td> <!-- entry_type -->
8230
8231 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8232 <p>Lists which camera output streams image data
8233from this capture must be sent to</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8234 </td>
8235
8236 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8237 List of camera stream IDs
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8238 </td>
8239
8240 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]8241 <p>List must only include streams that have been
8242created</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8243 </td>
8244
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8245 <td class="entry_tags">
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]8246 <ul class="entry_tags">
8247 <li><a href="#tag_HAL2">HAL2</a></li>
8248 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8249 </td>
8250
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8251 </tr>
8252 <tr class="entries_header">
8253 <th class="th_details" colspan="5">Details</th>
8254 </tr>
8255 <tr class="entry_cont">
8256 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8257 <p>If no output streams are listed,<wbr/> then the image
8258data should simply be discarded.<wbr/> The image data must
8259still be captured for metadata and statistics production,<wbr/>
8260and the lens and flash must operate as requested.<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8261 </td>
8262 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8263
8264
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8265 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8266 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8267
8268
8269
8270 <!-- end of kind -->
8271 </tbody>
8272
8273 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8274 <tr><td colspan="6" id="section_scaler" class="section">scaler</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8275
8276
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8277 <tr><td colspan="6" class="kind">controls</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8278
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8279 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8280 <tr>
8281 <th class="th_name">Property Name</th>
8282 <th class="th_type">Type</th>
8283 <th class="th_description">Description</th>
8284 <th class="th_units">Units</th>
8285 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8286 <th class="th_tags">Tags</th>
8287 </tr>
8288 </thead>
8289
8290 <tbody>
8291
8292
8293
8294
8295
8296
8297
8298
8299
8300
8301 <tr class="entry" id="controls_android.scaler.cropRegion">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8302 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8303 android.<wbr/>scaler.<wbr/>crop<wbr/>Region
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8304 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8305 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8306 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8307 <span class="entry_type_container">x</span>
8308
8309 <span class="entry_type_array">
Eino-Ville Talvalae04ec6e2013-04-16 15:35:18 -0700[diff] [blame]8310 4
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8311 </span>
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]8312 <span class="entry_type_visibility"> [public as rectangle]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8313
8314
8315 </td> <!-- entry_type -->
8316
8317 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8318 <p>(x,<wbr/> y,<wbr/> width,<wbr/> height).<wbr/></p>
8319<p>A rectangle with the top-level corner of (x,<wbr/>y) and size
8320(width,<wbr/> height).<wbr/> The region of the sensor that is used for
8321output.<wbr/> Each stream must use this rectangle to produce its
8322output,<wbr/> cropping to a smaller region if necessary to
8323maintain the stream's aspect ratio.<wbr/></p>
8324<p>HAL2.<wbr/>x uses only (x,<wbr/> y,<wbr/> width)</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8325 </td>
8326
8327 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8328 (x,<wbr/>y) of top-left corner,<wbr/> width and height of region
8329 in pixels; (0,<wbr/>0) is top-left corner of
8330 android.<wbr/>sensor.<wbr/>active<wbr/>Array<wbr/>Size
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8331 </td>
8332
8333 <td class="entry_range">
8334 </td>
8335
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8336 <td class="entry_tags">
8337 <ul class="entry_tags">
8338 <li><a href="#tag_BC">BC</a></li>
8339 </ul>
8340 </td>
8341
8342 </tr>
8343 <tr class="entries_header">
8344 <th class="th_details" colspan="5">Details</th>
8345 </tr>
8346 <tr class="entry_cont">
8347 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8348 <p>Any additional per-stream cropping must be done to
8349maximize the final pixel area of the stream.<wbr/></p>
8350<p>For example,<wbr/> if the crop region is set to a 4:3 aspect
8351ratio,<wbr/> then 4:3 streams should use the exact crop
8352region.<wbr/> 16:9 streams should further crop vertically
8353(letterbox).<wbr/></p>
8354<p>Conversely,<wbr/> if the crop region is set to a 16:9,<wbr/> then 4:3
8355outputs should crop horizontally (pillarbox),<wbr/> and 16:9
8356streams should match exactly.<wbr/> These additional crops must
8357be centered within the crop region.<wbr/></p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]8358<p>The output streams must maintain square pixels at all
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8359times,<wbr/> no matter what the relative aspect ratios of the
8360crop region and the stream are.<wbr/> Negative values for
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]8361corner are allowed for raw output if full pixel array is
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8362larger than active pixel array.<wbr/> Width and height may be
8363rounded to nearest larger supportable width,<wbr/> especially
8364for raw output,<wbr/> where only a few fixed scales may be
8365possible.<wbr/> The width and height of the crop region cannot
8366be set to be smaller than floor( activeArraySize.<wbr/>width /<wbr/>
8367android.<wbr/>scaler.<wbr/>max<wbr/>Digital<wbr/>Zoom ) and floor(
8368activeArraySize.<wbr/>height /<wbr/> android.<wbr/>scaler.<wbr/>max<wbr/>Digital<wbr/>Zoom),<wbr/>
8369respectively.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8370 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8371 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8372
8373
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8374 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8375 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8376
8377
8378
8379 <!-- end of kind -->
8380 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8381 <tr><td colspan="6" class="kind">static</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8382
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8383 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8384 <tr>
8385 <th class="th_name">Property Name</th>
8386 <th class="th_type">Type</th>
8387 <th class="th_description">Description</th>
8388 <th class="th_units">Units</th>
8389 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8390 <th class="th_tags">Tags</th>
8391 </tr>
8392 </thead>
8393
8394 <tbody>
8395
8396
8397
8398
8399
8400
8401
8402
8403
8404
8405 <tr class="entry" id="static_android.scaler.availableFormats">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8406 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8407 android.<wbr/>scaler.<wbr/>available<wbr/>Formats
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8408 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8409 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8410 <span class="entry_type_name entry_type_name_enum">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8411 <span class="entry_type_container">x</span>
8412
8413 <span class="entry_type_array">
8414 n
8415 </span>
Eino-Ville Talvalad4e240a2013-08-08 12:56:37 -0700[diff] [blame]8416 <span class="entry_type_visibility"> [public as imageFormat]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8417 <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]8418
8419 <ul class="entry_type_enum">
8420 <li>
8421 <span class="entry_type_enum_name">RAW_SENSOR</span>
8422 <span class="entry_type_enum_value">0x20</span>
8423 </li>
8424 <li>
8425 <span class="entry_type_enum_name">YV12</span>
8426 <span class="entry_type_enum_value">0x32315659</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8427 <span class="entry_type_enum_notes">YCrCb 4:2:0 Planar</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8428 </li>
8429 <li>
Zhijun Hec2eebff2013-05-16 17:49:35 -0700[diff] [blame]8430 <span class="entry_type_enum_name">YCrCb_420_SP</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8431 <span class="entry_type_enum_value">0x11</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8432 <span class="entry_type_enum_notes">NV21</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8433 </li>
8434 <li>
Zhijun Hec2eebff2013-05-16 17:49:35 -0700[diff] [blame]8435 <span class="entry_type_enum_name">IMPLEMENTATION_DEFINED</span>
8436 <span class="entry_type_enum_value">0x22</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8437 <span class="entry_type_enum_notes">Hal Implementation Defined</span>
Zhijun Hec2eebff2013-05-16 17:49:35 -0700[diff] [blame]8438 </li>
8439 <li>
8440 <span class="entry_type_enum_name">YCbCr_420_888</span>
8441 <span class="entry_type_enum_value">0x23</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8442 <span class="entry_type_enum_notes">Flexible YUV420 Format</span>
Zhijun Hec2eebff2013-05-16 17:49:35 -0700[diff] [blame]8443 </li>
8444 <li>
8445 <span class="entry_type_enum_name">BLOB</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8446 <span class="entry_type_enum_value">0x21</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8447 <span class="entry_type_enum_notes">JPEG</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8448 </li>
8449 </ul>
8450
8451 </td> <!-- entry_type -->
8452
8453 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8454 <p>List of app-visible formats</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8455 </td>
8456
8457 <td class="entry_units">
8458 </td>
8459
8460 <td class="entry_range">
8461 </td>
8462
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8463 <td class="entry_tags">
8464 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]8465 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8466 </ul>
8467 </td>
8468
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8469 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8470
8471
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8472 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8473 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8474
8475
8476 <tr class="entry" id="static_android.scaler.availableJpegMinDurations">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8477 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8478 android.<wbr/>scaler.<wbr/>available<wbr/>Jpeg<wbr/>Min<wbr/>Durations
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8479 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8480 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8481 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8482 <span class="entry_type_container">x</span>
8483
8484 <span class="entry_type_array">
8485 n
8486 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8487 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8488
8489
8490 </td> <!-- entry_type -->
8491
8492 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8493 <p>The minimum frame duration that is supported
8494for each resolution in availableJpegSizes.<wbr/> Should
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]8495correspond to the frame duration when only that JPEG
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8496stream is active and captured in a burst,<wbr/> with all
8497processing set to FAST</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8498 </td>
8499
8500 <td class="entry_units">
8501 </td>
8502
8503 <td class="entry_range">
8504 </td>
8505
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8506 <td class="entry_tags">
8507 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]8508 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8509 </ul>
8510 </td>
8511
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8512 </tr>
8513 <tr class="entries_header">
8514 <th class="th_details" colspan="5">Details</th>
8515 </tr>
8516 <tr class="entry_cont">
8517 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8518 <p>When multiple streams are configured,<wbr/> the minimum
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8519frame duration will be &gt;= max(individual stream min
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8520durations)</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8521 </td>
8522 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8523
8524
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8525 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8526 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8527
8528
8529 <tr class="entry" id="static_android.scaler.availableJpegSizes">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8530 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8531 android.<wbr/>scaler.<wbr/>available<wbr/>Jpeg<wbr/>Sizes
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8532 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8533 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8534 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8535 <span class="entry_type_container">x</span>
8536
8537 <span class="entry_type_array">
8538 n x 2
8539 </span>
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]8540 <span class="entry_type_visibility"> [public as size]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8541
8542
8543 </td> <!-- entry_type -->
8544
8545 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8546 <p>The resolutions available for output from
8547the JPEG block.<wbr/> Listed as width x height</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8548 </td>
8549
8550 <td class="entry_units">
8551 </td>
8552
8553 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]8554 <p>Must include: - sensor maximum resolution Should
8555include: - half/<wbr/>quarter max resolution</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8556 </td>
8557
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8558 <td class="entry_tags">
8559 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]8560 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8561 </ul>
8562 </td>
8563
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8564 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8565
8566
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8567 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8568 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8569
8570
8571 <tr class="entry" id="static_android.scaler.availableMaxDigitalZoom">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8572 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8573 android.<wbr/>scaler.<wbr/>available<wbr/>Max<wbr/>Digital<wbr/>Zoom
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8574 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8575 <td class="entry_type">
Igor Murashkinf11a4df2013-05-07 10:00:46 -0700[diff] [blame]8576 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8577
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8578 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8579
8580
8581 </td> <!-- entry_type -->
8582
8583 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8584 <p>The maximum ratio between active area width
8585and crop region width,<wbr/> or between active area height and
8586crop region height,<wbr/> if the crop region height is larger
8587than width</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8588 </td>
8589
8590 <td class="entry_units">
8591 </td>
8592
8593 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame^]8594 <p>&gt;=1</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8595 </td>
8596
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8597 <td class="entry_tags">
Igor Murashkinf11a4df2013-05-07 10:00:46 -0700[diff] [blame]8598 <ul class="entry_tags">
8599 <li><a href="#tag_BC">BC</a></li>
8600 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8601 </td>
8602
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8603 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8604
8605
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8606 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8607 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8608
8609
8610 <tr class="entry" id="static_android.scaler.availableProcessedMinDurations">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8611 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8612 android.<wbr/>scaler.<wbr/>available<wbr/>Processed<wbr/>Min<wbr/>Durations
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8613 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8614 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8615 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8616 <span class="entry_type_container">x</span>
8617
8618 <span class="entry_type_array">
8619 n
8620 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8621 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8622
8623
8624 </td> <!-- entry_type -->
8625
8626 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8627 <p>The minimum frame duration that is supported
8628for each resolution in availableProcessedSizes.<wbr/> Should
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]8629correspond to the frame duration when only that processed
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8630stream is active,<wbr/> with all processing set to
8631FAST</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8632 </td>
8633
8634 <td class="entry_units">
8635 </td>
8636
8637 <td class="entry_range">
8638 </td>
8639
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8640 <td class="entry_tags">
8641 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]8642 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8643 </ul>
8644 </td>
8645
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8646 </tr>
8647 <tr class="entries_header">
8648 <th class="th_details" colspan="5">Details</th>
8649 </tr>
8650 <tr class="entry_cont">
8651 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8652 <p>When multiple streams are configured,<wbr/> the minimum
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8653frame duration will be &gt;= max(individual stream min
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8654durations)</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8655 </td>
8656 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8657
8658
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8659 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8660 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8661
8662
8663 <tr class="entry" id="static_android.scaler.availableProcessedSizes">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8664 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8665 android.<wbr/>scaler.<wbr/>available<wbr/>Processed<wbr/>Sizes
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8666 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8667 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8668 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8669 <span class="entry_type_container">x</span>
8670
8671 <span class="entry_type_array">
8672 n x 2
8673 </span>
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]8674 <span class="entry_type_visibility"> [public as size]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8675
8676
8677 </td> <!-- entry_type -->
8678
8679 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8680 <p>The resolutions available for use with
8681processed output streams,<wbr/> such as YV12,<wbr/> NV12,<wbr/> and
8682platform opaque YUV/<wbr/>RGB streams to the GPU or video
8683encoders.<wbr/> Listed as width,<wbr/> height</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8684 </td>
8685
8686 <td class="entry_units">
8687 </td>
8688
8689 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]8690 <p>Must include: - sensor maximum resolution -
8691standard QCIF,<wbr/> 240p,<wbr/> 480p,<wbr/> 720p,<wbr/> and 1080p
8692resolutions</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8693 </td>
8694
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8695 <td class="entry_tags">
8696 <ul class="entry_tags">
8697 <li><a href="#tag_BC">BC</a></li>
8698 </ul>
8699 </td>
8700
8701 </tr>
8702 <tr class="entries_header">
8703 <th class="th_details" colspan="5">Details</th>
8704 </tr>
8705 <tr class="entry_cont">
8706 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8707 <p>The actual supported resolution list may be limited by
8708consumer end points for different use cases.<wbr/> For example,<wbr/> for
8709recording use case,<wbr/> the largest supported resolution may be
8710limited by max supported size from encoder,<wbr/> for preview use
8711case,<wbr/> the largest supported resolution may be limited by max
8712resolution SurfaceTexture/<wbr/>SurfaceView can support.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8713 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8714 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8715
8716
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8717 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8718 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8719
8720
8721 <tr class="entry" id="static_android.scaler.availableRawMinDurations">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8722 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8723 android.<wbr/>scaler.<wbr/>available<wbr/>Raw<wbr/>Min<wbr/>Durations
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8724 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8725 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8726 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8727 <span class="entry_type_container">x</span>
8728
8729 <span class="entry_type_array">
8730 n
8731 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8732 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8733
8734
8735 </td> <!-- entry_type -->
8736
8737 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8738 <p>The minimum frame duration that is supported
8739for each raw resolution in availableRawSizes.<wbr/> Should
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]8740correspond to the frame duration when only the raw stream
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8741is active.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8742 </td>
8743
8744 <td class="entry_units">
8745 </td>
8746
8747 <td class="entry_range">
8748 </td>
8749
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8750 <td class="entry_tags">
8751 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]8752 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8753 </ul>
8754 </td>
8755
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8756 </tr>
8757 <tr class="entries_header">
8758 <th class="th_details" colspan="5">Details</th>
8759 </tr>
8760 <tr class="entry_cont">
8761 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8762 <p>When multiple streams are configured,<wbr/> the minimum
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8763frame duration will be &gt;= max(individual stream min
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8764durations)</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8765 </td>
8766 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8767
8768
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8769 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8770 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8771
8772
8773 <tr class="entry" id="static_android.scaler.availableRawSizes">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8774 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8775 android.<wbr/>scaler.<wbr/>available<wbr/>Raw<wbr/>Sizes
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8776 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8777 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8778 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8779 <span class="entry_type_container">x</span>
8780
8781 <span class="entry_type_array">
8782 n x 2
8783 </span>
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]8784 <span class="entry_type_visibility"> [system as size]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8785
8786
8787 </td> <!-- entry_type -->
8788
8789 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8790 <p>The resolutions available for use with raw
8791sensor output streams,<wbr/> listed as width,<wbr/>
8792height</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8793 </td>
8794
8795 <td class="entry_units">
8796 </td>
8797
8798 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]8799 <p>Must include: - sensor maximum resolution</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8800 </td>
8801
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8802 <td class="entry_tags">
8803 </td>
8804
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8805 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8806
8807
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8808 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8809 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8810
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8811
8812
8813 <!-- end of kind -->
8814 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8815 <tr><td colspan="6" class="kind">dynamic</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8816
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8817 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8818 <tr>
8819 <th class="th_name">Property Name</th>
8820 <th class="th_type">Type</th>
8821 <th class="th_description">Description</th>
8822 <th class="th_units">Units</th>
8823 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8824 <th class="th_tags">Tags</th>
8825 </tr>
8826 </thead>
8827
8828 <tbody>
8829
8830
8831
8832
8833
8834
8835
8836
8837
8838
8839 <tr class="entry" id="dynamic_android.scaler.cropRegion">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8840 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8841 android.<wbr/>scaler.<wbr/>crop<wbr/>Region
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8842 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8843 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8844 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8845 <span class="entry_type_container">x</span>
8846
8847 <span class="entry_type_array">
Eino-Ville Talvalae04ec6e2013-04-16 15:35:18 -0700[diff] [blame]8848 4
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8849 </span>
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]8850 <span class="entry_type_visibility"> [public as rectangle]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8851
8852
8853 </td> <!-- entry_type -->
8854
8855 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8856 <p>(x,<wbr/> y,<wbr/> width,<wbr/> height).<wbr/></p>
8857<p>A rectangle with the top-level corner of (x,<wbr/>y) and size
8858(width,<wbr/> height).<wbr/> The region of the sensor that is used for
8859output.<wbr/> Each stream must use this rectangle to produce its
8860output,<wbr/> cropping to a smaller region if necessary to
8861maintain the stream's aspect ratio.<wbr/></p>
8862<p>HAL2.<wbr/>x uses only (x,<wbr/> y,<wbr/> width)</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8863 </td>
8864
8865 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8866 (x,<wbr/>y) of top-left corner,<wbr/> width and height of region
8867 in pixels; (0,<wbr/>0) is top-left corner of
8868 android.<wbr/>sensor.<wbr/>active<wbr/>Array<wbr/>Size
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8869 </td>
8870
8871 <td class="entry_range">
8872 </td>
8873
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8874 <td class="entry_tags">
8875 <ul class="entry_tags">
8876 <li><a href="#tag_BC">BC</a></li>
8877 </ul>
8878 </td>
8879
8880 </tr>
8881 <tr class="entries_header">
8882 <th class="th_details" colspan="5">Details</th>
8883 </tr>
8884 <tr class="entry_cont">
8885 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8886 <p>Any additional per-stream cropping must be done to
8887maximize the final pixel area of the stream.<wbr/></p>
8888<p>For example,<wbr/> if the crop region is set to a 4:3 aspect
8889ratio,<wbr/> then 4:3 streams should use the exact crop
8890region.<wbr/> 16:9 streams should further crop vertically
8891(letterbox).<wbr/></p>
8892<p>Conversely,<wbr/> if the crop region is set to a 16:9,<wbr/> then 4:3
8893outputs should crop horizontally (pillarbox),<wbr/> and 16:9
8894streams should match exactly.<wbr/> These additional crops must
8895be centered within the crop region.<wbr/></p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]8896<p>The output streams must maintain square pixels at all
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8897times,<wbr/> no matter what the relative aspect ratios of the
8898crop region and the stream are.<wbr/> Negative values for
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]8899corner are allowed for raw output if full pixel array is
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8900larger than active pixel array.<wbr/> Width and height may be
8901rounded to nearest larger supportable width,<wbr/> especially
8902for raw output,<wbr/> where only a few fixed scales may be
8903possible.<wbr/> The width and height of the crop region cannot
8904be set to be smaller than floor( activeArraySize.<wbr/>width /<wbr/>
8905android.<wbr/>scaler.<wbr/>max<wbr/>Digital<wbr/>Zoom ) and floor(
8906activeArraySize.<wbr/>height /<wbr/> android.<wbr/>scaler.<wbr/>max<wbr/>Digital<wbr/>Zoom),<wbr/>
8907respectively.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8908 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8909 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8910
8911
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8912 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8913 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8914
8915
8916
8917 <!-- end of kind -->
8918 </tbody>
8919
8920 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8921 <tr><td colspan="6" id="section_sensor" class="section">sensor</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8922
8923
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8924 <tr><td colspan="6" class="kind">controls</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8925
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8926 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8927 <tr>
8928 <th class="th_name">Property Name</th>
8929 <th class="th_type">Type</th>
8930 <th class="th_description">Description</th>
8931 <th class="th_units">Units</th>
8932 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8933 <th class="th_tags">Tags</th>
8934 </tr>
8935 </thead>
8936
8937 <tbody>
8938
8939
8940
8941
8942
8943
8944
8945
8946
8947
8948 <tr class="entry" id="controls_android.sensor.exposureTime">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8949 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8950 android.<wbr/>sensor.<wbr/>exposure<wbr/>Time
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8951 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8952 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8953 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8954
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8955 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8956
8957
8958 </td> <!-- entry_type -->
8959
8960 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8961 <p>Duration each pixel is exposed to
8962light.<wbr/></p>
8963<p>If the sensor can't expose this exact duration,<wbr/> it should shorten the
8964duration exposed to the nearest possible value (rather than expose longer).<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8965 </td>
8966
8967 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8968 nanoseconds
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8969 </td>
8970
8971 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]8972 <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]8973 </td>
8974
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8975 <td class="entry_tags">
8976 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]8977 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8978 </ul>
8979 </td>
8980
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8981 </tr>
8982 <tr class="entries_header">
8983 <th class="th_details" colspan="5">Details</th>
8984 </tr>
8985 <tr class="entry_cont">
8986 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8987 <p>1/<wbr/>10000 - 30 sec range.<wbr/> No bulb mode</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8988 </td>
8989 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8990
8991
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8992 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8993 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8994
8995
8996 <tr class="entry" id="controls_android.sensor.frameDuration">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8997 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8998 android.<wbr/>sensor.<wbr/>frame<wbr/>Duration
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8999 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9000 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9001 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9002
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9003 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9004
9005
9006 </td> <!-- entry_type -->
9007
9008 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9009 <p>Duration from start of frame exposure to
9010start of next frame exposure</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9011 </td>
9012
9013 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9014 nanoseconds
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9015 </td>
9016
9017 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]9018 <p>see <a href="#static_android.sensor.info.maxFrameDuration">android.<wbr/>sensor.<wbr/>info.<wbr/>max<wbr/>Frame<wbr/>Duration</a>,<wbr/>
9019android.<wbr/>scaler.<wbr/>info.<wbr/>available<wbr/>Min<wbr/>Frame<wbr/>Durations</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9020 </td>
9021
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9022 <td class="entry_tags">
9023 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9024 <li><a href="#tag_V1">V1</a></li>
9025 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9026 </ul>
9027 </td>
9028
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9029 </tr>
9030 <tr class="entries_header">
9031 <th class="th_details" colspan="5">Details</th>
9032 </tr>
9033 <tr class="entry_cont">
9034 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9035 <p>Exposure time has priority,<wbr/> so duration is set to
9036max(duration,<wbr/> exposure time + overhead)</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9037 </td>
9038 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9039
9040
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9041 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9042 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9043
9044
9045 <tr class="entry" id="controls_android.sensor.sensitivity">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9046 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9047 android.<wbr/>sensor.<wbr/>sensitivity
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9048 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9049 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9050 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9051
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9052 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9053
9054
9055 </td> <!-- entry_type -->
9056
9057 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9058 <p>Gain applied to image data.<wbr/> Must be
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]9059implemented through analog gain only if set to values
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9060below 'maximum analog sensitivity'.<wbr/></p>
9061<p>If the sensor can't apply this exact gain,<wbr/> it should lessen the
9062gain to the nearest possible value (rather than gain more).<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9063 </td>
9064
9065 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9066 ISO arithmetic units
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9067 </td>
9068
9069 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]9070 <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]9071 </td>
9072
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9073 <td class="entry_tags">
9074 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9075 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9076 </ul>
9077 </td>
9078
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9079 </tr>
9080 <tr class="entries_header">
9081 <th class="th_details" colspan="5">Details</th>
9082 </tr>
9083 <tr class="entry_cont">
9084 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9085 <p>ISO 12232:2006 REI method</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9086 </td>
9087 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9088
9089
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9090 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9091 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9092
9093
9094
9095 <!-- end of kind -->
9096 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9097 <tr><td colspan="6" class="kind">static</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9098
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9099 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9100 <tr>
9101 <th class="th_name">Property Name</th>
9102 <th class="th_type">Type</th>
9103 <th class="th_description">Description</th>
9104 <th class="th_units">Units</th>
9105 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9106 <th class="th_tags">Tags</th>
9107 </tr>
9108 </thead>
9109
9110 <tbody>
9111
9112
9113
9114
9115
9116
9117
9118
9119
9120
9121
9122
9123 <tr class="entry" id="static_android.sensor.info.activeArraySize">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9124 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9125 android.<wbr/>sensor.<wbr/>info.<wbr/>active<wbr/>Array<wbr/>Size
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9126 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9127 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9128 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9129 <span class="entry_type_container">x</span>
9130
9131 <span class="entry_type_array">
9132 4
9133 </span>
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]9134 <span class="entry_type_visibility"> [public as rectangle]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9135 <div class="entry_type_notes">Four ints defining the active pixel rectangle</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9136
9137
9138 </td> <!-- entry_type -->
9139
9140 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9141 <p>Area of raw data which corresponds to only
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]9142active pixels; smaller or equal to
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9143pixelArraySize.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9144 </td>
9145
9146 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9147 xmin,<wbr/> ymin,<wbr/> width,<wbr/> height.<wbr/> Top left of full
9148 pixel array is (0,<wbr/>0)
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9149 </td>
9150
9151 <td class="entry_range">
9152 </td>
9153
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9154 <td class="entry_tags">
9155 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9156 <li><a href="#tag_DNG">DNG</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9157 </ul>
9158 </td>
9159
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9160 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9161
9162
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9163 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9164 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9165
9166
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]9167 <tr class="entry" id="static_android.sensor.info.sensitivityRange">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9168 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9169 android.<wbr/>sensor.<wbr/>info.<wbr/>sensitivity<wbr/>Range
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9170 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9171 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9172 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9173 <span class="entry_type_container">x</span>
9174
9175 <span class="entry_type_array">
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]9176 2
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9177 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9178 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9179 <div class="entry_type_notes">Range of supported sensitivities</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9180
9181
9182 </td> <!-- entry_type -->
9183
9184 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9185 <p>Range of valid sensitivities</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9186 </td>
9187
9188 <td class="entry_units">
9189 </td>
9190
9191 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]9192 <p>Min &lt;= 100,<wbr/> Max &gt;= 1600</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9193 </td>
9194
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9195 <td class="entry_tags">
9196 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9197 <li><a href="#tag_BC">BC</a></li>
9198 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9199 </ul>
9200 </td>
9201
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9202 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9203
9204
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9205 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9206 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9207
9208
9209 <tr class="entry" id="static_android.sensor.info.colorFilterArrangement">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9210 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9211 android.<wbr/>sensor.<wbr/>info.<wbr/>color<wbr/>Filter<wbr/>Arrangement
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9212 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9213 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9214 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9215
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9216 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9217
9218 <ul class="entry_type_enum">
9219 <li>
9220 <span class="entry_type_enum_name">RGGB</span>
9221 </li>
9222 <li>
9223 <span class="entry_type_enum_name">GRBG</span>
9224 </li>
9225 <li>
9226 <span class="entry_type_enum_name">GBRG</span>
9227 </li>
9228 <li>
9229 <span class="entry_type_enum_name">BGGR</span>
9230 </li>
9231 <li>
9232 <span class="entry_type_enum_name">RGB</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9233 <span class="entry_type_enum_notes">Sensor is not Bayer; output has 3 16-bit
9234 values for each pixel,<wbr/> instead of just 1 16-bit value
9235 per pixel.<wbr/></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9236 </li>
9237 </ul>
9238
9239 </td> <!-- entry_type -->
9240
9241 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9242 <p>Arrangement of color filters on sensor;
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]9243represents the colors in the top-left 2x2 section of
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9244the sensor,<wbr/> in reading order</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9245 </td>
9246
9247 <td class="entry_units">
9248 </td>
9249
9250 <td class="entry_range">
9251 </td>
9252
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9253 <td class="entry_tags">
9254 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9255 <li><a href="#tag_DNG">DNG</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9256 </ul>
9257 </td>
9258
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9259 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9260
9261
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9262 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9263 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9264
9265
9266 <tr class="entry" id="static_android.sensor.info.exposureTimeRange">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9267 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9268 android.<wbr/>sensor.<wbr/>info.<wbr/>exposure<wbr/>Time<wbr/>Range
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9269 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9270 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9271 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9272 <span class="entry_type_container">x</span>
9273
9274 <span class="entry_type_array">
9275 2
9276 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9277 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9278 <div class="entry_type_notes">nanoseconds</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9279
9280
9281 </td> <!-- entry_type -->
9282
9283 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9284 <p>Range of valid exposure
9285times</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9286 </td>
9287
9288 <td class="entry_units">
9289 </td>
9290
9291 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]9292 <p>Min &lt;= 100e3 (100 us),<wbr/> Max &gt;= 30e9 (30
9293sec)</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9294 </td>
9295
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9296 <td class="entry_tags">
9297 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9298 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9299 </ul>
9300 </td>
9301
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9302 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9303
9304
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9305 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9306 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9307
9308
9309 <tr class="entry" id="static_android.sensor.info.maxFrameDuration">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9310 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9311 android.<wbr/>sensor.<wbr/>info.<wbr/>max<wbr/>Frame<wbr/>Duration
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9312 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9313 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9314 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9315
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9316 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9317
9318
9319 </td> <!-- entry_type -->
9320
9321 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9322 <p>Maximum possible frame duration (minimum frame
9323rate)</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9324 </td>
9325
9326 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9327 nanoseconds
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9328 </td>
9329
9330 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame^]9331 <p>&gt;= 30e9</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9332 </td>
9333
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9334 <td class="entry_tags">
9335 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9336 <li><a href="#tag_BC">BC</a></li>
9337 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9338 </ul>
9339 </td>
9340
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9341 </tr>
9342 <tr class="entries_header">
9343 <th class="th_details" colspan="5">Details</th>
9344 </tr>
9345 <tr class="entry_cont">
9346 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9347 <p>Minimum duration is a function of resolution,<wbr/>
9348processing settings.<wbr/> See
9349android.<wbr/>scaler.<wbr/>available<wbr/>Processed<wbr/>Min<wbr/>Durations
9350android.<wbr/>scaler.<wbr/>available<wbr/>Jpeg<wbr/>Min<wbr/>Durations
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]9351<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]9352 </td>
9353 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9354
9355
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9356 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9357 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9358
9359
9360 <tr class="entry" id="static_android.sensor.info.physicalSize">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9361 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9362 android.<wbr/>sensor.<wbr/>info.<wbr/>physical<wbr/>Size
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9363 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9364 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9365 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9366 <span class="entry_type_container">x</span>
9367
9368 <span class="entry_type_array">
9369 2
9370 </span>
Timothy Knightec817d52013-08-16 16:15:29 -0700[diff] [blame]9371 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9372 <div class="entry_type_notes">width x height in millimeters</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9373
9374
9375 </td> <!-- entry_type -->
9376
9377 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9378 <p>The physical dimensions of the full pixel
9379array</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9380 </td>
9381
9382 <td class="entry_units">
9383 </td>
9384
9385 <td class="entry_range">
9386 </td>
9387
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9388 <td class="entry_tags">
9389 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9390 <li><a href="#tag_V1">V1</a></li>
9391 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9392 </ul>
9393 </td>
9394
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9395 </tr>
9396 <tr class="entries_header">
9397 <th class="th_details" colspan="5">Details</th>
9398 </tr>
9399 <tr class="entry_cont">
9400 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9401 <p>Needed for FOV calculation for old API</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9402 </td>
9403 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9404
9405
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9406 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9407 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9408
9409
9410 <tr class="entry" id="static_android.sensor.info.pixelArraySize">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9411 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9412 android.<wbr/>sensor.<wbr/>info.<wbr/>pixel<wbr/>Array<wbr/>Size
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9413 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9414 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9415 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9416 <span class="entry_type_container">x</span>
9417
9418 <span class="entry_type_array">
9419 2
9420 </span>
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]9421 <span class="entry_type_visibility"> [system as size]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9422
9423
9424 </td> <!-- entry_type -->
9425
9426 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9427 <p>Dimensions of full pixel array,<wbr/> possibly
9428including black calibration pixels</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9429 </td>
9430
9431 <td class="entry_units">
9432 </td>
9433
9434 <td class="entry_range">
9435 </td>
9436
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9437 <td class="entry_tags">
9438 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9439 <li><a href="#tag_DNG">DNG</a></li>
9440 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9441 </ul>
9442 </td>
9443
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9444 </tr>
9445 <tr class="entries_header">
9446 <th class="th_details" colspan="5">Details</th>
9447 </tr>
9448 <tr class="entry_cont">
9449 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9450 <p>Maximum output resolution for raw format must
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9451match this in
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9452android.<wbr/>scaler.<wbr/>info.<wbr/>available<wbr/>Sizes<wbr/>Per<wbr/>Format</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9453 </td>
9454 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9455
9456
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9457 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9458 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9459
9460
9461 <tr class="entry" id="static_android.sensor.info.whiteLevel">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9462 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9463 android.<wbr/>sensor.<wbr/>info.<wbr/>white<wbr/>Level
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9464 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9465 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9466 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9467
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9468 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9469
9470
9471 </td> <!-- entry_type -->
9472
9473 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9474 <p>Maximum raw value output by
9475sensor</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9476 </td>
9477
9478 <td class="entry_units">
9479 </td>
9480
9481 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame^]9482 <p>&gt; 1024 (10-bit output)</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9483 </td>
9484
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9485 <td class="entry_tags">
9486 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9487 <li><a href="#tag_DNG">DNG</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9488 </ul>
9489 </td>
9490
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9491 </tr>
9492 <tr class="entries_header">
9493 <th class="th_details" colspan="5">Details</th>
9494 </tr>
9495 <tr class="entry_cont">
9496 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9497 <p>Defines sensor bit depth (10-14 bits is
9498expected)</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9499 </td>
9500 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9501
9502
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9503 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9504 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9505
9506
9507
9508
9509
9510 <tr class="entry" id="static_android.sensor.baseGainFactor">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9511 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9512 android.<wbr/>sensor.<wbr/>base<wbr/>Gain<wbr/>Factor
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9513 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9514 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9515 <span class="entry_type_name">rational</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9516
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9517 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9518
9519
9520 </td> <!-- entry_type -->
9521
9522 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9523 <p>Gain factor from electrons to raw units when
9524ISO=100</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9525 </td>
9526
9527 <td class="entry_units">
9528 </td>
9529
9530 <td class="entry_range">
9531 </td>
9532
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9533 <td class="entry_tags">
9534 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9535 <li><a href="#tag_V1">V1</a></li>
Alex Rayef40ad62013-10-01 17:52:33 -0700[diff] [blame]9536 <li><a href="#tag_FULL">FULL</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9537 </ul>
9538 </td>
9539
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9540 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9541
9542
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9543 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9544 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9545
9546
9547 <tr class="entry" id="static_android.sensor.blackLevelPattern">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9548 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9549 android.<wbr/>sensor.<wbr/>black<wbr/>Level<wbr/>Pattern
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9550 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9551 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9552 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9553 <span class="entry_type_container">x</span>
9554
9555 <span class="entry_type_array">
9556 4
9557 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9558 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9559 <div class="entry_type_notes">2x2 raw count block</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9560
9561
9562 </td> <!-- entry_type -->
9563
9564 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9565 <p>A fixed black level offset for each of the
9566Bayer mosaic channels</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9567 </td>
9568
9569 <td class="entry_units">
9570 </td>
9571
9572 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame^]9573 <p>&gt;= 0 each</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9574 </td>
9575
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9576 <td class="entry_tags">
9577 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9578 <li><a href="#tag_DNG">DNG</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9579 </ul>
9580 </td>
9581
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9582 </tr>
9583 <tr class="entries_header">
9584 <th class="th_details" colspan="5">Details</th>
9585 </tr>
9586 <tr class="entry_cont">
9587 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9588 <p>As per DNG BlackLevelRepeatDim /<wbr/> BlackLevel
9589tags</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9590 </td>
9591 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9592
9593
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9594 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9595 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9596
9597
9598 <tr class="entry" id="static_android.sensor.calibrationTransform1">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9599 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9600 android.<wbr/>sensor.<wbr/>calibration<wbr/>Transform1
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9601 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9602 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9603 <span class="entry_type_name">rational</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9604 <span class="entry_type_container">x</span>
9605
9606 <span class="entry_type_array">
9607 9
9608 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9609 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9610 <div class="entry_type_notes">3x3 matrix in row-major-order</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9611
9612
9613 </td> <!-- entry_type -->
9614
9615 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9616 <p>Per-device calibration on top of color space
9617transform 1</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9618 </td>
9619
9620 <td class="entry_units">
9621 </td>
9622
9623 <td class="entry_range">
9624 </td>
9625
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9626 <td class="entry_tags">
9627 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9628 <li><a href="#tag_DNG">DNG</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9629 </ul>
9630 </td>
9631
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9632 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9633
9634
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9635 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9636 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9637
9638
9639 <tr class="entry" id="static_android.sensor.calibrationTransform2">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9640 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9641 android.<wbr/>sensor.<wbr/>calibration<wbr/>Transform2
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9642 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9643 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9644 <span class="entry_type_name">rational</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9645 <span class="entry_type_container">x</span>
9646
9647 <span class="entry_type_array">
9648 9
9649 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9650 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9651 <div class="entry_type_notes">3x3 matrix in row-major-order</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9652
9653
9654 </td> <!-- entry_type -->
9655
9656 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9657 <p>Per-device calibration on top of color space
9658transform 2</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9659 </td>
9660
9661 <td class="entry_units">
9662 </td>
9663
9664 <td class="entry_range">
9665 </td>
9666
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9667 <td class="entry_tags">
9668 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9669 <li><a href="#tag_DNG">DNG</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9670 </ul>
9671 </td>
9672
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9673 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9674
9675
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9676 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9677 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9678
9679
9680 <tr class="entry" id="static_android.sensor.colorTransform1">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9681 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9682 android.<wbr/>sensor.<wbr/>color<wbr/>Transform1
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9683 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9684 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9685 <span class="entry_type_name">rational</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9686 <span class="entry_type_container">x</span>
9687
9688 <span class="entry_type_array">
9689 9
9690 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9691 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9692 <div class="entry_type_notes">3x3 matrix in row-major-order</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9693
9694
9695 </td> <!-- entry_type -->
9696
9697 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9698 <p>Linear mapping from XYZ (D50) color space to
9699reference linear sensor color,<wbr/> for first reference
9700illuminant</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9701 </td>
9702
9703 <td class="entry_units">
9704 </td>
9705
9706 <td class="entry_range">
9707 </td>
9708
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9709 <td class="entry_tags">
9710 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9711 <li><a href="#tag_DNG">DNG</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9712 </ul>
9713 </td>
9714
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9715 </tr>
9716 <tr class="entries_header">
9717 <th class="th_details" colspan="5">Details</th>
9718 </tr>
9719 <tr class="entry_cont">
9720 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9721 <p>Use as follows XYZ = inv(transform) * clip( (raw -
9722black level(raw) ) /<wbr/> ( white level - max black level) ).<wbr/>
9723At least in the simple case</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9724 </td>
9725 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9726
9727
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9728 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9729 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9730
9731
9732 <tr class="entry" id="static_android.sensor.colorTransform2">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9733 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9734 android.<wbr/>sensor.<wbr/>color<wbr/>Transform2
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9735 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9736 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9737 <span class="entry_type_name">rational</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9738 <span class="entry_type_container">x</span>
9739
9740 <span class="entry_type_array">
9741 9
9742 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9743 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9744 <div class="entry_type_notes">3x3 matrix in row-major-order</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9745
9746
9747 </td> <!-- entry_type -->
9748
9749 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9750 <p>Linear mapping from XYZ (D50) color space to
9751reference linear sensor color,<wbr/> for second reference
9752illuminant</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9753 </td>
9754
9755 <td class="entry_units">
9756 </td>
9757
9758 <td class="entry_range">
9759 </td>
9760
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9761 <td class="entry_tags">
9762 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9763 <li><a href="#tag_DNG">DNG</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9764 </ul>
9765 </td>
9766
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9767 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9768
9769
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9770 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9771 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9772
9773
9774 <tr class="entry" id="static_android.sensor.forwardMatrix1">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9775 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9776 android.<wbr/>sensor.<wbr/>forward<wbr/>Matrix1
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9777 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9778 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9779 <span class="entry_type_name">rational</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9780 <span class="entry_type_container">x</span>
9781
9782 <span class="entry_type_array">
9783 9
9784 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9785 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9786 <div class="entry_type_notes">3x3 matrix in row-major-order</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9787
9788
9789 </td> <!-- entry_type -->
9790
9791 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9792 <p>Used by DNG for better WB
9793adaptation</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9794 </td>
9795
9796 <td class="entry_units">
9797 </td>
9798
9799 <td class="entry_range">
9800 </td>
9801
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9802 <td class="entry_tags">
9803 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9804 <li><a href="#tag_DNG">DNG</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9805 </ul>
9806 </td>
9807
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9808 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9809
9810
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9811 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9812 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9813
9814
9815 <tr class="entry" id="static_android.sensor.forwardMatrix2">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9816 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9817 android.<wbr/>sensor.<wbr/>forward<wbr/>Matrix2
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9818 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9819 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9820 <span class="entry_type_name">rational</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9821 <span class="entry_type_container">x</span>
9822
9823 <span class="entry_type_array">
9824 9
9825 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9826 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9827 <div class="entry_type_notes">3x3 matrix in row-major-order</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9828
9829
9830 </td> <!-- entry_type -->
9831
9832 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9833 <p>Used by DNG for better WB
9834adaptation</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9835 </td>
9836
9837 <td class="entry_units">
9838 </td>
9839
9840 <td class="entry_range">
9841 </td>
9842
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9843 <td class="entry_tags">
9844 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9845 <li><a href="#tag_DNG">DNG</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9846 </ul>
9847 </td>
9848
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9849 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9850
9851
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9852 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9853 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9854
9855
9856 <tr class="entry" id="static_android.sensor.maxAnalogSensitivity">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9857 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9858 android.<wbr/>sensor.<wbr/>max<wbr/>Analog<wbr/>Sensitivity
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9859 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9860 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9861 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9862
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9863 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9864
9865
9866 </td> <!-- entry_type -->
9867
9868 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9869 <p>Maximum sensitivity that is implemented
9870purely through analog gain</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9871 </td>
9872
9873 <td class="entry_units">
9874 </td>
9875
9876 <td class="entry_range">
9877 </td>
9878
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9879 <td class="entry_tags">
9880 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9881 <li><a href="#tag_V1">V1</a></li>
Alex Rayef40ad62013-10-01 17:52:33 -0700[diff] [blame]9882 <li><a href="#tag_FULL">FULL</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9883 </ul>
9884 </td>
9885
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9886 </tr>
9887 <tr class="entries_header">
9888 <th class="th_details" colspan="5">Details</th>
9889 </tr>
9890 <tr class="entry_cont">
9891 <td class="entry_details" colspan="5">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]9892 <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]9893equal to this,<wbr/> all applied gain must be analog.<wbr/> For
9894values above this,<wbr/> it can be a mix of analog and
9895digital</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9896 </td>
9897 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9898
9899
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9900 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9901 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9902
9903
9904 <tr class="entry" id="static_android.sensor.noiseModelCoefficients">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9905 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9906 android.<wbr/>sensor.<wbr/>noise<wbr/>Model<wbr/>Coefficients
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9907 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9908 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9909 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9910 <span class="entry_type_container">x</span>
9911
9912 <span class="entry_type_array">
9913 2
9914 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9915 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9916 <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]9917
9918
9919 </td> <!-- entry_type -->
9920
9921 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9922 <p>Estimation of sensor noise
9923characteristics</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9924 </td>
9925
9926 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9927 var(raw pixel value) = electrons * (baseGainFactor
9928 * iso/<wbr/>100)^2 + A * (baseGainFactor * iso/<wbr/>100)^2 +
9929 B
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9930 </td>
9931
9932 <td class="entry_range">
9933 </td>
9934
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9935 <td class="entry_tags">
9936 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9937 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9938 </ul>
9939 </td>
9940
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9941 </tr>
9942 <tr class="entries_header">
9943 <th class="th_details" colspan="5">Details</th>
9944 </tr>
9945 <tr class="entry_cont">
9946 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9947 <p>A represents sensor read noise before analog
9948amplification; B represents noise from A/<wbr/>D conversion and
9949other circuits after amplification.<wbr/> Both noise sources
9950are assumed to be gaussian,<wbr/> independent,<wbr/> and not to vary
9951across the sensor</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9952 </td>
9953 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9954
9955
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9956 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9957 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9958
9959
9960 <tr class="entry" id="static_android.sensor.orientation">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9961 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9962 android.<wbr/>sensor.<wbr/>orientation
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9963 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9964 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9965 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9966
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9967 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9968
9969
9970 </td> <!-- entry_type -->
9971
9972 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9973 <p>Clockwise angle through which the output
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]9974image needs to be rotated to be upright on the device
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9975screen in its native orientation.<wbr/> Also defines the
9976direction of rolling shutter readout,<wbr/> which is from top
9977to bottom in the sensor's coordinate system</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9978 </td>
9979
9980 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9981 degrees clockwise rotation,<wbr/> only multiples of
9982 90
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9983 </td>
9984
9985 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]9986 <p>0,<wbr/>90,<wbr/>180,<wbr/>270</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9987 </td>
9988
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9989 <td class="entry_tags">
9990 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9991 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9992 </ul>
9993 </td>
9994
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9995 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9996
9997
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9998 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9999 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10000
10001
10002 <tr class="entry" id="static_android.sensor.referenceIlluminant1">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10003 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10004 android.<wbr/>sensor.<wbr/>reference<wbr/>Illuminant1
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10005 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10006 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10007 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10008
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10009 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10010
10011 <ul class="entry_type_enum">
10012 <li>
10013 <span class="entry_type_enum_name">DAYLIGHT</span>
10014 <span class="entry_type_enum_value">1</span>
10015 </li>
10016 <li>
10017 <span class="entry_type_enum_name">FLUORESCENT</span>
10018 <span class="entry_type_enum_value">2</span>
10019 </li>
10020 <li>
10021 <span class="entry_type_enum_name">TUNGSTEN</span>
10022 <span class="entry_type_enum_value">3</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10023 <span class="entry_type_enum_notes">Incandescent light</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10024 </li>
10025 <li>
10026 <span class="entry_type_enum_name">FLASH</span>
10027 <span class="entry_type_enum_value">4</span>
10028 </li>
10029 <li>
10030 <span class="entry_type_enum_name">FINE_WEATHER</span>
10031 <span class="entry_type_enum_value">9</span>
10032 </li>
10033 <li>
10034 <span class="entry_type_enum_name">CLOUDY_WEATHER</span>
10035 <span class="entry_type_enum_value">10</span>
10036 </li>
10037 <li>
10038 <span class="entry_type_enum_name">SHADE</span>
10039 <span class="entry_type_enum_value">11</span>
10040 </li>
10041 <li>
10042 <span class="entry_type_enum_name">DAYLIGHT_FLUORESCENT</span>
10043 <span class="entry_type_enum_value">12</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10044 <span class="entry_type_enum_notes">D 5700 - 7100K</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10045 </li>
10046 <li>
10047 <span class="entry_type_enum_name">DAY_WHITE_FLUORESCENT</span>
10048 <span class="entry_type_enum_value">13</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10049 <span class="entry_type_enum_notes">N 4600 - 5400K</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10050 </li>
10051 <li>
10052 <span class="entry_type_enum_name">COOL_WHITE_FLUORESCENT</span>
10053 <span class="entry_type_enum_value">14</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10054 <span class="entry_type_enum_notes">W 3900 - 4500K</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10055 </li>
10056 <li>
10057 <span class="entry_type_enum_name">WHITE_FLUORESCENT</span>
10058 <span class="entry_type_enum_value">15</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10059 <span class="entry_type_enum_notes">WW 3200 - 3700K</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10060 </li>
10061 <li>
10062 <span class="entry_type_enum_name">STANDARD_A</span>
10063 <span class="entry_type_enum_value">17</span>
10064 </li>
10065 <li>
10066 <span class="entry_type_enum_name">STANDARD_B</span>
10067 <span class="entry_type_enum_value">18</span>
10068 </li>
10069 <li>
10070 <span class="entry_type_enum_name">STANDARD_C</span>
10071 <span class="entry_type_enum_value">19</span>
10072 </li>
10073 <li>
10074 <span class="entry_type_enum_name">D55</span>
10075 <span class="entry_type_enum_value">20</span>
10076 </li>
10077 <li>
10078 <span class="entry_type_enum_name">D65</span>
10079 <span class="entry_type_enum_value">21</span>
10080 </li>
10081 <li>
10082 <span class="entry_type_enum_name">D75</span>
10083 <span class="entry_type_enum_value">22</span>
10084 </li>
10085 <li>
10086 <span class="entry_type_enum_name">D50</span>
10087 <span class="entry_type_enum_value">23</span>
10088 </li>
10089 <li>
10090 <span class="entry_type_enum_name">ISO_STUDIO_TUNGSTEN</span>
10091 <span class="entry_type_enum_value">24</span>
10092 </li>
10093 </ul>
10094
10095 </td> <!-- entry_type -->
10096
10097 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10098 <p>Light source used to define transform
100991</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10100 </td>
10101
10102 <td class="entry_units">
10103 </td>
10104
10105 <td class="entry_range">
10106 </td>
10107
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10108 <td class="entry_tags">
10109 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]10110 <li><a href="#tag_DNG">DNG</a></li>
10111 <li><a href="#tag_EXIF">EXIF</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10112 </ul>
10113 </td>
10114
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10115 </tr>
10116 <tr class="entries_header">
10117 <th class="th_details" colspan="5">Details</th>
10118 </tr>
10119 <tr class="entry_cont">
10120 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10121 <p>[EXIF LightSource tag] Must all these be
10122supported? Need CCT for each!</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10123 </td>
10124 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10125
10126
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10127 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10128 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10129
10130
10131 <tr class="entry" id="static_android.sensor.referenceIlluminant2">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10132 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10133 android.<wbr/>sensor.<wbr/>reference<wbr/>Illuminant2
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10134 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10135 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10136 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10137
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10138 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10139
10140
10141 </td> <!-- entry_type -->
10142
10143 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10144 <p>Light source used to define transform
101452</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10146 </td>
10147
10148 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10149 Same as illuminant 1
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10150 </td>
10151
10152 <td class="entry_range">
10153 </td>
10154
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10155 <td class="entry_tags">
10156 </td>
10157
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10158 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10159
10160
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10161 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10162 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10163
10164
10165
10166 <!-- end of kind -->
10167 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10168 <tr><td colspan="6" class="kind">dynamic</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10169
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10170 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10171 <tr>
10172 <th class="th_name">Property Name</th>
10173 <th class="th_type">Type</th>
10174 <th class="th_description">Description</th>
10175 <th class="th_units">Units</th>
10176 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10177 <th class="th_tags">Tags</th>
10178 </tr>
10179 </thead>
10180
10181 <tbody>
10182
10183
10184
10185
10186
10187
10188
10189
10190
10191
10192 <tr class="entry" id="dynamic_android.sensor.exposureTime">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10193 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10194 android.<wbr/>sensor.<wbr/>exposure<wbr/>Time
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10195 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10196 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10197 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10198
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10199 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10200
10201
10202 </td> <!-- entry_type -->
10203
10204 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10205 <p>Duration each pixel is exposed to
10206light.<wbr/></p>
10207<p>If the sensor can't expose this exact duration,<wbr/> it should shorten the
10208duration exposed to the nearest possible value (rather than expose longer).<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10209 </td>
10210
10211 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10212 nanoseconds
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10213 </td>
10214
10215 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]10216 <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]10217 </td>
10218
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10219 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]10220 <ul class="entry_tags">
10221 <li><a href="#tag_V1">V1</a></li>
10222 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10223 </td>
10224
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10225 </tr>
10226 <tr class="entries_header">
10227 <th class="th_details" colspan="5">Details</th>
10228 </tr>
10229 <tr class="entry_cont">
10230 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10231 <p>1/<wbr/>10000 - 30 sec range.<wbr/> No bulb mode</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10232 </td>
10233 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10234
10235
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10236 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10237 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10238
10239
10240 <tr class="entry" id="dynamic_android.sensor.frameDuration">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10241 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10242 android.<wbr/>sensor.<wbr/>frame<wbr/>Duration
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10243 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10244 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10245 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10246
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10247 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10248
10249
10250 </td> <!-- entry_type -->
10251
10252 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10253 <p>Duration from start of frame exposure to
10254start of next frame exposure</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10255 </td>
10256
10257 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10258 nanoseconds
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10259 </td>
10260
10261 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]10262 <p>see <a href="#static_android.sensor.info.maxFrameDuration">android.<wbr/>sensor.<wbr/>info.<wbr/>max<wbr/>Frame<wbr/>Duration</a>,<wbr/>
10263android.<wbr/>scaler.<wbr/>info.<wbr/>available<wbr/>Min<wbr/>Frame<wbr/>Durations</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10264 </td>
10265
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10266 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]10267 <ul class="entry_tags">
10268 <li><a href="#tag_V1">V1</a></li>
10269 <li><a href="#tag_BC">BC</a></li>
10270 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10271 </td>
10272
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10273 </tr>
10274 <tr class="entries_header">
10275 <th class="th_details" colspan="5">Details</th>
10276 </tr>
10277 <tr class="entry_cont">
10278 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10279 <p>Exposure time has priority,<wbr/> so duration is set to
10280max(duration,<wbr/> exposure time + overhead)</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10281 </td>
10282 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10283
10284
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10285 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10286 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10287
10288
10289 <tr class="entry" id="dynamic_android.sensor.sensitivity">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10290 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10291 android.<wbr/>sensor.<wbr/>sensitivity
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10292 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10293 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10294 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10295
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10296 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10297
10298
10299 </td> <!-- entry_type -->
10300
10301 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10302 <p>Gain applied to image data.<wbr/> Must be
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]10303implemented through analog gain only if set to values
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10304below 'maximum analog sensitivity'.<wbr/></p>
10305<p>If the sensor can't apply this exact gain,<wbr/> it should lessen the
10306gain to the nearest possible value (rather than gain more).<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10307 </td>
10308
10309 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10310 ISO arithmetic units
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10311 </td>
10312
10313 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]10314 <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]10315 </td>
10316
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10317 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]10318 <ul class="entry_tags">
10319 <li><a href="#tag_V1">V1</a></li>
10320 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10321 </td>
10322
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10323 </tr>
10324 <tr class="entries_header">
10325 <th class="th_details" colspan="5">Details</th>
10326 </tr>
10327 <tr class="entry_cont">
10328 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10329 <p>ISO 12232:2006 REI method</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10330 </td>
10331 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10332
10333
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10334 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10335 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10336
10337
10338 <tr class="entry" id="dynamic_android.sensor.timestamp">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10339 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10340 android.<wbr/>sensor.<wbr/>timestamp
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10341 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10342 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10343 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10344
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10345 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10346
10347
10348 </td> <!-- entry_type -->
10349
10350 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10351 <p>Time at start of exposure of first
10352row</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10353 </td>
10354
10355 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10356 nanoseconds
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10357 </td>
10358
10359 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame^]10360 <p>&gt; 0</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10361 </td>
10362
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10363 <td class="entry_tags">
10364 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]10365 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10366 </ul>
10367 </td>
10368
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10369 </tr>
10370 <tr class="entries_header">
10371 <th class="th_details" colspan="5">Details</th>
10372 </tr>
10373 <tr class="entry_cont">
10374 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10375 <p>Monotonic,<wbr/> should be synced to other timestamps in
10376system</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10377 </td>
10378 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10379
10380
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10381 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10382 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10383
Igor Murashkin656aa5a2013-08-13 14:23:39 -0700[diff] [blame]10384
10385 <tr class="entry" id="dynamic_android.sensor.temperature">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10386 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10387 android.<wbr/>sensor.<wbr/>temperature
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10388 </td>
Igor Murashkin656aa5a2013-08-13 14:23:39 -0700[diff] [blame]10389 <td class="entry_type">
10390 <span class="entry_type_name">float</span>
10391
10392 <span class="entry_type_visibility"> [public]</span>
10393
10394
10395 </td> <!-- entry_type -->
10396
10397 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10398 <p>The temperature of the sensor,<wbr/> sampled at the time
10399exposure began for this frame.<wbr/></p>
10400<p>The thermal diode being queried should be inside the sensor PCB,<wbr/> or
10401somewhere close to it.<wbr/></p>
Igor Murashkin656aa5a2013-08-13 14:23:39 -0700[diff] [blame]10402 </td>
10403
10404 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10405 celsius
Igor Murashkin656aa5a2013-08-13 14:23:39 -0700[diff] [blame]10406 </td>
10407
10408 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]10409 <p>Optional.<wbr/> This value is missing if no temperature is available.<wbr/></p>
Igor Murashkin656aa5a2013-08-13 14:23:39 -0700[diff] [blame]10410 </td>
10411
Igor Murashkin656aa5a2013-08-13 14:23:39 -0700[diff] [blame]10412 <td class="entry_tags">
Alex Rayef40ad62013-10-01 17:52:33 -0700[diff] [blame]10413 <ul class="entry_tags">
10414 <li><a href="#tag_FULL">FULL</a></li>
10415 </ul>
Igor Murashkin656aa5a2013-08-13 14:23:39 -0700[diff] [blame]10416 </td>
10417
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10418 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10419
10420
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10421 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10422 <!-- end of entry -->
Igor Murashkin656aa5a2013-08-13 14:23:39 -0700[diff] [blame]10423
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10424
10425
10426 <!-- end of kind -->
10427 </tbody>
10428
10429 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10430 <tr><td colspan="6" id="section_shading" class="section">shading</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10431
10432
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10433 <tr><td colspan="6" class="kind">controls</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10434
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10435 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10436 <tr>
10437 <th class="th_name">Property Name</th>
10438 <th class="th_type">Type</th>
10439 <th class="th_description">Description</th>
10440 <th class="th_units">Units</th>
10441 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10442 <th class="th_tags">Tags</th>
10443 </tr>
10444 </thead>
10445
10446 <tbody>
10447
10448
10449
10450
10451
10452
10453
10454
10455
10456
10457 <tr class="entry" id="controls_android.shading.mode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10458 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10459 android.<wbr/>shading.<wbr/>mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10460 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10461 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10462 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10463
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10464 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10465
10466 <ul class="entry_type_enum">
10467 <li>
10468 <span class="entry_type_enum_name">OFF</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10469 <span class="entry_type_enum_notes">No shading correction is applied</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10470 </li>
10471 <li>
10472 <span class="entry_type_enum_name">FAST</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10473 <span class="entry_type_enum_notes">Must not slow down frame rate relative to raw
10474 bayer output</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10475 </li>
10476 <li>
10477 <span class="entry_type_enum_name">HIGH_QUALITY</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10478 <span class="entry_type_enum_notes">Frame rate may be reduced by high
10479 quality</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10480 </li>
10481 </ul>
10482
10483 </td> <!-- entry_type -->
10484
10485 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10486 <p>Quality of lens shading correction applied
10487to the image data</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10488 </td>
10489
10490 <td class="entry_units">
10491 </td>
10492
10493 <td class="entry_range">
10494 </td>
10495
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10496 <td class="entry_tags">
10497 </td>
10498
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10499 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10500
10501
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10502 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10503 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10504
10505
10506 <tr class="entry" id="controls_android.shading.strength">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10507 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10508 android.<wbr/>shading.<wbr/>strength
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10509 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10510 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10511 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10512
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10513 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10514
10515
10516 </td> <!-- entry_type -->
10517
10518 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10519 <p>Control the amount of shading correction
10520applied to the images</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10521 </td>
10522
10523 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10524 unitless: 1-10; 10 is full shading
10525 compensation
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10526 </td>
10527
10528 <td class="entry_range">
10529 </td>
10530
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10531 <td class="entry_tags">
10532 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]10533 <li><a href="#tag_ADV">ADV</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10534 </ul>
10535 </td>
10536
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10537 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10538
10539
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10540 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10541 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10542
10543
10544
10545 <!-- end of kind -->
10546 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10547 <tr><td colspan="6" class="kind">dynamic</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10548
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10549 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10550 <tr>
10551 <th class="th_name">Property Name</th>
10552 <th class="th_type">Type</th>
10553 <th class="th_description">Description</th>
10554 <th class="th_units">Units</th>
10555 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10556 <th class="th_tags">Tags</th>
10557 </tr>
10558 </thead>
10559
10560 <tbody>
10561
10562
10563
10564
10565
10566
10567
10568
10569
10570
10571 <tr class="entry" id="dynamic_android.shading.mode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10572 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10573 android.<wbr/>shading.<wbr/>mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10574 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10575 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10576 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10577
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10578 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10579
10580 <ul class="entry_type_enum">
10581 <li>
10582 <span class="entry_type_enum_name">OFF</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10583 <span class="entry_type_enum_notes">No shading correction is applied</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10584 </li>
10585 <li>
10586 <span class="entry_type_enum_name">FAST</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10587 <span class="entry_type_enum_notes">Must not slow down frame rate relative to raw
10588 bayer output</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10589 </li>
10590 <li>
10591 <span class="entry_type_enum_name">HIGH_QUALITY</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10592 <span class="entry_type_enum_notes">Frame rate may be reduced by high
10593 quality</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10594 </li>
10595 </ul>
10596
10597 </td> <!-- entry_type -->
10598
10599 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10600 <p>Quality of lens shading correction applied
10601to the image data</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10602 </td>
10603
10604 <td class="entry_units">
10605 </td>
10606
10607 <td class="entry_range">
10608 </td>
10609
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10610 <td class="entry_tags">
10611 </td>
10612
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10613 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10614
10615
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10616 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10617 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10618
10619
10620
10621 <!-- end of kind -->
10622 </tbody>
10623
10624 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10625 <tr><td colspan="6" id="section_statistics" class="section">statistics</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10626
10627
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10628 <tr><td colspan="6" class="kind">controls</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10629
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10630 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10631 <tr>
10632 <th class="th_name">Property Name</th>
10633 <th class="th_type">Type</th>
10634 <th class="th_description">Description</th>
10635 <th class="th_units">Units</th>
10636 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10637 <th class="th_tags">Tags</th>
10638 </tr>
10639 </thead>
10640
10641 <tbody>
10642
10643
10644
10645
10646
10647
10648
10649
10650
10651
10652 <tr class="entry" id="controls_android.statistics.faceDetectMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10653 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10654 android.<wbr/>statistics.<wbr/>face<wbr/>Detect<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10655 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10656 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10657 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10658
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10659 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10660
10661 <ul class="entry_type_enum">
10662 <li>
10663 <span class="entry_type_enum_name">OFF</span>
10664 </li>
10665 <li>
10666 <span class="entry_type_enum_name">SIMPLE</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10667 <span class="entry_type_enum_notes">Optional Return rectangle and confidence
10668 only</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10669 </li>
10670 <li>
10671 <span class="entry_type_enum_name">FULL</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10672 <span class="entry_type_enum_notes">Optional Return all face
10673 metadata</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10674 </li>
10675 </ul>
10676
10677 </td> <!-- entry_type -->
10678
10679 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10680 <p>State of the face detector
10681unit</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10682 </td>
10683
10684 <td class="entry_units">
10685 </td>
10686
10687 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]10688 <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]10689 </td>
10690
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10691 <td class="entry_tags">
10692 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]10693 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10694 </ul>
10695 </td>
10696
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10697 </tr>
10698 <tr class="entries_header">
10699 <th class="th_details" colspan="5">Details</th>
10700 </tr>
10701 <tr class="entry_cont">
10702 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10703 <p>Whether face detection is enabled,<wbr/> and whether it
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10704should output just the basic fields or the full set of
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10705fields.<wbr/> Value must be one of the
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]10706<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]10707 </td>
10708 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10709
10710
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10711 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10712 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10713
10714
10715 <tr class="entry" id="controls_android.statistics.histogramMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10716 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10717 android.<wbr/>statistics.<wbr/>histogram<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10718 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10719 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10720 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10721
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]10722 <span class="entry_type_visibility"> [system as boolean]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10723
10724 <ul class="entry_type_enum">
10725 <li>
10726 <span class="entry_type_enum_name">OFF</span>
10727 </li>
10728 <li>
10729 <span class="entry_type_enum_name">ON</span>
10730 </li>
10731 </ul>
10732
10733 </td> <!-- entry_type -->
10734
10735 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10736 <p>Operating mode for histogram
10737generation</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10738 </td>
10739
10740 <td class="entry_units">
10741 </td>
10742
10743 <td class="entry_range">
10744 </td>
10745
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10746 <td class="entry_tags">
10747 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]10748 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10749 </ul>
10750 </td>
10751
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10752 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10753
10754
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10755 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10756 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10757
10758
10759 <tr class="entry" id="controls_android.statistics.sharpnessMapMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10760 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10761 android.<wbr/>statistics.<wbr/>sharpness<wbr/>Map<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10762 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10763 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10764 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10765
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]10766 <span class="entry_type_visibility"> [system as boolean]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10767
10768 <ul class="entry_type_enum">
10769 <li>
10770 <span class="entry_type_enum_name">OFF</span>
10771 </li>
10772 <li>
10773 <span class="entry_type_enum_name">ON</span>
10774 </li>
10775 </ul>
10776
10777 </td> <!-- entry_type -->
10778
10779 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10780 <p>Operating mode for sharpness map
10781generation</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10782 </td>
10783
10784 <td class="entry_units">
10785 </td>
10786
10787 <td class="entry_range">
10788 </td>
10789
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10790 <td class="entry_tags">
10791 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]10792 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10793 </ul>
10794 </td>
10795
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10796 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10797
10798
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10799 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10800 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10801
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]10802
10803 <tr class="entry" id="controls_android.statistics.lensShadingMapMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10804 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10805 android.<wbr/>statistics.<wbr/>lens<wbr/>Shading<wbr/>Map<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10806 </td>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]10807 <td class="entry_type">
10808 <span class="entry_type_name entry_type_name_enum">byte</span>
10809
10810 <span class="entry_type_visibility"> [public]</span>
10811
10812 <ul class="entry_type_enum">
10813 <li>
10814 <span class="entry_type_enum_name">OFF</span>
10815 </li>
10816 <li>
10817 <span class="entry_type_enum_name">ON</span>
10818 </li>
10819 </ul>
10820
10821 </td> <!-- entry_type -->
10822
10823 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10824 <p>Whether the HAL needs to output the lens
10825shading map in output result metadata</p>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]10826 </td>
10827
10828 <td class="entry_units">
10829 </td>
10830
10831 <td class="entry_range">
10832 </td>
10833
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10834 <td class="entry_tags">
10835 </td>
10836
10837 </tr>
10838 <tr class="entries_header">
10839 <th class="th_details" colspan="5">Details</th>
10840 </tr>
10841 <tr class="entry_cont">
10842 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10843 <p>When set to ON,<wbr/>
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]10844<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]10845the output result metadata.<wbr/></p>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]10846 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10847 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10848
10849
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10850 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10851 <!-- end of entry -->
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]10852
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10853
10854
10855 <!-- end of kind -->
10856 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10857 <tr><td colspan="6" class="kind">static</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10858
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10859 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10860 <tr>
10861 <th class="th_name">Property Name</th>
10862 <th class="th_type">Type</th>
10863 <th class="th_description">Description</th>
10864 <th class="th_units">Units</th>
10865 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10866 <th class="th_tags">Tags</th>
10867 </tr>
10868 </thead>
10869
10870 <tbody>
10871
10872
10873
10874
10875
10876
10877
10878
10879
10880
10881
10882
10883 <tr class="entry" id="static_android.statistics.info.availableFaceDetectModes">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10884 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10885 android.<wbr/>statistics.<wbr/>info.<wbr/>available<wbr/>Face<wbr/>Detect<wbr/>Modes
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10886 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10887 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10888 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10889 <span class="entry_type_container">x</span>
10890
10891 <span class="entry_type_array">
10892 n
10893 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10894 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10895 <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]10896
10897
10898 </td> <!-- entry_type -->
10899
10900 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10901 <p>Which face detection modes are available,<wbr/>
10902if any</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10903 </td>
10904
10905 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10906 List of enum:
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]10907 OFF
10908 SIMPLE
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10909 FULL
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10910 </td>
10911
10912 <td class="entry_range">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10913 </td>
10914
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10915 <td class="entry_tags">
10916 </td>
10917
10918 </tr>
10919 <tr class="entries_header">
10920 <th class="th_details" colspan="5">Details</th>
10921 </tr>
10922 <tr class="entry_cont">
10923 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10924 <p>OFF means face detection is disabled,<wbr/> it must
10925be included in the list.<wbr/></p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]10926<p>SIMPLE means the device supports the
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]10927<a href="#dynamic_android.statistics.faceRectangles">android.<wbr/>statistics.<wbr/>face<wbr/>Rectangles</a> and
10928<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]10929<p>FULL means the device additionally supports the
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]10930<a href="#dynamic_android.statistics.faceIds">android.<wbr/>statistics.<wbr/>face<wbr/>Ids</a> and
10931<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]10932 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10933 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10934
10935
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10936 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10937 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10938
10939
10940 <tr class="entry" id="static_android.statistics.info.histogramBucketCount">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10941 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10942 android.<wbr/>statistics.<wbr/>info.<wbr/>histogram<wbr/>Bucket<wbr/>Count
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10943 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10944 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10945 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10946
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10947 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10948
10949
10950 </td> <!-- entry_type -->
10951
10952 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10953 <p>Number of histogram buckets
10954supported</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10955 </td>
10956
10957 <td class="entry_units">
10958 </td>
10959
10960 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame^]10961 <p>&gt;= 64</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10962 </td>
10963
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10964 <td class="entry_tags">
10965 </td>
10966
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10967 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10968
10969
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10970 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10971 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10972
10973
10974 <tr class="entry" id="static_android.statistics.info.maxFaceCount">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10975 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10976 android.<wbr/>statistics.<wbr/>info.<wbr/>max<wbr/>Face<wbr/>Count
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10977 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10978 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10979 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10980
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10981 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10982
10983
10984 </td> <!-- entry_type -->
10985
10986 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10987 <p>Maximum number of simultaneously detectable
10988faces</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10989 </td>
10990
10991 <td class="entry_units">
10992 </td>
10993
10994 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame^]10995 <p>&gt;= 4 if availableFaceDetectionModes lists
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]10996modes besides OFF,<wbr/> otherwise 0</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10997 </td>
10998
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10999 <td class="entry_tags">
11000 </td>
11001
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11002 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11003
11004
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11005 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11006 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11007
11008
11009 <tr class="entry" id="static_android.statistics.info.maxHistogramCount">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11010 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11011 android.<wbr/>statistics.<wbr/>info.<wbr/>max<wbr/>Histogram<wbr/>Count
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11012 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11013 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]11014 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11015
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]11016 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11017
11018
11019 </td> <!-- entry_type -->
11020
11021 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11022 <p>Maximum value possible for a histogram
11023bucket</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11024 </td>
11025
11026 <td class="entry_units">
11027 </td>
11028
11029 <td class="entry_range">
11030 </td>
11031
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11032 <td class="entry_tags">
11033 </td>
11034
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11035 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11036
11037
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11038 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11039 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11040
11041
11042 <tr class="entry" id="static_android.statistics.info.maxSharpnessMapValue">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11043 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11044 android.<wbr/>statistics.<wbr/>info.<wbr/>max<wbr/>Sharpness<wbr/>Map<wbr/>Value
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11045 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11046 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]11047 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11048
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]11049 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11050
11051
11052 </td> <!-- entry_type -->
11053
11054 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11055 <p>Maximum value possible for a sharpness map
11056region.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11057 </td>
11058
11059 <td class="entry_units">
11060 </td>
11061
11062 <td class="entry_range">
11063 </td>
11064
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11065 <td class="entry_tags">
11066 </td>
11067
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11068 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11069
11070
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11071 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11072 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11073
11074
11075 <tr class="entry" id="static_android.statistics.info.sharpnessMapSize">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11076 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11077 android.<wbr/>statistics.<wbr/>info.<wbr/>sharpness<wbr/>Map<wbr/>Size
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11078 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11079 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]11080 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11081 <span class="entry_type_container">x</span>
11082
11083 <span class="entry_type_array">
11084 2
11085 </span>
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]11086 <span class="entry_type_visibility"> [system as size]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11087 <div class="entry_type_notes">width x height</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11088
11089
11090 </td> <!-- entry_type -->
11091
11092 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11093 <p>Dimensions of the sharpness
11094map</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11095 </td>
11096
11097 <td class="entry_units">
11098 </td>
11099
11100 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]11101 <p>Must be at least 32 x 32</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11102 </td>
11103
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11104 <td class="entry_tags">
11105 </td>
11106
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11107 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11108
11109
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11110 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11111 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11112
11113
11114
11115
11116
11117
11118 <!-- end of kind -->
11119 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11120 <tr><td colspan="6" class="kind">dynamic</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11121
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]11122 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11123 <tr>
11124 <th class="th_name">Property Name</th>
11125 <th class="th_type">Type</th>
11126 <th class="th_description">Description</th>
11127 <th class="th_units">Units</th>
11128 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11129 <th class="th_tags">Tags</th>
11130 </tr>
11131 </thead>
11132
11133 <tbody>
11134
11135
11136
11137
11138
11139
11140
11141
11142
11143
11144 <tr class="entry" id="dynamic_android.statistics.faceDetectMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11145 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11146 android.<wbr/>statistics.<wbr/>face<wbr/>Detect<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11147 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11148 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]11149 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11150
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]11151 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11152
11153 <ul class="entry_type_enum">
11154 <li>
11155 <span class="entry_type_enum_name">OFF</span>
11156 </li>
11157 <li>
11158 <span class="entry_type_enum_name">SIMPLE</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11159 <span class="entry_type_enum_notes">Optional Return rectangle and confidence
11160 only</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11161 </li>
11162 <li>
11163 <span class="entry_type_enum_name">FULL</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11164 <span class="entry_type_enum_notes">Optional Return all face
11165 metadata</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11166 </li>
11167 </ul>
11168
11169 </td> <!-- entry_type -->
11170
11171 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11172 <p>State of the face detector
11173unit</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11174 </td>
11175
11176 <td class="entry_units">
11177 </td>
11178
11179 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]11180 <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]11181 </td>
11182
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11183 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]11184 <ul class="entry_tags">
11185 <li><a href="#tag_BC">BC</a></li>
11186 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11187 </td>
11188
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11189 </tr>
11190 <tr class="entries_header">
11191 <th class="th_details" colspan="5">Details</th>
11192 </tr>
11193 <tr class="entry_cont">
11194 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11195 <p>Whether face detection is enabled,<wbr/> and whether it
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11196should output just the basic fields or the full set of
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11197fields.<wbr/> Value must be one of the
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]11198<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]11199 </td>
11200 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11201
11202
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11203 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11204 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11205
11206
11207 <tr class="entry" id="dynamic_android.statistics.faceIds">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11208 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11209 android.<wbr/>statistics.<wbr/>face<wbr/>Ids
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11210 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11211 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]11212 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11213 <span class="entry_type_container">x</span>
11214
11215 <span class="entry_type_array">
11216 n
11217 </span>
Zhijun He3b4c2062013-10-07 11:23:30 -0700[diff] [blame]11218 <span class="entry_type_visibility"> [hidden]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11219
11220
11221 </td> <!-- entry_type -->
11222
11223 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11224 <p>List of unique IDs for detected
11225faces</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11226 </td>
11227
11228 <td class="entry_units">
11229 </td>
11230
11231 <td class="entry_range">
11232 </td>
11233
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11234 <td class="entry_tags">
11235 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]11236 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11237 </ul>
11238 </td>
11239
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11240 </tr>
11241 <tr class="entries_header">
11242 <th class="th_details" colspan="5">Details</th>
11243 </tr>
11244 <tr class="entry_cont">
11245 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11246 <p>Only available if faceDetectMode == FULL</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11247 </td>
11248 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11249
11250
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11251 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11252 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11253
11254
11255 <tr class="entry" id="dynamic_android.statistics.faceLandmarks">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11256 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11257 android.<wbr/>statistics.<wbr/>face<wbr/>Landmarks
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11258 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11259 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]11260 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11261 <span class="entry_type_container">x</span>
11262
11263 <span class="entry_type_array">
11264 n x 6
11265 </span>
Zhijun He3b4c2062013-10-07 11:23:30 -0700[diff] [blame]11266 <span class="entry_type_visibility"> [hidden]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11267 <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]11268
11269
11270 </td> <!-- entry_type -->
11271
11272 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11273 <p>List of landmarks for detected
11274faces</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11275 </td>
11276
11277 <td class="entry_units">
11278 </td>
11279
11280 <td class="entry_range">
11281 </td>
11282
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11283 <td class="entry_tags">
11284 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]11285 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11286 </ul>
11287 </td>
11288
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11289 </tr>
11290 <tr class="entries_header">
11291 <th class="th_details" colspan="5">Details</th>
11292 </tr>
11293 <tr class="entry_cont">
11294 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11295 <p>Only available if faceDetectMode == FULL</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11296 </td>
11297 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11298
11299
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11300 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11301 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11302
11303
11304 <tr class="entry" id="dynamic_android.statistics.faceRectangles">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11305 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11306 android.<wbr/>statistics.<wbr/>face<wbr/>Rectangles
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11307 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11308 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]11309 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11310 <span class="entry_type_container">x</span>
11311
11312 <span class="entry_type_array">
11313 n x 4
11314 </span>
Zhijun He3b4c2062013-10-07 11:23:30 -0700[diff] [blame]11315 <span class="entry_type_visibility"> [hidden as rectangle]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11316 <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]11317
11318
11319 </td> <!-- entry_type -->
11320
11321 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11322 <p>List of the bounding rectangles for detected
11323faces</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 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]11334 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11335 </ul>
11336 </td>
11337
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11338 </tr>
11339 <tr class="entries_header">
11340 <th class="th_details" colspan="5">Details</th>
11341 </tr>
11342 <tr class="entry_cont">
11343 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11344 <p>Only available if faceDetectMode != OFF</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11345 </td>
11346 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11347
11348
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11349 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11350 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11351
11352
11353 <tr class="entry" id="dynamic_android.statistics.faceScores">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11354 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11355 android.<wbr/>statistics.<wbr/>face<wbr/>Scores
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11356 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11357 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]11358 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11359 <span class="entry_type_container">x</span>
11360
11361 <span class="entry_type_array">
11362 n
11363 </span>
Zhijun He3b4c2062013-10-07 11:23:30 -0700[diff] [blame]11364 <span class="entry_type_visibility"> [hidden]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11365
11366
11367 </td> <!-- entry_type -->
11368
11369 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11370 <p>List of the face confidence scores for
11371detected faces</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11372 </td>
11373
11374 <td class="entry_units">
11375 </td>
11376
11377 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]11378 <p>1-100</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11379 </td>
11380
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11381 <td class="entry_tags">
11382 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]11383 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11384 </ul>
11385 </td>
11386
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11387 </tr>
11388 <tr class="entries_header">
11389 <th class="th_details" colspan="5">Details</th>
11390 </tr>
11391 <tr class="entry_cont">
11392 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11393 <p>Only available if faceDetectMode != OFF.<wbr/> The value should be
11394meaningful (for example,<wbr/> setting 100 at all times is illegal).<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11395 </td>
11396 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11397
11398
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11399 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11400 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11401
11402
11403 <tr class="entry" id="dynamic_android.statistics.histogram">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11404 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11405 android.<wbr/>statistics.<wbr/>histogram
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11406 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11407 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]11408 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11409 <span class="entry_type_container">x</span>
11410
11411 <span class="entry_type_array">
11412 n x 3
11413 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]11414 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11415 <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]11416
11417
11418 </td> <!-- entry_type -->
11419
11420 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11421 <p>A 3-channel histogram based on the raw
11422sensor data</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11423 </td>
11424
11425 <td class="entry_units">
11426 </td>
11427
11428 <td class="entry_range">
11429 </td>
11430
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11431 <td class="entry_tags">
11432 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]11433 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11434 </ul>
11435 </td>
11436
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11437 </tr>
11438 <tr class="entries_header">
11439 <th class="th_details" colspan="5">Details</th>
11440 </tr>
11441 <tr class="entry_cont">
11442 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11443 <p>The k'th bucket (0-based) covers the input range
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]11444(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]11445(k + 1) * w /<wbr/> N ).<wbr/> If only a monochrome sharpness map is
11446supported,<wbr/> all channels should have the same data</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11447 </td>
11448 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11449
11450
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11451 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11452 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11453
11454
11455 <tr class="entry" id="dynamic_android.statistics.histogramMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11456 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11457 android.<wbr/>statistics.<wbr/>histogram<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11458 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11459 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]11460 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11461
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]11462 <span class="entry_type_visibility"> [system as boolean]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11463
11464 <ul class="entry_type_enum">
11465 <li>
11466 <span class="entry_type_enum_name">OFF</span>
11467 </li>
11468 <li>
11469 <span class="entry_type_enum_name">ON</span>
11470 </li>
11471 </ul>
11472
11473 </td> <!-- entry_type -->
11474
11475 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11476 <p>Operating mode for histogram
11477generation</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11478 </td>
11479
11480 <td class="entry_units">
11481 </td>
11482
11483 <td class="entry_range">
11484 </td>
11485
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11486 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]11487 <ul class="entry_tags">
11488 <li><a href="#tag_V1">V1</a></li>
11489 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11490 </td>
11491
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11492 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11493
11494
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11495 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11496 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11497
11498
11499 <tr class="entry" id="dynamic_android.statistics.sharpnessMap">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11500 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11501 android.<wbr/>statistics.<wbr/>sharpness<wbr/>Map
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11502 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11503 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]11504 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11505 <span class="entry_type_container">x</span>
11506
11507 <span class="entry_type_array">
11508 n x m x 3
11509 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]11510 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11511 <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]11512
11513
11514 </td> <!-- entry_type -->
11515
11516 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11517 <p>A 3-channel sharpness map,<wbr/> based on the raw
11518sensor data</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11519 </td>
11520
11521 <td class="entry_units">
11522 </td>
11523
11524 <td class="entry_range">
11525 </td>
11526
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11527 <td class="entry_tags">
11528 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]11529 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11530 </ul>
11531 </td>
11532
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11533 </tr>
11534 <tr class="entries_header">
11535 <th class="th_details" colspan="5">Details</th>
11536 </tr>
11537 <tr class="entry_cont">
11538 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11539 <p>If only a monochrome sharpness map is supported,<wbr/>
11540all channels should have the same data</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11541 </td>
11542 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11543
11544
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11545 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11546 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11547
11548
11549 <tr class="entry" id="dynamic_android.statistics.sharpnessMapMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11550 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11551 android.<wbr/>statistics.<wbr/>sharpness<wbr/>Map<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11552 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11553 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]11554 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11555
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]11556 <span class="entry_type_visibility"> [system as boolean]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11557
11558 <ul class="entry_type_enum">
11559 <li>
11560 <span class="entry_type_enum_name">OFF</span>
11561 </li>
11562 <li>
11563 <span class="entry_type_enum_name">ON</span>
11564 </li>
11565 </ul>
11566
11567 </td> <!-- entry_type -->
11568
11569 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11570 <p>Operating mode for sharpness map
11571generation</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11572 </td>
11573
11574 <td class="entry_units">
11575 </td>
11576
11577 <td class="entry_range">
11578 </td>
11579
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11580 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]11581 <ul class="entry_tags">
11582 <li><a href="#tag_V1">V1</a></li>
11583 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11584 </td>
11585
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11586 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11587
11588
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11589 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11590 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11591
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]11592
11593 <tr class="entry" id="dynamic_android.statistics.lensShadingMap">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11594 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11595 android.<wbr/>statistics.<wbr/>lens<wbr/>Shading<wbr/>Map
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11596 </td>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]11597 <td class="entry_type">
11598 <span class="entry_type_name">float</span>
11599 <span class="entry_type_container">x</span>
11600
11601 <span class="entry_type_array">
11602 4 x n x m
11603 </span>
11604 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11605 <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]11606
11607
11608 </td> <!-- entry_type -->
11609
11610 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11611 <p>The shading map is a low-resolution floating-point map
11612that lists the coefficients used to correct for vignetting,<wbr/> for each
11613Bayer color channel.<wbr/></p>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]11614 </td>
11615
11616 <td class="entry_units">
11617 </td>
11618
11619 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]11620 <p>Each gain factor is &gt;= 1</p>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]11621 </td>
11622
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11623 <td class="entry_tags">
11624 </td>
11625
11626 </tr>
11627 <tr class="entries_header">
11628 <th class="th_details" colspan="5">Details</th>
11629 </tr>
11630 <tr class="entry_cont">
11631 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11632 <p>The least shaded section of the image should have a gain factor
11633of 1; all other sections should have gains above 1.<wbr/></p>
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]11634<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]11635must take into account the colorCorrection settings.<wbr/></p>
11636<p>The shading map is for the entire active pixel array,<wbr/> and is not
11637affected by the crop region specified in the request.<wbr/> Each shading map
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]11638entry is the value of the shading compensation map over a specific
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11639pixel on the sensor.<wbr/> Specifically,<wbr/> with a (N x M) resolution shading
11640map,<wbr/> and an active pixel array size (W x H),<wbr/> shading map entry
11641(x,<wbr/>y) ϵ (0 ...<wbr/> N-1,<wbr/> 0 ...<wbr/> M-1) is the value of the shading map at
11642pixel ( ((W-1)/<wbr/>(N-1)) * x,<wbr/> ((H-1)/<wbr/>(M-1)) * y) for the four color channels.<wbr/>
11643The map is assumed to be bilinearly interpolated between the sample points.<wbr/></p>
11644<p>The channel order is [R,<wbr/> Geven,<wbr/> Godd,<wbr/> B],<wbr/> where Geven is the green
11645channel for the even rows of a Bayer pattern,<wbr/> and Godd is the odd rows.<wbr/>
11646The shading map is stored in a fully interleaved format,<wbr/> and its size
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]11647is 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]11648<p>The shading map should have on the order of 30-40 rows and columns,<wbr/>
11649and must be smaller than 64x64.<wbr/></p>
11650<p>As an example,<wbr/> given a very small map defined as:</p>
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]11651<pre><code><a href="#static_android.lens.info.shadingMapSize">android.<wbr/>lens.<wbr/>info.<wbr/>shading<wbr/>Map<wbr/>Size</a> = [ 4,<wbr/> 3 ]
11652<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]11653[ 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/>
11654 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/>
11655 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/>
11656 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/>
11657 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/>
11658 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]11659</code></pre>
11660<p>The low-resolution scaling map images for each channel are
11661(displayed using nearest-neighbor interpolation):</p>
11662<p><img alt="Red lens shading map" src="images/camera2/metadata/android.statistics.lensShadingMap/red_shading.png"/>
11663<img alt="Green (even rows) lens shading map" src="images/camera2/metadata/android.statistics.lensShadingMap/green_e_shading.png"/>
11664<img alt="Green (odd rows) lens shading map" src="images/camera2/metadata/android.statistics.lensShadingMap/green_o_shading.png"/>
11665<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]11666<p>As a visualization only,<wbr/> inverting the full-color map to recover an
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]11667image 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]11668<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]11669 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11670 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11671
11672
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11673 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11674 <!-- end of entry -->
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]11675
11676
11677 <tr class="entry" id="dynamic_android.statistics.predictedColorGains">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11678 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11679 android.<wbr/>statistics.<wbr/>predicted<wbr/>Color<wbr/>Gains
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11680 </td>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]11681 <td class="entry_type">
11682 <span class="entry_type_name">float</span>
11683 <span class="entry_type_container">x</span>
11684
11685 <span class="entry_type_array">
11686 4
11687 </span>
11688 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11689 <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]11690
11691
11692 </td> <!-- entry_type -->
11693
11694 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11695 <p>The best-fit color channel gains calculated
11696by the HAL's statistics units for the current output frame</p>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]11697 </td>
11698
11699 <td class="entry_units">
11700 </td>
11701
11702 <td class="entry_range">
11703 </td>
11704
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11705 <td class="entry_tags">
11706 </td>
11707
11708 </tr>
11709 <tr class="entries_header">
11710 <th class="th_details" colspan="5">Details</th>
11711 </tr>
11712 <tr class="entry_cont">
11713 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11714 <p>This may be different than the gains used for this frame,<wbr/>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]11715since statistics processing on data from a new frame
11716typically completes after the transform has already been
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11717applied to that frame.<wbr/></p>
11718<p>The 4 channel gains are defined in Bayer domain,<wbr/>
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]11719see <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]11720<p>This value should always be calculated by the AWB block,<wbr/>
11721regardless of the android.<wbr/>control.<wbr/>* current values.<wbr/></p>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]11722 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11723 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11724
11725
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11726 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11727 <!-- end of entry -->
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]11728
11729
11730 <tr class="entry" id="dynamic_android.statistics.predictedColorTransform">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11731 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11732 android.<wbr/>statistics.<wbr/>predicted<wbr/>Color<wbr/>Transform
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11733 </td>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]11734 <td class="entry_type">
11735 <span class="entry_type_name">rational</span>
11736 <span class="entry_type_container">x</span>
11737
11738 <span class="entry_type_array">
11739 3 x 3
11740 </span>
11741 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11742 <div class="entry_type_notes">3x3 rational matrix in row-major order</div>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]11743
11744
11745 </td> <!-- entry_type -->
11746
11747 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11748 <p>The best-fit color transform matrix estimate
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]11749calculated by the HAL's statistics units for the current
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11750output frame</p>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]11751 </td>
11752
11753 <td class="entry_units">
11754 </td>
11755
11756 <td class="entry_range">
11757 </td>
11758
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11759 <td class="entry_tags">
11760 </td>
11761
11762 </tr>
11763 <tr class="entries_header">
11764 <th class="th_details" colspan="5">Details</th>
11765 </tr>
11766 <tr class="entry_cont">
11767 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11768 <p>The HAL must provide the estimate from its
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]11769statistics unit on the white balance transforms to use
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11770for the next frame.<wbr/> These are the values the HAL believes
11771are the best fit for the current output frame.<wbr/> This may
11772be different than the transform used for this frame,<wbr/> since
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]11773statistics processing on data from a new frame typically
11774completes after the transform has already been applied to
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11775that frame.<wbr/></p>
11776<p>These estimates must be provided for all frames,<wbr/> even if
11777capture settings and color transforms are set by the application.<wbr/></p>
11778<p>This value should always be calculated by the AWB block,<wbr/>
11779regardless of the android.<wbr/>control.<wbr/>* current values.<wbr/></p>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]11780 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11781 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11782
11783
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11784 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11785 <!-- end of entry -->
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]11786
11787
11788 <tr class="entry" id="dynamic_android.statistics.sceneFlicker">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11789 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11790 android.<wbr/>statistics.<wbr/>scene<wbr/>Flicker
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11791 </td>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]11792 <td class="entry_type">
11793 <span class="entry_type_name entry_type_name_enum">byte</span>
11794
11795 <span class="entry_type_visibility"> [public]</span>
11796
11797 <ul class="entry_type_enum">
11798 <li>
11799 <span class="entry_type_enum_name">NONE</span>
11800 </li>
11801 <li>
11802 <span class="entry_type_enum_name">50HZ</span>
11803 </li>
11804 <li>
11805 <span class="entry_type_enum_name">60HZ</span>
11806 </li>
11807 </ul>
11808
11809 </td> <!-- entry_type -->
11810
11811 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11812 <p>The HAL estimated scene illumination lighting
11813frequency</p>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]11814 </td>
11815
11816 <td class="entry_units">
11817 </td>
11818
11819 <td class="entry_range">
11820 </td>
11821
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]11822 <td class="entry_tags">
11823 </td>
11824
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11825 </tr>
11826 <tr class="entries_header">
11827 <th class="th_details" colspan="5">Details</th>
11828 </tr>
11829 <tr class="entry_cont">
11830 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11831 <p>Report NONE if there doesn't appear to be flickering
11832illumination</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11833 </td>
11834 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11835
11836
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11837 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11838 <!-- end of entry -->
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]11839
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11840
11841
11842 <!-- end of kind -->
11843 </tbody>
11844
11845 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11846 <tr><td colspan="6" id="section_tonemap" class="section">tonemap</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11847
11848
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11849 <tr><td colspan="6" class="kind">controls</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11850
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]11851 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11852 <tr>
11853 <th class="th_name">Property Name</th>
11854 <th class="th_type">Type</th>
11855 <th class="th_description">Description</th>
11856 <th class="th_units">Units</th>
11857 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11858 <th class="th_tags">Tags</th>
11859 </tr>
11860 </thead>
11861
11862 <tbody>
11863
11864
11865
11866
11867
11868
11869
11870
11871
11872
11873 <tr class="entry" id="controls_android.tonemap.curveBlue">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11874 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11875 android.<wbr/>tonemap.<wbr/>curve<wbr/>Blue
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11876 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11877 <td class="entry_type">
Eino-Ville Talvala76548fe2013-01-11 13:57:19 -0800[diff] [blame]11878 <span class="entry_type_name">float</span>
Zhijun He704d1282013-08-19 15:26:33 -0700[diff] [blame]11879 <span class="entry_type_container">x</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11880
Zhijun He704d1282013-08-19 15:26:33 -0700[diff] [blame]11881 <span class="entry_type_array">
11882 n x 2
11883 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]11884 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11885 <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]11886
11887
11888 </td> <!-- entry_type -->
11889
11890 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11891 <p>Table mapping blue input values to output
11892values</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11893 </td>
11894
11895 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11896 same as android.<wbr/>tonemap.<wbr/>curve<wbr/>Red
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11897 </td>
11898
11899 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]11900 <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]11901 </td>
11902
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11903 <td class="entry_tags">
11904 </td>
11905
11906 </tr>
11907 <tr class="entries_header">
11908 <th class="th_details" colspan="5">Details</th>
11909 </tr>
11910 <tr class="entry_cont">
11911 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11912 <p>Tonemapping /<wbr/> contrast /<wbr/> gamma curve for the blue
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]11913channel,<wbr/> to use when <a href="#controls_android.tonemap.mode">android.<wbr/>tonemap.<wbr/>mode</a> is CONTRAST_<wbr/>CURVE.<wbr/></p>
11914<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]11915 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11916 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11917
11918
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11919 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11920 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11921
11922
11923 <tr class="entry" id="controls_android.tonemap.curveGreen">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11924 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11925 android.<wbr/>tonemap.<wbr/>curve<wbr/>Green
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11926 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11927 <td class="entry_type">
Eino-Ville Talvala76548fe2013-01-11 13:57:19 -0800[diff] [blame]11928 <span class="entry_type_name">float</span>
Zhijun He704d1282013-08-19 15:26:33 -0700[diff] [blame]11929 <span class="entry_type_container">x</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11930
Zhijun He704d1282013-08-19 15:26:33 -0700[diff] [blame]11931 <span class="entry_type_array">
11932 n x 2
11933 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]11934 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11935 <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]11936
11937
11938 </td> <!-- entry_type -->
11939
11940 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11941 <p>Table mapping green input values to output
11942values</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11943 </td>
11944
11945 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11946 same as android.<wbr/>tonemap.<wbr/>curve<wbr/>Red
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11947 </td>
11948
11949 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]11950 <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]11951 </td>
11952
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11953 <td class="entry_tags">
11954 </td>
11955
11956 </tr>
11957 <tr class="entries_header">
11958 <th class="th_details" colspan="5">Details</th>
11959 </tr>
11960 <tr class="entry_cont">
11961 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11962 <p>Tonemapping /<wbr/> contrast /<wbr/> gamma curve for the green
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]11963channel,<wbr/> to use when <a href="#controls_android.tonemap.mode">android.<wbr/>tonemap.<wbr/>mode</a> is CONTRAST_<wbr/>CURVE.<wbr/></p>
11964<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]11965 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11966 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11967
11968
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11969 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11970 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11971
11972
11973 <tr class="entry" id="controls_android.tonemap.curveRed">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11974 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11975 android.<wbr/>tonemap.<wbr/>curve<wbr/>Red
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11976 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11977 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]11978 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11979 <span class="entry_type_container">x</span>
11980
11981 <span class="entry_type_array">
11982 n x 2
11983 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]11984 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11985 <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]11986
11987
11988 </td> <!-- entry_type -->
11989
11990 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11991 <p>Table mapping red input values to output
11992values</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11993 </td>
11994
11995 <td class="entry_units">
11996 </td>
11997
11998 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]11999 <p>0-1 on input and output coordinates.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12000 </td>
12001
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12002 <td class="entry_tags">
12003 <ul class="entry_tags">
12004 <li><a href="#tag_DNG">DNG</a></li>
12005 </ul>
12006 </td>
12007
12008 </tr>
12009 <tr class="entries_header">
12010 <th class="th_details" colspan="5">Details</th>
12011 </tr>
12012 <tr class="entry_cont">
12013 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12014 <p>Tonemapping /<wbr/> contrast /<wbr/> gamma curve for the red
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]12015channel,<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]12016<p>Since the input and output ranges may vary depending on
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12017the camera pipeline,<wbr/> the input and output pixel values
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]12018are represented by normalized floating-point values
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12019between 0 and 1,<wbr/> with 0 == black and 1 == white.<wbr/></p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]12020<p>The curve should be linearly interpolated between the
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12021defined points.<wbr/> The points will be listed in increasing
12022order of P_<wbr/>IN.<wbr/> For example,<wbr/> if the array is: [0.<wbr/>0,<wbr/> 0.<wbr/>0,<wbr/>
120230.<wbr/>3,<wbr/> 0.<wbr/>5,<wbr/> 1.<wbr/>0,<wbr/> 1.<wbr/>0],<wbr/> then the input-&gt;output mapping
12024for a few sample points would be: 0 -&gt; 0,<wbr/> 0.<wbr/>15 -&gt;
120250.<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]12026 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12027 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12028
12029
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12030 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
12031 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12032
12033
12034 <tr class="entry" id="controls_android.tonemap.mode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12035 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12036 android.<wbr/>tonemap.<wbr/>mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12037 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12038 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]12039 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12040
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]12041 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12042
12043 <ul class="entry_type_enum">
12044 <li>
12045 <span class="entry_type_enum_name">CONTRAST_CURVE</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12046 <span class="entry_type_enum_notes">Use the tone mapping curve specified in
12047 android.<wbr/>tonemap.<wbr/>curve</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12048 </li>
12049 <li>
12050 <span class="entry_type_enum_name">FAST</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12051 <span class="entry_type_enum_notes">Must not slow down frame rate relative to raw
12052 bayer output</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12053 </li>
12054 <li>
12055 <span class="entry_type_enum_name">HIGH_QUALITY</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12056 <span class="entry_type_enum_notes">Frame rate may be reduced by high
12057 quality</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12058 </li>
12059 </ul>
12060
12061 </td> <!-- entry_type -->
12062
12063 <td class="entry_description">
12064 </td>
12065
12066 <td class="entry_units">
12067 </td>
12068
12069 <td class="entry_range">
12070 </td>
12071
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12072 <td class="entry_tags">
12073 </td>
12074
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12075 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12076
12077
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12078 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
12079 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12080
12081
12082
12083 <!-- end of kind -->
12084 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12085 <tr><td colspan="6" class="kind">static</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12086
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]12087 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12088 <tr>
12089 <th class="th_name">Property Name</th>
12090 <th class="th_type">Type</th>
12091 <th class="th_description">Description</th>
12092 <th class="th_units">Units</th>
12093 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12094 <th class="th_tags">Tags</th>
12095 </tr>
12096 </thead>
12097
12098 <tbody>
12099
12100
12101
12102
12103
12104
12105
12106
12107
12108
12109 <tr class="entry" id="static_android.tonemap.maxCurvePoints">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12110 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12111 android.<wbr/>tonemap.<wbr/>max<wbr/>Curve<wbr/>Points
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12112 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12113 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]12114 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12115
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]12116 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12117
12118
12119 </td> <!-- entry_type -->
12120
12121 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12122 <p>Maximum number of supported points in the
12123tonemap curve</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12124 </td>
12125
12126 <td class="entry_units">
12127 </td>
12128
12129 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame^]12130 <p>&gt;= 128</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12131 </td>
12132
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12133 <td class="entry_tags">
12134 </td>
12135
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]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 -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12141
12142
12143
12144 <!-- end of kind -->
12145 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12146 <tr><td colspan="6" class="kind">dynamic</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12147
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]12148 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12149 <tr>
12150 <th class="th_name">Property Name</th>
12151 <th class="th_type">Type</th>
12152 <th class="th_description">Description</th>
12153 <th class="th_units">Units</th>
12154 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12155 <th class="th_tags">Tags</th>
12156 </tr>
12157 </thead>
12158
12159 <tbody>
12160
12161
12162
12163
12164
12165
12166
12167
12168
12169
12170 <tr class="entry" id="dynamic_android.tonemap.curveBlue">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12171 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12172 android.<wbr/>tonemap.<wbr/>curve<wbr/>Blue
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12173 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12174 <td class="entry_type">
Eino-Ville Talvala76548fe2013-01-11 13:57:19 -0800[diff] [blame]12175 <span class="entry_type_name">float</span>
Zhijun He704d1282013-08-19 15:26:33 -0700[diff] [blame]12176 <span class="entry_type_container">x</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12177
Zhijun He704d1282013-08-19 15:26:33 -0700[diff] [blame]12178 <span class="entry_type_array">
12179 n x 2
12180 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]12181 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12182 <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]12183
12184
12185 </td> <!-- entry_type -->
12186
12187 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12188 <p>Table mapping blue input values to output
12189values</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12190 </td>
12191
12192 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12193 same as android.<wbr/>tonemap.<wbr/>curve<wbr/>Red
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12194 </td>
12195
12196 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]12197 <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]12198 </td>
12199
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12200 <td class="entry_tags">
12201 </td>
12202
12203 </tr>
12204 <tr class="entries_header">
12205 <th class="th_details" colspan="5">Details</th>
12206 </tr>
12207 <tr class="entry_cont">
12208 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12209 <p>Tonemapping /<wbr/> contrast /<wbr/> gamma curve for the blue
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]12210channel,<wbr/> to use when <a href="#controls_android.tonemap.mode">android.<wbr/>tonemap.<wbr/>mode</a> is CONTRAST_<wbr/>CURVE.<wbr/></p>
12211<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]12212 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12213 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12214
12215
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12216 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
12217 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12218
12219
12220 <tr class="entry" id="dynamic_android.tonemap.curveGreen">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12221 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12222 android.<wbr/>tonemap.<wbr/>curve<wbr/>Green
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12223 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12224 <td class="entry_type">
Eino-Ville Talvala76548fe2013-01-11 13:57:19 -0800[diff] [blame]12225 <span class="entry_type_name">float</span>
Zhijun He704d1282013-08-19 15:26:33 -0700[diff] [blame]12226 <span class="entry_type_container">x</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12227
Zhijun He704d1282013-08-19 15:26:33 -0700[diff] [blame]12228 <span class="entry_type_array">
12229 n x 2
12230 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]12231 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12232 <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]12233
12234
12235 </td> <!-- entry_type -->
12236
12237 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12238 <p>Table mapping green input values to output
12239values</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12240 </td>
12241
12242 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12243 same as android.<wbr/>tonemap.<wbr/>curve<wbr/>Red
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12244 </td>
12245
12246 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]12247 <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]12248 </td>
12249
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12250 <td class="entry_tags">
12251 </td>
12252
12253 </tr>
12254 <tr class="entries_header">
12255 <th class="th_details" colspan="5">Details</th>
12256 </tr>
12257 <tr class="entry_cont">
12258 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12259 <p>Tonemapping /<wbr/> contrast /<wbr/> gamma curve for the green
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]12260channel,<wbr/> to use when <a href="#controls_android.tonemap.mode">android.<wbr/>tonemap.<wbr/>mode</a> is CONTRAST_<wbr/>CURVE.<wbr/></p>
12261<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]12262 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12263 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12264
12265
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12266 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
12267 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12268
12269
12270 <tr class="entry" id="dynamic_android.tonemap.curveRed">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12271 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12272 android.<wbr/>tonemap.<wbr/>curve<wbr/>Red
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12273 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12274 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]12275 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12276 <span class="entry_type_container">x</span>
12277
12278 <span class="entry_type_array">
12279 n x 2
12280 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]12281 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12282 <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]12283
12284
12285 </td> <!-- entry_type -->
12286
12287 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12288 <p>Table mapping red input values to output
12289values</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12290 </td>
12291
12292 <td class="entry_units">
12293 </td>
12294
12295 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]12296 <p>0-1 on input and output coordinates.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12297 </td>
12298
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12299 <td class="entry_tags">
12300 <ul class="entry_tags">
12301 <li><a href="#tag_DNG">DNG</a></li>
12302 </ul>
12303 </td>
12304
12305 </tr>
12306 <tr class="entries_header">
12307 <th class="th_details" colspan="5">Details</th>
12308 </tr>
12309 <tr class="entry_cont">
12310 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12311 <p>Tonemapping /<wbr/> contrast /<wbr/> gamma curve for the red
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]12312channel,<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]12313<p>Since the input and output ranges may vary depending on
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12314the camera pipeline,<wbr/> the input and output pixel values
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]12315are represented by normalized floating-point values
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12316between 0 and 1,<wbr/> with 0 == black and 1 == white.<wbr/></p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]12317<p>The curve should be linearly interpolated between the
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12318defined points.<wbr/> The points will be listed in increasing
12319order of P_<wbr/>IN.<wbr/> For example,<wbr/> if the array is: [0.<wbr/>0,<wbr/> 0.<wbr/>0,<wbr/>
123200.<wbr/>3,<wbr/> 0.<wbr/>5,<wbr/> 1.<wbr/>0,<wbr/> 1.<wbr/>0],<wbr/> then the input-&gt;output mapping
12321for a few sample points would be: 0 -&gt; 0,<wbr/> 0.<wbr/>15 -&gt;
123220.<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]12323 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12324 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12325
12326
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12327 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
12328 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12329
12330
12331 <tr class="entry" id="dynamic_android.tonemap.mode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12332 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12333 android.<wbr/>tonemap.<wbr/>mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12334 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12335 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]12336 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12337
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]12338 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12339
12340 <ul class="entry_type_enum">
12341 <li>
12342 <span class="entry_type_enum_name">CONTRAST_CURVE</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12343 <span class="entry_type_enum_notes">Use the tone mapping curve specified in
12344 android.<wbr/>tonemap.<wbr/>curve</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12345 </li>
12346 <li>
12347 <span class="entry_type_enum_name">FAST</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12348 <span class="entry_type_enum_notes">Must not slow down frame rate relative to raw
12349 bayer output</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12350 </li>
12351 <li>
12352 <span class="entry_type_enum_name">HIGH_QUALITY</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12353 <span class="entry_type_enum_notes">Frame rate may be reduced by high
12354 quality</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12355 </li>
12356 </ul>
12357
12358 </td> <!-- entry_type -->
12359
12360 <td class="entry_description">
12361 </td>
12362
12363 <td class="entry_units">
12364 </td>
12365
12366 <td class="entry_range">
12367 </td>
12368
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12369 <td class="entry_tags">
12370 </td>
12371
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12372 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12373
12374
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12375 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
12376 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12377
12378
12379
12380 <!-- end of kind -->
12381 </tbody>
12382
12383 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12384 <tr><td colspan="6" id="section_led" class="section">led</td></tr>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12385
12386
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12387 <tr><td colspan="6" class="kind">controls</td></tr>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12388
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]12389 <thead class="entries_header">
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[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 Murashkinc469f7d2013-04-23 14:31:02 -0700[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="controls_android.led.transmit">
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/>led.<wbr/>transmit
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12414 </td>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12415 <td class="entry_type">
12416 <span class="entry_type_name entry_type_name_enum">byte</span>
12417
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]12418 <span class="entry_type_visibility"> [hidden as boolean]</span>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12419
12420 <ul class="entry_type_enum">
12421 <li>
12422 <span class="entry_type_enum_name">OFF</span>
12423 </li>
12424 <li>
12425 <span class="entry_type_enum_name">ON</span>
12426 </li>
12427 </ul>
12428
12429 </td> <!-- entry_type -->
12430
12431 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12432 <p>This LED is nominally used to indicate to the user
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]12433that the camera is powered on and may be streaming images back to the
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12434Application Processor.<wbr/> In certain rare circumstances,<wbr/> the OS may
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]12435disable this when video is processed locally and not transmitted to
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12436any untrusted applications.<wbr/></p>
12437<p>In particular,<wbr/> the LED <em>must</em> always be on when the data could be
12438transmitted off the device.<wbr/> The LED <em>should</em> always be on whenever
12439data is stored locally on the device.<wbr/></p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]12440<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]12441doesn't violate the above rules.<wbr/></p>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12442 </td>
12443
12444 <td class="entry_units">
12445 </td>
12446
12447 <td class="entry_range">
12448 </td>
12449
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12450 <td class="entry_tags">
12451 </td>
12452
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12453 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12454
12455
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12456 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
12457 <!-- end of entry -->
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12458
12459
12460
12461 <!-- end of kind -->
12462 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12463 <tr><td colspan="6" class="kind">dynamic</td></tr>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12464
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]12465 <thead class="entries_header">
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12466 <tr>
12467 <th class="th_name">Property Name</th>
12468 <th class="th_type">Type</th>
12469 <th class="th_description">Description</th>
12470 <th class="th_units">Units</th>
12471 <th class="th_range">Range</th>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12472 <th class="th_tags">Tags</th>
12473 </tr>
12474 </thead>
12475
12476 <tbody>
12477
12478
12479
12480
12481
12482
12483
12484
12485
12486
12487 <tr class="entry" id="dynamic_android.led.transmit">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12488 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12489 android.<wbr/>led.<wbr/>transmit
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12490 </td>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12491 <td class="entry_type">
12492 <span class="entry_type_name entry_type_name_enum">byte</span>
12493
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]12494 <span class="entry_type_visibility"> [hidden as boolean]</span>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12495
12496 <ul class="entry_type_enum">
12497 <li>
12498 <span class="entry_type_enum_name">OFF</span>
12499 </li>
12500 <li>
12501 <span class="entry_type_enum_name">ON</span>
12502 </li>
12503 </ul>
12504
12505 </td> <!-- entry_type -->
12506
12507 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12508 <p>This LED is nominally used to indicate to the user
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]12509that the camera is powered on and may be streaming images back to the
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12510Application Processor.<wbr/> In certain rare circumstances,<wbr/> the OS may
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]12511disable this when video is processed locally and not transmitted to
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12512any untrusted applications.<wbr/></p>
12513<p>In particular,<wbr/> the LED <em>must</em> always be on when the data could be
12514transmitted off the device.<wbr/> The LED <em>should</em> always be on whenever
12515data is stored locally on the device.<wbr/></p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]12516<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]12517doesn't violate the above rules.<wbr/></p>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12518 </td>
12519
12520 <td class="entry_units">
12521 </td>
12522
12523 <td class="entry_range">
12524 </td>
12525
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12526 <td class="entry_tags">
12527 </td>
12528
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12529 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12530
12531
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12532 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
12533 <!-- end of entry -->
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12534
12535
12536
12537 <!-- end of kind -->
12538 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12539 <tr><td colspan="6" class="kind">static</td></tr>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12540
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]12541 <thead class="entries_header">
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12542 <tr>
12543 <th class="th_name">Property Name</th>
12544 <th class="th_type">Type</th>
12545 <th class="th_description">Description</th>
12546 <th class="th_units">Units</th>
12547 <th class="th_range">Range</th>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12548 <th class="th_tags">Tags</th>
12549 </tr>
12550 </thead>
12551
12552 <tbody>
12553
12554
12555
12556
12557
12558
12559
12560
12561
12562
12563 <tr class="entry" id="static_android.led.availableLeds">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12564 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12565 android.<wbr/>led.<wbr/>available<wbr/>Leds
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12566 </td>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12567 <td class="entry_type">
12568 <span class="entry_type_name entry_type_name_enum">byte</span>
12569 <span class="entry_type_container">x</span>
12570
12571 <span class="entry_type_array">
12572 n
12573 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]12574 <span class="entry_type_visibility"> [hidden]</span>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12575
12576 <ul class="entry_type_enum">
12577 <li>
12578 <span class="entry_type_enum_name">TRANSMIT</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12579 <span class="entry_type_enum_notes">android.<wbr/>led.<wbr/>transmit control is used</span>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12580 </li>
12581 </ul>
12582
12583 </td> <!-- entry_type -->
12584
12585 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12586 <p>A list of camera LEDs that are available on this system.<wbr/></p>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12587 </td>
12588
12589 <td class="entry_units">
12590 </td>
12591
12592 <td class="entry_range">
12593 </td>
12594
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12595 <td class="entry_tags">
12596 </td>
12597
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12598 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12599
12600
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12601 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
12602 <!-- end of entry -->
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12603
12604
12605
12606 <!-- end of kind -->
12607 </tbody>
12608
12609 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12610 <tr><td colspan="6" id="section_info" class="section">info</td></tr>
Igor Murashkin38b8cae2013-05-23 16:38:59 -0700[diff] [blame]12611
12612
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12613 <tr><td colspan="6" class="kind">static</td></tr>
Igor Murashkin38b8cae2013-05-23 16:38:59 -0700[diff] [blame]12614
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]12615 <thead class="entries_header">
Igor Murashkin38b8cae2013-05-23 16:38:59 -0700[diff] [blame]12616 <tr>
12617 <th class="th_name">Property Name</th>
12618 <th class="th_type">Type</th>
12619 <th class="th_description">Description</th>
12620 <th class="th_units">Units</th>
12621 <th class="th_range">Range</th>
Igor Murashkin38b8cae2013-05-23 16:38:59 -0700[diff] [blame]12622 <th class="th_tags">Tags</th>
12623 </tr>
12624 </thead>
12625
12626 <tbody>
12627
12628
12629
12630
12631
12632
12633
12634
12635
12636
12637 <tr class="entry" id="static_android.info.supportedHardwareLevel">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12638 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12639 android.<wbr/>info.<wbr/>supported<wbr/>Hardware<wbr/>Level
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12640 </td>
Igor Murashkin38b8cae2013-05-23 16:38:59 -0700[diff] [blame]12641 <td class="entry_type">
12642 <span class="entry_type_name entry_type_name_enum">byte</span>
12643
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]12644 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin38b8cae2013-05-23 16:38:59 -0700[diff] [blame]12645
12646 <ul class="entry_type_enum">
12647 <li>
12648 <span class="entry_type_enum_name">LIMITED</span>
12649 </li>
12650 <li>
12651 <span class="entry_type_enum_name">FULL</span>
12652 </li>
12653 </ul>
12654
12655 </td> <!-- entry_type -->
12656
12657 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12658 <p>The camera 3 HAL device can implement one of two possible
12659operational modes; limited and full.<wbr/> Full support is
12660expected from new higher-end devices.<wbr/> Limited mode has
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]12661hardware requirements roughly in line with those for a
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12662camera HAL device v1 implementation,<wbr/> and is expected from
12663older or inexpensive devices.<wbr/> Full is a strict superset of
12664limited,<wbr/> and they share the same essential operational flow.<wbr/></p>
12665<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]12666 </td>
12667
12668 <td class="entry_units">
12669 </td>
12670
12671 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]12672 <p>Optional.<wbr/> Default value is LIMITED.<wbr/></p>
Igor Murashkin38b8cae2013-05-23 16:38:59 -0700[diff] [blame]12673 </td>
12674
Igor Murashkin38b8cae2013-05-23 16:38:59 -0700[diff] [blame]12675 <td class="entry_tags">
12676 </td>
12677
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12678 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12679
12680
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12681 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
12682 <!-- end of entry -->
Igor Murashkin38b8cae2013-05-23 16:38:59 -0700[diff] [blame]12683
12684
12685
12686 <!-- end of kind -->
12687 </tbody>
12688
12689 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12690 <tr><td colspan="6" id="section_blackLevel" class="section">blackLevel</td></tr>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]12691
12692
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12693 <tr><td colspan="6" class="kind">controls</td></tr>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]12694
12695 <thead class="entries_header">
12696 <tr>
12697 <th class="th_name">Property Name</th>
12698 <th class="th_type">Type</th>
12699 <th class="th_description">Description</th>
12700 <th class="th_units">Units</th>
12701 <th class="th_range">Range</th>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]12702 <th class="th_tags">Tags</th>
12703 </tr>
12704 </thead>
12705
12706 <tbody>
12707
12708
12709
12710
12711
12712
12713
12714
12715
12716
12717 <tr class="entry" id="controls_android.blackLevel.lock">
Eino-Ville Talvala7796cfe2013-12-26 13:16:54 -0800[diff] [blame]12718 <td class="entry_name" rowspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12719 android.<wbr/>black<wbr/>Level.<wbr/>lock
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12720 </td>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]12721 <td class="entry_type">
12722 <span class="entry_type_name entry_type_name_enum">byte</span>
12723
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]12724 <span class="entry_type_visibility"> [public as boolean]</span>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]12725
12726 <ul class="entry_type_enum">
12727 <li>
12728 <span class="entry_type_enum_name">OFF</span>
12729 </li>
12730 <li>
12731 <span class="entry_type_enum_name">ON</span>
12732 </li>
12733 </ul>
12734
12735 </td> <!-- entry_type -->
12736
12737 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12738 <p>Whether black-level compensation is locked
12739to its current values,<wbr/> or is free to vary.<wbr/></p>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]12740 </td>
12741
12742 <td class="entry_units">
12743 </td>
12744
12745 <td class="entry_range">
12746 </td>
12747
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12748 <td class="entry_tags">
12749 <ul class="entry_tags">
12750 <li><a href="#tag_HAL2">HAL2</a></li>
12751 </ul>
12752 </td>
12753
12754 </tr>
12755 <tr class="entries_header">
12756 <th class="th_details" colspan="5">Details</th>
12757 </tr>
12758 <tr class="entry_cont">
12759 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12760 <p>When set to ON,<wbr/> the values used for black-level
Eino-Ville Talvala7796cfe2013-12-26 13:16:54 -0800[diff] [blame]12761compensation will not change until the lock is set to
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12762OFF.<wbr/></p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]12763<p>Since changes to certain capture parameters (such as
12764exposure time) may require resetting of black level
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12765compensation,<wbr/> the camera device must report whether setting
Eino-Ville Talvala7796cfe2013-12-26 13:16:54 -0800[diff] [blame]12766the black level lock was successful in the output result
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12767metadata.<wbr/></p>
12768<p>For example,<wbr/> if a sequence of requests is as follows:</p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]12769<ul>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12770<li>Request 1: Exposure = 10ms,<wbr/> Black level lock = OFF</li>
12771<li>Request 2: Exposure = 10ms,<wbr/> Black level lock = ON</li>
12772<li>Request 3: Exposure = 10ms,<wbr/> Black level lock = ON</li>
12773<li>Request 4: Exposure = 20ms,<wbr/> Black level lock = ON</li>
12774<li>Request 5: Exposure = 20ms,<wbr/> Black level lock = ON</li>
12775<li>Request 6: Exposure = 20ms,<wbr/> Black level lock = ON</li>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]12776</ul>
Eino-Ville Talvala7796cfe2013-12-26 13:16:54 -0800[diff] [blame]12777<p>And the exposure change in Request 4 requires the camera
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12778device to reset the black level offsets,<wbr/> then the output
Eino-Ville Talvala7796cfe2013-12-26 13:16:54 -0800[diff] [blame]12779result metadata is expected to be:</p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]12780<ul>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12781<li>Result 1: Exposure = 10ms,<wbr/> Black level lock = OFF</li>
12782<li>Result 2: Exposure = 10ms,<wbr/> Black level lock = ON</li>
12783<li>Result 3: Exposure = 10ms,<wbr/> Black level lock = ON</li>
12784<li>Result 4: Exposure = 20ms,<wbr/> Black level lock = OFF</li>
12785<li>Result 5: Exposure = 20ms,<wbr/> Black level lock = ON</li>
12786<li>Result 6: Exposure = 20ms,<wbr/> Black level lock = ON</li>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]12787</ul>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12788<p>This indicates to the application that on frame 4,<wbr/> black
12789levels were reset due to exposure value changes,<wbr/> and pixel
12790values may not be consistent across captures.<wbr/></p>
Eino-Ville Talvala7796cfe2013-12-26 13:16:54 -0800[diff] [blame]12791<p>The camera device will maintain the lock to the extent
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12792possible,<wbr/> only overriding the lock to OFF when changes to
Eino-Ville Talvala7796cfe2013-12-26 13:16:54 -0800[diff] [blame]12793other request parameters require a black level recalculation
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12794or reset.<wbr/></p>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]12795 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12796 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12797
Eino-Ville Talvala7796cfe2013-12-26 13:16:54 -0800[diff] [blame]12798 <tr class="entries_header">
12799 <th class="th_details" colspan="5">HAL Implementation Details</th>
12800 </tr>
12801 <tr class="entry_cont">
12802 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12803 <p>If for some reason black level locking is no longer possible
12804(for example,<wbr/> the analog gain has changed,<wbr/> which forces
12805black level offsets to be recalculated),<wbr/> then the HAL must
Eino-Ville Talvala7796cfe2013-12-26 13:16:54 -0800[diff] [blame]12806override this request (and it must report 'OFF' when this
12807does happen) until the next capture for which locking is
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12808possible again.<wbr/></p>
Eino-Ville Talvala7796cfe2013-12-26 13:16:54 -0800[diff] [blame]12809 </td>
12810 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12811
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12812 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
12813 <!-- end of entry -->
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]12814
12815
12816
12817 <!-- end of kind -->
12818 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12819 <tr><td colspan="6" class="kind">dynamic</td></tr>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]12820
12821 <thead class="entries_header">
12822 <tr>
12823 <th class="th_name">Property Name</th>
12824 <th class="th_type">Type</th>
12825 <th class="th_description">Description</th>
12826 <th class="th_units">Units</th>
12827 <th class="th_range">Range</th>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]12828 <th class="th_tags">Tags</th>
12829 </tr>
12830 </thead>
12831
12832 <tbody>
12833
12834
12835
12836
12837
12838
12839
12840
12841
12842
12843 <tr class="entry" id="dynamic_android.blackLevel.lock">
Eino-Ville Talvala7796cfe2013-12-26 13:16:54 -0800[diff] [blame]12844 <td class="entry_name" rowspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12845 android.<wbr/>black<wbr/>Level.<wbr/>lock
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12846 </td>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]12847 <td class="entry_type">
12848 <span class="entry_type_name entry_type_name_enum">byte</span>
12849
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]12850 <span class="entry_type_visibility"> [public as boolean]</span>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]12851
12852 <ul class="entry_type_enum">
12853 <li>
12854 <span class="entry_type_enum_name">OFF</span>
12855 </li>
12856 <li>
12857 <span class="entry_type_enum_name">ON</span>
12858 </li>
12859 </ul>
12860
12861 </td> <!-- entry_type -->
12862
12863 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12864 <p>Whether black-level compensation is locked
12865to its current values,<wbr/> or is free to vary.<wbr/></p>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]12866 </td>
12867
12868 <td class="entry_units">
12869 </td>
12870
12871 <td class="entry_range">
12872 </td>
12873
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]12874 <td class="entry_tags">
12875 <ul class="entry_tags">
12876 <li><a href="#tag_HAL2">HAL2</a></li>
12877 </ul>
12878 </td>
12879
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12880 </tr>
12881 <tr class="entries_header">
12882 <th class="th_details" colspan="5">Details</th>
12883 </tr>
12884 <tr class="entry_cont">
12885 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12886 <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]12887ON 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]12888a change in other capture settings forced the camera device to
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12889perform a black level reset.<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12890 </td>
12891 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12892
Eino-Ville Talvala7796cfe2013-12-26 13:16:54 -0800[diff] [blame]12893 <tr class="entries_header">
12894 <th class="th_details" colspan="5">HAL Implementation Details</th>
12895 </tr>
12896 <tr class="entry_cont">
12897 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12898 <p>If for some reason black level locking is no longer possible
12899(for example,<wbr/> the analog gain has changed,<wbr/> which forces
12900black level offsets to be recalculated),<wbr/> then the HAL must
Eino-Ville Talvala7796cfe2013-12-26 13:16:54 -0800[diff] [blame]12901override this request (and it must report 'OFF' when this
12902does happen) until the next capture for which locking is
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12903possible again.<wbr/></p>
Eino-Ville Talvala7796cfe2013-12-26 13:16:54 -0800[diff] [blame]12904 </td>
12905 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12906
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12907 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
12908 <!-- end of entry -->
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]12909
12910
12911
12912 <!-- end of kind -->
12913 </tbody>
12914
12915 <!-- end of section -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12916<!-- </namespace> -->
12917 </table>
12918
12919 <div class="tags" id="tag_index">
12920 <h2>Tags</h2>
12921 <ul>
12922 <li id="tag_AWB">AWB -
12923 Needed for auto white balance
12924
12925 <ul class="tags_entries">
12926 <li><a href="#controls_android.control.awbMode">android.control.awbMode</a> (controls)</li>
12927 </ul>
12928 </li> <!-- tag_AWB -->
12929 <li id="tag_BC">BC -
12930 Needed for backwards compatibility with old Java API
12931
12932 <ul class="tags_entries">
Eino-Ville Talvala19ce2c12013-12-30 12:03:45 -0800[diff] [blame]12933 <li><a href="#controls_android.control.aeAntibandingMode">android.control.aeAntibandingMode</a> (controls)</li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12934 <li><a href="#controls_android.control.aeExposureCompensation">android.control.aeExposureCompensation</a> (controls)</li>
12935 <li><a href="#controls_android.control.aeLock">android.control.aeLock</a> (controls)</li>
12936 <li><a href="#controls_android.control.aeMode">android.control.aeMode</a> (controls)</li>
12937 <li><a href="#controls_android.control.aeRegions">android.control.aeRegions</a> (controls)</li>
12938 <li><a href="#controls_android.control.aeTargetFpsRange">android.control.aeTargetFpsRange</a> (controls)</li>
Eino-Ville Talvala3b4383a2013-03-18 09:42:48 -0700[diff] [blame]12939 <li><a href="#controls_android.control.aePrecaptureTrigger">android.control.aePrecaptureTrigger</a> (controls)</li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12940 <li><a href="#controls_android.control.afMode">android.control.afMode</a> (controls)</li>
12941 <li><a href="#controls_android.control.afRegions">android.control.afRegions</a> (controls)</li>
Eino-Ville Talvala3b4383a2013-03-18 09:42:48 -0700[diff] [blame]12942 <li><a href="#controls_android.control.afTrigger">android.control.afTrigger</a> (controls)</li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12943 <li><a href="#controls_android.control.awbLock">android.control.awbLock</a> (controls)</li>
12944 <li><a href="#controls_android.control.awbMode">android.control.awbMode</a> (controls)</li>
12945 <li><a href="#controls_android.control.awbRegions">android.control.awbRegions</a> (controls)</li>
12946 <li><a href="#controls_android.control.captureIntent">android.control.captureIntent</a> (controls)</li>
12947 <li><a href="#controls_android.control.effectMode">android.control.effectMode</a> (controls)</li>
12948 <li><a href="#controls_android.control.mode">android.control.mode</a> (controls)</li>
12949 <li><a href="#controls_android.control.sceneMode">android.control.sceneMode</a> (controls)</li>
12950 <li><a href="#controls_android.control.videoStabilizationMode">android.control.videoStabilizationMode</a> (controls)</li>
12951 <li><a href="#static_android.control.aeCompensationRange">android.control.aeCompensationRange</a> (static)</li>
12952 <li><a href="#static_android.control.aeCompensationStep">android.control.aeCompensationStep</a> (static)</li>
12953 <li><a href="#static_android.control.afAvailableModes">android.control.afAvailableModes</a> (static)</li>
12954 <li><a href="#static_android.control.availableEffects">android.control.availableEffects</a> (static)</li>
12955 <li><a href="#static_android.control.availableSceneModes">android.control.availableSceneModes</a> (static)</li>
12956 <li><a href="#static_android.control.availableVideoStabilizationModes">android.control.availableVideoStabilizationModes</a> (static)</li>
12957 <li><a href="#static_android.control.awbAvailableModes">android.control.awbAvailableModes</a> (static)</li>
12958 <li><a href="#static_android.control.maxRegions">android.control.maxRegions</a> (static)</li>
12959 <li><a href="#static_android.control.sceneModeOverrides">android.control.sceneModeOverrides</a> (static)</li>
12960 <li><a href="#controls_android.flash.mode">android.flash.mode</a> (controls)</li>
12961 <li><a href="#static_android.flash.info.available">android.flash.info.available</a> (static)</li>
12962 <li><a href="#controls_android.jpeg.gpsCoordinates">android.jpeg.gpsCoordinates</a> (controls)</li>
12963 <li><a href="#controls_android.jpeg.gpsProcessingMethod">android.jpeg.gpsProcessingMethod</a> (controls)</li>
12964 <li><a href="#controls_android.jpeg.gpsTimestamp">android.jpeg.gpsTimestamp</a> (controls)</li>
12965 <li><a href="#controls_android.jpeg.orientation">android.jpeg.orientation</a> (controls)</li>
12966 <li><a href="#controls_android.jpeg.quality">android.jpeg.quality</a> (controls)</li>
12967 <li><a href="#controls_android.jpeg.thumbnailQuality">android.jpeg.thumbnailQuality</a> (controls)</li>
12968 <li><a href="#controls_android.jpeg.thumbnailSize">android.jpeg.thumbnailSize</a> (controls)</li>
12969 <li><a href="#static_android.jpeg.availableThumbnailSizes">android.jpeg.availableThumbnailSizes</a> (static)</li>
12970 <li><a href="#controls_android.lens.focusDistance">android.lens.focusDistance</a> (controls)</li>
12971 <li><a href="#static_android.lens.info.availableFocalLengths">android.lens.info.availableFocalLengths</a> (static)</li>
12972 <li><a href="#static_android.lens.info.hyperfocalDistance">android.lens.info.hyperfocalDistance</a> (static)</li>
12973 <li><a href="#dynamic_android.lens.focusRange">android.lens.focusRange</a> (dynamic)</li>
12974 <li><a href="#static_android.request.maxNumOutputStreams">android.request.maxNumOutputStreams</a> (static)</li>
12975 <li><a href="#controls_android.scaler.cropRegion">android.scaler.cropRegion</a> (controls)</li>
12976 <li><a href="#static_android.scaler.availableFormats">android.scaler.availableFormats</a> (static)</li>
12977 <li><a href="#static_android.scaler.availableJpegMinDurations">android.scaler.availableJpegMinDurations</a> (static)</li>
12978 <li><a href="#static_android.scaler.availableJpegSizes">android.scaler.availableJpegSizes</a> (static)</li>
Igor Murashkinf11a4df2013-05-07 10:00:46 -0700[diff] [blame]12979 <li><a href="#static_android.scaler.availableMaxDigitalZoom">android.scaler.availableMaxDigitalZoom</a> (static)</li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12980 <li><a href="#static_android.scaler.availableProcessedMinDurations">android.scaler.availableProcessedMinDurations</a> (static)</li>
12981 <li><a href="#static_android.scaler.availableProcessedSizes">android.scaler.availableProcessedSizes</a> (static)</li>
12982 <li><a href="#static_android.scaler.availableRawMinDurations">android.scaler.availableRawMinDurations</a> (static)</li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12983 <li><a href="#controls_android.sensor.frameDuration">android.sensor.frameDuration</a> (controls)</li>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]12984 <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]12985 <li><a href="#static_android.sensor.info.maxFrameDuration">android.sensor.info.maxFrameDuration</a> (static)</li>
12986 <li><a href="#static_android.sensor.info.physicalSize">android.sensor.info.physicalSize</a> (static)</li>
12987 <li><a href="#static_android.sensor.info.pixelArraySize">android.sensor.info.pixelArraySize</a> (static)</li>
12988 <li><a href="#static_android.sensor.orientation">android.sensor.orientation</a> (static)</li>
12989 <li><a href="#dynamic_android.sensor.timestamp">android.sensor.timestamp</a> (dynamic)</li>
12990 <li><a href="#controls_android.statistics.faceDetectMode">android.statistics.faceDetectMode</a> (controls)</li>
12991 <li><a href="#dynamic_android.statistics.faceIds">android.statistics.faceIds</a> (dynamic)</li>
12992 <li><a href="#dynamic_android.statistics.faceLandmarks">android.statistics.faceLandmarks</a> (dynamic)</li>
12993 <li><a href="#dynamic_android.statistics.faceRectangles">android.statistics.faceRectangles</a> (dynamic)</li>
12994 <li><a href="#dynamic_android.statistics.faceScores">android.statistics.faceScores</a> (dynamic)</li>
12995 <li><a href="#dynamic_android.lens.focalLength">android.lens.focalLength</a> (dynamic)</li>
12996 <li><a href="#dynamic_android.lens.focusDistance">android.lens.focusDistance</a> (dynamic)</li>
12997 </ul>
12998 </li> <!-- tag_BC -->
12999 <li id="tag_V1">V1 -
13000 New features for first camera 2 release (API1)
13001
13002 <ul class="tags_entries">
13003 <li><a href="#controls_android.demosaic.mode">android.demosaic.mode</a> (controls)</li>
13004 <li><a href="#controls_android.flash.firingPower">android.flash.firingPower</a> (controls)</li>
13005 <li><a href="#controls_android.flash.firingTime">android.flash.firingTime</a> (controls)</li>
13006 <li><a href="#static_android.flash.info.chargeDuration">android.flash.info.chargeDuration</a> (static)</li>
13007 <li><a href="#controls_android.hotPixel.mode">android.hotPixel.mode</a> (controls)</li>
13008 <li><a href="#controls_android.lens.aperture">android.lens.aperture</a> (controls)</li>
13009 <li><a href="#controls_android.lens.filterDensity">android.lens.filterDensity</a> (controls)</li>
13010 <li><a href="#controls_android.lens.focalLength">android.lens.focalLength</a> (controls)</li>
13011 <li><a href="#controls_android.lens.focusDistance">android.lens.focusDistance</a> (controls)</li>
13012 <li><a href="#controls_android.lens.opticalStabilizationMode">android.lens.opticalStabilizationMode</a> (controls)</li>
13013 <li><a href="#static_android.lens.info.availableApertures">android.lens.info.availableApertures</a> (static)</li>
13014 <li><a href="#static_android.lens.info.availableFilterDensities">android.lens.info.availableFilterDensities</a> (static)</li>
13015 <li><a href="#static_android.lens.info.availableFocalLengths">android.lens.info.availableFocalLengths</a> (static)</li>
13016 <li><a href="#static_android.lens.info.availableOpticalStabilization">android.lens.info.availableOpticalStabilization</a> (static)</li>
13017 <li><a href="#static_android.lens.info.geometricCorrectionMapSize">android.lens.info.geometricCorrectionMapSize</a> (static)</li>
13018 <li><a href="#static_android.lens.info.minimumFocusDistance">android.lens.info.minimumFocusDistance</a> (static)</li>
13019 <li><a href="#static_android.lens.info.shadingMapSize">android.lens.info.shadingMapSize</a> (static)</li>
13020 <li><a href="#static_android.lens.position">android.lens.position</a> (static)</li>
13021 <li><a href="#dynamic_android.lens.state">android.lens.state</a> (dynamic)</li>
13022 <li><a href="#controls_android.noiseReduction.mode">android.noiseReduction.mode</a> (controls)</li>
13023 <li><a href="#controls_android.request.id">android.request.id</a> (controls)</li>
13024 <li><a href="#controls_android.sensor.exposureTime">android.sensor.exposureTime</a> (controls)</li>
13025 <li><a href="#controls_android.sensor.frameDuration">android.sensor.frameDuration</a> (controls)</li>
13026 <li><a href="#controls_android.sensor.sensitivity">android.sensor.sensitivity</a> (controls)</li>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]13027 <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]13028 <li><a href="#static_android.sensor.info.exposureTimeRange">android.sensor.info.exposureTimeRange</a> (static)</li>
13029 <li><a href="#static_android.sensor.info.maxFrameDuration">android.sensor.info.maxFrameDuration</a> (static)</li>
13030 <li><a href="#static_android.sensor.info.physicalSize">android.sensor.info.physicalSize</a> (static)</li>
13031 <li><a href="#static_android.sensor.baseGainFactor">android.sensor.baseGainFactor</a> (static)</li>
13032 <li><a href="#static_android.sensor.maxAnalogSensitivity">android.sensor.maxAnalogSensitivity</a> (static)</li>
13033 <li><a href="#static_android.sensor.noiseModelCoefficients">android.sensor.noiseModelCoefficients</a> (static)</li>
13034 <li><a href="#controls_android.statistics.histogramMode">android.statistics.histogramMode</a> (controls)</li>
13035 <li><a href="#controls_android.statistics.sharpnessMapMode">android.statistics.sharpnessMapMode</a> (controls)</li>
13036 <li><a href="#dynamic_android.statistics.histogram">android.statistics.histogram</a> (dynamic)</li>
13037 <li><a href="#dynamic_android.statistics.sharpnessMap">android.statistics.sharpnessMap</a> (dynamic)</li>
13038 <li><a href="#dynamic_android.hotPixel.mode">android.hotPixel.mode</a> (dynamic)</li>
13039 <li><a href="#dynamic_android.lens.aperture">android.lens.aperture</a> (dynamic)</li>
13040 <li><a href="#dynamic_android.lens.filterDensity">android.lens.filterDensity</a> (dynamic)</li>
13041 <li><a href="#dynamic_android.lens.opticalStabilizationMode">android.lens.opticalStabilizationMode</a> (dynamic)</li>
13042 </ul>
13043 </li> <!-- tag_V1 -->
13044 <li id="tag_ADV">ADV - None
13045 <ul class="tags_entries">
13046 <li><a href="#static_android.flash.colorTemperature">android.flash.colorTemperature</a> (static)</li>
13047 <li><a href="#static_android.flash.maxEnergy">android.flash.maxEnergy</a> (static)</li>
13048 <li><a href="#controls_android.geometric.strength">android.geometric.strength</a> (controls)</li>
13049 <li><a href="#static_android.hotPixel.info.map">android.hotPixel.info.map</a> (static)</li>
13050 <li><a href="#static_android.lens.opticalAxisAngle">android.lens.opticalAxisAngle</a> (static)</li>
13051 <li><a href="#controls_android.shading.strength">android.shading.strength</a> (controls)</li>
13052 </ul>
13053 </li> <!-- tag_ADV -->
13054 <li id="tag_DNG">DNG -
13055 Needed for DNG file support
13056
13057 <ul class="tags_entries">
13058 <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]13059 <li><a href="#static_android.sensor.info.activeArraySize">android.sensor.info.activeArraySize</a> (static)</li>
13060 <li><a href="#static_android.sensor.info.colorFilterArrangement">android.sensor.info.colorFilterArrangement</a> (static)</li>
13061 <li><a href="#static_android.sensor.info.pixelArraySize">android.sensor.info.pixelArraySize</a> (static)</li>
13062 <li><a href="#static_android.sensor.info.whiteLevel">android.sensor.info.whiteLevel</a> (static)</li>
13063 <li><a href="#static_android.sensor.blackLevelPattern">android.sensor.blackLevelPattern</a> (static)</li>
13064 <li><a href="#static_android.sensor.calibrationTransform1">android.sensor.calibrationTransform1</a> (static)</li>
13065 <li><a href="#static_android.sensor.calibrationTransform2">android.sensor.calibrationTransform2</a> (static)</li>
13066 <li><a href="#static_android.sensor.colorTransform1">android.sensor.colorTransform1</a> (static)</li>
13067 <li><a href="#static_android.sensor.colorTransform2">android.sensor.colorTransform2</a> (static)</li>
13068 <li><a href="#static_android.sensor.forwardMatrix1">android.sensor.forwardMatrix1</a> (static)</li>
13069 <li><a href="#static_android.sensor.forwardMatrix2">android.sensor.forwardMatrix2</a> (static)</li>
13070 <li><a href="#static_android.sensor.referenceIlluminant1">android.sensor.referenceIlluminant1</a> (static)</li>
13071 <li><a href="#controls_android.tonemap.curveRed">android.tonemap.curveRed</a> (controls)</li>
13072 </ul>
13073 </li> <!-- tag_DNG -->
13074 <li id="tag_EXIF">EXIF - None
13075 <ul class="tags_entries">
13076 <li><a href="#static_android.sensor.referenceIlluminant1">android.sensor.referenceIlluminant1</a> (static)</li>
13077 </ul>
13078 </li> <!-- tag_EXIF -->
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]13079 <li id="tag_HAL2">HAL2 -
Alex Rayef40ad62013-10-01 17:52:33 -0700[diff] [blame]13080 Entry is only used by camera device HAL 2.x
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]13081
13082 <ul class="tags_entries">
13083 <li><a href="#controls_android.request.inputStreams">android.request.inputStreams</a> (controls)</li>
13084 <li><a href="#controls_android.request.outputStreams">android.request.outputStreams</a> (controls)</li>
13085 <li><a href="#controls_android.request.type">android.request.type</a> (controls)</li>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]13086 <li><a href="#controls_android.blackLevel.lock">android.blackLevel.lock</a> (controls)</li>
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]13087 </ul>
13088 </li> <!-- tag_HAL2 -->
Alex Rayef40ad62013-10-01 17:52:33 -0700[diff] [blame]13089 <li id="tag_FULL">FULL -
13090 Entry is required for full hardware level devices, and optional for other hardware levels
13091
13092 <ul class="tags_entries">
13093 <li><a href="#static_android.sensor.baseGainFactor">android.sensor.baseGainFactor</a> (static)</li>
13094 <li><a href="#static_android.sensor.maxAnalogSensitivity">android.sensor.maxAnalogSensitivity</a> (static)</li>
13095 <li><a href="#dynamic_android.sensor.temperature">android.sensor.temperature</a> (dynamic)</li>
13096 </ul>
13097 </li> <!-- tag_FULL -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13098 </ul>
13099 </div>
13100
13101 [ <a href="#">top</a> ]
13102
13103</body>
13104</html>